Перейти к основному содержимому
Версия: 9.0

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

Параметры конфигурации плагина

ПараметрТипОбязательныйЗначение по умолчаниюОписание
targetStringда-IP или DNS адрес опрашиваемой цели
packetCountInteger-4Количество пакетов, которое будет отправлено для проверки
packetSizeInteger-32 байтаРазмер одного пакета (в байтах)
packetIntervalInteger-1000 мсИнтервал отправки пакетов (в миллисекундах)
replyTimeoutInteger-4000 мсВремя, за которое должна быть выполнена проверка, иначе ресурс будет считаться недоступным
customFieldsObject--Дополнительные поля, которые будут добавлены к собранным метрикам в качестве меток
  • Параметр customFields указывается в следующем формате:

      ...
    customFields:
    field: value
    field2: value2
    ...

Собираемые метрики

МетрикаТипОписание
icmp_ping_resultgaugeРезультат доступности хоста (1 если хост доступен, 0 - недоступен)
icmp_ping_lossgaugeПроцент потерянных пакетов
icmp_ping_mingaugeМинимальное время отклика от момента отправки ICMP-запроса до момента получения ICMP-ответа от хоста по любому из пакетов
icmp_ping_maxgaugeМаксимальное время отклика от момента отправки ICMP-запроса до момента получения ICMP-ответа от хоста по любому из пакетов
icmp_ping_avggaugeСреднее время отклика от момента отправки 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 - автоматически он становится на мониторинг.