improve(go.d/snmp): add net-snmp.yaml profile (#20959)
Ilya Mashchenko committed
Sep 11, 2025 at 18:42 UTC
96549fe0ca51d1d4c4833951e9dd413325174eb2
2 files changed
+160
-66
src/go/plugin/go.d/config/go.d/snmp.profiles/default/_std-ucd-mib.yaml
+156
-66
@@ -1,12 +1,38 @@
1
+# - UCD-SNMP-MIB
2
+# https://mibbrowser.online/mibdb_search.php?mib=UCD-SNMP-MIB
3
+# https://github.com/DanielleHuisman/observium-community-edition/blob/main/mibs/net-snmp/UCD-SNMP-MIB
4
+# - UCD-DISKIO-MIB
5
+# https://mibbrowser.online/mibdb_search.php?mib=UCD-DISKIO-MIB
6
+# https://github.com/DanielleHuisman/observium-community-edition/blob/main/mibs/net-snmp/UCD-DISKIO-MIB
7
+
8
metrics:
9
- MIB: UCD-SNMP-MIB
10
symbol:
4
- name: ucd.cpuLoad
11
+ name: ucd.cpuLoad1m
12
OID: 1.3.6.1.4.1.2021.10.1.5.1
13
chart_meta:
7
- family: 'System/CPU/LoadAverage/1Min'
8
- description: The 1,5 and 15 minute load averages as an integer
14
+ family: 'System/LoadAverage/1Min'
15
+ description: 1 minute load average
16
+ unit: "{load_average}"
17
+ scale_factor: 0.01
18
+ - MIB: UCD-SNMP-MIB
19
+ symbol:
20
+ name: ucd.cpuLoad5m
21
+ OID: 1.3.6.1.4.1.2021.10.1.5.2
22
+ chart_meta:
23
+ family: 'System/LoadAverage/5Min'
24
+ description: 5 minute load average
25
unit: "{load_average}"
26
+ scale_factor: 0.01
27
+ - MIB: UCD-SNMP-MIB
28
+ symbol:
29
+ name: ucd.cpuLoad15m
30
+ OID: 1.3.6.1.4.1.2021.10.1.5.3
31
+ chart_meta:
32
+ family: 'System/LoadAverage/15Min'
33
+ description: 15 minute load average
34
+ unit: "{load_average}"
35
+ scale_factor: 0.01
36
- MIB: UCD-SNMP-MIB
37
symbol:
38
name: ucd.memoryTotal
@@ -88,6 +114,7 @@ metrics:
114
description: The total amount of real or virtual memory currently allocated for use as cached memory
115
unit: "By"
116
scale_factor: 1024
117
+
118
- MIB: UCD-SNMP-MIB
119
table:
120
OID: 1.3.6.1.4.1.2021.9
@@ -189,7 +216,7 @@ metrics:
216
- name: ucd.diskIONWrittenX
217
OID: 1.3.6.1.4.1.2021.13.15.1.1.13
218
chart_meta:
192
- family: 'System/Disk/Traffic/Write'
219
+ family: 'System/Disk/IO/Write'
220
description: The number of bytes written to this device since boot
221
unit: "By/s"
222
metric_tags:
@@ -197,83 +224,146 @@ metrics:
224
symbol:
225
name: ucd.diskIODevice
226
OID: 1.3.6.1.4.1.2021.13.15.1.1.2
227
+
228
- MIB: UCD-SNMP-MIB
229
symbol:
202
- name: ucd.ssCpuUser
203
- OID: 1.3.6.1.4.1.2021.11.9.0
204
- chart_meta:
205
- family: 'System/CPU/Usage/User'
206
- description: The percentage of CPU time spent processing user-level code, calculated over the last minute
207
- unit: "%"
208
- - MIB: UCD-SNMP-MIB
209
- symbol:
210
- name: ucd.ssCpuSystem
211
- OID: 1.3.6.1.4.1.2021.11.10.0
212
- chart_meta:
213
- family: 'System/CPU/Usage/System'
214
- description: The percentage of CPU time spent processing system-level code, calculated over the last minute
215
- unit: "%"
216
- - MIB: UCD-SNMP-MIB
217
- symbol:
218
- name: ucd.ssCpuIdle
219
- OID: 1.3.6.1.4.1.2021.11.11.0
220
- chart_meta:
221
- family: 'System/CPU/Usage/Idle'
222
- description: The percentage of processor time spent idle, calculated over the last minute
223
- unit: "%"
224
- - MIB: UCD-SNMP-MIB
225
- symbol:
226
- name: ucd.ssCpuRawUser
227
- OID: 1.3.6.1.4.1.2021.11.50.0
228
- chart_meta:
229
- family: 'System/CPU/Time/User'
230
- description: The number of ticks spent processing user-level code
231
- unit: "{tick}/s"
232
- - MIB: UCD-SNMP-MIB
233
- symbol:
234
- name: ucd.ssCpuRawNice
235
- OID: 1.3.6.1.4.1.2021.11.51.0
230
+ name: ucd.ssIORawSent
231
+ OID: 1.3.6.1.4.1.2021.11.57.0
232
chart_meta:
237
- family: 'System/CPU/Time/Nice'
238
- description: The number of ticks spent processing reduced-priority code
239
- unit: "{tick}/s"
233
+ family: 'System/Disk/Total/IO/Write'
234
+ description: Amount of data written to disk or other block device
235
+ unit: "By/s"
236
+ scale_factor: 512
237
+
238
- MIB: UCD-SNMP-MIB
239
symbol:
242
- name: ucd.ssCpuRawSystem
243
- OID: 1.3.6.1.4.1.2021.11.52.0
240
+ name: ucd.ssIORawReceived
241
+ OID: 1.3.6.1.4.1.2021.11.58.0
242
chart_meta:
245
- family: 'System/CPU/Time/System'
246
- description: The number of ticks spent processing system-level code
247
- unit: "{tick}/s"
243
+ family: 'System/Disk/Total/IO/Read'
244
+ description: Amount of data read from disk or other block device
245
+ unit: "By/s"
246
+ scale_factor: 512
247
+
248
- MIB: UCD-SNMP-MIB
249
symbol:
250
- name: ucd.ssCpuRawIdle
251
- OID: 1.3.6.1.4.1.2021.11.53.0
250
+ name: ucd.ssRawInterrupts
251
+ OID: 1.3.6.1.4.1.2021.11.59.0
252
chart_meta:
253
- family: 'System/CPU/Time/Idle'
254
- description: The number of ticks spent idle
255
- unit: "{tick}/s"
253
+ family: 'System/CPU/Interrupts'
254
+ description: Number of interrupts processed
255
+ unit: "{interrupt}/s"
256
+
257
- MIB: UCD-SNMP-MIB
258
symbol:
258
- name: ucd.ssCpuRawWait
259
- OID: 1.3.6.1.4.1.2021.11.54.0
259
+ name: ucd.ssRawContexts
260
+ OID: 1.3.6.1.4.1.2021.11.60.0
261
chart_meta:
261
- family: 'System/CPU/Time/IOWait'
262
- description: The number of ticks spent waiting for IO
263
- unit: "{tick}/s"
262
+ family: 'System/CPU/ContextSwitches'
263
+ description: Number of context switches
264
+ unit: "{switch}/s"
265
+
266
- MIB: UCD-SNMP-MIB
267
symbol:
266
- name: ucd.ssCpuRawKernel
267
- OID: 1.3.6.1.4.1.2021.11.55.0
268
+ name: ucd.ssRawSwapIn
269
+ OID: 1.3.6.1.4.1.2021.11.62.0
270
chart_meta:
269
- family: 'System/CPU/Time/Kernel'
270
- description: The number of ticks spent processing kernel-level code
271
- unit: "{tick}/s"
271
+ family: 'System/Memory/Swap/IO/In'
272
+ description: Amount of memory swapped in from disk
273
+ unit: "By/s"
274
+ scale_factor: 512
275
+
276
- MIB: UCD-SNMP-MIB
277
symbol:
274
- name: ucd.ssCpuRawInterrupt
275
- OID: 1.3.6.1.4.1.2021.11.56.0
278
+ name: ucd.ssRawSwapOut
279
+ OID: 1.3.6.1.4.1.2021.11.63.0
280
chart_meta:
277
- family: 'System/CPU/Time/Interrupt'
278
- description: The number of ticks spent processing hardware interrupts
279
- unit: "{tick}/s"
281
+ family: 'System/Memory/Swap/IO/Out'
282
+ description: Amount of memory swapped out to disk
283
+ unit: "By/s"
284
+ scale_factor: 512
285
+
286
+## TODO: These metrics (e.g., ucd.ssCpuUser, ucd.ssCpuSystem, etc.) represent CPU usage breakdowns (user, system, idle, etc.).
287
+## Typically more useful when visualized together in a single composite CPU usage chart, rather than as separate metrics/charts.
288
+## Displaying them separately can be confusing and less informative for users.
289
+## Next steps: Consider combining these metrics into a single composite CPU usage chart.
290
+# - MIB: UCD-SNMP-MIB
291
+# symbol:
292
+# name: ucd.ssCpuUser
293
+# OID: 1.3.6.1.4.1.2021.11.9.0
294
+# chart_meta:
295
+# family: 'System/CPU/Usage/User'
296
+# description: The percentage of CPU time spent processing user-level code, calculated over the last minute
297
+# unit: "%"
298
+# - MIB: UCD-SNMP-MIB
299
+# symbol:
300
+# name: ucd.ssCpuSystem
301
+# OID: 1.3.6.1.4.1.2021.11.10.0
302
+# chart_meta:
303
+# family: 'System/CPU/Usage/System'
304
+# description: The percentage of CPU time spent processing system-level code, calculated over the last minute
305
+# unit: "%"
306
+# - MIB: UCD-SNMP-MIB
307
+# symbol:
308
+# name: ucd.ssCpuIdle
309
+# OID: 1.3.6.1.4.1.2021.11.11.0
310
+# chart_meta:
311
+# family: 'System/CPU/Usage/Idle'
312
+# description: The percentage of processor time spent idle, calculated over the last minute
313
+# unit: "%"
314
+# - MIB: UCD-SNMP-MIB
315
+# symbol:
316
+# name: ucd.ssCpuRawUser
317
+# OID: 1.3.6.1.4.1.2021.11.50.0
318
+# chart_meta:
319
+# family: 'System/CPU/Time/User'
320
+# description: The number of ticks spent processing user-level code
321
+# unit: "{tick}/s"
322
+# - MIB: UCD-SNMP-MIB
323
+# symbol:
324
+# name: ucd.ssCpuRawNice
325
+# OID: 1.3.6.1.4.1.2021.11.51.0
326
+# chart_meta:
327
+# family: 'System/CPU/Time/Nice'
328
+# description: The number of ticks spent processing reduced-priority code
329
+# unit: "{tick}/s"
330
+# - MIB: UCD-SNMP-MIB
331
+# symbol:
332
+# name: ucd.ssCpuRawSystem
333
+# OID: 1.3.6.1.4.1.2021.11.52.0
334
+# chart_meta:
335
+# family: 'System/CPU/Time/System'
336
+# description: The number of ticks spent processing system-level code
337
+# unit: "{tick}/s"
338
+# - MIB: UCD-SNMP-MIB
339
+# symbol:
340
+# name: ucd.ssCpuRawIdle
341
+# OID: 1.3.6.1.4.1.2021.11.53.0
342
+# chart_meta:
343
+# family: 'System/CPU/Time/Idle'
344
+# description: The number of ticks spent idle
345
+# unit: "{tick}/s"
346
+# - MIB: UCD-SNMP-MIB
347
+# symbol:
348
+# name: ucd.ssCpuRawWait
349
+# OID: 1.3.6.1.4.1.2021.11.54.0
350
+# chart_meta:
351
+# family: 'System/CPU/Time/IOWait'
352
+# description: The number of ticks spent waiting for IO
353
+# unit: "{tick}/s"
354
+# - MIB: UCD-SNMP-MIB
355
+# symbol:
356
+# name: ucd.ssCpuRawKernel
357
+# OID: 1.3.6.1.4.1.2021.11.55.0
358
+# chart_meta:
359
+# family: 'System/CPU/Time/Kernel'
360
+# description: The number of ticks spent processing kernel-level code
361
+# unit: "{tick}/s"
362
+# - MIB: UCD-SNMP-MIB
363
+# symbol:
364
+# name: ucd.ssCpuRawInterrupt
365
+# OID: 1.3.6.1.4.1.2021.11.56.0
366
+# chart_meta:
367
+# family: 'System/CPU/Time/Interrupt'
368
+# description: The number of ticks spent processing hardware interrupts
369
+# unit: "{tick}/s"
src/go/plugin/go.d/config/go.d/snmp.profiles/default/net-snmp.yaml
new
+4
@@ -0,0 +1,4 @@
1
+extends:
2
+ - _std-ucd-mib.yaml
3
+
4
+sysobjectid: 1.3.6.1.4.1.8072.*