На странице
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
Указать номер порта, на котором работает trapper сервера 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. Все значения из входного файла
отправляются последовательно, сверху вниз. Записи должны быть
отформатированы в соответствии со следующими правилами:
• Поддерживаются записи в кавычках и без кавычек.
• Для заключения в кавычки используются двойные кавычки.
• Записи, содержащие пробелы, должны быть заключены в
кавычки.
• Двойные кавычки и символы обратной косой черты внутри
записи в кавычках должны экранироваться обратной косой
чертой.
• Экранирование не поддерживается в записях без кавычек.
• В строках в кавычках поддерживаются управляющие
последовательности перевода строки (\n).
• Управляющие последовательности перевода строки
удаляются из конца записи.
-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)