拾遗：使用 systemd-journald 管理 Docker 容器日志

在 docker.service 文件中的 ExecStart 字段中，添加(或：docker run --log-driver=journald)：

--log-driver=journald \

之后：

systemctl daemon-reload
systemctl restart docker.service

配置 journald.conf（此文件的各项正文必须单独占一行，否则不生效） ：

[Journal]
#日志存储到磁盘
Storage=persistent
#压缩日志
Compress=yes
#为日志添加序列号
Seal=yes
#每个用户分别记录日志
SplitMode=uid
#日志同步到磁盘的间隔，高级别的日志，如：CRIT、ALERT、EMERG 三种总是实时同步
SyncIntervalSec=1m 

#即制日志的最大流量，此处指 30s 内最多记录  条日志，超出的将被丢弃
RateLimitInterval=30s
#与 RateLimitInterval 配合使用
RateLimitBurst=

#限制全部日志文件加在一起最多可以占用多少空间，默认值是10%空间与4G空间两者中的较小者
SystemMaxUse=64G
#默认值是15%空间与4G空间两者中的较大者
SystemKeepFree=1G 

#单个日志文件的大小限制，超过此限制将触发滚动保存
SystemMaxFileSize=128M 

#日志滚动的最大时间间隔，若不设置则完全以大小限制为准
MaxFileSec=1day
#日志最大保留时间，超过时限的旧日志将被删除
MaxRetentionSec=100year 

#是否转发符合条件的日志记录到本机的其它日志管理系统，如：rsyslog
ForwardToSyslog=yes
ForwardToKMsg=no
#是否转发符合条件的日志到所有登陆用户的终端
ForwardToWall=yes
MaxLevelStore=debug
MaxLevelSyslog=err
MaxLevelWall=emerg
ForwardToConsole=no
#TTYPath=/dev/console
#MaxLevelConsole=info
#MaxLevelKMsg=notice

之后：

mkdir /var/log/journal
chown root:systemd-journal /var/log/journal
chmod  /var/log/journal
systemctl reset-failed systemd-journald.service && systemctl restart systemd-journald.service

日志查看工具 journalctl 的用法：

journalctl
    -u/--unit=docker.service \ #可以多次使用该选项，按 OR 逻辑筛选显示
    -o/--output=export \ #指定显示格式，常用三种： export、json-pretty、cat
    -r/--reverse \ #反向显示，即较新的日志显示在最上面
    --no-pager \ #不要使用 less 或 more 分页显示
    -f/--follow \ #类似 tail -f 效果
    --flush \ #将内存中日志同步到磁盘
    -D/--directory=DIR \ #指定读取日志的路径
    --file=zLogFilePath \ #同上，指定具体文件路径，可同时使用多次指定多个文件
    --priority= "emerg" (或 ), "alert" (), "crit" (), "err" (), "warning" (), "notice" (), "info" (), "debug" () \ #指定要显示的日志等级
    --since= "2012-10-30 18:17:16" \
    --until= "2017-10-30 18:17:16" \
    --disk-usage \ #显示所有日志占用的磁盘空间
#export 格式显示的特定进程的标识字段均可以用作筛选，例如：
    CONTAINER_ID= \ #以指定容器 ID 为标识显示日志
    CONTAINER_NAME= \ #同上，指定容器名称
    _PID= \ #以容器进程 ID 为标识显示日志
    _UID= \ ＃显示以某个用户 ID 身份运行的所有容器日志

export 格式输出样例：

 __CURSOR=s=cc2bd54b07c04211996c7eb3a46b4ecc;i=11f8;b=9319f78348534d7c9231b3788881d1be;m=ea1d9a9ab;t=54f2a70366564;x=cb3b442de23e1b6d
 __REALTIME_TIMESTAMP=
 __MONOTONIC_TIMESTAMP=
 _BOOT_ID=9319f78348534d7c9231b3788881d1be
 PRIORITY=
 _UID=
 _GID=
 _SYSTEMD_SLICE=system.slice
 _MACHINE_ID=783e916069bb40508bd037b154bf7593
 _TRANSPORT=journal
 _CAP_EFFECTIVE=1fffffffff
 _HOSTNAME=x
 _COMM=dockerd-current
 _EXE=/usr/bin/dockerd-current
 _SYSTEMD_CGROUP=/system.slice/docker.service
 _SYSTEMD_UNIT=docker.service
 _CMDLINE=/usr/bin/dockerd-current --log-driver=journald --add-runtime docker-runc=/usr/libexec/docker/docker-runc-current --default-runtime=docker-runc --exec-opt native.cgroupdriver=systemd --userland-proxy-path=/usr/libexec/docker/docker-proxy-current --selinux-enabled --log-driver=journald --signature-verification=false
 _SELINUX_CONTEXT=system_u:system_r:container_runtime_t:s0
 CONTAINER_TAG=
 _PID=
 CONTAINER_ID=bc31bfa22688
 CONTAINER_ID_FULL=bc31bfa22688736403a5e5e0377630382b4e0ac696b97254e779ce2b90a95b2d
 CONTAINER_NAME=hopeful_poitras
 MESSAGE
 3root@bc31bfa22688:/# date
 _SOURCE_REALTIME_TIMESTAMP=

 __CURSOR=s=cc2bd54b07c04211996c7eb3a46b4ecc;i=11f9;b=9319f78348534d7c9231b3788881d1be;m=ea1daab4f;t=54f2a70376708;x=e8ea5e3b827ffd6a
 __REALTIME_TIMESTAMP=
 __MONOTONIC_TIMESTAMP=
 _BOOT_ID=9319f78348534d7c9231b3788881d1be
 PRIORITY=
 _UID=
 _GID=
 _SYSTEMD_SLICE=system.slice
 _MACHINE_ID=783e916069bb40508bd037b154bf7593
 _TRANSPORT=journal
 _CAP_EFFECTIVE=1fffffffff
 _HOSTNAME=x
 _COMM=dockerd-current
 _EXE=/usr/bin/dockerd-current
 _SYSTEMD_CGROUP=/system.slice/docker.service
 _SYSTEMD_UNIT=docker.service
 _CMDLINE=/usr/bin/dockerd-current --log-driver=journald --add-runtime docker-runc=/usr/libexec/docker/docker-runc-current --default-runtime=docker-runc --exec-opt native.cgroupdriver=systemd --userland-proxy-path=/usr/libexec/docker/docker-proxy-current --selinux-enabled --log-driver=journald --signature-verification=false
 _SELINUX_CONTEXT=system_u:system_r:container_runtime_t:s0
 CONTAINER_TAG=
 _PID=
 CONTAINER_ID=bc31bfa22688
 CONTAINER_ID_FULL=bc31bfa22688736403a5e5e0377630382b4e0ac696b97254e779ce2b90a95b2d
 CONTAINER_NAME=hopeful_poitras
 MESSAGE
 Wed May  :: UTC
 _SOURCE_REALTIME_TIMESTAMP=

