zabbix_sender

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


[ ]{#lbAB}

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

zabbix_sender - утилита Zabbix Sender. [ ]{#lbAC}

СИНТАКСИС

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

ОПИСАНИЕ

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

[ ]{#lbAE}

Опции

-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
Вывод информации о версии и выход.

[ ]{#lbAF}

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

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

[ ]{#lbAG}

ПРИМЕРЫ

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 из командной строки. Пустые значения должны быть указаны с помощью двойных кавычек.

[ ]{#lbAH}

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

zabbix_agentd(8), zabbix_get(8), zabbix_proxy(8), zabbix_server(8) [ ]{#lbAI}

АВТОР

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


[ ]{#index}

Оглавление

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

СИНТАКСИС

ОПИСАНИЕ
Опции

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

ПРИМЕРЫ

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

АВТОР


This document was created by man2html, using the manual pages.
Time: 09:44:44 GMT, February 14, 2017