跳到主要内容
版本:2.x

采集点详情

概述

采集点列表 中点击某个采集点名称,进入该采集点的详情页。这里集中展示和配置单个采集点的全部信息:基本连接参数、标签、宏,以及各类发现规则。它是日常运维中调整"这台设备到底怎么采"的主要入口。

详情页采用顶部区块 + 标签页的混合布局:顶部是采集点自身的属性区块,下方标签页是其挂载的发现规则。

采集点详情页

页面布局

区域内容
顶部:概览采集点的基本连接信息(名称、接口、代理、关联模板、分组、状态等)
顶部:标签键值对标签,用于分组与筛选
顶部:宏变量定义,用于在模板中做参数化
标签页:CI 发现规则把采集数据映射为配置项(CI)的规则
标签页:采集点发现规则基于采集点数据动态生成采集点的发现规则

顶部区块

概览

这是采集点最核心的连接配置,决定"系统如何与这台设备建立采集通道":

配置说明
名称采集点的显示名称
接口连接设备的入口——地址(IP / DNS)、端口、连接协议(如 Agent、SNMP)。一台采集点可有多个接口,其中一个为主接口
代理由哪个代理负责采集;不指定则平台直连
关联模板已套用的 采集模板,模板内的发现规则等配置会同步到本采集点
分组所属的采集分组,用于批量管理
状态启用 / 禁用
接口决定"能不能连上"

"接口"是最常出问题的字段。如果采集点在列表里显示启用却不可达,先回到这里检查:地址对不对、端口对不对、连接协议与设备实际开放的服务是否一致。

标签

标签是附加在采集点上的键值对(如 env: prodrole: web),不参与采集逻辑,但非常实用:

  • 在列表里按标签筛选一组设备
  • 采集规则 在自动纳管时打标
  • 作为批量操作的筛选条件

一个采集点可以打多个标签。

宏是采集点级别的变量,格式为 {$MACRO}(大写名字、外层包 {$ })。它的作用是让同一套 采集模板 在不同采集点上呈现不同的取值——模板里写变量,具体值在各个采集点的"宏"里填。

例如模板里有一条采集规则用到超时变量 {$TIMEOUT},那么 web 服务器采集点可把 {$TIMEOUT} 设为 3,老旧设备采集点设为 10,共用一套模板却各自适配。

采集点宏优先于模板宏

当模板和采集点都定义了同名宏时,采集点的值优先。这让你既享受模板的统一配置,又能在个别设备上覆盖特殊值。

标签页:发现规则

发现规则是采集点的"采集策略扩展",用来自动派生出更多采集项。详情页提供两类发现规则标签页:

CI 发现规则

把采集到的数据**映射为配置项(CI)**的规则。每条规则定义"从哪个数据键取值、按什么类型、以多长间隔更新,最终在 CMDB 里得到哪些 CI"。列表展示:

