Containerd默认日志格式为text，需升级至1.6+并配置log_format="json"，使time、stream、log、attrs等字段原生结构化，提升Fluent Bit等边缘采集器解析效率与稳定性。

Containerd 默认日志格式为 text（即非结构化文本），直接对接 Fluent Bit、Loki、Filebeat 等边缘日志采集器时，需额外解析才能提取字段，影响性能与可靠性。启用 log_format = "json" 可原生输出标准 JSON 日志，使时间戳、容器 ID、日志级别等关键字段自动结构化，显著降低边缘侧解析负担，提升海量日志场景下的吞吐与稳定性。

确认 Containerd 版本支持 JSON 日志格式

Containerd 1.6+ 正式支持 log_format 配置项；低于该版本（如 1.5.x）即使配置也无效。可通过以下命令验证：

containerd --version

若版本过低，需先升级 Containerd。Kubernetes 集群中还应同步检查 CRI 插件兼容性（如 kubeadm 部署需确认 containerd socket 路径与版本匹配）。

修改 containerd 配置启用 JSON 日志

编辑 /etc/containerd/config.toml，在 [plugins."io.containerd.grpc.v1.cri".containerd.default_runtime] 或对应 runtime 配置块下添加或修改：

    [plugins."io.containerd.grpc.v1.cri".containerd.default_runtime.options]
      log_format = "json"
      # 可选：指定日志驱动（仅当使用 cri-o 或自定义运行时需显式声明）
      # systemd = false

注意：

Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载

• 必须重启 containerd 生效：sudo systemctl restart containerd
• 若使用 Kata Containers、gVisor 等非 runc 运行时，需在对应 runtime 的 options 块中单独配置
• JSON 日志默认包含 time（RFC3339）、stream（stdout/stderr）、log（原始内容）、attrs（含 container_id、image 等）字段，无需额外注解

边缘采集器适配建议（以 Fluent Bit 为例）

启用 JSON 日志后，Fluent Bit 可跳过正则解析，直接用 parser 插件读取原生字段：

[INPUT]
    Name              tail
    Path              /var/log/containers/*.log
    Parser            docker
<p>[PARSER]
Name        docker
Format      json
Time_Key    time
Time_Format %Y-%m-%dT%H:%M:%S.%L%z

优势明显：

• 避免因日志换行、特殊字符导致的解析失败
• 减少 CPU 占用（无正则匹配开销），适合资源受限边缘节点
• 天然支持 Loki 的 labels 提取（如 container_id、kubernetes.namespace）

验证与排障要点

部署后快速验证是否生效：

• 启动一个测试容器：crictl runp <pod-config> && crictl create <container-config>
• 查看其日志文件（通常位于 /var/log/containers/<name>_<ns>_<id>.log），首行应为合法 JSON（含 "log": "...", "stream": "...", "time": "...", "attrs": {...}）
• 若仍为纯文本，检查 containerd 是否真正重载配置（containerd config dump 查看运行时生效值）及 runtime 是否被 Pod 正确引用（crictl inspect <cid> | grep runtime）

不复杂但容易忽略。