На странице
zabbix_sender
ZABBIX_SENDER(1) Руководство по общим командам ZABBIX_SENDER(1)
НАЗВАНИЕ
zabbix_sender — утилита Zabbix sender
СИНТАКСИС
zabbix_sender [-v] -z сервер [-p порт] [-I IP-адрес] [-t тайм-аут] -s
узел-сети -k ключ -o значение
zabbix_sender [-v] -z сервер [-p порт] [-I IP-адрес] [-t тайм-аут] [-s
узел-сети] [-T] [-N] [-r] -i входной-файл
zabbix_sender [-v] -c конфиг-файл [-z сервер] [-p порт] [-I IP-адрес]
[-t тайм-аут] [-s узел-сети] -k ключ -o значение
zabbix_sender [-v] -c конфиг-файл [-z сервер] [-p порт] [-I IP-адрес]
[-t тайм-аут] [-s узел-сети] [-T] [-N] [-r] -i входной-файл
zabbix_sender [-v] -z сервер [-p порт] [-I IP-адрес] [-t тайм-аут] -s
узел-сети --tls-connect cert --tls-ca-file CA-файл [--tls-crl-file CRL-файл]
[--tls-server-cert-issuer эмитент] [--tls-server-cert-subject
субъект] --tls-cert-file cert-файл --tls-key-file key-файл
[--tls-cipher13 строка-шифра] [--tls-cipher строка-шифра] -k ключ -o
значение
zabbix_sender [-v] -z сервер [-p порт] [-I IP-адрес] [-t тайм-аут] [-s
узел-сети] --tls-connect cert --tls-ca-file CA-файл [--tls-crl-file
CRL-файл] [--tls-server-cert-issuer эмитент]
[--tls-server-cert-subject субъект] --tls-cert-file cert-файл
--tls-key-file key-файл [--tls-cipher13 строка-шифра] [--tls-cipher
строка-шифра] [-T] [-N] [-r] -i входной-файл
zabbix_sender [-v] -c конфиг-файл [-z сервер] [-p порт] [-I IP-адрес]
[-t тайм-аут] [-s узел-сети] --tls-connect cert --tls-ca-file CA-файл
[--tls-crl-file CRL-файл] [--tls-server-cert-issuer эмитент]
[--tls-server-cert-subject субъект] --tls-cert-file cert-файл
--tls-key-file key-файл [--tls-cipher13 строка-шифра] [--tls-cipher
строка-шифра] -k ключ -o значение
zabbix_sender [-v] -c конфиг-файл [-z сервер] [-p порт] [-I IP-адрес]
[-t тайм-аут] [-s узел-сети] --tls-connect cert --tls-ca-file CA-файл
[--tls-crl-file CRL-файл] [--tls-server-cert-issuer эмитент]
[--tls-server-cert-subject субъект] --tls-cert-file cert-файл
--tls-key-file key-файл [--tls-cipher13 строка-шифра] [--tls-cipher
строка-шифра] [-T] [-N] [-r] -i входной-файл
zabbix_sender [-v] -c конфиг-файл [-z сервер] [-p порт] [-I IP-адрес]
[-t тайм-аут] [-s узел-сети] --tls-connect cert --tls-ca-file CA-файл
[--tls-crl-file CRL-файл] [--tls-server-cert-issuer эмитент]
[--tls-server-cert-subject субъект] --tls-cert-file cert-файл
--tls-key-file key-файл [--tls-cipher13 строка-шифра] [--tls-cipher
строка-шифра] -k ключ -o значение
zabbix_sender [-v] -c конфиг-файл [-z сервер] [-p порт] [-I IP-адрес]
[-t тайм-аут] [-s узел-сети] --tls-connect cert --tls-ca-file CA-файл
[--tls-crl-file CRL-файл] [--tls-server-cert-issuer эмитент]
[--tls-server-cert-subject субъект] --tls-cert-file cert-файл
--tls-key-file key-файл [--tls-cipher13 строка-шифра] [--tls-cipher
строка-шифра] [-T] [-N] [-r] -i входной-файл
zabbix_sender [-v] -z сервер [-p порт] [-I IP-адрес] [-t тайм-аут] -s
узел-сети --tls-connect psk --tls-psk-identity идентификатор-PSK --tls-psk-file
PSK-файл [--tls-cipher13 строка-шифра] [--tls-cipher строка-шифра] -k
ключ -o значение
zabbix_sender [-v] -z сервер [-p порт] [-I IP-адрес] [-t тайм-аут] [-s
узел-сети] --tls-connect psk --tls-psk-identity идентификатор-PSK --tls-psk-file
PSK-файл [--tls-cipher13 строка-шифра] [--tls-cipher строка-шифра]
[-T] [-N] [-r] -i входной-файл
zabbix_sender [-v] -c конфиг-файл [-z сервер] [-p порт] [-I IP-адрес]
[-t тайм-аут] [-s узел-сети] --tls-connect psk --tls-psk-identity
идентификатор-PSK --tls-psk-file PSK-файл [--tls-cipher13 строка-шифра]
[--tls-cipher строка-шифра] -k ключ -o значение
zabbix_sender [-v] -c конфиг-файл [-z сервер] [-p порт] [-I IP-адрес]
[-t тайм-аут] [-s узел-сети] --tls-connect psk --tls-psk-identity
идентификатор-PSK --tls-psk-file PSK-файл [--tls-cipher13 строка-шифра]
[--tls-cipher строка-шифра] [-T] [-N] [-r] -i входной-файл
zabbix_sender -h
zabbix_sender -V
ОПИСАНИЕ
zabbix_sender — это утилита командной строки для отправки данных
мониторинга на Zabbix сервер или прокси. На Zabbix сервере должен
быть создан элемент данных с типом «Zabbix траппер (Zabbix trapper)»
и соответствующим ключом. Обратите внимание, что поступающие
значения будут приниматься только от хостов, указанных в поле
«Разрешённые хосты (Allowed hosts)» этого элемента данных.
ПАРАМЕТРЫ
-c, --config конфиг-файл
Использовать конфиг-файл. Zabbix sender читает подробности сервера
из конфигурационного файла agentd. По умолчанию, Zabbix sender не
читает какие-либо конфиг-файлы. Поддерживаются только параметры
Hostname, ServerActive, SourceIP, TLSConnect, TLSCAFile, TLSCRLFile,
TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile, TLSKeyFile,
TLSPSKIdentity и TLSPSKFile. Имя узла сети, определённое посредством
параметра HostnameItem, не подхватится, в таком случае имя узла сети
должно быть указано посредством командной строки (смотрите опцию
-s). Для отсылки данных будут использованы все адреса, определённые
в параметре конфигурации агента ServerActive. Если отправка партии
данных на один из адресов завершается ошибкой, тогда следующие
партии данных отправляться на этот адрес не будут.
-z, --zabbix-server сервер
Имя хоста или IP адрес Zabbix сервера. Если узел сети контролируется
через прокси, вместо этого следует указать имя хоста или IP адрес прокси.
При использовании совместно с опцией --config, переопределяет
значение параметра ServerActive, указанное в файле конфигурации agentd.
-p, --port порт
Указать номер порта траппера, работающего на Zabbix сервере.
По умолчанию: 10051. При использовании совместно с опцией
--config, переопределяет номер порта в значении параметра
ServerActive, указанном в файле конфигурации agentd.
-I, --source-address IP-адрес
Указать исходящий IP адрес. При использовании совместно
с опцией --config, переопределяет значение параметра SourceIP,
указанное в файле конфигурации agentd.
-t, --timeout секунд
Указать время ожидания. Допустимый диапазон: 1-300 секунд
(по умолчанию: 60)
-s, --host узел-сети
Указать имя узла сети, к которому относится элемент данных (как
зарегистрировано в веб-интерфейсе Zabbix). IP-адрес и DNS-имя
узла сети работать не будут. При использовании совместно с опцией
--config, переопределяет значение параметра Hostname, указанное
в файле конфигурации agentd.
-k, --key ключ
Указать ключ элемента данных, для которого отсылается значение.
-o, --value значение
Указать значение элемента данных.
-i, --input-file входной-файл
Загрузить значения из входного файла. Укажите «-» в качестве
<входного файла>, чтобы читать значения из стандартного ввода
(stdin). Каждая строка файла содержит разделённые пробелом:
<имя-узла-сети> <ключ> <значение>. Каждое значение должно быть
указано на отдельной строке. Каждая строка должна содержать три
поля через пробел: <имя-узла-сети> <ключ> <значение>, где
«имя-узла-сети» — это имя отслеживаемого узла сети в том виде,
как он зарегистрирован в веб-интерфейсе Zabbix, «ключ» — ключ
целевого элемента данных, а «значение» — отсылаемое значение.
Укажите «-» в поле <имя-узла-сети>, чтобы использовать имя узла
сети, заданное файлом конфигурации агента либо аргументом --host.
Пример строки входного файла:
"Linux DB3" db.connections 43
В настройках элемента данных в веб-интерфейсе Zabbix должен
быть правильно указан тип значения. Zabbix sender будет отсылать
до 250 значений за одно соединение. Содержимое входного файла
должно быть в кодировке UTF-8. Все значения из входного файла
пересылаются в последовательном порядке сверху-вниз. Поля
должны быть отформатированы с использованием следующих правил:
• Поддерживаются как заключённые в кавычки поля, так и поля без кавычек.
• Для кавычек используется символ двойных кавычек (").
• Поля, содержащие пробелы, должны быть обрамлены кавычками.
• Символы двойных кавычек и обратной косой черты внутри
закавыченного поля должны экранироваться символом
обратной косой черты.
• Экранирование не поддерживается в полях, не заключённых в кавычки.
• Экранированная последовательность перевода строки (\n)
поддерживается в строках, заключённых в кавычки.
• Экранированные последовательности перевода строки из концов полей
обрезаются.
-T, --with-timestamps
Эта опция может использоваться только совместно с опцией --input-file.
Каждая строка входного файла должна содержать 4 разделённых пробелом
поля: <имя-узла-сети> <ключ> <таймстэмп> <значение>. Отметка времени (таймстэмп)
должна быть указана в формате Unix timestamp. Если целевой элемент данных имеет
ссылающиеся на него триггеры, все таймстэмпы должны следовать в возрастающем
порядке, в противном случае вычисление событий будет неправильным.
Пример строки входного файла:
"Linux DB3" db.connections 1429533600 43
Для дополнительной информации, пожалуйста, смотрите опцию --input-file.
Если снабжённое отметкой времени значение отсылается на узел сети, находящийся
в режиме обслуживания с типом «без сбора данных», то это значение будет отброшено;
однако, можно отослать значение, снабжённое отметкой времени истекшего периода
обслуживания, и оно будет принято.
-N, --with-ns
Эта опция может использоваться только совместно с опцией --with-timestamps.
Каждая строка входного файла должна содержать 4 разделённых пробелом
поля: <имя-узла-сети> <ключ> <таймстэмп> <ns> <значение>.
Пример строки входного файла:
"Linux DB3" db.connections 1429533600 7402561 43
Для дополнительной информации, пожалуйста, смотрите опцию --input-file.
-r, --real-time
Отсылать значения по одному, как только они получены. Это может быть
использовано при чтении из стандартного ввода (stdin).
--tls-connect значение
Как подключаться к серверу или прокси. Значения:
unencrypted
подключаться без шифрования (по умолчанию)
psk подключаться с использованием TLS и общего ключа (pre-shared
key, PSK)
cert подключаться с использованием TLS и сертификата
--tls-ca-file CA-файл
Полный путь к файлу, содержащему сертификаты CA верхнего уровня
для проверки сертификата партнёра.
--tls-crl-file CRL-файл
Полный путь к файлу, содержащему отозванные сертификаты.
--tls-server-cert-issuer эмитент
Разрешённый эмитент сертификата сервера.
--tls-server-cert-subject субъект
Разрешённый субъект сертификата сервера.
--tls-cert-file cert-файл
Полный путь к файлу, содержащему сертификат или
цепочку сертификатов.
--tls-key-file key-файл
Полный путь к файлу, содержащему закрытый ключ (private key).
--tls-psk-identity идентификатор-PSK
Строка, используемая для идентификации общего ключа (PSK).
--tls-psk-file PSK-файл
Полный путь к файлу, содержащему общий ключ (pre-shared key).
--tls-cipher13 строка-шифра
Строка шифра для OpenSSL 1.1.1 или новее для TLS 1.3. Переопределить
критерии выбора набора шифров по умолчанию. Эта опция недоступна,
если версия OpenSSL ниже 1.1.1.
--tls-cipher строка-шифра
Строка приоритета 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)