Вики IT-KB

В состав комплекта плагинов Centreon Plugins входит плагин мониторинга источников бесперебойного питания (ИБП), в которые установлена российская плата управления Инматикс ПСУ Спутник. Реализован мониторинг ИБП с помощью периодических опросов по протоколу SNMP. В рассматриваемых примерах используется SNMPv3 опрос модуля управления ПСУ Спутник A21 в ИБП APC Smart-UPS SURT6000XLI.

Данная статья не описывает процессов интеграции плагина с системами мониторинга типа Icinga/Nagios, а лишь обозначает некоторые практические примеры использования режимов работы плагина.

Плагин мониторинга имеет несколько режимов работы, позволяющих отслеживать состояние разных показателей:

# /usr/lib/nagios/plugins/centreon-plugins/centreon_plugins.pl \
--plugin=hardware::ups::inmatics::sputnik::snmp::plugin \
--list-mode

...
Modes Available:
   alarms
   battery-status
   environment
   input-lines
   output-lines
   output-source

Режим позволяет создать отдельную службу мониторинга, например «APC UPS State Alarms», статус которой будет меняться в зависимости от критических событий, зафиксированных на ИБП. Пример вызова данного режима:

# ./centreon_plugins.pl --plugin=hardware::ups::inmatics::sputnik::snmp::plugin \
--mode=alarms \
--hostname=KOM-UP001 --snmp-version=3 --snmp-username='icinga-user' \
--authprotocol=SHA --authpassphrase='myAuthPass' \
--privprotocol=DES --privpassphrase='myEncPass' \
--output-ignore-perfdata --verbose

OK: current alarms: 0

Опцию output-ignore-perfdata используем для отключения вывода данных performance data, так как полезных данных такого рода в выводе плагина нет.

Опцию verbose используем для более детального вывода

Режим позволяет создать отдельную службу мониторинга, например «APC UPS Battery Status», статус которой будет меняться в зависимости от состояния аккумуляторов ИБП. Режим позволяет получить расчётное время автономной работы от батарей, текущий статус заряда батарей в процентах, а также показания температурного сенсора для батарей. Пример вызова данного режима:

# ./centreon_plugins.pl --plugin=hardware::ups::inmatics::sputnik::snmp::plugin \
--mode=battery-status \
--hostname=KOM-UP001 --snmp-version=3 --snmp-username='icinga-user' \
--authprotocol=SHA --authpassphrase='myAuthPass' \
--privprotocol=DES --privpassphrase='myEncPass' \
--warning-charge-remaining='50:100' --critical-charge-remaining='25:100' \ 
--warning-charge-remaining-minutes='@10:15' --critical-charge-remaining-minutes='@0:9' \
--warning-temperature='11:39' --critical-temperature='6:44' \
--filter-uom=null --use-new-perfdata'

OK: battery status is normal - charge remaining: 100% (205 minutes remaining) | 
'battery.charge.remaining.percent'=100;50:100;25:100;0;100 
'battery.charge.remaining.minutes'=205;@10:15;@0:9;0; 
'battery.voltage.volt'=218.1;;;; 
'battery.temperature.celsius'=19;11:39;6:44;;

Опциями warning-charge-remaining и critical-charge-remaining задаём границы изменения статуса для уровня заряда батарей в процентах (менее 50% - предупреждение, менее 25% - критический статус).

Опциями warning-charge-remaining-minutes и critical-charge-remaining-minutes задаём допустимые границы времени автономной работы в минутах (больше 15 минут - нормально, от 15 до 10 минут - предупреждение, меньше 9 минут - критический статус)

Опциями warning-temperature и critical-temperature задаём допустимые границы показаний температурного датчика, расположенного в ИБП в районе аккумуляторов (менее 11С и выше 39С - предупреждение, менее 6С и выше 44С - критический статус)

Опцией filter-uom в этом и последующих примерах при желании можно отсечь излишние обозначения единиц измерения в данных performance data. Возвращаемые плагином названия метрик performance data уже содержат информацию о единицах измерения, поэтому дублировать её в самих данных смысла особого нет.

Уровень напряжения на батарее в данном примере не имеет границ для оповещений.

Режим позволяет создать отдельную службу мониторинга, например «APC UPS Environment», статус которой будет меняться в зависимости от состояния внешних датчиков контроля окружающей среды, подключенных к плате управления и измеряющих температуру и влажность. Пример вызова данного режима:

# ./centreon_plugins.pl --plugin=hardware::ups::inmatics::sputnik::snmp::plugin \
--mode=environment \
--hostname=KOM-UP001 --snmp-version=3 --snmp-username='icinga-user' \
--authprotocol=SHA --authpassphrase='myAuthPass' \
--privprotocol=DES --privpassphrase='myEncPass' \
--critical-temperature='11:34' --critical-humidity='6:84' \
--filter-uom=null

