docker日志引擎说明

Posted 2020-11-10 运维者说

docker原生支持众多的日志引擎，适用于各种不同的应用场景，本篇文档对其作一个简单的说明。

Docker日志引擎说明

docker支持的日志引擎如下：

• none：关闭docker的回显日志, docker logs 看不到任何输出。使用这种方式也就意味着无法查看任何容器输出的日志

• json-file：把每个容器的回显日志打到每个容器的内部, 形式为json 文件。在实际使用中, 有些容器在启动后有大量的回显日志, 尤其在程序内部报错时打出的日志信息尤其巨大, 很可能会因为某几个容器的json 日志过大而撑爆整个宿主机的磁盘

• syslog：把所有容器的回显日志打到系统的syslog中。

  目前harbor私有镜像仓库使用docker-compose方式启动的话，就默认使用的这种方式。将所有容器的日志都集中收集到一个harbor-log的容器中，在执行docker logs的时候会提示"logs" command is supported only for "json-file" and "journald" loggin drivers (got: syslog)

• journald：把所有容器的回显日志打到系统的journald服务中，这是推荐的方式。

• fluentd：把所有容器的回显日志打到fluentd服务中

• gelf 把所有容器的回显日志打到支持 GELF(Graylog Extended Log Format) 格式的服务中, 比如Graylog或Logstash

修改docker日志引擎

1. 修改docker配置文件/etc/docker/daemon.json如下：

   {
       "log-driver": "journald"
   }

2. 在容器运行时指定其日志引擎：

   docker run --log-driver=journald alpint /bin/sh

journald配置说明

journald配置文件说明

# /etc/systemd/jornald.conf示例：

[Journal]
#Storage=auto  存储为自动模式, 其他模式有无日志模式, 纯内存模式和纯磁盘模式
#Compress=yes  默认启动压缩功能
#Seal=yes   默认加密, 日志文件为二进制文件, 无法 vim或tail 查看
#SplitMode=uid
#SyncIntervalSec=5m
#RateLimitIntervalSec=30s
#RateLimitBurst=1000
#SystemMaxUse=  精确设置日志可以占用的最大磁盘空间
#SystemKeepFree=  保证系统剩余的空间大小
#SystemMaxFileSize=
#SystemMaxFiles=100
#RuntimeMaxUse=
#RuntimeKeepFree=
#RuntimeMaxFileSize=
#RuntimeMaxFiles=100
#MaxRetentionSec=
#MaxFileSec=1month
#ForwardToSyslog=no
#ForwardToKMsg=no
#ForwardToConsole=no
#ForwardToWall=yes
#TTYPath=/dev/console
#MaxLevelStore=debug
#MaxLevelSyslog=debug
#MaxLevelKMsg=notice
#MaxLevelConsole=info
#MaxLevelWall=emerg

journald 默认配置下, 默认日志最大限制为所在文件系统容量的 10%

默认配置下, journald 的日志存放在 /var/log/journal 下, 如果该目录在根分区下, 且根分区空间大小为10G, 那么 journald 存放日志最大的大小为1G, 超出1G 后将删除最早的日志

也可以精确指定占用的空间大小：

SystemMaxUse=50M

journalctl基本用法

• journalctl 从头查看所有日志

• journalctl -b 查看本次开机后的所有系统引导日志

• journalctl -b -1 显示上次开机后的系统引导日志, 以此类推

• journalctl -f 类似于 tail -f或tailf

• journalctl /usr/bin/dockerd 后加程序的绝对路径,可以显示该程序的所有日志信息

• journalctl -xe systemd 启动程序失败时会提示你使用这个命令查看错误信息, 其中x 表示在日志输出中增加一些解释性的短文本, e表示立即跳转至日志的尾部

journald注意事项

journald配置中，有两个非常重要的优化项目：

ForwardToSyslog=yes
ForwardToWall=yes

以上两个参数默认都是 yes 意味着 journald 收集日志后还会转发到 syslog 中

由此造成的影响是: journald 虽然可以乖乖的按照上面的配置进行日志的清理, 但是 syslog 却不在 journald 的控制范围之内

在日志量很大的情况下,syslog中的日志量也变得巨大,所以我们需要把上面两个参数的值改为no

重启journald服务：

systemctl restart systemd-journald.service

参考：https://docs.lvrui.io/2017/02/19/%E6%9B%B4%E6%94%B9docker%E7%9A%84%E6%97%A5%E5%BF%97%E5%BC%95%E6%93%8E%E4%B8%BA-journald/