JSON 文件日志驱动程序

目录

默认情况下，Docker捕获所有容器的标准输出（和标准错误），并使用JSON格式将它们写入文件。JSON格式使用其来源（stdout或stderr）及其时间戳注释每一行。每个日志文件仅包含有关一个容器的信息。

{
  "log": "Log line is here\n",
  "stream": "stdout",
  "time": "2019-01-01T11:11:11.111111111Z"
}

警告

json-file日志驱动程序使用基于文件的存储。这些文件旨在被Docker守护进程独占访问。使用外部工具与这些文件交互可能会干扰Docker的日志系统并导致意外行为，应避免。

用法

要将json-file驱动程序用作默认日志驱动程序，请在daemon.json文件中将log-driver和log-opts键设置为适当的值，该文件位于Linux主机的/etc/docker/或Windows Server的C:\ProgramData\docker\config\中。如果文件不存在，请先创建它。有关使用daemon.json配置Docker的更多信息，请参阅daemon.json。

以下示例将日志驱动程序设置为json-file，并将max-size和max-file选项设置为启用自动日志轮换。

{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  }
}

注意

daemon.json配置文件中的log-opts配置选项必须作为字符串提供。因此，布尔值和数值（例如上面示例中max-file的值）必须用引号（"）括起来。

重新启动Docker才能使对新创建容器的更改生效。现有容器不会自动使用新的日志记录配置。

您可以使用--log-driver标志到docker container create或docker run来设置特定容器的日志记录驱动程序

$ docker run \
      --log-driver json-file --log-opt max-size=10m \
      alpine echo hello world

选项

json-file日志驱动程序支持以下日志记录选项

选项描述示例值
max-size日志在滚动之前的最大大小。一个正整数加上表示度量单位的修饰符（k、m或g）。默认为-1（无限制）。--log-opt max-size=10m
max-file可以存在的日志文件的最大数量。如果滚动日志创建了多余的文件，则会删除最旧的文件。仅当也设置了max-size时才有效。一个正整数。默认为1。--log-opt max-file=3
labels在启动Docker守护程序时应用。此守护程序接受的与日志记录相关的标签的逗号分隔列表。用于高级日志标签选项。--log-opt labels=production_status,geo
labels-regex类似于并兼容labels。用于匹配与日志记录相关的标签的正则表达式。用于高级日志标签选项。--log-opt labels-regex=^(production_status|geo)
env在启动Docker守护程序时应用。此守护程序接受的与日志记录相关的环境变量的逗号分隔列表。用于高级日志标签选项。--log-opt env=os,customer
env-regex类似于并兼容env。用于匹配与日志记录相关的环境变量的正则表达式。用于高级日志标签选项。--log-opt env-regex=^(os|customer)
compress切换旋转日志的压缩。默认为disabled。--log-opt compress=true

示例

此示例启动一个alpine容器，该容器最多可以有3个日志文件，每个文件不超过10兆字节。

$ docker run -it --log-opt max-size=10m --log-opt max-file=3 alpine ash