日志输出样例

每个容器对应日志中的多个唯一 ID，可以认为在宿主机上，能够 100％ 标识每一个容器，如：

• • _BOOT_ID    #标识宿主机是哪次启动的
  • _MACHINE_ID    #宿主机机器标识
  • CONTAINER_ID
  • CONTAINER_ID_FULL
  • CONTAINER_NAME

外部查看指定容器日志常用命令：

journalctl -u docker.service CONTAINER_ID=bc31bfa22688 -D </Path/To/LogBakDir> -o cat

形如这种的形式的，都是已滚动保存的日志（二进制形式）：

system@6c8acebb0081486ba83d698c06cd1d33--00054f2c2fe295f9.journal
system@6c8acebb0081486ba83d698c06cd1d33--00054f2c31c92008.journal
system@6c8acebb0081486ba83d698c06cd1d33-000000000000001d-00054f2c3311307d.journal

最后，将这些滚动日志定时复制或移动到指定位置即可。

自动布署脚本示例:

 #!/usr/bin/env sh

 zBakDir="/tmp"

 ###########################
 ##### docker.service ######
 ###########################

 zDockerPathA="/etc/systemd/system/docker.service"
 zDockerPathB="/usr/lib/systemd/system/docker.service"

 if [[  -eq `ls $zDockerPathA >/dev/null | wc -l` ]];then
     zPathToDockerService=$zDockerPathA
 else
     zPathToDockerService=$zDockerPathB
 fi

 if [[  -lt `grep -c 'log-driver=' $zPathToDockerService` ]];then
     perl -pi.bak -e 's/(?<=--log-driver=)\w+/journald/g' $zPathToDockerService
 else
     perl -pi.bak -e 's/(ExecStart=(\/\S+)+)/$1 --log-driver=journald /g' $zPathToDockerService
 fi

 ##############################
 ## systemd-journald.service ##
 ##############################

 zJournaldConfPath="/etc/systemd/journald.conf"
 zJournaldConf="[Journal]\nStorage=persistent\nCompress=yes\nSeal=yes\nSplitMode=uid\nSyncIntervalSec=30s\n\nRateLimitInterval=30s\nRateLimitBurst=100000\n\nSystemMaxUse=64G\nSystemKeepFree=1G\nSystemMaxFileSize=64M\nMaxFileSec=1day\nMaxRetentionSec=100year"
 echo -e $zJournaldConf > $zJournaldConfPath

 mkdir -p /var/log/journal
 chown -R root:systemd-journal /var/log/journal
 chmod -R  /var/log/journal

 ##############################
 ####  Back up docker log  ####
 ##############################

 zPath="/etc/systemd/system"
 mkdir -p ${zPath}

 zServName="zDockerLogBakUp"
 zBakExec="#!/usr/bin/env sh\n\ncp -np /var/log/journal/*/*@*.journal $zBakDir"
 zBakService="[Unit]\nDescription=''\nAfter=docker.service systemd-journald.service\n\n[Service]\nExecStart=${zPath}/${zServName}.sh\n\n[Install]\nWantedBy=multi-user.target"
 zBakTimer="[Unit]\nDescription=''\n\n[Timer]\nOnCalendar=*-*-* 02:30:00\nUnit=zDockerLogBakUp.service\n\n[Install]\nWantedBy=multi-user.target"

 echo -e "$zBakExec" > "${zPath}/${zServName}.sh"
 echo -e $zBakService > "${zPath}/${zServName}.service"
 echo -e $zBakTimer > "${zPath}/${zServName}.timer"

 chmod u+x ${zPath}/${zServName}.sh

 ##############################
 ####    Start Services    ####
 ##############################

 systemctl daemon-reload
 systemctl reset-failed docker.service
 systemctl restart docker.service

 systemctl reset-failed systemd-journald.service
 systemctl restart systemd-journald.service

 systemctl enable ${zServName}.timer

...