网络设备采集模板

编写网络设备采集模板

在采集模版点击右上角新增即可新增自定义采集模版。

下面给出一个 snmp 设备的自定义采集配置和基本参数说明。

基础参数说明

agents：配置采集信息地址、端口和协议；

格式：agents = ["<scheme://><hostname>:<port>"]

scheme：协议类型，默认是 udp 协议。目前支持 udp udp4 udp6 tcp tcp4 tcp6 。

hostname：采集的地址。

port：采集地址的端口号。

示例：

agents = ["udp://127.0.0.1:161"] 表示使用 UDP 协议，连接到本地 127.0.0.1 地址的端口 161。

agents = ["tcp://127.0.0.1:161"] 表示使用 TCP 协议，连接到本地 127.0.0.1 地址的端口 161。

如果使用网络设备进行采集

配置文件可以这样写自动调用网络设备采集中的相应字段。

[[instances]]
agents = ["{{.Schema}}://{{.IP}}:{{.Port}}"]
interval_times = 1
timeout = "{{.Timeout}}s"
version = {{.Version}}
#retries = 3
max_repetitions=15
disable_up = true
{{.Auth}}

如下图所示，可以将填入配置中的字段进行映射，在采集的时候自动调取变量对应的值。

{{.IP}} == IP

{{.Schema}} == SNMP 协议

{{.Port}} == SNMP 端口

{{.Timeout}} == 超时时间(s)

{{.Version}} == SNMP 版本

{{.Auth}} == Community

community：设备配置文件或者管理界面获取的参数，一般是 public 。

agent_host_tag :上报设备 ip 的 LabelName 。

retries : SNMP 请求失败时，系统会重试的次数。

max_repetitions ：SNMP 一次请求中最多请求对象的数量。注意：这个值越高，可能会减少请求次数，但也可能增加网络负载。

获取 Scalar 数据类型：这些数据点在 MIB 中是以单个 OID 标识的。

# 获取 Scalar 数据
# cpu系统态使用率
[[instances.field]]
oid = "1.3.6.1.4.1.2021.11.9.0"
name = "cpu_usage_sys"
# cpu用户态使用率
[[instances.field]]
oid = "1.3.6.1.4.1.2021.11.10.0"
name = "cpu_usage_user"
# 设备空闲内存
[[instances.field]]
oid = "1.3.6.1.4.1.2021.4.6.0"
name = "mem_free"

获取 Table 类数据：有多列数据，也有多个索引，Categraf会自动获取Table中的所有索引字段做成时序数据的标签，会自动获取所有的数据列，作为指标上报。

# 获取 Table 类数据
[[instances.table]]
oid = "IF-MIB::ifTable"
name = "interface"
[[instances.table.field]]
oid = "IF-MIB::ifDescr"
name = "ifDescr"
# 有些列可能不是数值，比如 ifDescr 就是字符串，这个列无需作为指标上报，应该作为标签上报更合适，所以有个 is_tag=true 的配置。
is_tag = true