配置任务日志输出和保留

影响日志记录的任务环境变量

您可以修改任务日志的位置和日志保留 通过在其中指定以下任何环境变量修改 任务定义:

环境变量 默认 简述
CONTAINER_LOGGER_DESTINATION_TYPE logrotate 任务日志的指向:任务的沙盒或日志。
CONTAINER_LOGGER_LOGROTATE_MAX_STDOUT_SIZE 2MB 沙盒中 stdout 文件在触发日志轮换之前的最大大小。
CONTAINER_LOGGER_LOGROTATE_STDOUT_OPTIONS rotate 9 轮换 stdout 文件时传递给 logrotate 的选项。
CONTAINER_LOGGER_LOGROTATE_MAX_STDERR_SIZE 2MB 沙盒中 stderr 文件在触发日志轮换之前的最大大小。
CONTAINER_LOGGER_LOGROTATE_STDERR_OPTIONS rotate 9 轮换 stderr 文件时传递给 logrotate 的选项。
CONTAINER_LOGGER_EXTRA_LABELS "{}" 在输出到 journald 时标记每个日志行的额外密钥值对。

详细信息

警告:为这些选项指定无效值将导致该任务 启动失败。

目标类型

CONTAINER_LOGGER_DESTINATION_TYPE 可能采用三个自变量:

  • logrotate (默认)
  • journald
  • journald+logrotate

不推荐 使用 journald 选项,这是因为 journald 性能问题。 启用后,日志会直接通过管道传输到节点的日志中,同时还有 AGENT_IDEXECUTOR_IDCONTAINER_ID 等一些标签

logrotate 选项将放置日志(名为 stdoutstderr) 在任务沙盒内并创建附加文件,用于轮换这些 日志 (*.logrotate.conf*.logrotate.state)。

请参阅 日志记录 API 了解如何读取这些日志的信息。

最大大小

CONTAINER_LOGGER_LOGROTATE_MAX_STDOUT_SIZECONTAINER_LOGGER_LOGROTATE_MAX_STDERR_SIZE 选项控制 这些日志文件的最大大小。达到此阈值后,日志轮换 就会被触发。

大小必须为小于 2^64 的整数,且后缀必须带有 B(字节)、KBMBGBTB 的等单位。不应该在 整数和单位之间留有空格。

示例:

  • 2MB
  • 1234B
  • 1TB

重要信息:大小的规定上限为 2^64 字节。尝试指定更高的 值(例如 2^64 TB)将导致未确定的结果。

日志轮换选项

CONTAINER_LOGGER_LOGROTATE_STDOUT_OPTIONSCONTAINER_LOGGER_LOGROTATE_STDERR_OPTIONS 选项控制每次轮换 传递至 logrotate 的参数。自变量 没有限制。请参阅 手册页 了解可能的值。

每条日志轮换规则均应以换行符 (\n) 隔开。例如:

  • rotate 10\ncompress\ndelaycompress
  • daily\nmaxage 10\nnomail

有些规则是不必要的,或者将被覆盖:

  • size 将会被值 CONTAINER_LOGGER_LOGROTATE_MAX_STDOUT_SIZECONTAINER_LOGGER_LOGROTATE_MAX_STDERR_SIZE 覆盖。
  • 无法如期运行基于时间的轮换。轮换的触发 纯粹基于写入的量。所以如果 在 2MB 时触发轮换,但写入量少于 2MB,则轮换永远 都不会发生。
  • 不需要 copycopytruncate,因为不会在轮换时 写入日志文件。这意味着没有日志行 会丢失(尽管可以将太长的行切割成不同的文件)。