Вики IT-KB

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
===== Мониторинг Avaya IP-Phone в Icinga с помощью плагина Centreon Plugins =====

{{:avaya:pasted:20220201-123204.png }} В состав комплекта плагинов **Centreon Plugins** не входит выделенный плагин мониторинга IP-телефонов **Avaya**. Однако для этой цели мы можем использовать реализацию мониторинга стандартной **Linux**-системы с помощью периодических опросов по протоколу **SNMP** из плагина **os::linux::snmp::plugin**. 

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

----

==== Режимы работы плагина ====

Плагин мониторинга **os::linux::snmp::plugin** имеет несколько режимов работы, позволяющих отслеживать состояние разных показателей. С точки зрения мониторинга IP-телефонов Avaya нам будут интересны лишь некоторые из этих режимов:   

<HTML><pre style="background:#5a5a62;color:#ffffff;padding:10px;border:0px;"># /usr/lib/nagios/plugins/centreon-plugins/centreon_plugins.pl \
--plugin=os::linux::snmp::plugin \
--list-mode
</br><font style="color:#B2B2B2;">...
Modes Available:
   ...
   cpu
   ...
   interfaces
   ...
   load
   memory
   ...
   uptime</font></pre></HTML>

----

==== Режим cpu ====

Режим позволяет создать отдельную службу мониторинга, например "**Avaya CPU Usage**", статус которой будет меняться в зависимости от текущей нагрузки на процессор аппарата. 
Пример вызова данного режима:

<HTML><pre style="background:#5a5a62;color:#ffffff;padding:10px;border:0px;"># ./centreon_plugins.pl --plugin=os::linux::snmp::plugin --mode=cpu \
--warning-average='90' --warning-core='90' --critical-average='98' --critical-core='98' \
--hostname='MY-PHONE01' --snmp-community='myROcs' --snmp-version='2c' \
--use-new-perfdata
</br><font style="color:#B2B2B2;">OK: 1 CPU(s) average usage is 14.00 % - CPU '0' usage : 14.00 % | 
'cpu.utilization.percentage'=14.00%;0:90;0:98;0;100 
'0#core.cpu.utilization.percentage'=14.00%;0:90;0:98;0;100</font></pre></HTML>

Опциями ''warning-average'' и ''critical-average'' задаём границы изменения общей нагрузки процессора (по всем ядрам) в процентах (более 90% - предупреждение, более 98% - критический статус). 

Опциями ''warning-core'' и ''critical-core'' задаём границы изменения нагрузки по каждому отдельному процессорному ядру в процентах (более 90% - предупреждение, более 98% - критический статус). 


{{ :icinga:centreon-plugins:pasted:20220201-133332.png }}

----

==== Режим load ====

Режим позволяет создать отдельную службу мониторинга, например "**Avaya Load Average**", статус которой будет меняться в зависимости от средней загрузки операционной системы аппарата в целом. 
Пример вызова данного режима:

<HTML><pre style="background:#5a5a62;color:#ffffff;padding:10px;border:0px;"># ./centreon_plugins.pl --plugin=os::linux::snmp::plugin --mode=load \
--critical='12,,' \
--hostname='MY-PHONE01' --snmp-community='myROcs' --snmp-version='2c'
</br><font style="color:#B2B2B2;">OK: Load average: 2.50, 2.49, 2.46 | 
'load1'=2.50;;0:12;0; 'load5'=2.49;;;0; 'load15'=2.46;;;0;</font></pre></HTML>

Опциями ''warning'' и ''critical'' мы можем задать границы изменения загрузки системы в формате ''"load last 1m, load last 5m, load last 15m"''. То есть в нашем примере, задан только критический порог для показателя load за последнюю минуту со значением в 12 единиц (это пограничное значение было подсмотрено в документации Avaya).

{{ :icinga:centreon-plugins:pasted:20220201-142415.png }}

----

==== Режим memory ====

Режим позволяет создать отдельную службу мониторинга, например "**Avaya Memory Usage**", статус которой будет меняться в зависимости от текущего уровня утилизации оперативной памяти аппарата. 
Пример вызова данного режима:

<HTML><pre style="background:#5a5a62;color:#ffffff;padding:10px;border:0px;"># ./centreon_plugins.pl --plugin='os::linux::snmp::plugin' --mode='memory' \
--hostname='KOM-PHONE01' --snmp-version='2' --snmp-community='myROcs' \
--warning-usage-prct='90' --critical-usage-prct='98' \
--use-new-perfdata --filter-perfdata='(usage.bytes|usage.percentage)' 
</br><font style="color:#B2B2B2;">OK: Ram Total: 115.25 MB Used (-buffers/cache): 51.04 MB (44.29%) 
Free: 64.21 MB (55.71%), Buffer: 0.00 B, Cached: 36.58 MB, Shared: 852.00 KB | 
'memory.usage.bytes'=53518336B;;;0;120844288 
'memory.usage.percentage'=44.29%;0:90;0:98;0;100</font></pre></HTML>

Опциями ''warning-usage-prct'' и ''critical-usage-prct'' задаём границы изменения статуса службы мониторинга в процентах (более 90% - предупреждение, более 98% - критический статус). 

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

