系统日志记录驱动程序

日志记录驱动程序syslog将日志路由到syslog服务器。该syslog协议使用原始字符串作为日志消息，并支持一组有限的元数据。系统日志消息必须采用特定方式格式化才能有效。从有效消息中，接收者可以提取以下信息：

• 优先级：日志记录级别，例如debug、warning、error、info。
• 时间戳：事件发生的时间。
• 主机名：事件发生的位置。
• 设施：哪个子系统记录了消息，例如mail或kernel。
• 进程名称和进程 ID (PID)：生成日志的进程的名称和 ID。

该格式在RFC 5424中定义 ，Docker 的 syslog 驱动程序 通过以下方式实现ABNF 参考：

                TIMESTAMP SP HOSTNAME SP APP-NAME SP PROCID SP MSGID
                    +          +             +           |        +
                    |          |             |           |        |
                    |          |             |           |        |
       +------------+          +----+        |           +----+   +---------+
       v                            v        v                v             v
2017-04-01T17:41:05.616647+08:00 a.vm {taskid:aa,version:} 1787791 {taskid:aa,version:}

用法

要将syslog驱动程序用作默认日志记录驱动程序，请将log-driver 和log-opt键设置为文件中的适当值daemon.json，该文件位于/etc/docker/Linux 主机或 C:\ProgramData\docker\config\daemon.jsonWindows Server 上。有关使用配置 Docker 的更多信息daemon.json，请参阅 daemon.json。

以下示例将日志驱动程序设置为syslog并设置该 syslog-address选项。该syslog-address选项同时支持UDP和TCP；本示例使用 UDP。

{
  "log-driver": "syslog",
  "log-opts": {
    "syslog-address": "udp://1.2.3.4:1111"
  }
}

重新启动 Docker 以使更改生效。

笔记

log-opts配置文件中的配置选项daemon.json必须以字符串形式提供。因此，数字和布尔值（例如 的值 syslog-tls-skip-verify）必须用引号 ( ) 括起来"。

您可以使用或--log-driver标志为特定容器设置日志记录驱动程序 ：docker container createdocker run

$ docker run \
      --log-driver syslog --log-opt syslog-address=udp://1.2.3.4:1111 \
      alpine echo hello world

选项

支持以下日志记录选项作为syslog日志记录驱动程序的选项。daemon.json通过将它们作为键值对添加到JSON 数组，可以将它们设置为默认值log-opts。还可以通过--log-opt <key>=<value>在启动容器时为每个选项添加标志来在给定容器上设置它们。