На странице
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] -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» с соответствующим ключом.
Обратите внимание, что входящие значения будут приниматься только от
узлов сети, указанных в поле «Разрешённые узлы сети» для этого элемента
данных.
ПАРАМЕТРЫ
-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.
По умолчанию используется порт 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. Если на целевой элемент данных ссылаются триггеры, все
временные метки должны идти в возрастающем порядке; в противном
случае расчёт событий будет некорректным.
Пример строки входного файла:
"Linux DB3" db.connections 1429533600 43
Дополнительные сведения см. в описании параметра --input-file.
Если значение с временной меткой отправляется для узла сети,
находящегося в режиме обслуживания типа «нет данных», это
значение будет отброшено; однако значение с временной меткой
можно отправить за пределами периода обслуживания, и оно будет
принято.
-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
Разрешённое имя субъекта сертификата сервера.
--tls-cert-file cert-file
Полное имя файла, содержащего сертификат или цепочку
сертификатов.
--tls-key-file key-file
Полное имя файла, содержащего закрытый ключ.
--tls-psk-identity PSK-identity
Строка идентификатора PSK.
--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)