docker如何配置syslog作为log输出。

docker如何配置syslog作为log输出。

1. 为docker配置syslog

有两个途径，一是全局配置即daemon.json，影响所有的container

$ cat /etc/docker/daemon.json
{
  "log-driver": "syslog",
  "log-opts": {
    "tag": "{{.Name}}",
    "syslog-facility": "local6"
  }
}

其中log-opts需要查看docker的文档，根据需要配置。
这个例子中的两个参数，后面会介绍他们的含义。

另一个途径就是per-container的配置。
就是在docker run的时候指定参数。

$ docker run --log-driver "syslog" --log-opts tag={{.Name}} --log-opts syslog-facility=local6 ...

经过这个配置之后，docker会把container的log导出到syslog。

2 配置syslog

必须先确保syslog在运行

$ sudo service rsyslog status

查看是状态是否在运行；注意rsyslog依赖于journald，查看journald是否在运行

$ sudo service systemd-journald status

这里systemd-journald依赖于一个machine id

sudo dbus-uuidgen --ensure=/etc/machine-id

重启journald和rsyslog

$ sudo systemctl start systemd-journald
$ sudo systemctl start rsyslog

经过这个步骤之后，container的log就导出到/var/log/messages里面了。

3 remote syslog

syslog还可以把log输出到远程的syslog，比如在docker swarm环境下，可以配置一个syslog server，把所有的不同机器上的container全部导出到这台机器上，实现log的集中式管理。

配置rsyslog server

$ cat /etc/rsyslog.conf
# Provides UDP syslog reception
#$ModLoad imudp
#$UDPServerRun 514

# Provides TCP syslog reception
$ModLoad imtcp
$InputTCPServerRun 514

可以配置成TCP或者UDP，上述配成UDP

上述配置了server端的监听地址，下面配置server端收到log信息之后如何处理。

# set umask
$Umask 0022
#$template mydyblogfile,"/u01/logs/%programname:1:36%/%programname%.log"
$template mydynlogfile,"/u01/logs/mylog.log"
# change log ower and group to username:docker
if (($inputname == 'imudp' or $inputname == 'imtcp') and $syslogfacility-text == 'local6') then {
  action (type="omfile" dynaFile="mydynlogfile"
          dirOwner="username:docker" dirGroup="docker"
          fileOwner="username:docker" fileGroup="docker"
          dirCreateMode="0755" fileCreateMode="0644")
  stop
}
# restore umask
$Umask 0002

# support long then 32 chars tag
$template LongTagForwardFormat,"<%PRI%>%TIMESTAMP:::date-rfc3339% %HOSTNAME% %syslogtag%%msg:::sp-if-no-1st-sp%%msg%"
$ActionForwardDefaultTemplate LongTagForwardFormat

几点说明：

1. Umask，如果要改日志文件的chmod则需要改
2. LongTagForwardFormat定义长tag，缺省情况下tag不能超过32字符，否则自动截断。

配置rsyslog client

$ cat /etc/rsyslog.d/.conf
...
# define forward buffer information
$ActionQueueFileName        fwdyourname
$ActionQueueMaxDiskSpace    1g
$ActionQueueSaveOnShutdown  on
$ActionQueueType            LinkedList
$ActionResumeRetryCount     -1
local6.*                    @@:514
& stop

这里把客户端的log全部转发到server地址:514，两个@@表示远端是TCP连接，一个@表示UDP连接。

并且定义了buffer的文件名(fwdyourname)和空间大小(1g)，以备远程server不能服务的时候，缓存本地日志。

4 配置logrotate

$ cat /etc/logrotate.d/myrotate.conf
/u01/logs/mylog.log {
  daily
  missingok
  notifempty
  dateext
  maxsize 100M
  rotate 10
  copytruncate
}

配置container的logrotate信息。

1. 每天一个rotate
2. 保留10天