利用夜莺开源版对H3C无线设备监控

编者荐语：
真正搞监控的人肯定知道 SNMP 水有多深，有时我甚至腹黑猜测，这些厂商是故意的吧，，，指标不标准，格式各异，只能靠一款灵活的采集器了，本文是夜莺社区用户写的文章，转给大家参考。

author:网络小斐

关于夜莺SNMP插件

前文说明了利用夜莺开源版如何监控H3C交换机的，算是抛砖引玉；秉持着授人与鱼不如授人与渔，今天我们就来具体谈谈夜莺SNMP插件的使用，能自己自定义自身需求的监控指标才是真正学会如何利用夜莺去监控SNMP协议设备，今天将以H3C无线作为案例，具体讲解下SNMP插件配置。
场景介绍

企业华三无线AP和AC的设备信息监控，需要通过SNMP协议拿到指标数据，并把数据插入到VictoriaMetrics时序数据库中，通过夜莺对数据的即时查询和提取可以构建需要的监控面板，实现基础的数据指标监控提取。
华三无线指标

由于snmp.toml配置文件（路径：categraf/conf/input.snmp/）中已经存在华三交换机的指标配置文件，为了区分多类型设备采集模板，这里将把交换机采集配置模板文件和无线设备采集配置模板文件进行分开，分别取名：snmp_h3c_sw.toml和snmp_h3c_wireless.toml，配置会同步读取，具体配置如下：interval = 10

