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 守護程序

測試容器記錄器