Fluentd 日志驱动程序

fluentd 日志记录驱动程序将容器日志作为结构化日志数据发送到 Fluentd 收集器。然后，用户可以使用 Fluentd 的各种输出插件将这些日志写入各种目的地。

除了日志消息本身，fluentd 日志驱动程序还在结构化日志消息中发送以下元数据

字段	描述
`container_id`	完整的 64 位字符容器 ID。
`container_name`	容器启动时的名称。如果使用 `docker rename` 重命名容器，新名称不会反映在日志条目中。
`source`	`stdout` 或 `stderr`
`log`	容器日志

用法

支持通过多次指定 --log-opt 来设置一些选项

fluentd-address：指定一个套接字地址以连接到 Fluentd 守护进程，例如 fluentdhost:24224 或 unix:///path/to/fluentd.sock。
tag：为 Fluentd 消息指定一个标签。支持一些 Go 模板标记，例如 {{.ID}}、{{.FullID}} 或 {{.Name}} docker.{{.ID}}。

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

以下示例将日志驱动程序设置为 fluentd 并设置 fluentd-address 选项。

{
  "log-driver": "fluentd",
  "log-opts": {
    "fluentd-address": "fluentdhost:24224"
  }
}

重启 Docker 以使更改生效。

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

要为特定容器设置日志记录驱动程序，请将 --log-driver 选项传递给 docker run

$ docker run --log-driver=fluentd ...

在使用此日志记录驱动程序之前，请启动一个 Fluentd 守护进程。日志记录驱动程序默认通过 localhost:24224 连接到此守护进程。使用 fluentd-address 选项连接到不同的地址。

$ docker run --log-driver=fluentd --log-opt fluentd-address=fluentdhost:24224

如果容器无法连接到 Fluentd 守护进程，容器将立即停止，除非使用了 fluentd-async 选项。

选项

用户可以使用 --log-opt NAME=VALUE 标志来指定额外的 Fluentd 日志记录驱动程序选项。

fluentd-address

默认情况下，日志记录驱动程序连接到 localhost:24224。提供 fluentd-address 选项以连接到不同的地址。支持 tcp（默认）和 unix 套接字。

$ docker run --log-driver=fluentd --log-opt fluentd-address=fluentdhost:24224
$ docker run --log-driver=fluentd --log-opt fluentd-address=tcp://fluentdhost:24224
$ docker run --log-driver=fluentd --log-opt fluentd-address=unix:///path/to/fluentd.sock

以上两个示例指定了相同的地址，因为 tcp 是默认值。

<source>
  @type forward
</source>

<match *>
  @type stdout
</match>

使用此配置文件启动 Fluentd 容器

$ docker run -it -p 24224:24224 -v /path/to/conf/test.conf:/fluentd/etc/test.conf -e FLUENTD_CONF=test.conf fluent/fluentd:latest

使用 fluentd 日志记录驱动程序启动一个或多个容器
$ docker run --log-driver=fluentd your/application

Fluentd 日志驱动程序

用法

选项

fluentd-address

tag

labels, labels-regex, env, 和 env-regex

fluentd-async

fluentd-async-reconnect-interval

fluentd-buffer-limit

fluentd-retry-wait

fluentd-max-retries

fluentd-sub-second-precision

fluentd-write-timeout

使用 Docker 管理 Fluentd 守护进程

测试容器记录器