4. Протокол плагина Zabbix Агента 2

Протокол Zabbix агента 2 основан на коде, размере и модели данных.

Код

Размер

Данные полезной нагрузки

Определение данных полезной нагрузки

Общие данные

Эти параметры присутствуют во всех вопросах/ответах:

Запрос журналирования

Запрос отсылается плагином, чтобы записать журнальное сообщение в журнальный файл агента.

Параметры, специфичные для запросов журналирования:

Пример:

{"id":0,"type":1,"severity":3,"message":"сообщение"}

Запрос регистрации

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

Параметры, специфичные для запросов регистрации:

Пример:

{"id":1,"type":2,"version":"1.0"}

Ответ на регистрацию

Ответ плагина на запрос на регистрацию.

Параметры, специфичные для ответов на регистрацию:

Примеры:

{"id":2,"type":3,"metrics":["external.test", "Тестирование внешнего экпортера."], "interfaces": 4}

или

{"id":2,"type":3,"error":"сообщение об ошибке"}

Запрос на запуск

Запрос на выполнение функции запуска (Start) интерфейса Runner.

Запрос не имеет специфичных параметров, он содержит только параметры общих данных.

Пример:

{"id":3,"type":4}

Запрос на останов

Запрос отсылается агентом, чтобы остановить плагин.

Запрос не имеет специфичных параметров, он содержит только параметры общих данных.

Пример:

{"id":3,"type":5}

Запрос экспорта

Запрос на выполнение функции экспорта (Export) интерфейса Exporter.

Параметры, специфичные для запросов экспорта:

Пример:

{"id":4,"type":6,"key":"test.key","parameters":["foo","bar"]}

Ответ экспорта

Ответ из функции Export интерфейса Exporter.

Параметры, специфичные для ответов экспорта:

Примеры:

{"id":5,"type":7,"value":"response"}

или

{"id":5,"type":7,"error":"сообщение об ошибке"}

Запрос на конфигурацию

Запрос на выполнение функции Configure интерфейса Configurator.

Параметры, специфичные для запросов Configure:

Пример:

{"id":6,"type":8,"global_options":{...},"private_options":{...}}

Запрос на валидацию

Запрос на выполнение функции Validate интерфейса Configurator.

Параметры, специфичные для запросов Validate:

Пример:

{"id":7,"type":9,"private_options":{...}}

Ответ на валидацию

Ответ от функции Validate интерфейса Configurator.

Параметры, специфичные для ответов на Validate:

Примеры:

{"id":8,"type":10}

или

{"id":8,"type":10,"error":"сообщение об ошибке"}