Syslog 日志记录驱动程序

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

• 优先级：日志记录级别，例如 、 、 、 。debugwarningerrorinfo
• 时间戳：事件发生的时间。
• 主机名：事件发生的位置。
• Facility：记录消息的子系统，例如 或 。mailkernel
• 进程名称和进程 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:}

用法

要将驱动程序用作默认日志记录驱动程序，请在文件中将 和 键设置为适当的值，即 位于 Linux 主机或 Windows Server 上。有关 使用 配置 Docker，请参阅 daemon.json。sysloglog-driverlog-optdaemon.json/etc/docker/C:\ProgramData\docker\config\daemon.jsondaemon.json

以下示例将日志驱动程序设置为 并设置选项。这些选项支持 UDP 和 TCP; 此示例使用 UDP。syslogsyslog-addresssyslog-address

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

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

注意

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

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

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

选项

支持将以下日志记录选项作为日志记录的选项 司机。可以在 中将它们设置为默认值，方法是将它们添加为 键值对添加到 JSON 数组中。它们也可以设置在给定的 容器，为每个选项添加一个标志，当 启动容器。syslogdaemon.jsonlog-opts--log-opt <key>=<value>