1. # H3C AC信息采集
2. [[instances]]
3. agents = [
4.     "udp://192.168.100.100",
5. ]
7. interval_times = 3
8. labels = { region = "beijing", role = "ac" }
10. # 每个请求的超时时间
11. timeout = "5s"
12. # SNMP Agent的版本
13. version = 2
14. # SNMP团体名
15. community = "XXXX"
16. # 自定义 mib 文件路径
17. # path = ["/usr/share/snmp/mibs"]
18. # 代理主机标签
19. agent_host_tag = "ident"
20. # 尝试的重试次数
21. retries = 3
22. # GETBULK 每次获取的最大对象数 如果指标越多 建议数值越大 可加速采集时间
23. max_repetitions = 50
25. # 系统启动时间
26. [[instances.field]]
27. oid = "1.3.6.1.2.1.1.3.0"
28. name = "uptime"
30. # 系统名称
31. [[instances.field]]
32. oid = "1.3.6.1.2.1.1.5.0"
33. name = "deviceName"
34. is_tag = true
36. # 接口表信息
37. [[instances.table]]
38. oid = "IF-MIB::ifTable"
39. name = "interface"
40. inherit_tags = ["deviceName"]
42. # 接口表信息中的某个字段
43. [[instances.table.field]]
44. oid = "IF-MIB::ifDescr"
45. name = "ifDescr"
46. is_tag = true
48. [[instances.table.field]]
49. oid = "IF-MIB::ifSpeed"
50. name = "ifSpeed"
51. is_tag = true
53. [[instances.table.field]]
54. oid = "IF-MIB::ifType"
55. name = "ifType"
56. is_tag = true
58. [[instances.table.field]]
59. oid = "IF-MIB::ifMtu"
60. name = "ifMtu" 
61. is_tag = true
63. [[instances.table.field]]
64. oid = "IF-MIB::ifAlias"
65. name = "ifAlias" 
66. is_tag = true
68. # 入方向报文统计(64位) ifHCInOctets
69. [[instances.table.field]]
70. oid = "1.3.6.1.2.1.31.1.1.1.6"
71. name = "ifHCInOctets"
73. # 入方向单播报文统计(64位) ifHCInUcastPkts
74. [[instances.table.field]]
75. oid = "1.3.6.1.2.1.31.1.1.1.7"
76. name = "ifHCInUcastPkts"
78. # 入方向多播报文统计(64位) ifHCInMulticastPkts
79. [[instances.table.field]]
80. oid = "1.3.6.1.2.1.31.1.1.1.8"
81. name = "ifHCInMulticastPkts"
83. # 入方向广播报文统计(64位) ifHCInBroadcastPkts
84. [[instances.table.field]]
85. oid = "1.3.6.1.2.1.31.1.1.1.9"
86. name = "ifHCInBroadcastPkts"
88. # 出方向报文统计(64位) ifHCOutOctets
89. [[instances.table.field]]
90. oid = "1.3.6.1.2.1.31.1.1.1.10"
91. name = "ifHCOutOctets"
93. # 出方向单播报文统计(64位) ifHCOutUcastPkts
94. [[instances.table.field]]
95. oid = "1.3.6.1.2.1.31.1.1.1.11"
96. name = "ifHCOutUcastPkts"
98. # 出方向多播报文统计(64位) ifHCOutMulticastPkts
99. [[instances.table.field]]
100. oid = "1.3.6.1.2.1.31.1.1.1.12"
101. name = "ifHCOutMulticastPkts"
103. # 出方向广播报文统计(64位) ifHCOutBroadcastPkts
104. [[instances.table.field]]
105. oid = "1.3.6.1.2.1.31.1.1.1.13"
106. name = "ifHCOutBroadcastPkts"
108. # 新建空table h3c_system 索引 entPhysicalIndex 获取实体CPU和内存信息
109. [[instances.table]]
110. name = "h3c_system"
111. index_as_tag = true
112. filters = ["exprA:ent_descr:^(MODULE|Module) (LEVEL|level)1 (SLOT|slot)1$", "exprB:ent_name:.*", "exprC:cpu_usage:.*"]
113. filters_expression = "exprA && exprB && exprC"
115. # 实体描述信息 entPhysicalDescr
116. [[instances.table.field]]
117. oid = "1.3.6.1.2.1.47.1.1.1.1.2"
118. name = "ent_descr"
119. is_tag = true
121. # 实体名称 entPhysicalName
122. [[instances.table.field]]
123. oid = "1.3.6.1.2.1.47.1.1.1.1.7"
124. name = "ent_name"
125. is_tag = true
127. # 实体CPU实时利用率统计周期为5秒钟
128. [[instances.table.field]]
129. oid = "1.3.6.1.4.1.25506.2.6.1.1.1.1.6"
130. name = "cpu_usage"
132. # 实体内存实时利用率百分比
133. [[instances.table.field]]
134. oid = "1.3.6.1.4.1.25506.2.6.1.1.1.1.8"
135. name = "mem_usage"
137. # 新建空table h3c_system 索引 entPhysicalIndex 获取实体风扇状态信息
138. [[instances.table]]
139. name = "h3c_system"
140. index_as_tag = true
141. filters = ["exprA:ent_class:7", "exprB:ent_name:.*", "exprC:fan:.*"]
142. filters_expression = "exprA && exprB && exprC"
144. # 实体类型 entPhysicalClass
145. [[instances.table.field]]
146. oid = "1.3.6.1.2.1.47.1.1.1.1.5"
147. name = "ent_class"
148. is_tag = true
150. # 实体名称 entPhysicalName
151. [[instances.table.field]]
152. oid = "1.3.6.1.2.1.47.1.1.1.1.7"
153. name = "ent_name"
154. is_tag = true
156. # 实体错误状态 Normal(2)表示正常
157. [[instances.table.field]]
158. oid = "1.3.6.1.4.1.25506.2.6.1.1.1.1.19"
159. name = "fan"
161. # 新建空table h3c_system 索引 entPhysicalIndex 获取实体电源状态信息
162. [[instances.table]]
163. name = "h3c_system"
164. index_as_tag = true
165. filters = ["exprA:ent_class:6", "exprB:ent_name:.*", "exprC:psu:.*"]
166. filters_expression = "exprA && exprB && exprC"
168. # 实体类型 entPhysicalClass
169. [[instances.table.field]]
170. oid = "1.3.6.1.2.1.47.1.1.1.1.5"
171. name = "ent_class"
172. is_tag = true
174. # 实体名称 entPhysicalName
175. [[instances.table.field]]
176. oid = "1.3.6.1.2.1.47.1.1.1.1.7"
177. name = "ent_name"
178. is_tag = true
180. # 实体错误状态 Normal(2)表示正常
181. [[instances.table.field]]
182. oid = "1.3.6.1.4.1.25506.2.6.1.1.1.1.19"
183. name = "psu"
185. # 新建空table h3c_system 索引 entPhysicalIndex 获取实体传感器温度信息
186. [[instances.table]]
187. name = "h3c_system"
188. index_as_tag = true
189. filters = ["exprA:ent_descr:^(Sensor|SENSOR) (SLOT|slot)1#.*", "exprB:ent_name:.*", "exprC:temperature_value:.*"]
190. filters_expression = "exprA && exprB && exprC"
192. # 实体描述信息 entPhysicalDescr
193. [[instances.table.field]]
194. oid = "1.3.6.1.2.1.47.1.1.1.1.2"
195. name = "ent_descr"
196. is_tag = true
198. # 实体名称 entPhysicalName
199. [[instances.table.field]]
200. oid = "1.3.6.1.2.1.47.1.1.1.1.7"
201. name = "ent_name"
202. is_tag = true
204. # 实体温度 hh3cEntityExtTemperature
205. [[instances.table.field]]
206. oid = "1.3.6.1.4.1.25506.2.6.1.1.1.1.12"
207. name = "temperature_value"
210. # 新建空table H3C AP H3C的mib库文件：HH3C-DOT11-APMT-MIB
211. [[instances.table]]
212. #oid = "HH3C-DOT11-APMT-MIB::hh3cDot11APObjectTable"
213. name = "h3c_ap"
214. index_as_tag = false
216. # AP别名 hh3cDot11CurrAPName
217. [[instances.table.field]]
218. oid = "HH3C-DOT11-APMT-MIB::hh3cDot11CurrAPName"
219. name = "apname"
220. is_tag = true
222. # AP的IP地址 hh3cDot11APIPAddress
223. [[instances.table.field]]
224. oid = "HH3C-DOT11-APMT-MIB::hh3cDot11APIPAddress"
225. name = "apip"
226. is_tag = true
228. # AP的Mac地址 hh3cDot11APMacAddress2
229. [[instances.table.field]]
230. oid = "HH3C-DOT11-APMT-MIB::hh3cDot11APMacAddress2"
231. name = "apmac"
232. is_tag = true
234. # AP状态 hh3cDot11APOperationStatus join(1)AP正在加入AC；joinConfirm(2)AC确认是否允许AP加入；
235. # download(3)AP正在从AC下载软件版本；config(4)下发配置；run(5)上线
236. [[instances.table.field]]
237. oid = "HH3C-DOT11-APMT-MIB::hh3cDot11APOperationStatus"
238. name = "status"
240. # AP在线总数 hh3cDot11APConnectCount
241. [[instances.table.field]]
242. oid = "HH3C-DOT11-ACMT-MIB::hh3cDot11APConnectCount"
243. name = "sumnum"
245. # AP在线用户数 hh3cDot11CurrAPStationAssocCount
246. [[instances.table.field]]
247. oid = "HH3C-DOT11-APMT-MIB::hh3cDot11CurrAPStationAssocCount"
248. name = "user_num"
250. # AP实时CPU利用率(周期1分钟) hh3cDot11APCPURTUsage2
251. [[instances.table.field]]
252. oid = "HH3C-DOT11-APMT-MIB::hh3cDot11APCPURTUsage2"
253. name = "cpu_usage"
255. # AP实时内存利用率(周期1分钟) hh3cDot11APMemRTUsage2
256. [[instances.table.field]]
257. oid = "HH3C-DOT11-APMT-MIB::hh3cDot11APMemRTUsage2"
258. name = "mem_usage"
260. # 新建AP射频信息表
261. [[instances.table]]
262. #oid = "HH3C-DOT11-APMT-MIB::hh3cDot11APRadioTable"
263. name = "h3c_ap_radio"
264. index_as_tag = false
266. # AP当前ID hh3cDot11CurAPID
267. [[instances.table.field]]
268. oid = "HH3C-DOT11-APMT-MIB::hh3cDot11CurAPID"
269. name = "cur_apid"
270. # secondary_index_table = true
271. is_tag = true
273. # AP别名 hh3cDot11CurrAPName
274. [[instances.table.field]]
275. oid = "HH3C-DOT11-APMT-MIB::hh3cDot11CurrAPName"
276. name = "apname"
277. # secondary_index_use = true
278. # secondary_outer_join = true
279. is_tag = true
281. # 当前AP射频的ID hh3cDot11RadioID
282. [[instances.table.field]]
283. oid = "HH3C-DOT11-APMT-MIB::hh3cDot11RadioID"
284. name = "radio_id"
285. is_tag = true
287. # 当前AP射频的工作状态 hh3cDot11OperStatus
288. [[instances.table.field]]
289. oid = "HH3C-DOT11-APMT-MIB::hh3cDot11OperStatus"
290. name = "status"
292. # 当前AP射频的信道分配 hh3cDot11Channel
293. [[instances.table.field]]
294. oid = "HH3C-DOT11-APMT-MIB::hh3cDot11Channel"
295. name = "channel"
297. # 当前AP射频的发射功率电平 hh3cDot11TxPowerLevel
298. [[instances.table.field]]
299. oid = "HH3C-DOT11-APMT-MIB::hh3cDot11TxPowerLevel"
300. name = "powerlevel"
302. # 当前AP射频接收到的平均信号强度 hh3cDot11AvgRxSignalStrength
303. [[instances.table.field]]
304. oid = "HH3C-DOT11-APMT-MIB::hh3cDot11AvgRxSignalStrength"
305. name = "avg_rx_ss"
307. # 当前AP射频天线的增益 hh3cDot11AntennaGain
308. [[instances.table.field]]
309. oid = "HH3C-DOT11-APMT-MIB::hh3cDot11AntennaGain"
310. name = "gain"
312. # 当前AP射频资源的使用率 hh3cDot11ResourceUseRatio
313. [[instances.table.field]]
314. oid = "HH3C-DOT11-APMT-MIB::hh3cDot11ResourceUseRatio"
315. name = "resource"
317. # 当前AP射频口在主信道的空口利用率 hh3cDot11AirPrimChnlBusy
318. [[instances.table.field]]
319. oid = "HH3C-DOT11-APMT-MIB::hh3cDot11AirPrimChnlBusy"
320. name = "air_chnl_busy"

