使用 Docker logs 与远程日志驱动程序

概述

您可以使用docker logs命令读取容器日志，无论配置的日志驱动程序或插件如何。Docker Engine 使用local日志驱动程序充当缓存，用于读取容器的最新日志。这称为双重日志记录。默认情况下，缓存启用了日志文件轮换，并且每个容器最多限制为 5 个文件，每个文件 20 MB（压缩前）。

请参阅配置选项部分以自定义这些默认值，或参阅禁用双重日志记录部分以禁用此功能。

前提条件

如果配置的日志驱动程序不支持读取日志，则 Docker Engine 会自动启用双重日志记录。

以下示例显示了在有和没有双重日志记录可用性的情况下运行docker logs命令的结果。

无双重日志记录功能

当容器配置了远程日志驱动程序（例如splunk）并且禁用了双重日志记录时，尝试在本地读取容器日志时会显示错误。

• 步骤 1：配置 Docker 守护程序

  $ cat /etc/docker/daemon.json
  {
    "log-driver": "splunk",
    "log-opts": {
      "cache-disabled": "true",
      ... (options for "splunk" logging driver)
    }
  }
  

• 步骤 2：启动容器

  $ docker run -d busybox --name testlog top
  

• 步骤 3：读取容器日志

  $ docker logs 7d6ac83a89a0
  Error response from daemon: configured logging driver does not support reading
  

具有双重日志记录功能

启用双重日志记录缓存后，即使日志驱动程序不支持读取日志，也可以使用docker logs命令读取日志。以下示例显示了使用splunk远程日志驱动程序作为默认值且启用了双重日志记录缓存的守护程序配置。

• 步骤 1：配置 Docker 守护程序

  $ cat /etc/docker/daemon.json
  {
    "log-driver": "splunk",
    "log-opts": {
      ... (options for "splunk" logging driver)
    }
  }
  

• 步骤 2：启动容器

  $ docker run -d busybox --name testlog top
  

• 步骤 3：读取容器日志

  $ docker logs 7d6ac83a89a0
  2019-02-04T19:48:15.423Z [INFO]  core: marked as sealed
  2019-02-04T19:48:15.423Z [INFO]  core: pre-seal teardown starting
  2019-02-04T19:48:15.423Z [INFO]  core: stopping cluster listeners
  2019-02-04T19:48:15.423Z [INFO]  core: shutting down forwarding rpc listeners
  2019-02-04T19:48:15.423Z [INFO]  core: forwarding rpc listeners stopped
  2019-02-04T19:48:15.599Z [INFO]  core: rpc listeners successfully shut down
  2019-02-04T19:48:15.599Z [INFO]  core: cluster listeners successfully shut down
  

注意

对于支持读取日志的日志驱动程序（例如local、json-file和journald驱动程序），在双重日志记录功能可用之前和之后，功能没有任何区别。对于这些驱动程序，可以在两种情况下都使用docker logs读取日志。

配置选项

双重日志记录缓存接受与local日志驱动程序相同的配置选项，但带有cache-前缀。这些选项可以针对每个容器指定，并且可以使用守护程序配置文件为新容器设置默认值。

默认情况下，缓存启用了日志文件轮换，并且每个容器最多限制为 5 个文件，每个文件 20MB（压缩前）。使用下面描述的配置选项自定义这些默认值。

禁用双重日志记录缓存

使用cache-disabled选项禁用双重日志缓存。在仅通过远程日志系统读取日志，并且不需要通过docker logs读取日志进行调试的情况下，禁用缓存可以节省存储空间。

使用守护进程配置文件时，可以为单个容器禁用缓存，或者默认情况下为新容器禁用缓存。

以下示例使用守护进程配置文件将splunk日志驱动程序作为默认驱动程序，并禁用缓存。

$ cat /etc/docker/daemon.json
{
  "log-driver": "splunk",
  "log-opts": {
    "cache-disabled": "true",
    ... (options for "splunk" logging driver)
  }
}

注意

对于支持读取日志的日志驱动程序（例如local、json-file和journald驱动程序），不会使用双重日志记录，禁用此选项无效。

限制

• 如果使用发送远程日志的日志驱动程序或插件的容器出现网络问题，则不会写入本地缓存。
• 如果由于任何原因（例如文件系统已满、写入权限被移除）logdriver写入失败，则缓存写入失败，并在守护进程日志中记录。不会重试写入缓存的日志条目。
• 在默认配置中，某些日志可能会从缓存中丢失，因为使用环形缓冲区是为了防止在文件写入缓慢的情况下阻塞容器的标准输入/输出。管理员必须在守护进程关闭时修复这些问题。