Fluentd 日志记录驱动程序

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

除了日志消息本身之外，fluentd日志 Driver 在结构化日志消息中发送以下元数据：

田	描述
`container_id`	完整的 64 个字符的容器 ID。
`container_name`	启动容器时的名称。如果您使用`docker rename`要重命名容器，新名称不会反映在 Journal entries （日记帐条目）中。
`source`	`stdout`或`stderr`
`log`	容器日志

用法

通过指定--log-opt根据需要多次：

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

要使用fluentddriver 作为默认的日志记录驱动程序，将log-driver和log-optkeys 添加到daemon.json文件，即位于/etc/docker/在 Linux 主机上或C:\ProgramData\docker\config\daemon.json在 Windows Server 上。有关使用配置 Dockerdaemon.json，请参阅 daemon.json。

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

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

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

注意
log-opts配置选项中的daemon.json配置文件必须以字符串形式提供。布尔值和数值（例如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 地址

默认情况下，日志记录驱动程序连接到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是 default。

<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 地址

标记

labels、labels-regex、env 和 env-regex

Fluentd-异步

fluentd-async-reconnect-interval

fluentd-buffer-limit 缓冲区限制

fluentd-retry-wait

fluentd-max-retries

流利的亚秒级精度

使用 Docker 管理 Fluentd 守护程序

测试容器记录器