拾遗：使用 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 内最多记录 100000 条日志，超出的将被丢弃
RateLimitInterval=30s 
#与 RateLimitInterval 配合使用
RateLimitBurst=100000

#限制全部日志文件加在一起最多可以占用多少空间，默认值是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 0770 /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" (或 0), "alert" (1), "crit" (2), "err" (3), "warning" (4), "notice" (5), "info" (6), "debug" (7)  #指定要显示的日志等级
    --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 格式输出样例：

 1 __CURSOR=s=cc2bd54b07c04211996c7eb3a46b4ecc;i=11f8;b=9319f78348534d7c9231b3788881d1be;m=ea1d9a9ab;t=54f2a70366564;x=cb3b442de23e1b6d
 2 __REALTIME_TIMESTAMP=1494418573387108
 3 __MONOTONIC_TIMESTAMP=62844938667
 4 _BOOT_ID=9319f78348534d7c9231b3788881d1be
 5 PRIORITY=6
 6 _UID=0
 7 _GID=0
 8 _SYSTEMD_SLICE=system.slice
 9 _MACHINE_ID=783e916069bb40508bd037b154bf7593
10 _TRANSPORT=journal
11 _CAP_EFFECTIVE=1fffffffff
12 _HOSTNAME=x
13 _COMM=dockerd-current
14 _EXE=/usr/bin/dockerd-current
15 _SYSTEMD_CGROUP=/system.slice/docker.service
16 _SYSTEMD_UNIT=docker.service
17 _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
18 _SELINUX_CONTEXT=system_u:system_r:container_runtime_t:s0
19 CONTAINER_TAG=
20 _PID=9109
21 CONTAINER_ID=bc31bfa22688
22 CONTAINER_ID_FULL=bc31bfa22688736403a5e5e0377630382b4e0ac696b97254e779ce2b90a95b2d
23 CONTAINER_NAME=hopeful_poitras
24 MESSAGE
25 3root@bc31bfa22688:/# date
26 _SOURCE_REALTIME_TIMESTAMP=1494418573386408
27 
28 __CURSOR=s=cc2bd54b07c04211996c7eb3a46b4ecc;i=11f9;b=9319f78348534d7c9231b3788881d1be;m=ea1daab4f;t=54f2a70376708;x=e8ea5e3b827ffd6a
29 __REALTIME_TIMESTAMP=1494418573453064
30 __MONOTONIC_TIMESTAMP=62845004623
31 _BOOT_ID=9319f78348534d7c9231b3788881d1be
32 PRIORITY=6
33 _UID=0
34 _GID=0
35 _SYSTEMD_SLICE=system.slice
36 _MACHINE_ID=783e916069bb40508bd037b154bf7593
37 _TRANSPORT=journal
38 _CAP_EFFECTIVE=1fffffffff
39 _HOSTNAME=x
40 _COMM=dockerd-current
41 _EXE=/usr/bin/dockerd-current
42 _SYSTEMD_CGROUP=/system.slice/docker.service
43 _SYSTEMD_UNIT=docker.service
44 _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
45 _SELINUX_CONTEXT=system_u:system_r:container_runtime_t:s0
46 CONTAINER_TAG=
47 _PID=9109
48 CONTAINER_ID=bc31bfa22688
49 CONTAINER_ID_FULL=bc31bfa22688736403a5e5e0377630382b4e0ac696b97254e779ce2b90a95b2d
50 CONTAINER_NAME=hopeful_poitras
51 MESSAGE
52 Wed May 10 12:16:13 UTC 2017
53 _SOURCE_REALTIME_TIMESTAMP=1494418573452545

日志输出样例

每个容器对应日志中的多个唯一 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-0000000000000001-00054f2c2fe295f9.journal
system@6c8acebb0081486ba83d698c06cd1d33-0000000000000017-00054f2c31c92008.journal
system@6c8acebb0081486ba83d698c06cd1d33-000000000000001d-00054f2c3311307d.journal

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

自动布署脚本示例:

 1 #!/usr/bin/env sh
 2 
 3 zBakDir="/tmp"
 4 
 5 ###########################
 6 ##### docker.service ######
 7 ###########################
 8 
 9 zDockerPathA="/etc/systemd/system/docker.service"
10 zDockerPathB="/usr/lib/systemd/system/docker.service"
11 
12 if [[ 1 -eq `ls $zDockerPathA 2>/dev/null | wc -l` ]];then
13     zPathToDockerService=$zDockerPathA
14 else
15     zPathToDockerService=$zDockerPathB
16 fi
17 
18 if [[ 0 -lt `grep -c 'log-driver=' $zPathToDockerService` ]];then
19     perl -pi.bak -e 's/(?<=--log-driver=)w+/journald/g' $zPathToDockerService
20 else
21     perl -pi.bak -e 's/(ExecStart=(/S+)+)/$1 --log-driver=journald /g' $zPathToDockerService
22 fi
23 
24 ##############################
25 ## systemd-journald.service ##
26 ##############################
27 
28 zJournaldConfPath="/etc/systemd/journald.conf"
29 zJournaldConf="[Journal]
Storage=persistent
Compress=yes
Seal=yes
SplitMode=uid
SyncIntervalSec=30s

RateLimitInterval=30s
RateLimitBurst=100000

SystemMaxUse=64G
SystemKeepFree=1G
SystemMaxFileSize=64M
MaxFileSec=1day
MaxRetentionSec=100year"
30 echo -e $zJournaldConf > $zJournaldConfPath
31 
32 mkdir -p /var/log/journal
33 chown -R root:systemd-journal /var/log/journal
34 chmod -R 0770 /var/log/journal
35 
36 ##############################
37 ####  Back up docker log  ####
38 ##############################
39 
40 zPath="/etc/systemd/system"
41 mkdir -p ${zPath}
42 
43 zServName="zDockerLogBakUp"
44 zBakExec="#!/usr/bin/env sh

cp -np /var/log/journal/*/*@*.journal $zBakDir"
45 zBakService="[Unit]
Description=''
After=docker.service systemd-journald.service

[Service]
ExecStart=${zPath}/${zServName}.sh

[Install]
WantedBy=multi-user.target"
46 zBakTimer="[Unit]
Description=''

[Timer]
OnCalendar=*-*-* 02:30:00
Unit=zDockerLogBakUp.service

[Install]
WantedBy=multi-user.target"
47 
48 echo -e "$zBakExec" > "${zPath}/${zServName}.sh"
49 echo -e $zBakService > "${zPath}/${zServName}.service"
50 echo -e $zBakTimer > "${zPath}/${zServName}.timer"
51 
52 chmod u+x ${zPath}/${zServName}.sh
53 
54 ##############################
55 ####    Start Services    ####
56 ##############################
57 
58 systemctl daemon-reload
59 systemctl reset-failed docker.service
60 systemctl restart docker.service
61 
62 systemctl reset-failed systemd-journald.service
63 systemctl restart systemd-journald.service
64 
65 systemctl enable ${zServName}.timer

...