配置任务日志输出和保留

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

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

环境变量默认简述
CONTAINER_LOGGER_DESTINATION_TYPElogrotate任务日志的指向:任务的沙盒或日志。
CONTAINER_LOGGER_LOGROTATE_MAX_STDOUT_SIZE2MB沙盒中 stdout 文件在触发日志轮换之前的最大大小。
CONTAINER_LOGGER_LOGROTATE_STDOUT_OPTIONSrotate 9轮换 stdout 文件时传递给 logrotate 的选项。
CONTAINER_LOGGER_LOGROTATE_MAX_STDERR_SIZE2MB沙盒中 stderr 文件在触发日志轮换之前的最大大小。
CONTAINER_LOGGER_LOGROTATE_STDERR_OPTIONSrotate 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)。

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

最大大小

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,以防止滥用 postrotate 条款和其他注入式攻击。请参阅 MESOS-9564以获取更多信息。