说明
名称规则名称
键值取数的数据键(如 ssh.ci.discoverysnmp.ci.discovery
类型数据采集类型
更新间隔多久更新一次
状态启用 / 禁用

典型用途:把采集点上报的主机名、IP、序列号、网口、磁盘、已安装软件等原始数据,自动整理进 CMDB 成为受管的配置项。

编辑一条 CI 发现规则

点击某条规则进入编辑后,可配置以下内容:

配置说明
名称 / 类型 / 键规则标识。决定这条规则去取什么数据、最终产出哪一类 CI(详见下方),无法在表单里单独勾选 CI 类别
采集接口用采集点的哪个接口取数
更新间隔 / 超时多久跑一次、单次超时阈值
保留丢失的资源周期设备上消失的 CI 还在 CMDB 保留多久后才清理
启用是否生效

键决定产出哪些 CI。 例如 ssh.ci.discovery 产出 Linux / macOS 主机及其网卡、IP、磁盘、已安装软件、应用等 CI;vmware.ci.discovery 产出 vCenter、集群、ESXi、虚拟机等拓扑 CI。换一个键,产出的 CI 类别就不同——CI 类别由键和后端映射决定,无需也无法在表单里单独勾选。

发现选项:要不要顺带收集软件 / 应用

对 SSH / WMI / WinRM 这几类 CI 发现键,表单会出现一个发现选项多选(如"SSH 发现选项"),提供两个默认勾选的开关:

选项效果
收集已安装软件额外采集设备上安装的软件清单,产出"已安装软件"CI
收集应用程序额外采集运行中的应用 / 进程,产出"应用"CI

两者默认开启。如果只想要轻量发现、不想拉取庞大的软件 / 应用清单(大型环境里这会显著增加采集量与 CMDB 噪声),在这里取消勾选即可。

CI 过滤:把不要的 CI 拦掉

CI 过滤用来按条件排除部分被发现到的 CI,避免把无价值的 CI 灌进 CMDB。过滤按分组组织,每个分组针对一种 CI 类型(CIT,如 ci_linux_redhat):

  • 每个分组先指定一个 CI 类型,再给一组条件(属性 + 算子 + 值)。
  • 分组内多个条件可按 AND(全部满足)OR(任一满足) 组合。
  • 语义是 "命中即排除":一个被发现的 CI,若它的类型匹配了某分组的 CIT、且该分组的条件成立,就会被丢弃、不写入 CMDB。
  • 不填任何过滤 = 不拦截,所有发现的 CI 全部进入 CMDB。

支持的算子:

算子含义
包含 / 不包含属性值是否包含指定文本(不区分大小写)
等于 / 不等于属性值是否等于指定文本
匹配正则 / 不匹配正则属性值是否匹配正则表达式
非空 / 为空属性是否有值(无需填值)
这是"CI 过滤",和采集点发现规则里的"过滤器"不是一套

CI 发现规则里的 CI 过滤(本节)针对"哪些 CI 不写进 CMDB",语义是排除,按 CI 类型分组;下方 采集点发现规则 里的过滤器是另一套机制,针对"哪些发现项要生成采集点"。两者形式相似但作用对象不同,别混用。

排查"某类 CI 没进 CMDB"先看这里

某类 CI 始终没出现在 CMDB,除了检查采集点是否可达、凭据是否够权限,还要回来看这条 CI 发现规则的 CI 过滤——是不是被一条过宽的排除条件(比如正则写错、或针对该 CIT 的分组条件太松)误拦了。临时清空过滤可快速验证。

采集点发现规则

采集点发现规则:基于采集点返回的动态数据(如一台交换机的所有网口),为每个发现的元素自动生成一个采集点。列表展示:

说明
名称规则名称
键值发现数据的数据键
类型采集类型
状态启用 / 禁用
描述规则说明

典型用途:交换机有 48 个端口,逐个手建采集点不现实;一条发现规则就能"每发现一个端口,自动生成一个采集点"。

两类发现规则的区别

简单记:CI 发现规则负责"把数据变成 CI(往 CMDB 灌)";采集点发现规则负责"按需批量生成采集点(扩充采集面)"。一个面向资产台账,一个面向采集点纳管。

顶部操作

详情页顶部可对当前采集点执行:

操作说明
启用 / 禁用切换采集状态。禁用 = 暂停采集(配置保留)
删除删除该采集点
刷新重新加载详情数据

创建采集点

手工创建采集点(大多数采集点由 采集规则 自动产生,手工创建通常用于少量特殊设备)时,依次填写:

区块填什么
概览名称、接口(地址/端口/协议)、代理、关联模板、分组、状态
标签(可选)键值对标签
(可选)变量定义

填完点击保存即完成创建。最关键的是把接口填对——它是系统能否连上设备的前提。

常见场景

场景 1:调整某台设备的采集超时

某台老旧设备采集总是超时失败:进入它的详情页 → 区块 → 新增 {$TIMEOUT} 并设一个更大的值 → 保存。关联模板里的超时逻辑会改用这个值。

场景 2:给一批设备打上环境标签便于筛选

虽然逐个打标较慢(批量打标建议用 采集规则 自动完成),但对少量设备:进入详情页 → 标签 → 添加 env: prod → 保存。之后在 采集点列表 按标签筛选即可。

场景 3:暂停一台设备的采集但不删配置

设备临时下线维护,不想让它一直报不可达:详情页顶部点禁用。维护完点启用即可恢复,所有配置原样保留。