ghcr.io/coroot/coroot-node-agent:1.23.16

Coroot-node-agent

该代理收集与节点及其上运行的容器相关的指标，并以 Prometheus 格式暴露这些指标。

它使用 eBPF 跟踪与容器相关的事件（如 TCP 连接），因此最低支持的 Linux 内核版本为 5.1。

功能

TCP 连接跟踪

为提供服务间关系的可见性，代理会跟踪容器的 TCP 事件，例如 connect() 和 listen()。

导出的指标可用于：

• 获取实际的服务间通信映射。无需在代码中集成分布式追踪框架。
• 检测从一个服务到另一个服务的连接错误。
• 测量容器、节点和可用区之间的网络延迟。

相关博客文章：

• 使用 eBPF 构建服务地图
• ping 如何使用 SO_TIMESTAMPING 准确测量网络往返时间
• eBPF 可移植性的现状

日志模式提取

日志管理通常成本较高。在大多数情况下，无需单独分析每个事件，只需提取重复出现的模式及相关事件的数量即可。

这种方法可大幅减少快速日志分析所需的数据量。

代理会发现容器日志并在节点上直接解析。

目前支持以下日志来源：

• 直接记录到 /var/log/ 目录下的文件
• Journald
• Dockerd（JSON 文件驱动）
• Containerd（CRI 日志）

要了解有关自动日志聚类的更多信息，请查看博客文章 "从非结构化日志中挖掘指标"。

延迟统计

https://www.kernel.org/doc/html/latest/accounting/delay-accounting.html 使工程师能够准确识别容器面临 CPU 时间不足或等待 I/O 的情况。

代理通过 https://man7.org/linux/man-pages/man7/netlink.7.html 收集每个进程的计数器，并将其聚合为每个容器的指标：

• container_resources_cpu_delay_seconds_total
• container_resources_disk_delay_seconds_total

相关博客文章：

• 延迟统计：Linux 内核中被低估的功能

内存不足事件跟踪

container_oom_kills_total 指标显示容器已被 OOM killer 终止。

实例元信息

如果节点是云实例，代理会识别云提供商并使用相关元数据服务收集额外信息。

收集的信息包括：

• AccountID
• InstanceID
• 实例/机器类型
• 区域（Region）
• 可用区（AvailabilityZone）
• 可用区 ID（AvailabilityZoneId，仅 AWS）
• 生命周期（LifeCycle）：按需/竞价型（仅 AWS 和 GCP）
• 私有和公有 IP 地址

相关博客文章：

• 在 AWS、GCP 和 Azure 中收集云实例元数据

安装

请遵循 Coroot 文档。

指标

收集的指标说明请参见 此处。

Coroot

将指标转化为应用问题答案的最佳方式是使用 https://github.com/coroot/coroot%E2%80%94%E2%80%94%E4%B8%80%E6%AC%BE%E7%94%A8%E4%BA%8E%E5%BE%AE%E6%9C%8D%E5%8A%A1%E6%9E%B6%E6%9E%84%E7%9A%84%E9%9B%B6%E6%8F%92%E6%A1%A9%E5%8F%AF%E8%A7%82%E6%B5%8B%E6%80%A7%E5%B7%A5%E5%85%B7%E3%80%82

Coroot 的实时演示可在 demo.coroot.com 查看。

贡献

要开始贡献，请查看我们的 https://github.com/coroot/coroot-node-agent/blob/main/CONTRIBUTING.md%E3%80%82

许可证

Coroot-node-agent 采用 https://github.com/coroot/coroot-node-agent/blob/main/LICENSE 许可证。

BPF 代码采用 GNU General Public License, Version 2.0 许可证。