容器监控配置
配置针对容器和 Pod 的监控与采集策略,用于服务识别和调用链层级的深度监控。支持手动创建、批量导入和导出,满足大规模环境下的高效规则管理需求。
核心能力
- 深度监控自动注入:为 Containerd、CRI-O、Docker、Podman 等容器技术配置 APM 探针自动注入,实现进程服务识别与调用链深度监控。
- Pod 监控规则:按 Kubernetes Cluster、Namespace、Pod Name 前缀等条件精细化控制哪些 Pod 需要被监控,支持监控全部或限定数量的 Pod。
- 容器监控规则:基于容器名、镜像名、Kubernetes 属性等多维条件,定义容器的监控或不监控策略。
- 批量导入 / 导出:通过标准 Excel 模板批量导入规则,解决大量规则的重复配置问题;已有规则支持一键导出备份或迁移。
使用场景
场景 1:新环境初始化配置。接入一套新的 Kubernetes 集群,需要批量配置数十条 Pod 监控规则,下载模板填写后直接导入,避免逐条手动创建。
场景 2:精细化屏蔽系统 Pod。系统命名空间(如 kube-system、istio-system)下的基础设施 Pod 无需业务监控,配置容器监控规则将其设为不监控,降低无效数据采集量。
场景 3:规则迁移与备份。将生产环境已有的采集规则导出为 Excel,用于新环境快速复制或作为配置基线存档。
开始使用
进入部署配置 → 规则配 置 → 数据采集 → 容器,即可查看容器采集规则页面。
深度监控的自动容器注入
页面顶部列出支持的容器技术(Containerd、CRI-O、Docker、Podman),您可逐一开启或关闭对应容器技术的 APM 探针自动注入。
Podman 在非 root 模式下不支持自动注入。

Pod 监控规则
规则列表展示所有已配置规则的优先级、描述、数据中心、Kubernetes Cluster Name 及 Namespace Name等信息,支持按规则配置信息和启用状态搜索,列表默认按优先级排序(数字越小优先级越高)。
批量操作:勾选多条规则后,可批量执行启用、禁用、删除操作;通过【移动】可手动调整规则优先级顺序。




创建规则
- 点击【创建】,打开"创建 Pod 监控规则"面板。
- 填写监控条件:
Kubernetes cluster name:等于指定集群名称(探针安装时指定的集群名)。Kubernetes namespace name:等于指定命名空间。Kubernetes pod name 前缀:支持"等于"或"包含"两种匹配方式;Pod Name 也支持按 Deployment 名称匹配。数据中心:选择全部、主中心或副中心,决定规则下发范围。条件关系:多条件之间取"与"关系。
- 设置监控项:选择"监控全部 Pod"或"监控部分 Pod"(后者需填写 Pod 数量上限)。
- 填写描述(必填),点击【保存】。

容器监控规则
规则列表展示优先级和描述,支持按描述关键字搜索,列表默认按优先级排序(数字越小优先级越高)。
批量操作:勾选多条规则后,可批量执行启用、禁用、删除操作;通过【移动】可手动调整规则优先级顺序。

创建规则
-
点击【创建】,打开"创建规则"面板。
-
设置生效范围:主机范围选择"全部主机"或"自定义主机范围"(自定义时按主机名称或 IP 筛选)。
-
配置条件:
- 选择监控状态:"监控"或"不监控"。
- 条件配置支持两种模式切换:
- 引导式:通过下拉选择条件字段(容器名、镜像名、Kubernetes 属性等)、操作符和值进行可视化配置。
- JSON 格式:直接编辑 JSON 数组,适合批量粘贴或从 Excel 模板复制。JSON 文本框提供完整的数据映射说明,右上角【复制】按钮可将 JSON 内容复制到剪贴板。
条件关系:多条件之间选择"或"或"与"。
-
填写描述(必填),点击【保存】。

批量导入规则
适用于 Pod 监控规则和容器监控规则,两者操作流程一致。以容器监控规则导入为例:
- 点击【导入】,打开导入弹窗。
- 点击【下载模版】获取标准 Excel 模板(容器:
容器采集规则导入模版.xlsx)。 - 按模板格式填写规则数据后,将文件拖入上传区域或点击选择文件(支持
.xlsx/.xls,单文件不超过 10M)。 - 点击【确定】,系统 逐行校验数据:
- 任意一行校验失败(格式错误、重复数据),则整个文件导入失败,页面给出精确的行号和错误原因提示。
- 全部校验通过后,自动完成批量导入。
- 导入成功后,新规则默认按最近导入时间倒序排列(越靠上优先级越高)。

导出规则
以容器监控规则导入为例,点击规则列表右上角【导出】图标,将当前所有规则导出为 Excel 文件,文件名格式:容器采集规则_年月日时分秒.xlsx,数据格式与导入模板一致,可直接用于再次导入。

预置监控规则
页面底部展示系统内置的预置规则(默认禁用对无关容器的监控),您可按需开启或关闭,无法删除或编辑。

特殊说明
规则上限:自定义采集规则最多支持 1000 条,导入超出上限的部分会导入失败,行数靠前的规则优先导入。
重复检测:导入时系统会自动检测重复数据(描述字段除外),Excel 内行间重复或与已有规则重复均会提示具体行号,仅去除重复项后的合法数据导入成功。
Pod Name 前缀功能版本要求:Kubernetes pod name 前缀 配置项仅支持 SmartAgent 探针版本 8.5.2 及以上,低版本探针该配置不生效。
多数据中心注意:规则数据中心选择"全部"时,监控部分 Pod 的数量限制将同步下发至所有数据中心。
引导式与 JSON 格式互转:两种条件配置模式可随时切换;从 JSON 切换到引导式时,若 JSON 格式有误或含无效数据,系统会弹框确认是否清除异常数据后继续切换。