SNMP: _generic-ups.yaml (#20351)
Co-authored-by: ilyam8 <ilya@netdata.cloud>
Fotis Voutsas committed
May 28, 2025 at 14:25 UTC
e2c3ea2bf9e7c3dce62aa8889642e7a1df50ae70
1 file changed
+97
-68
src/go/plugin/go.d/config/go.d/snmp.profiles/default/_generic-ups.yaml
+97
-68
@@ -1,126 +1,143 @@
1
metrics:
2
-# - MIB: UPS-MIB
3
-# symbol:
4
-# OID: 1.3.6.1.2.1.33.1.2.1.0
5
-# name: upsBatteryStatus
6
-# enum:
7
-# unknown: 1
8
-# batteryNormal: 2
9
-# batteryLow: 3
10
-# batteryDepleted: 4
11
-# TODO: enum in scalar metric is not supported yet (keep this metric and this
12
-# comment in profile until it's fixed)
2
+ - MIB: UPS-MIB
3
+ symbol:
4
+ OID: 1.3.6.1.2.1.33.1.2.1.0
5
+ name: upsBatteryStatus
6
+ description: The indication of the capacity remaining in the UPS system's batteries
7
+ family: UPS/Battery/Status
8
+ unit: "{status}"
9
+ mapping:
10
+ 1: unknown
11
+ 2: batteryNormal
12
+ 3: batteryLow
13
+ 4: batteryDepleted
14
- MIB: UPS-MIB
15
symbol:
16
OID: 1.3.6.1.2.1.33.1.2.2.0
17
name: upsSecondsOnBattery
17
- description: If the unit is on battery power, the elapsed time since the UPS last switched to battery power, or the time since the network management subsystem was last restarted, whichever is less. Zero shall be returned if the unit is not on battery power.
18
+ description: If the unit is on battery power, the elapsed time since the UPS last switched to battery power, or the time since the network management subsystem was last restarted, whichever is less. Zero shall be returned if the unit is not on battery power
19
+ family: UPS/Battery/Charge
20
unit: "s"
21
- MIB: UPS-MIB
22
symbol:
23
OID: 1.3.6.1.2.1.33.1.2.3.0
24
name: upsEstimatedMinutesRemaining
23
- description: An estimate of the time to battery charge depletion under the present load conditions if the utility power is off and remains off, or if it were to be lost and remain off.
25
+ description: An estimate of the time to battery charge depletion under the present load conditions if the utility power is off and remains off, or if it were to be lost and remain off
26
+ family: UPS/Battery/Charge
27
unit: "min"
28
- MIB: UPS-MIB
29
symbol:
30
OID: 1.3.6.1.2.1.33.1.2.4.0
31
name: upsEstimatedChargeRemaining
29
- description: An estimate of the battery charge remaining expressed as a percent of full charge.
32
+ description: An estimate of the battery charge remaining expressed as a percent of full charge
33
+ family: UPS/Battery/Charge
34
unit: "%"
35
- MIB: UPS-MIB
36
symbol:
37
OID: 1.3.6.1.2.1.33.1.2.5.0
38
name: upsBatteryVoltage
35
- description: The magnitude of the present battery voltage.
39
+ description: The magnitude of the present battery voltage
40
+ family: UPS/Battery/Voltage
41
unit: "V"
42
- MIB: UPS-MIB
43
symbol:
44
OID: 1.3.6.1.2.1.33.1.2.6.0
45
name: upsBatteryCurrent
41
- description: The present battery current.
46
+ description: The present battery current
47
+ family: UPS/Battery/Current
48
unit: "A"
49
- MIB: UPS-MIB
50
symbol:
51
OID: 1.3.6.1.2.1.33.1.2.7.0
52
name: upsBatteryTemperature
47
- description: The ambient temperature at or near the UPS Battery casing.
53
+ description: The ambient temperature at or near the UPS Battery casing
54
+ family: UPS/Battery/Temperature
55
unit: "Cel"
56
- MIB: UPS-MIB
57
symbol:
58
OID: 1.3.6.1.2.1.33.1.3.1.0
59
name: upsInputLineBads
53
- description: A count of the number of times the input entered an out-of-tolerance condition as defined by the manufacturer. This count is incremented by one each time the input transitions from zero out-of-tolerance lines to one or more input lines out-of-tolerance.
54
- unit: "{event}"
60
+ description: A count of the number of times the input entered an out-of-tolerance condition as defined by the manufacturer. This count is incremented by one each time the input transitions from zero out-of-tolerance lines to one or more input lines out-of-tolerance
61
+ family: UPS/Input/Tolerance
62
+ unit: "{transition}"
63
metric_type: monotonic_count
64
- MIB: UPS-MIB
65
symbol:
66
OID: 1.3.6.1.2.1.33.1.3.2.0
67
name: upsInputNumLines
60
- description: The number of input lines utilized in this device. This variable indicates the number of rows in the input table.
61
- unit: "{input_line}"
62
-# - MIB: UPS-MIB
63
-# symbol:
64
-# OID: 1.3.6.1.2.1.33.1.4.1.0
65
-# name: upsOutputSource
66
-# enum:
67
-# other: 1
68
-# none: 2
69
-# normal: 3
70
-# bypass: 4
71
-# battery: 5
72
-# booster: 6
73
-# reducer: 7
74
-# TODO: enum in scalar metric is not supported yet (keep this metric and this
75
-# comment in profile until it's fixed)
68
+ description: The number of input lines utilized in this device. This variable indicates the number of rows in the input table
69
+ family: UPS/Input/Lines
70
+ unit: "{line}"
71
+ - MIB: UPS-MIB
72
+ symbol:
73
+ OID: 1.3.6.1.2.1.33.1.4.1.0
74
+ name: upsOutputSource
75
+ description: The present source of output power
76
+ family: UPS/Output/Source
77
+ unit: "{status}"
78
+ mapping:
79
+ 1: other
80
+ 2: none
81
+ 3: normal
82
+ 4: bypass
83
+ 5: battery
84
+ 6: booster
85
+ 7: reducer
86
- MIB: UPS-MIB
87
symbol:
88
OID: 1.3.6.1.2.1.33.1.4.2.0
89
name: upsOutputFrequency
80
- description: The present output frequency.
90
+ description: The present output frequency
91
+ family: UPS/Output/Frequency
92
unit: "Hz"
93
- MIB: UPS-MIB
94
symbol:
95
OID: 1.3.6.1.2.1.33.1.4.3.0
96
name: upsOutputNumLines
86
- description: The number of output lines utilized in this device. This variable indicates the number of rows in the output table.
87
- unit: "{output_line}"
97
+ description: The number of output lines utilized in this device. This variable indicates the number of rows in the output table
98
+ family: UPS/Output/Lines
99
+ unit: "{line}"
100
- MIB: UPS-MIB
101
symbol:
102
OID: 1.3.6.1.2.1.33.1.5.1.0
103
name: upsBypassFrequency
92
- description: The present bypass frequency.
104
+ description: The present bypass frequency
105
+ family: UPS/Bypass/Frequency
106
unit: "Hz"
107
- MIB: UPS-MIB
108
symbol:
109
OID: 1.3.6.1.2.1.33.1.5.2.0
110
name: upsBypassNumLines
98
- description: The number of bypass lines utilized in this device. This entry indicates the number of rows in the bypass table.
99
- unit: "{bypass_line}"
111
+ description: The number of bypass lines utilized in this device. This entry indicates the number of rows in the bypass table
112
+ family: UPS/Bypass/Lines
113
+ unit: "{line}"
114
- MIB: UPS-MIB
115
symbol:
116
OID: 1.3.6.1.2.1.33.1.6.1.0
117
name: upsAlarmsPresent
104
- description: The present number of active alarm conditions.
118
+ description: The present number of active alarm conditions
119
+ family: UPS/Alarms
120
unit: "{alarm}"
106
-# - MIB: UPS-MIB
107
-# symbol:
108
-# OID: 1.3.6.1.2.1.33.1.7.3.0
109
-# name: upsTestResultsSummary
110
-# enum:
111
-# donePass: 1
112
-# doneWarning: 2
113
-# doneError: 3
114
-# aborted: 4
115
-# inProgress: 5
116
-# noTestsInitiated: 6
117
-# TODO: enum in scalar metric is not supported yet (keep this metric and this
118
-# comment in profile until it's fixed)
121
+ - MIB: UPS-MIB
122
+ symbol:
123
+ OID: 1.3.6.1.2.1.33.1.7.3.0
124
+ name: upsTestResultsSummary
125
+ description: The results of the current or last UPS diagnostics test performed
126
+ family: UPS/Test
127
+ unit: "{status}"
128
+ mapping:
129
+ 1: donePass
130
+ 2: doneWarning
131
+ 3: doneError
132
+ 4: aborted
133
+ 5: inProgress
134
+ 6: noTestsInitiated
135
- MIB: UPS-MIB
136
symbol:
137
OID: 1.3.6.1.2.1.33.1.7.5.0
138
name: upsTestStartTime
123
- description: The value of sysUpTime at the time the test in progress was initiated, or, if no test is in progress, the time the previous test was initiated. If the value of upsTestResultsSummary is noTestsInitiated(6), upsTestStartTime has the value 0.
139
+ description: The value of sysUpTime at the time the test in progress was initiated, or, if no test is in progress, the time the previous test was initiated
140
+ family: UPS/Test
141
unit: "s"
142
- MIB: UPS-MIB
143
table:
@@ -129,19 +146,23 @@ metrics:
146
symbols:
147
- OID: 1.3.6.1.2.1.33.1.4.4.1.2
148
name: upsOutputVoltage
132
- description: The present output voltage.
149
+ description: The present output voltage
150
+ family: UPS/Output/Voltage
151
unit: "V"
152
- OID: 1.3.6.1.2.1.33.1.4.4.1.3
153
name: upsOutputCurrent
136
- description: The present output current.
154
+ description: The present output current
155
+ family: UPS/Output/Current
156
unit: "A"
157
- OID: 1.3.6.1.2.1.33.1.4.4.1.4
158
name: upsOutputPower
140
- description: The present output true power.
159
+ description: The present output true power
160
+ family: UPS/Output/Power
161
unit: "W"
162
- OID: 1.3.6.1.2.1.33.1.4.4.1.5
163
name: upsOutputPercentLoad
144
- description: The percentage of the UPS power capacity presently being used on this output line, i.e., the greater of the percent load of true power capacity and the percent load of VA.
164
+ description: The percentage of the UPS power capacity presently being used on this output line
165
+ family: UPS/Output/Load
166
unit: "%"
167
metric_tags:
168
- symbol:
@@ -155,19 +176,23 @@ metrics:
176
symbols:
177
- OID: 1.3.6.1.2.1.33.1.3.3.1.2
178
name: upsInputFrequency
158
- description: The present input frequency.
179
+ description: The present input frequency
180
+ family: UPS/Input/Frequency
181
unit: "Hz"
182
- OID: 1.3.6.1.2.1.33.1.3.3.1.3
183
name: upsInputVoltage
162
- description: The magnitude of the present input voltage.
184
+ description: The magnitude of the present input voltage
185
+ family: UPS/Input/Voltage
186
unit: "V"
187
- OID: 1.3.6.1.2.1.33.1.3.3.1.4
188
name: upsInputCurrent
166
- description: The magnitude of the present input current.
189
+ description: The magnitude of the present input current
190
+ family: UPS/Input/Current
191
unit: "A"
192
- OID: 1.3.6.1.2.1.33.1.3.3.1.5
193
name: upsInputTruePower
170
- description: The magnitude of the present input true power.
194
+ description: The magnitude of the present input true power
195
+ family: UPS/Input/Power
196
unit: "W"
197
metric_tags:
198
- symbol:
@@ -181,15 +206,18 @@ metrics:
206
symbols:
207
- OID: 1.3.6.1.2.1.33.1.5.3.1.2
208
name: upsBypassVoltage
184
- description: The present bypass voltage.
209
+ description: The present bypass voltage
210
+ family: UPS/Bypass/Voltage
211
unit: "V"
212
- OID: 1.3.6.1.2.1.33.1.5.3.1.3
213
name: upsBypassCurrent
188
- description: The present bypass current.
214
+ description: The present bypass current
215
+ family: UPS/Bypass/Current
216
unit: "A"
217
- OID: 1.3.6.1.2.1.33.1.5.3.1.4
218
name: upsBypassPower
192
- description: The present true power conveyed by the bypass.
219
+ description: The present true power conveyed by the bypass
220
+ family: UPS/Bypass/Power
221
unit: "W"
222
metric_tags:
223
- symbol:
@@ -203,7 +231,8 @@ metrics:
231
symbols:
232
- OID: 1.3.6.1.2.1.33.1.6.2.1.3
233
name: upsAlarmTime
206
- description: The value of sysUpTime when the alarm condition was detected. If the alarm condition was detected at the time of agent startup and presumably existed before agent startup, the value of upsAlarmTime shall equal 0.
234
+ description: The value of sysUpTime when the alarm condition was detected. If the alarm condition was detected at the time of agent startup and presumably existed before agent startup, the value of upsAlarmTime shall equal 0
235
+ family: UPS/Alarms
236
unit: "s"
237
metric_tags:
238
- symbol: