ICMP
Общие сведения
Название плагина: icmp
Ссылка для загрузки плагина: скачать
Описание:
Данный плагин предназначен для регулярного опроса сетевых устройств по протоколу ICMP.
Формат сценария плагина ICMP
name: ICMP Probe
jobs:
- name: ICMP Request
steps:
- plugin: icmp
with:
target: <ip/dns address>
packetCount: <4>
packetSize: <32>
packetInterval: <1000>
replyTimeout: <4000>
customFields:
{field_name}: {field_value}
outputs:
result: $._outputs.result
artifacts:
- data: $.outputs.result
send-to: monq
type: metrics
Параметры конфигурации плагина
Параметр | Тип | Обязательный | Значение по умолчанию | Описание |
---|---|---|---|---|
target | String | да | - | IP или DNS адрес опрашиваемой цели |
packetCount | Integer | - | 4 | Количество пакетов, которое будет отправлено для проверки |
packetSize | Integer | - | 32 байта | Размер одного пакета (в байтах) |
packetInterval | Integer | - | 1000 мс | Интервал отправки пакетов (в миллисекундах) |
replyTimeout | Integer | - | 4000 мс | Время, за которое должна быть выполнена проверка, иначе ресурс будет считаться недоступным |
customFields | Object | - | - | Дополнительные поля, которые будут добавлены к собранным метрикам в качестве меток |
-
Параметр
customFields
указывается в следующем формате:...
customFields:
field: value
field2: value2
...
Собираемые метрики
Метрика | Тип | Описание |
---|---|---|
icmp_ping_result | gauge | Результат доступности хоста (1 если хост доступен, 0 - недоступен) |
icmp_ping_loss | gauge | Процент потерянных пакетов |
icmp_ping_min | gauge | Минимальное время отклика от момента отправки ICMP-запроса до момента получения ICMP-ответа от хоста по любому из пакетов |
icmp_ping_max | gauge | Максимальное время отклика от момента отправки ICMP-запроса до момента получения ICMP-ответа от хоста по любому из пакетов |
icmp_ping_avg | gauge | Среднее время отклика от момента отправки ICMP-запроса до момента получения ICMP-ответа от хоста по всем пакетам |
Пример настройки задания для проверки сайта monq.ru
jobs:
- steps:
- plugin: icmp
with:
target: monq.ru
packetCount: 4
packetSize: 56
packetInterval: 5
replyTimeout: 200
customFields:
source: system
outputs:
result: $._outputs.result
artifacts:
- data: $.outputs.result
send-to: monq
type: metrics
это удобно
При помощи сбора данных по CMDB можно формировать перечень объектов, для которых будет выполнять задание сборщик. Например, для всех ваших коммутаторов настроить один сборщик ICMP, который будет выполняться для всех объектов (КЕ) с типом коммутатор, значение IP-адреса будет взято из соответствующего атрибута в CMDB. Появляется новый коммутатор в CMDB - автоматически он становится на мониторинг.