apache/skywalking-banyandb-fodc-agent

Apache SkyWalking BanyanDB FODC Agent镜像

Docker镜像并非ASF官方发布，而是为了方便提供。推荐的使用方式始终是从源码构建。

SkyWalking是一个APM（应用性能监控）系统，特别为微服务、云原生和基于容器（Docker、Kubernetes、Mesos）的架构设计。

FODC Agent是FODC（首次发生数据收集）的每节点数据收集器。它设计为与BanyanDB节点一起运行，收集本地指标，暴露Prometheus端点，并向FODC代理流式传输节点信息。

此镜像仅运行FODC agent，不会自行启动BanyanDB或FODC代理。

您可以在https://github.com/apache/skywalking-banyandb/tree/main/fodc/agent/Dockerfile%E6%89%BE%E5%88%B0%E6%BA%90%E4%BB%A3%E7%A0%81%E5%92%8CDockerfile%E3%80%82

如何使用此镜像

容器的入口点是fodc-agent二进制文件，因此运行时配置通过命令行标志传递。

在BanyanDB节点旁运行agent

这是典型的边车模式用法。默认情况下，agent从端口2121收集BanyanDB指标，并在端口9090上暴露自己的Prometheus端点。

bash
docker run --rm \
  --network host \
  apache/skywalking-banyandb-fodc-agent:latest \
  --prometheus-listen-addr=:9090 \
  --poll-metrics-ports=2121

将agent连接到FODC代理

要注册到代理，请提供代理gRPC地址和pod标识。对于完整节点注册，还需启用集群状态轮询。

bash
docker run --rm \
  --network host \
  apache/skywalking-banyandb-fodc-agent:latest \
  --prometheus-listen-addr=:9090 \
  --poll-metrics-ports=2121 \
  --proxy-addr=127.0.0.1:17912 \
  --pod-name=banyandb-datanode-0 \
  --cluster-state-ports=17912

如果在容器网络而非主机网络中运行agent，请调整目标地址和端口，使agent仍能访问本地BanyanDB指标端点和FODC代理。

常用标志

• --poll-metrics-interval：收集本地BanyanDB指标的间隔。默认值：10s。
• --poll-metrics-ports：要收集的BanyanDB指标端口。默认值：2121。
• --max-metrics-memory-usage-percentage：内存中指标缓存使用的最大cgroup内存百分比。默认值：10。
• --prometheus-listen-addr：agent的Prometheus端点地址。默认值：:9090。
• --proxy-addr：FODC代理gRPC地址。默认值：localhost:17900。
• --pod-name：用作agent标识一部分的pod名称。
• --container-names：与--poll-metrics-ports一一对应的容器名称。
• --heartbeat-interval：向代理发送心跳的间隔。默认值：10s。
• --reconnect-interval：与代理重连的退避间隔。默认值：5s。
• --cluster-state-ports：用于集群状态轮询的BanyanDB gRPC端口。
• --cluster-state-poll-interval：轮询集群状态的间隔。默认值：30s。
• --ktm-enabled：在Linux上启用基于KTM eBPF的内核遥测。
• --ktm-interval：KTM收集间隔。默认值：10s。

端口

• 9090：FODC agent暴露的Prometheus指标端口。
• 2121：agent收集的典型BanyanDB本地指标端口。

了解更多

• FODC概述：https://github.com/apache/skywalking-banyandb/blob/main/docs/operation/fodc/overview.md
• FODC API和CLI标志：https://github.com/apache/skywalking-banyandb/blob/main/docs/operation/fodc/apis.md
• 项目主页：[***]