OK: 'Sensor 1': temperature 17.45 C, humidity 22 % | 
'Sensor 1#environment.temperature.celsius'=17.45;;11:34;; 
'Sensor 1#environment.humidity.percentage'=22;;6:84;0;100

Опцией critical-humidity задаём границы изменения статуса для уровня влажности в процентах (в нашем примере допустимый уровень - от 6 до 84%, за рамками которого - критический статус).

Опцией critical-temperature задаём допустимые границы температурного режима в градусах по шкале Цельсия (в нашем примере нормальный уровень - от 11С до 34С, за рамками этих значений - критический статус).

Режим позволяет создать отдельную службу мониторинга, например «APC UPS Input Lines», статус которой будет меняться в зависимости от состояния входного напряжения на силовых вводах, подключенных к ИБП. Пример вызова данного режима:

# ./centreon_plugins.pl --plugin=hardware::ups::inmatics::sputnik::snmp::plugin \
--mode=input-lines \
--hostname=KOM-UP001 --snmp-version=3 --snmp-username='icinga-user' \
--authprotocol=SHA --authpassphrase='myAuthPass' \
--privprotocol=DES --privpassphrase='myEncPass' \
--critical-frequence='49:51' --critical-voltage='198:242' \
--filter-uom=null --use-new-perfdata

OK: Input Line '1' Frequence: 50.00 Hz, Voltage: 226.00 V, Current: 0.00 A, Power: 0.00 W | 
'1#line.input.frequence.hertz'=50;;49:51;; 
'1#line.input.voltage.volt'=226;;198:242;; 
'1#line.input.current.ampere'=0;;;; 
'1#line.input.power.watt'=0;;;;

Опциями warning-voltage и critical-voltage можно самостоятельно указать допустимые границы для входного напряжения. В нашем примере используется опция critical-voltage, с помощью которой мы задаём допустимые границы вольтажа на силовом вводе (допускаем уровень от 198 до 242 V, за рамками которого - критический статус).

В нашем примере используется опция critical-frequence, с помощью которой мы задаём допустимые границы колебания значений частоты тока на силовом вводе (допускаем уровень от 49 до 51 Hz, за рамками которого - критический статус).

Режим позволяет создать отдельную службу мониторинга, например «APC UPS Output Lines», статус которой будет меняться в зависимости от состояния нагрузки на исходящие силовые выходы ИБП, а также будет отображать показатели качества выходного тока. Пример вызова данного режима:

# ./centreon_plugins.pl --plugin=hardware::ups::inmatics::sputnik::snmp::plugin \
--mode=output-lines \
--hostname=KOM-UP001 --snmp-version=3 --snmp-username='icinga-user' \
--authprotocol=SHA --authpassphrase='myAuthPass' \
--privprotocol=DES --privpassphrase='myEncPass' \
--warning-load='0:80' --critical-load='0:90' \
--critical-voltage='198:253' \
--filter-uom=null --use-new-perfdata

OK: frequence: 50.00 Hz 
- Output line '1' load: 11.00 %, current: 0.00 A, voltage: 221.00 V, power: 0.00 W | 
'lines.output.frequence.hertz'=50.00;;;; 
'1#line.output.load.percentage'=11.00;0:80;0:90;0;100 
'1#line.output.current.ampere'=0.00;;;0; 
'1#line.output.voltage.volt'=221.00;;198:253;; 
'1#line.output.power.watt'=0.00;;;;

Опциями warning-load и critical-load в явном виде указываем допустимые границы нагрузки на выходящие силовые линии ИБП (выше 80% нагрузки - предупреждение, выше 90% нагрузки - критический статус).

Опцией critical-voltage указываем допустимые границы для выходного напряжения ИБП. В данном случае используется в качестве допустимого принят диапазон от 198 до 253 VAC.

Так как информация, выдаваемая плагином по выходным линиям ИБП, фактически делится на 2 типа - информация по нагрузке на выход и информация по качеству выходной линии, то, возможно, имеет смысл разделить графики, отображающие performance data в системе мониторинга.

Данный режим является исключительно статусным и не возвращает никаких данных performance data. Режим показывает состояние выходных линий ИБП и позволяет сигнализировать, например, при возникновении перегрузки на выходе ИБП. Пример вызова этого режима такой:

# ./centreon_plugins.pl --plugin=hardware::ups::inmatics::sputnik::snmp::plugin \
--mode=output-source \
--hostname=KOM-UP001 --snmp-version=3 --snmp-username='icinga-user' \
--authprotocol=SHA --authpassphrase='myAuthPass' \
--privprotocol=DES --privpassphrase='myEncPass'

OK: Output source status is 'normal'

На мой взгляд, данный режим является избыточным, так как информацию о состоянии выходов ИБП можно получать с помощью режима output-lines.

Проверено на следующих конфигурациях:

Автор первичной редакции:
Алексей Максимов
Время публикации: 09.04.2024 10:17