{{ :icinga:centreon-plugins:pasted:20220201-145220.png }}

----

==== Режим uptime ====

Режим позволяет создать отдельную службу мониторинга, например "** Avaya Uptime**", которая будет отслеживать время непрерывной работы аппарата между перезагрузками его встроенной ОС. 
Пример вызова данного режима:

<HTML><pre style="background:#5a5a62;color:#ffffff;padding:10px;border:0px;">#./centreon_plugins.pl --plugin='os::linux::snmp::plugin' --mode='uptime' \
--hostname='KOM-PHONE01' --snmp-version='2' --snmp-community='myROcs'
</br><font style="color:#B2B2B2;">OK: System uptime is: 4d 15h 38m 3s | 'uptime'=401883s;;;0;</font></pre></HTML>

Сбор метрики производительности в секундах позволит нам построить наглядный исторический график, на котором будут заметны все перезагрузки аппарата. 

{{ :icinga:centreon-plugins:pasted:20220201-150509.png }}

----

==== Режим interfaces ====

Режим позволяет создать отдельную службу мониторинга, например "**Avaya Interfaces**", статус которой будет меняться в зависимости от уровня утилизации и наличия ошибок на сетевых интерфейсах аппарата. 
Пример вызова данного режима:

<HTML><pre style="background:#5a5a62;color:#ffffff;padding:10px;border:0px;"># ./centreon_plugins.pl --plugin='os::linux::snmp::plugin' --mode=interfaces \
--hostname='KOM-PHONE01' --snmp-version='2' --snmp-community='myROcs' \
--add-traffic --units-traffic='%' \
--add-errors \
--warning-out-traffic='98' --warning-out-error='1' --warning-out-discard='50' \
--warning-in-traffic='98' --warning-in-error='1' --warning-in-discard='50' \
--use-new-perfdata --filter-uom='null' \
--filter-perfdata-adv='not (%(value) == 0)' \
--filter-perfdata='.*[.](traffic|error|discard|crc)[.].*' \
--critical-status='%{errdisable} ne "-"'
</br><font style="color:#B2B2B2;">OK: All interfaces are ok | 
'eth0#interface.traffic.in.bitspersecond'=448.82;;;0; 
'eth0#interface.traffic.out.bitspersecond'=466.67;;;0; 
'eth0.101#interface.traffic.in.bitspersecond'=375.38;;;0; 
'eth0.101#interface.traffic.out.bitspersecond'=411.28;;;0;</font></pre></HTML>

Опция ''add-traffic'' добавляет в вывод плагина данные о производительности (perfdata) по трафику на сетевых интерфейсах, а опция ''units-traffic'' определяет то, что абсолютные показатели будут для удобства пересчитываться в проценты (в том числе и для сравнения с допустимыми пороговыми значениями).

Опция ''add-errors'' включает режим вывода сведений об ошибках на интерфейсах.

Опциями ''warning-in-*'' и ''warning-out-*'' задаём границы допустимых для нас значений в процентном соотношении. Например, в нашем случае опция ''warning-in-traffic'' служит для изменения статуса службы мониторинга на предупреждающий в случае, если утилизация входящего трафика превышает 98%.

Необязательной опцией ''filter-uom'' можем отказаться от вывода единиц измерения (UOM) в выводимых данных perfdata.

Опция ''filter-perfdata-adv'' позволяет нам задать расширенные условия для вывода данных perfdata. В нашем конкретном примере, из вывода плагина исключаются все значения, имеющие нулевой показатель (может быть полезно, если требуется сократить объём сохраняемых метрик).

Опция ''filter-perfdata'' позволяет отбросить все не интересующие нас метрики perfdata с использованием регулярных выражений.

Ну и, наконец, с помощью опции ''critical-status'' мы добавляем отлов интерфейсов, находящихся в состоянии ошибки.

{{ :icinga:centreon-plugins:pasted:20220201-153022.png }}

У телефонов **Avaya** серии **J100**, на которых проводилось тестирование и отладка работы плагина мониторинга **os::linux::snmp::plugin** было замечено то, что по протоколу SNMP может не возвращаться информация о пропускной способности сетевых интерфейсов. Это, в свою очередь,не позволяет контролировать процент текущей утилизации интерфейса и менять статус службы мониторинга в случае превышения допустимых пороговых значений.


----
Проверено на следующих конфигурациях:
^ Версия ОС ^ Версия Icinga ^ Версия Centreon Plugins  ^ Модель Avaya IP-Phone ^
| Debian GNU/Linux 10.12 (Buster) |  r2.13.2-1  |  20220113  |  J139 / J189  |

----
{{:user:blogroot.png?50&nolink |}} Автор первичной редакции:\\ [[user:blogroot|Алексей Максимов]] \\ Время публикации: 01.02.2022 13:40

{{tag>Monitoring "Centreon Plugins" SNMP Icinga Nagios Plugin Avaya "IP Phone" Linux "Avaya J100" "Avaya J139" "Avaya J189"}}

~~DISCUSSION~~