ACK 应用通过接入中心接入 OpenTelemetry 无侵入监控

更新时间:
复制 MD 格式

OBI(OpenTelemetry eBPF Instrumentation)以 DaemonSet 方式部署在 ACK 集群节点上,无需修改应用代码即可自动采集链路和指标数据。本文介绍如何通过云监控 CMS 2.0 接入中心为 ACK 集群中的应用接入 OBI 监控。

背景信息

OBI(OpenTelemetry eBPF Instrumentation)是基于 eBPF 技术的 Kubernetes 自动插桩组件。OBI 以 DaemonSet 方式部署在集群节点上,在内核层自动拦截应用的网络调用,无需修改应用代码或注入 Sidecar,即可采集指标(Metrics)和链路(Traces)数据,并通过 OTLP 协议上报至云监控 CMS 2.0。

OBI 支持自动探测以下协议和框架:

类别

支持的协议或框架

网络协议

HTTP、gRPC、SQL(MySQL/PostgreSQL)、Redis、Kafka

GenAI 框架

OpenAI、Anthropic、通义千问、MCP、Embedding、Rerank

选择接入方式

ACK 集群中的应用接入 OBI 监控有以下两种方式,根据需求选择:

维度

接入中心方式(本文)

手动 Helm 安装方式

适用场景

ACK 集群,追求零配置快速接入

通用 Kubernetes 集群(含非阿里云环境),需要自定义配置

操作方式

纯控制台操作,3 步完成

命令行操作,需手动编辑配置文件

K8s 版本要求

建议 1.32.0 及以上

1.24 及以上

如需使用手动 Helm 安装方式,请参见通用Kubernetes环境通过OpenTelemetry OBI 接入可观测

前提条件

已创建 ACK 集群,且集群中已部署需要监控的应用。

说明

建议 Kubernetes 版本为 1.32.0 及以上。如果集群版本低于此要求,接入中心可能无法正常识别集群。

步骤一:通过接入中心接入应用

通过 CMS 2.0 接入中心选择目标 ACK 集群和应用,完成 OBI 监控接入。

  1. 登录云监控 CMS 2.0 控制台,选择目标工作空间。

  2. 在左侧导航栏,单击接入中心

  3. 应用监控&链路追踪分类下,找到并单击OpenTelemetry 无侵入监控卡片。

    页面右侧弹出接入面板,面板中显示接入步骤。

  4. 选择 acs.ack.cluster步骤中,选择目标地域和 ACK 集群。

  5. 接入配置步骤中,选择需要监控的应用并填写应用名称。一次可以选择多个应用。

  6. 单击确定,等待接入配置完成。配置完成后,进入接入状态检查步骤查看接入结果。

步骤二:查看应用监控

OBI 自动扫描目标应用进程并开始采集数据。约 2~3 分钟后,即可在应用监控页面查看监控数据。

说明

如果需要监控使用 gRPC 协议的应用,需要重启对应的应用 Pod,才能完成 gRPC 协议监控的接入。

  1. 登录云监控 CMS 2.0 控制台,选择目标工作空间。

  2. 在左侧导航栏选择应用监控,查看已接入的应用列表。

  3. 单击目标应用名称,查看以下监控数据:

    • 应用拓扑:展示应用与上下游服务的调用关系。

    • 调用链路:查看单次请求的完整链路信息,包括每个跨度(Span)的耗时和状态。

    • 异常事务:查看发生错误的请求详情。

    • 慢事务:查看响应时间超过阈值的请求。

    • SQL 分析:查看数据库调用的性能指标。

卸载 OBI 监控

如需卸载已接入的 OBI 监控,按以下步骤删除监控配置。

  1. 登录云监控 CMS 2.0 控制台,选择目标工作空间。

  2. 在左侧导航栏,单击接入中心 > 接入管理

  3. 在接入管理页面,找到目标集群对应的应用,单击删除,将该应用从监控接入列表中移除。

通常 2~3 分钟后,该应用的监控数据将停止更新。

版本说明

版本号

变更时间

变更内容

变更影响

0.9.4

20260610

  • 支持不重启obi组件完成应用接入

此次升级不会对业务造成影响。

0.9.3

20260603

  • 增加profiling采集组件

此次升级不会对业务造成影响。

0.9.2

20260527

  • 支持云监控2.0接入中心接入应用

此次升级不会对业务造成影响。

0.9.1

20260522

首次发布