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

采集模板

概述

采集模板是一组可复用的采集配置集合。当你有几十上百台同类设备(比如 50 台同型号交换机),逐台配置发现规则既重复又容易不一致。采集模板解决这个问题:把一套发现规则和配置定义在一个模板里,再把它关联到这些设备,所有设备即刻共享同一套采集策略;以后要调整,只改模板,全部设备同步生效。

模板与 采集点 的关系,类似"职位说明书"与"员工"——说明书定义职责,员工套用后开始履职;一份说明书可复用给许多人。

采集模板列表页

主要特性

  • 一处定义,多处复用:一套配置关联到任意数量的采集点
  • 统一变更:改模板即同步到所有关联的采集点,避免逐台改的不一致
  • 模板间继承:模板可关联其它模板,层层组合形成配置层级
  • 按组归类:用模板组组织大量模板
  • 可导出:导出模板配置,便于跨环境迁移或备份

列表页

默认列

说明
名称模板的显示名称,点击进入 详情
描述模板的用途说明
标签模板上的键值对标签
关联模板本模板链接到的其它模板(继承关系)
模板组所属的模板组

表格的列管理、筛选、分页、密度等通用操作详见数据表格通用操作

筛选条件

支持按名称模糊搜索模板。

顶部操作

  • 新建:创建一个新模板(见下方创建
  • 批量删除:勾选多条后一次性删除
  • 导出:导出选中的模板配置
  • 刷新:重新加载列表

详情页

点击列表中的模板名称进入详情页。详情页采用与 采集点详情 一致的顶部区块 + 标签页布局,只是字段换成模板自己的:

采集模板详情页
区域内容
顶部:概览模板的基本信息:名称、描述、关联的其它模板、所属模板组、标签等
顶部:标签模板上的键值对标签
顶部:宏模板级变量定义(采集点可覆盖)
标签页:CI 发现规则模板定义的"数据→CI"映射规则,关联到采集点后同步生效
标签页:采集点发现规则模板定义的、基于动态数据生成采集点的发现规则,关联到采集点后同步生效
模板与采集点详情的同与异

两者布局一致、两个发现规则标签页含义相同(详见 采集点详情 — 发现规则)。其中 CI 发现规则可配置发现选项(收集已安装软件 / 应用)、CI 过滤等,完整字段说明见 采集点详情 — CI 发现规则。区别在顶部"概览":采集点的概览是连接信息(接口、代理),模板的概览是配置信息(关联模板、模板组)——模板不需要"怎么连设备",因为它本身不采集,是把它配给采集点后才由采集点去连。

详情页顶部可对该模板执行启用 / 禁用删除刷新

创建

新建模板时,依次填写:

区块填什么
概览名称、描述、关联的其它模板、所属模板组
标签(可选)键值对标签
(可选)模板级变量,供关联的采集点继承或覆盖

填完点击保存即创建完成。一个空模板创建后并无实际采集能力——它的价值在于后续在CI 发现规则采集点发现规则标签页里定义具体规则,再关联到采集点。

模板与采集点的关系

理解模板,关键是理解它的"一次定义、多处生效"机制:

  1. 定义:在模板的发现规则标签页里配置好规则
  2. 关联:把模板关联到一个或多个 采集点(可在采集点详情的概览里选模板,也可由 采集规则 在自动纳管时关联)
  3. 同步:模板的规则即刻在所有关联采集点上生效
  4. 变更:以后改模板,所有采集点自动同步新规则
删除模板前先解关联

删除一个仍被大量采集点关联的模板,会影响这些采集点的采集策略。删除前请先确认关联关系,必要时先把采集点迁移到其它模板。

常见场景

场景 1:为同型号设备建一套统一配置

  1. 新建模板"通用 Linux 服务器",在发现规则标签页配置好 CPU / 内存 / 磁盘等采集项的发现规则
  2. 在每台 Linux 服务器采集点的详情页,把"关联模板"指向它
  3. 此后所有服务器共享这套采集策略;要改采集项,只改模板一次

场景 2:模板分级组合

先做一个"基础采集"模板(所有设备通用的基础项),再做"网络设备增强"模板,让后者关联前者。给交换机挂"网络设备增强"模板时,等于同时拥有了基础项和增强项——不用重复定义。

场景 3:配合采集规则实现全自动纳管

采集规则 里把"关联模板"作为发现设备的动作之一。此后新设备被发现时自动挂上模板,连配置都全自动——这是发现采集链路里最省心的组合。

模板只"声明"宏,凭据值别写进模板

模板里用到的登录凭据({$SSH.USERNAME} / {$SSH.PASSWORD}{$SNMP_COMMUNITY} 等),模板只负责声明需要这些宏不要把真实凭据值作为默认值填在模板的宏里。一份固化了凭据的模板一旦被复用、导出或关联到大量采集点,凭据会跟着到处扩散,既不安全也难维护。

正确的做法是把凭据值放在离采集点最近的地方:

  • 自动纳管:填在 采集规则 的「关联模板」操作里——操作级宏覆盖会落到自动建出的每个采集点上,凭据随建随带;
  • 手工建的单个采集点:填在该采集点详情的区块;
  • 螺旋式发现里成批自动建出的采集点:填在模板的采集点原型上,原型生成采集点时把凭据一并带过去。

采集点级宏同名覆盖模板宏,所以模板留空、由采集点填值,既能统一配置又能逐点隔离凭据。