Syslog 日志驱动程序

syslog 日志驱动程序将日志路由到 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 驱动程序用作默认日志驱动程序，请在 daemon.json 文件中将 log-driver 和 log-opt 密钥设置为适当的值，该文件位于 Linux 主机的 /etc/docker/ 或 Windows Server 的 C:\ProgramData\docker\config\daemon.json 中。有关使用 daemon.json 配置 Docker 的更多信息，请参阅 daemon.json。

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

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

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

注意

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

您可以通过使用 --log-driver 标志到 docker container create 或 docker run 来为特定容器设置日志驱动程序。

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

选项

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