Table of Contents

zabbix_sender

zabbix_sender

Раздел: Команды обслуживания (8)
Обновлено: 16 Октября 2015
Оглавление Вернуться к основному содержимому

НАИМЕНОВАНИЕ

zabbix_sender - утилита Zabbix Sender.

СИНТАКСИС

zabbix_sender [-hpzvIV] {-kso | [-T] -i <входящийфайл>} [-c <файл-конфигурации>]

ОПИСАНИЕ

zabbix_sender это утилита командной строки, которая используется для отправки данных производительности удаленному Zabbix серверу. На Zabbix сервере должен быть создан элемент данных с типом Zabbix траппер и с соответствующим ключом. Обратите внимание, что входящие значения принимаются только с тех хостов, которые указаны в поле Разрешенные узлы сети этого элемента данных.

Опции

-c, --config <файл-конфигурации>
Использование файла-конфигурации. Zabbix sender читает детали сервера из файла конфигурации агента. По умолчанию Zabbix sender не читает никаких файлов конфигурации. Должен быть указан абсолютный путь к файлу конфигурации. Поддерживаются только параметры Hostname, ServerActive и SourceIP. Используется первая запись из параметра ServerActive.

-z, --zabbix-server <сервер>
Имя хоста или IP адрес Zabbix сервера. Если узел сети наблюдается через Zabbix прокси, вместо реквизитов сервера необходимо использовать имя хоста или IP адрес прокси.

-p, --port <порт>
Укажите номер порта сервера на котором запущен траппер сервера. По умолчанию 10051.

-s, --host <хост>
Укажите имя узла сети агента зарегистрированного в веб-интерфейсе Zabbix. IP адрес хоста и DNS имя не будут работать.

-I, --source-address <IP>
Укажите локальный IP адрес для исходящих подключений.

-k, --key <ключ>
Укажите ключ элемента данных на который отправляются данные.

-o, --value <значение>
Укажите значение.

-i, --input-file входящий-файл
Загрузка данных из входного файла. Укажите дефис - как <входящий-файл> для чтения значений со стандартного ввода. Каждая строка файла должна содержать разделенные пробелами: <имяузласети> <ключ> <значение>. Каждое значение должно располагаться на своей собственной строке. Каждая строка должна содержать записи, разделенные 3 пробелами: <имяузласети> <ключ> <значение>, где "именемузласети" является имя наблюдаемого узла сети, как указано в веб-интерфейса Zabbix, "ключем" является целевой ключ элемента данных и "значение" - отправляемое значение. Укажите дефис - в <имяузласети>, чтобы использовать имя хоста из файла конфигурации или --host аргумент.

Пример строки входящего файла:

"Linux DB3" db.connections 43

Тип значения должен быть корректно задан при настройке элемента данных в веб-интерфейсе Zabbix. Zabbix sender отправляет до 250 значений за одно соединение. Содержимое входящего файла должно быть в UTF-8 кодировке. Все значения из входящего файла отправляются в последовательном порядке сверху вниз. Записи необходимо отформатировать руководствуясь следующими правилами:

•
Поддерживаются записи как заключенные в кавычки, так и не в кавычках.

•
Двойные кавычки являются символом заключения в кавычки.

•
Записи с пробелами необходимо заключить в кавычки.

•
Двойные кавычки и символы обратной косой черты внутри заключенной в кавычки записи необходимо экранировать при помощи обратной косой черты.

•
Экранирование не поддерживается в не заключенных в кавычки записях.

•
Символы перевода строки (\n) поддерживаются в заключенных кавычками строках.

•
Символы перевода строки в конце записи обрезаются.

P>

-T, --with-timestamps
Эта опция используется только при наличии --input-file опции.

Если значение со штампом времени отправляется на узел сети, который находится в обслуживании с типом обслуживания "без данных", тогда это значение будет отброшено, однако, имеется возможность отправить значение со штампом времени в течении истекшего периода обслуживания и оно будет принято.

Каждая строка файла должна содержать записи, разделенные 4 пробелами: <имяузласети> <ключ> <штампвремени> <значение>. Штамп времени необходимо указывать в формате Unix timestamp. Если целевой элемент данных имеет триггеры ссылающиеся на него, тогда все штампы времени должны быть в порядке возрастания, в противном случае расчет событий будет неправильным.

Пример строки входящего файла:

"Linux DB3" db.connections 1429533600 43

Для получения деталей, пожалуйста, смотрите опцию --input-file.

-r, --real-time
Отправка значения одним за другим, как только они были получены. Эту функцию можно использовать при чтении из стандартного ввода.

-v, --verbose
Режим отладки, -vv для еще более подробной отладки.

-h, --help
Вывод этой справки и выход.

-V, --version
Вывод информации о версии и выход.

СТАТУС ВЫХОДА

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

ПРИМЕРЫ

zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s Monitored Host -k mysql.queries -o 342.45

Отправка 342.45 как значение ключа mysql.queries у узла сети Monitored Host, используя параметры Zabbix сервера, которые указаны в файле конфигурации демона агента.

zabbix_sender -z 192.168.1.113 -i data_values.txt

Отправка значений из файла data_values.txt на сервер с IP адресом 192.168.1.113. Имена узлов сети и ключи элементов данных указаны в файле.

echo - hw.serial.number 1287872261 SQ4321ASDF | zabbix_sender -c /usr/local/etc/zabbix_agentd.conf -T -i -

Отправка значения со штампом времени из командной строки на Zabbix сервер, который указан в файле конфигурации демона агента. Тире в данных, подаваемых на стандартный ввод, указывает, что имя узла сети должно быть взято из того же файла конфигурации.

echo 'Zabbix server trapper.item ' | zabbix_sender -z 192.168.1.113 -p 10000 -i -

Отправка пустого значения элементу данных на Zabbix сервер с IP адресом 192.168.1.113 на порту 10000 из командной строки. Пустые значения должны быть указаны с помощью двойных кавычек.

СМОТРИТЕ ТАКЖЕ

zabbix_agentd(8), zabbix_get(8), zabbix_proxy(8), zabbix_server(8)

АВТОР

Алексей Владышев <[email protected]>

Documentation