复制代码

需要看懂上面的配置需要了解一下知识点。
具体详解

MIB对象类型：
标量和表量，标量单一指标，表量多指标，并且这些指标都是有该表的唯一索引（索引可能由1个甚至多个oid单一指标组成）。具体查看MIB描述信息，如下所示：
标量如下所示，一般都会说全局节点，没有唯一索引，或者理解为索引就是0，只有一个oid指标对象：

 
表量如下所示，一般都会说明表节点，oid对象往往都是以Table结尾，里面有以该表的唯一索引的一批具体oid指标对象：

配置文件说明：

• [[instances]]下面的配置看官方文档
  
• [[instances.field]]对应标量，如果是采集标量直接使用。
  
• [[instances.table.field]]对应表量，如果采集有唯一索引的oid指标，直接使用。
  
• name和oid就是定义采集的oid对象和插入oid指标的名称，注意名称是会做拼接，注意格式。
  
• is_tag合理使用该参数，比如你不需要这个oid以指标的方式呈现，而是以有同一个唯一索引的指标标签的方式呈现。
  
• index_as_tag合理使用该参数，主要是索引是为作为标签插入，在有两个oid对象组合成的作为唯一索引情况下，很有用，具体根据实际数据说话。
  

空表是只新建单独的空白，插入某些需要的指标，而不是采集该唯一索引下所有的指标，一般不建议直接读取***Table的，比如：

