探针管理是针对可观测体系中数据采集探针提供全生命周期管理，包括：安装探针、探针详情查看、配置修改、升级、状态监控等，以保障大规模分布式系统中观测数据的稳定、可靠、可信。本文为您介绍如何安装和管理探针。

背景信息

基本概念

术语	说明
Add-on 插件	管理探针的组件，承担控制器职责，主要用于探针的配置下发，容器环境中通常通过无状态负载部署。例如：VKE 集群中的 apmplus-opentelemetry-collector 组件，主要用于 o11yagent-apm-otel-collector 探针的配置下发和管理。
探针	嵌入目标系统用于采集数据的独立组件，可在不改变业务逻辑的前提下，持续采集指标、日志、链路等数据，统一上报到监控存储的后端。例如：服务端应用中的 o11yagent-apm-otel-collector 探针，可采集应用中的指标、日志、链路等数据，批量上报至应用性能监控。

指标说明

探针和探针实例监控看板中涉及到的指标及详细说明如下：

指标	说明
CPU	探针或探针实例的 CPU 占用量，用于评估采集器负载，识别流量突增、规避过载引发的算力瓶颈。
Mem	探针或探针实例的内存占用量，反映观测数据缓冲区、解析处理逻辑的内存开销。
OTEL Receiver Bytes	探针或探针实例每秒接收的原始数据字节量，可用于衡量上游业务侧推送给探针的数据总量，判断业务埋点上报量是否突增。
OTEL Receiver Request Count	探针或探针实例每秒收到的上报请求次数，主要反映业务上报的请求频次，可用于判断业务侧上报频率是否异常。
Flush Bytes	探针或探针实例完成聚合压缩后，每秒批量推送到可观测存储后端的总出口字节流量。
Flush Count	探针或探针实例每秒执行批量上报的次数，表征探针向后端推送的网络调用频次。Flush Count 越高，代表探针批量切分越细，网络请求开销越大。

前提条件

安装三方云容器探针或主机探针前，确保已经获取具备 APMPlusServerDataExportRolePolicy 权限的火山引擎账号 AK/SK 信息，用于授权三方云进行探针安装和数据上报。获取方法参见：如何获取 API 访问密钥。

安装三方云容器探针前，需提前获取三方云中容器集群的集群名称信息。

目前仅 CentOS 7 系列及以上版本操作系统的 Linux 主机支持安装主机探针。

安装探针过程若使用 VPC 接入方式，需确保被采集资源与全栈可观测平台的网络连通性。

安装探针

火山引擎 VKE 探针

三方云容器探针

主机探针

登录全栈可观测平台控制台。

在左侧导航栏选择集成中心 -> 探针管理。

单击右上角安装探针按钮，并在容器探针页签中选择火山引擎 VKE。

选择目标地域并完成跨服务授权，确保全栈可观测平台能够正常获取 VKE 集群和组件安装信息。

说明

跨服务授权仅需配置一次，若当前并未完成跨服务授权，可根据界面引导进行配置。

选择目标集群，进行探针安装。

若集群未安装探针，单击一键安装即可安装最新版本的 Add-on 插件和容器探针。

若集群已经安装探针，无需重新安装。另外，单击配置可跳转到容器集群组件管理页面，进行探针实例的部署信息配置；单击卸载可快速卸载 Add-on 插件和容器探针。

登录全栈可观测平台控制台。

在左侧导航栏选择集成中心 -> 探针管理。

单击右上角安装探针按钮，并在容器探针页签中选择三方云。

选择目标地域并根据实际情况进行参数配置，将生成三方云容器探针的安装命令。

配置项	说明	图例
接入方式	三方云中的应用接入应用性能监控的方式，可结合网络连通性和网络安全性考量，根据实际情况选择 VPC 接入或公网接入。说明若选择 VPC 接入，需自行确保被采集资源与全栈可观测平台的网络连通性。
云厂商类型	应用所属的云厂商，目前支持腾讯云、华为云、阿里云、AWS、自建 Kubernetes。
集群名称	三方云中待安装探针的容器集群名称。
工作负载类型	探针通过容器方式部署时的工作负载类型，可根据实际情况选择 Deployment、DaemonSet 或 StatefulSet。 Deployment：使用无状态负载部署探针实例，支持多副本弹性扩缩容。适用于无状态的集中式采集场景，例如 APM、Trace 与集群级指标聚合。 DaemonSet：使用守护进程部署探针实例，适用于节点日志、主机监控、容器指标、Profiling 场景。 StatefulSet：使用有状态负载部署探针实例，适用于 Prometheus 采集场景。
Access Key	火山引擎账号的 AK 信息，与 SK 信息一起，用于授权三方云进行探针安装和数据上报。
Secret Key	火山引擎账号 AK 对应的 SK 信息。

通过 Kubectl 连接三方云容器集群，执行安装命令进行探针安装。探针安装成功后，等待 3~5 分钟即可正常采集监控数据。

执行 kubectl get pods -n o11yagent-monitor 命令可查看已安装的探针进程，探针的 STATUS 为 ONLINE 表示安装成功。

若需要卸载已经安装的探针，执行 helm uninstall o11yagent-operator -n o11yagent-monitor 命令。

管理探针

火山引擎 VKE 探针

三方云容器探针

主机探针

登录全栈可观测平台控制台。

在左侧导航栏选择集成中心 -> 探针管理，前往容器探针的火山引擎 VKE 页签，查看已经关联集成任务的 Add-on 插件列表。

说明

同类型环境中的 Add-on 插件名称相同，可通过所属集群进行区分。

升级组件：组件发布新版本时，目标组件行将出现提醒标识，单击待升级按钮，支持一键升级到最新版本。

说明

平台会定期发布 Add-on 插件新版本，推荐定期升级，以使用最新功能。

部署配置：单击目标组件右侧操作列中的配置，支持修改组件的部署配置，包括：部署方式、实例个数、CPU 请求/上限、内存请求/上限。配置建议参见：apmplus-opentelemetry-collector 组件使用规格建议。

单击目标 Add-on 插件名称，可在下拉页面中查看 Add-on 插件管理的探针列表。

单击目标探针名称，支持跳转到探针对应的工作负载详情页面，查看工作负载相关更多信息。

单击目标探针右侧操作列中的详情，可查看探针和探针实例相关详细信息。

展示项	说明	图例
所属集群	当前探针所属的容器集群，单击基础信息中的集群 ID，支持跳转到集群管理页面。	-
资源配置	当前探针的 Request / Limit 配置，单击编辑按钮，支持修改配置。 Request：CPU 和内存资源的请求量。 Limit：CPU 和内存资源的使用上限。
探针实例	单击目标探针实例名称，支持跳转到探针实例对应的 Pod 详情页面，查看更多信息。
		单击目标探针实例右侧操作列中的指标按钮，支持查看探针实例相关指标的监控看板，可用于性能分析。指标说明请参见：指标说明。
		单击目标探针实例右侧操作列中的运行日志按钮，支持跳转到日志管理页面，查看当前探针实例运行过程中产生的日志，可用于故障分析。
集成任务	当前探针关联的集成任务。单击集成任务名称，支持跳转到集成任务配置详情页面。更多详细说明参见：集成管理。	-
监控看板	当前探针相关指标的监控看板，可用于性能分析。指标说明请参见：指标说明。
运行日志	跳转到探针对应工作负载的日志页面，查看当前探针运行过程中产生的日志，可用于故障分析。

全栈可观测平台