Syslog日志记录驱动程序（引擎） | Syslog logging driver (Engine)

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选项。

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

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

注系统日志地址支持UDP和TCP.

您可以通过设置特定容器的记录驾驶员--log-driver标志docker create或docker run：

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

备选方案

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

syslog, docker, logging, driver