1. # AP射频信息表
2. [[instances.table]]
3. oid = "HH3C-DOT11-APMT-MIB::hh3cDot11APRadioTable"
4. name = "h3c_ap_radio"
5. index_as_tag = false

复制代码

而是新建一个空表，插入我们具体关注的指标即可，一些无用垃圾指标，不要获取。

1. # 新建AP射频信息空表
2. [[instances.table]]
3. name = "h3c_ap_radio"
4. index_as_tag = false
6. # 当前AP射频的工作状态 hh3cDot11OperStatus
7. [[instances.table.field]]
8. oid = "HH3C-DOT11-APMT-MIB::hh3cDot11OperStatus"
9. name = "status"
11. # 当前AP射频的信道分配 hh3cDot11Channel
12. [[instances.table.field]]
13. oid = "HH3C-DOT11-APMT-MIB::hh3cDot11Channel"
14. name = "channel"

复制代码

高级功能

值筛选：通过标签和值设置简单的正则表达式，过滤我们不需要的数据，得到想要的数据。
表连接如果获取的数据是在不同的索引表，而我们展示数据或者做监控报警，需要用到这些不同索引表中的数据，而单独索引表的指标有没有我们想要的数据，这个时候我们就需要使用表连接，对两个表量进行合并查询。
高级功能后续单独开篇讲讲。
最终效果


 

 

 

又或者这样

 

 
更多指标静待各位道友自行设置了。
最后
如果觉得这篇内容比你的咖啡还提神，就动动手指点个赞吧！如果觉得这里有趣，记得关注，不然下次可能会错过哦！

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！