Zabbix Documentation 2.2

6 Sender

Обзор

Zabbix sender - это утилита командной строки, которая может быть использована для отправки данных о производительности Zabbix серверу для последующей их обработки.

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

Чтобы отправлять результаты напрямую на Zabbix сервер или прокси, необходимо задать тип элемента данных траппер.

Отправка одного значения

Пример отправки одного значения на Zabbix сервер используя Zabbix sender:

shell> zabbix_sender -z zabbix -s "Linux DB3" -k db.connections -o 43

где:

z - хост Zabbix сервера (также можно использовать IP адрес)
s - техническое имя наблюдаемого узла сети (указанное в веб-интерфейсе Zabbix)
k - ключ элемента данных
o - отправляемое значение

Если объекты содержат пробелы, то эти объекты должны быть заключены в двойные кавычки.

Процесс Zabbix траппера не раскрывает макросы, которые используются в ключе элемента данных в попытке проверки наличия соответствующего ключа элемента данных на целевом узле сети.

Обратитесь к странице помощи Zabbix sender для получения более подробной информации.

Zabbix sender в Windows можно выполнить тем же самым способом:

zabbix_sender.exe [опции]

Начиная с версии Zabbix 1.8.4 утилита Zabbix_sender была улучшена в плане отправки данных в реальном времени. Имеется ввиду, что большое количество значений, полученное за короткий промежуток времени, будут накапливаться во временном стеке и затем будет отправлено серверу за одно соединение. Данные, пришедшие через менее, чем 0,2 сек после предыдущего значения накапливаются в одном стеке, но максимальное время их накопления до отправки все же 1 секунда.

Отправка множества значений

Имеется возможность указать входящий файл, который содержит значения к отправки на Zabbix сервер.

Смотрите опцию --input-file на странице помощи Zabbix sender о том, как правильно формировать файл.

Без штампов времени у значений

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

"Linux DB1" db.ping 1
"Linux DB3" db.ping 0
"Zabbix server" db.status 0
"Zabbix server" db.error "Linux DB3 down"

Со штампами времени у значений

Имеется возможность указать штамп времени для каждого отправляемого значения. В этом случае используйте опцию --with-timestamps. Ниже представлен пример входящего файла со штампами времени:

"Linux DB1" db.ping 1429533600 1
"Linux DB3" db.ping 1429533602 0
"Zabbix server" db.status 1429533603 0
"Zabbix server" db.error 1429533603 "Linux DB3 down"

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

Штампы времени, указанные во входящем файле, будут скорректированы для совпадения со временем сервера. Например, если указан штамп времени равный “10:30:50”, текущим временем на машине Zabbix sender является “10:40:03”, и текущим временем на машине Zabbix сервера является “10:40:05”, тогда значение элемента данных будет записано в базу данных со штампом времени равным “10:30:52”.

Аналогично в случае, если значение сначала отправляется на Zabbix прокси, затем отправляется на Zabbix сервер, то штамп времени будет скорректирован сначала для совпадения со временем на Zabbix прокси, и затем будет скорректирован для совпадения со временем на Zabbix сервере.

Zabbix sender принимает строки в UTF-8 кодировке (как в UNIX-подобных системах, так и в Windows) без изначального маркера последовательности байтов (BOM) в файле.

Заключение в кавычки во входящем файле

Страница помощи по Zabbix sender содержит правила как правильно форматировать записи во входящем файле в разделе --input-file. Ниже представлены примеры того, как значения будут сохранены в базе данных при использовании различных методов заключения в кавычки:

значение во входящем файле	результат в базе данных	сообщение об ошибке на экране
failed	failed
“status: failed”	status: failed
“status: \”failed\““	status: “failed”
“C:\\”	C:\
C:\	C:\
“C:\”		Warning: [line 1] 'Key value' required
“C:\My Documents”	C:\My Documents
status:\nfailed	status:\nfailed
“status:\tfailed”	status:\tfailed
“status:\nfailed”	status: failed
“status:\nfailed\n”	status: failed
“\nstatus:\nfailed”	status: failed
“\n\n”

Пример вывода

Ниже представлен пример отправки 300 значений из входящего файла:

# zabbix_sender -z 127.0.0.1 -i /tmp/trapper.txt 
Info from server: "Processed 250 Failed 0 Total 250 Seconds spent 0.002668"
Info from server: "Processed 50 Failed 0 Total 50 Seconds spent 0.000540"
sent: 300; skipped: 0; total: 300

Zabbix sender завершится, если в файле конфигурации имеется ошибочный (не соответствующий определению параметр=значение) параметр.