Graylog扩展格式日志记录驱动程序

预计阅读时间：4分钟

该gelf记录驱动器是受一些工具如所理解的方便格式 Graylog，Logstash，和 Fluentd。许多工具都使用这种格式。

在GELF中，每条日志消息都是具有以下字段的字典：

版本
主持人（首先发送邮件的人）
时间戳记
消息的简短版本和较长版本
您自己配置的任何自定义字段

用法

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

下面的示例将日志驱动程序gelf设置为并设置gelf-address 选项。

{
  "log-driver": "gelf",
  "log-opts": {
    "gelf-address": "udp://1.2.3.4:12201"
  }
}

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

笔记

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

您可以通过--log-driver在使用docker container create或时设置标志来为特定容器设置日志记录驱动程序 docker run：

$ docker run \
      --log-driver gelf –-log-opt gelf-address=udp://1.2.3.4:12201 \
      alpine echo hello world

GELF选项

该gelf日志驱动程序支持下面的选项：

选项	必需的	描述	示例值
`gelf-address`	必需的	GELF服务器的地址。`tcp`并且`udp`是唯一受支持的URI说明符，您必须指定端口。	`--log-opt gelf-address=udp://192.168.0.42:12201`
`gelf-compression-type`	可选的	`UDP Only`GELF驱动程序用于压缩每个日志消息的压缩类型。允许值是`gzip`，`zlib`和`none`。默认值为`gzip`。请注意，启用压缩会导致CPU使用率过高，因此强烈建议将其设置为`none`。	`--log-opt gelf-compression-type=gzip`
`gelf-compression-level`	可选的	`UDP Only`压缩时的水平`gzip`或`zlib`为`gelf-compression-type`。`-1`到`9`（BestCompression）范围内的整数。默认值为1（BestSpeed）。较高的级别以较低的速度提供更多的压缩。无论是`-1`或`0`禁用压缩。	`--log-opt gelf-compression-level=2`
`gelf-tcp-max-reconnect`	可选的	`TCP Only`连接断开时的最大重新连接尝试次数。一个正整数。预设值为3。	`--log-opt gelf-tcp-max-reconnect=3`
`gelf-tcp-reconnect-delay`	可选的	`TCP Only`两次重新连接尝试之间等待的秒数。一个正整数。预设值为1。	`--log-opt gelf-tcp-reconnect-delay=1`
`tag`	可选的	附加到消息`APP-NAME`中的的字符串`gelf`。默认情况下，Docker使用容器ID的前12个字符标记日志消息。请参阅日志标签选项文档以自定义日志标签格式。	`--log-opt tag=mailer`
`labels`	可选的	在启动Docker守护程序时适用。该守护程序接受的与日志记录相关的标签的逗号分隔列表。在`extra`字段上添加下划线（`_`）前缀的其他键。用于高级日志标签选项。	`--log-opt labels=production_status,geo`
`labels-regex`	可选的	与相似并兼容`labels`。与记录相关标签匹配的正则表达式。用于高级日志标签选项。	`--log-opt labels-regex=^(production_status\|geo)`
`env`	可选的	在启动Docker守护程序时适用。该守护程序接受的与日志记录相关的环境变量的逗号分隔列表。在`extra`字段上添加下划线（`_`）前缀的其他键。用于高级日志标签选项。	`--log-opt env=os,customer`
`env-regex`	可选的	与相似并兼容`env`。用于匹配与日志记录相关的环境变量的正则表达式。用于高级日志标签选项。	`--log-opt env-regex=^(os\|customer)`

笔记

该gelf驱动程序不支持TLS进行TCP连接。发送到受TLS保护的输入的消息可以静默失败。

例子

此示例配置使用GELF服务器运行在容器 192.168.0.42上的端口12201。

$ docker run -dit \
    --log-driver=gelf \
    --log-opt gelf-address=udp://192.168.0.42:12201 \
    alpine sh

graylog，GELF，日志记录，驾驶员