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日志记录驱动程序选项：

如果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守护进程指定下一个环境变量来配置少数高级选项。