На странице
zabbix_sender
ZABBIX_SENDER(1) Общее руководство по командам ZABBIX_SENDER(1)
ИМЯ
zabbix_sender — утилита отправки данных Zabbix
СИНТАКСИС
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] -s
host -k key -o value
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] [-s
host] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] -k key -o value
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] -s
host --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file]
[--tls-server-cert-issuer cert-issuer] [--tls-server-cert-subject
cert-subject] --tls-cert-file cert-file --tls-key-file key-file
[--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k key -o
value
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] [-s
host] --tls-connect cert --tls-ca-file CA-file [--tls-crl-file
CRL-file] [--tls-server-cert-issuer cert-issuer]
[--tls-server-cert-subject cert-subject] --tls-cert-file cert-file
--tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher
cipher-string] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] --tls-connect cert --tls-ca-file CA-file
[--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer]
[--tls-server-cert-subject cert-subject] --tls-cert-file cert-file
--tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher
cipher-string] -k key -o value
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] --tls-connect cert --tls-ca-file CA-file
[--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer]
[--tls-server-cert-subject cert-subject] --tls-cert-file cert-file
--tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher
cipher-string] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] --tls-connect cert --tls-ca-file CA-file
[--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer]
[--tls-server-cert-subject cert-subject] --tls-cert-file cert-file
--tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher
cipher-string] -k key -o value
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] --tls-connect cert --tls-ca-file CA-file
[--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer]
[--tls-server-cert-subject cert-subject] --tls-cert-file cert-file
--tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher
cipher-string] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] -s
host --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file
PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k
key -o value
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] [-s
host] --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file
PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string]
[-T] [-N] [-r] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] --tls-connect psk --tls-psk-identity PSK-iden‐
tity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-ci‐
pher cipher-string] -k key -o value
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] --tls-connect psk --tls-psk-identity PSK-iden‐
tity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-ci‐
pher cipher-string] [-T] [-N] [-r] -i input-file
zabbix_sender -h
zabbix_sender -V
ОПИСАНИЕ
zabbix_sender — это утилита командной строки для отправки данных мони‐
торинга на сервер или прокси Zabbix. На сервере Zabbix должен быть со‐
здан элемент данных типа Zabbix trapper с соответствующим ключом. Об‐
ратите внимание, что входящие значения будут приниматься только от уз‐
лов сети, указанных в поле Allowed hosts для этого элемента данных.
ПАРАМЕТРЫ
-c, --config config-file
Использовать config-file. Zabbix sender считывает сведения о
сервере из файла конфигурации agentd. По умолчанию Zabbix
sender не считывает никакой файл конфигурации. Поддерживаются
только параметры Hostname, ServerActive, SourceIP, TLSConnect,
TLSCAFile, TLSCRLFile, TLSServerCertIssuer, TLSServerCertSubject,
TLSCertFile, TLSKeyFile, TLSPSKIdentity и TLSPSKFile. Hostname,
определённый через параметр HostnameItem, не будет использован;
в этом случае имя узла сети следует указать в командной строке
(см. параметр -s). Для отправки данных используются все адреса,
определённые в параметре конфигурации агента ServerActive. Если
отправка пакета данных на один адрес завершилась неудачей, сле‐
дующие пакеты на этот адрес не отправляются.
-z, --zabbix-server server
Имя узла сети или IP-адрес сервера Zabbix. Если узел сети
мониторится через прокси, вместо этого следует использовать имя
узла сети или IP-адрес прокси. При использовании вместе с
--config переопределяет записи параметра ServerActive, указанно‐
го в файле конфигурации agentd.
-p, --port port
Указать номер порта Zabbix trapper, работающего на сервере. По
умолчанию используется 10051. При использовании вместе с
--config переопределяет записи порта параметра ServerActive,
указанного в файле конфигурации agentd.
-I, --source-address IP-address
Указать исходный IP-адрес. При использовании вместе с --config
переопределяет параметр SourceIP, указанный в файле конфигура‐
ции agentd.
-t, --timeout seconds
Указать тайм-аут. Допустимый диапазон: 1-300 секунд (по умолча‐
нию: 60)
-s, --host host
Указать имя узла сети, которому принадлежит элемент данных (как
оно зарегистрировано в веб-интерфейсе Zabbix). IP-адрес узла
сети и DNS-имя не подойдут. При использовании вместе с --config
переопределяет параметр Hostname, указанный в файле конфигура‐
ции agentd.
-k, --key key
Указать ключ элемента данных, в который отправляется значение.
-o, --value value
Указать значение элемента данных.
-i, --input-file input-file
Загрузить значения из входного файла. Укажите - в качестве
<input-file>, чтобы читать значения из стандартного ввода. Каж‐
дая строка файла содержит разделённые пробелами значения:
<hostname> <key> <value>. Каждое значение должно быть указано в
отдельной строке. Каждая строка должна содержать 3 записи, раз‐
делённые пробелами: <hostname> <key> <value>, где "hostname" —
это имя мониторимого узла сети, зарегистрированное в веб-интер‐
фейсе Zabbix, "key" — ключ целевого элемента данных, а "value"
— отправляемое значение. Укажите - в качестве <hostname>, чтобы
использовать имя узла сети из файла конфигурации агента или из
аргумента --host.
Пример строки входного файла:
"Linux DB3" db.connections 43
Тип значения должен быть правильно задан в конфигурации элемен‐
та данных в веб-интерфейсе Zabbix. Zabbix sender отправляет до
250 значений за одно соединение. Содержимое входного файла
должно быть в кодировке UTF-8. Все значения из входного файла
отправляются последовательно сверху вниз. Записи должны быть
отформатированы по следующим правилам:
• Поддерживаются записи в кавычках и без кавычек.
• Символ двойной кавычки является символом кавычек.
• Записи, содержащие пробельные символы, должны быть за‐
ключены в кавычки.
• Символы двойной кавычки и обратной косой черты внутри
записи в кавычках должны экранироваться обратной косой
чертой.
• Экранирование не поддерживается в записях без кавычек.
• В строках в кавычках поддерживаются escape-последова‐
тельности перевода строки (\n).
• Escape-последовательности перевода строки удаляются из
конца записи.
-T, --with-timestamps
Этот параметр можно использовать только вместе с параметром
--input-file.
Каждая строка входного файла должна содержать 4 записи, разде‐
лённые пробелами: <hostname> <key> <timestamp> <value>. Метка
времени должна быть указана в формате Unix timestamp. Если це‐
левой элемент данных имеет триггеры, которые на него ссылаются,
все метки времени должны идти в возрастающем порядке, иначе вы‐
числение событий будет некорректным.
Пример строки входного файла:
"Linux DB3" db.connections 1429533600 43
Подробнее см. параметр --input-file.
Если значение с меткой времени отправляется для узла сети, ко‐
торый находится в обслуживании типа “no data”, это значение бу‐
дет отброшено; однако можно отправить значение с меткой време‐
ни для уже истёкшего периода обслуживания, и оно будет принято.
-N, --with-ns
Этот параметр можно использовать только вместе с параметром
--with-timestamps.
Каждая строка входного файла должна содержать 5 записей, разде‐
лённых пробелами: <hostname> <key> <timestamp> <ns> <value>.
Пример строки входного файла:
"Linux DB3" db.connections 1429533600 7402561 43
Подробнее см. параметр --input-file.
-r, --real-time
Отправлять значения по одному сразу после их получения. Это
можно использовать при чтении из стандартного ввода.
--tls-connect value
Способ подключения к серверу или прокси. Значения:
unencrypted
подключение без шифрования (по умолчанию)
psk подключение с использованием TLS и предвари‐
тельно разделяемого ключа
cert подключение с использованием TLS и сертификата
--tls-ca-file CA-file
Полный путь к файлу, содержащему сертификаты корневых центров
сертификации для проверки сертификата удалённой стороны.
--tls-crl-file CRL-file
Полный путь к файлу, содержащему отозванные сертификаты.
--tls-server-cert-issuer cert-issuer
Допустимый издатель сертификата сервера.
--tls-server-cert-subject cert-subject
Допустимый subject сертификата сервера.
--tls-cert-file cert-file
Полный путь к файлу, содержащему сертификат или цепочку серти‐
фикатов.
--tls-key-file key-file
Полный путь к файлу, содержащему закрытый ключ.
--tls-psk-identity PSK-identity
Строка PSK-identity.
--tls-psk-file PSK-file
Полный путь к файлу, содержащему предварительно разделяемый
ключ.
--tls-cipher13 cipher-string
Строка шифров для OpenSSL 1.1.1 или новее для TLS 1.3. Переоп‐
ределяет критерии выбора набора шифров по умолчанию. Этот па‐
раметр недоступен, если версия OpenSSL ниже 1.1.1.
--tls-cipher cipher-string
Строка приоритетов GnuTLS (для TLS 1.2 и выше) или строка шиф‐
ров OpenSSL (только для TLS 1.2). Переопределяет критерии выбо‐
ра набора шифров по умолчанию.
-v, --verbose
Подробный режим, -vv для большей детализации.
-h, --help
Показать эту справку и выйти.
-V, --version
Вывести информацию о версии и выйти.
КОД ЗАВЕРШЕНИЯ
Код завершения равен 0, если значения были отправлены и все они были
успешно обработаны сервером. Если данные были отправлены, но обработка
хотя бы одного из значений завершилась неудачей, код завершения равен
2. Если отправка данных не удалась, код завершения равен 1.
ПРИМЕРЫ
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -k mysql.queries -o
342.45
Отправить 342.45 как значение для элемента данных mysql.queries
мониторимого узла сети. Используется мониторимый узел сети и
сервер Zabbix, определённые в файле конфигурации агента.
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 на сервер Zabbix с
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_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o
342.45 --tls-connect cert --tls-ca-file /home/zabbix/zabbix_ca_file
--tls-cert-file /home/zabbix/zabbix_agentd.crt --tls-key-file
/home/zabbix/zabbix_agentd.key
Отправить 342.45 как значение для элемента данных mysql.queries
узла сети Monitored Host на сервер с IP 192.168.1.113, используя
TLS с сертификатом.
zabbix_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o
342.45 --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd"
--tls-psk-file /home/zabbix/zabbix_agentd.psk
Отправить 342.45 как значение для элемента данных mysql.queries
узла сети Monitored Host на сервер с IP 192.168.1.113, используя
TLS с предварительно разделяемым ключом (PSK).
СМ. ТАКЖЕ
Документация
zabbix_agentd(8), zabbix_get(1), zabbix_proxy(8), zabbix_server(8),
zabbix_js(1), zabbix_agent2(8), zabbix_web_service(8)
Zabbix 2022-01-06 ZABBIX_SENDER(1)