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

splunk日志驱动程序发送集装箱日志HTTP事件收集器中的Splunk Enterprise和Splunk的云。

用法

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

以下示例将日志驱动程序设置为splunk。

{
  "log-driver": "splunk"
}

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

您可以使用以下--log-driver选项来设置特定容器的日志记录驱动程序docker run：

docker run --log-driver=splunk ...

Splunk选项

您可以使用该--log-opt NAME=VALUE标志来指定这些额外的Splunk日志记录驱动程序选项：

选项	需要	描述
splunk-token	需要	Splunk HTTP事件收集器令牌。
splunk-url	需要	以下列格式之一指向您的Splunk Enterprise，自助服务Splunk Cloud实例或Splunk云托管群集（包括HTTP Event Collector使用的端口和方案）的路径：https：// your_splunk_instance：8088或https：// input- prd-p-XXXXXXX.cloud.splunk.com:8088或https://http-inputs-XXXXXXXX.splunkcloud.com。
splunk-source	可选的	事件源。
splunk-sourcetype	可选的	事件源类型。
splunk-index	可选的	事件索引。
splunk-capath	可选的	根证书的路径。
Splunk-caname	可选的	用于验证服务器证书的名称; 默认情况下将使用splunk-url的主机名。
splunk-insecureskipverify	可选的	忽略服务器证书验证。
splunk-format	可选的	消息格式。可以是内联，json或raw。默认为内联。
splunk-verify-connection	可选的	在开始时验证，该docker可以连接到Splunk服务器。默认为true。
Splunk-gzip	可选的	启用/禁用gzip压缩以将事件发送到Splunk Enterprise或Splunk Cloud实例。默认为false。
splunk-gzip-level	可选的	设置gzip的压缩级别。有效值为-1（默认），0（不压缩），1（最佳速度）... 9（最佳压缩）。默认为DefaultCompression。
tag	可选的	为消息指定标签，解释某些标记。默认值是{{.ID}}（容器ID的12个字符）。请参阅日志标记选项文档以定制日志标记格式。
labels	可选的	如果这些标签是为容器指定的，则应在消息中包含标签的键的逗号分隔列表。
env	可选的	如果为容器指定了这些变量，则应该在消息中包含环境变量的键的逗号分隔列表。
env-regex	可选的	与env类似且兼容。一个正则表达式来匹配与日志相关的环境变量。用于高级日志标记选项。

如果label和env键之间存在冲突，env则优先。这两个选项都将附加字段添加到日志消息的属性中。

以下是为Splunk Enterprise实例指定的日志记录选项的示例。该实例本地安装在运行Docker守护程序的同一台机器上。根证书和通用名称的路径是使用HTTPS方案指定的。这用于验证。SplunkServerDefaultCert是由Splunk证书自动生成的。

$ docker run --log-driver=splunk \
           --log-opt splunk-token=176FCEBF-4CF5-4EDF-91BC-703796522D20 \
           --log-opt splunk-url=https://splunkhost:8088 \
           --log-opt splunk-capath=/path/to/cert/cacert.pem \
           --log-opt splunk-caname=SplunkServerDefaultCert \
           --log-opt tag="{{.Name}}/{{.FullID}}" \
           --log-opt labels=location \
           --log-opt env=TEST \
           --env "TEST=false" \
           --label location=west \
       your/application

splunk-url托管于云的Splunk Splunk的情况下，是在像格式https://http-inputs-XXXXXXXX.splunkcloud.com，并且不包括端口说明。

消息格式

默认情况下，日志驱动程序将消息发送给inline格式，例如，每条消息将作为字符串嵌入其中。

{
    "attrs": {
        "env1": "val1",
        "label1": "label1"
    },
    "tag": "MyImage/MyContainer",
    "source":  "stdout",
    "line": "my message"
}
{
    "attrs": {
        "env1": "val1",
        "label1": "label1"
    },
    "tag": "MyImage/MyContainer",
    "source":  "stdout",
    "line": "{\"foo\": \"bar\"}"
}

如果您的消息是JSON对象，您可能希望将它们嵌入到我们发送给Splunk的消息中。通过指定--log-opt splunk-format=json驱动程序将尝试将每一行解析为JSON对象，并将其作为嵌入式对象发送。如果它不能解析它-消息将作为inline.例如

{
    "attrs": {
        "env1": "val1",
        "label1": "label1"
    },
    "tag": "MyImage/MyContainer",
    "source":  "stdout",
    "line": "my message"
}
{
    "attrs": {
        "env1": "val1",
        "label1": "label1"
    },
    "tag": "MyImage/MyContainer",
    "source":  "stdout",
    "line": {
        "foo": "bar"
    }
}

第三种格式是raw消息。您可以使用指定它--log-opt splunk-format=raw。属性（环境变量和标签）和标签将作为消息的前缀。例如

MyImage/MyContainer env1=val1 label1=label1 my message
MyImage/MyContainer env1=val1 label1=label1 {"foo": "bar"}

高级选项

Splunk日志记录驱动程序允许您通过为Docker守护进程指定下一个环境变量来配置少数高级选项。

环境变量名称	默认值	描述
SPLUNK_LOGGING_DRIVER_POST_MESSAGES_FREQUENCY	5S	如果没有什么可以批量驱动程序发布消息的频率。您可以将此视为等待更多消息进行批处理的最长时间。
SPLUNK_LOGGING_DRIVER_POST_MESSAGES_BATCH_SIZE	1000	在一批发送驱动程序之前，驱动程序应等待多少个消息。
SPLUNK_LOGGING_DRIVER_BUFFER_MAX	10 * 1000	如果驱动程序无法连接到远程服务器，它可以保存在缓冲区中以便重试的最大消息数量是多少。
SPLUNK_LOGGING_DRIVER_CHANNEL_SIZE	4 * 1000	通道中有多少待处理消息可用于将消息发送给后台记录器工作人员，后者将对这些消息进行批处理。

本文档系腾讯云开发者社区成员共同维护，如有问题请联系 cloudcommunity@tencent.com

最后更新于：2017-12-18