Table of Contents

zabbix_sender

zabbix_sender

Раздел: Пользовательские команды (1)
Обновлено: 01.06.2021
Index Вернуться к основному содержанию

НАИМЕНОВАНИЕ

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-identity --tls-psk-file PSK-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 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 -h
zabbix_sender -V

ОПИСАНИЕ

zabbix_sender - это утилита командной строки для отправки значений мониторинга Zabbix серверу или Zabbix прокси. На Zabbix сервере должен быть создан элемент данных типа Zabbix траппер с соответствующим ключом. Обратите внимание, что входящие данные будут приняты только от узлов сети, указанных в поле Разрешенные хосты для этого элемента данных.

ПАРАМЕТРЫ

-c, --config config-file · Используйте config-file. Zabbix sender считывает сведения о сервере из файла конфигурации agentd. По умолчанию Zabbix sender не читает ни один конфигурационный файл. Только параметры Hostname, ServerActive, SourceIP, TLSConnect, TLSCAFile, TLSCRLFile, TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile, Поддерживаются TLSKeyFile, TLSPSKIdentity** и TLSPSKFile. Все адреса, определенные в параметре конфигурации агента ServerActive используются для отправки данных. Если отправка пакетных данных не удается на один адрес, следующие пакеты не отправляются на этот адрес.

-z, --zabbix-server сервер · Имя хоста или IP-адрес сервера Zabbix. Если хост контролируется прокси-сервером , вместо него следует использовать имя хоста прокси-сервера или IP-адрес. При использовании вместе с --config переопределяет запись параметраServerActive указанного в файле конфигурации agentd.

-p, --port port · Укажите номер порта траппера Zabbix сервера, запущенного на сервере. Значение по умолчанию - 10051. При использовании вместе с --config переопределяет записи port параметра 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 входной файл · Загружайте значения из входного файла. Укажите - как <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) поддерживаются в строках, заключенных в кавычки.

• · Экранирующие последовательности перевода строки обрезаются с конца записи.

-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 значение · Как подключиться к серверу или прокси-серверу. Значение:

· unencrypted · подключаться без шифрования (по умолчанию)

· psk · подключение с использованием TLS и pre-shared key

· cert · подключение с использованием TLS и сертификата

--tls-ca-file CA-file · Полный путь к файлу, содержащему корневые CA сертификаты для проверки однорангового сертификата.

--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 · Полный путь к файлу, содержащему pre-shared key.

--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 "Наблюдаемый узел сети" -k mysql.queries -o 342.45

· Отправьте 342.45 в качестве значения для элемента данных mysql.queries Наблюдаемый узел сети Будет использованы отслеживаемый узел сети и сервер 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 сервер" 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 "Наблюдаемый узел" -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 в Наблюдаемый узел хост-сервер с IP-адресом 192.168.1.113 с использованием TLS сертификат.

zabbix_sender -z 192.168.1.113 -s "Наблюдаемый узел" -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 в Наблюдаемый узел хост-сервер с IP-адресом 192.168.1.113 с использованием TLS и pre-shared key (PSK).

СМОТРИТЕ ТАКЖЕ

Документация https://www.zabbix.com/manuals

zabbix_agentd(8), zabbix_get(1), zabbix_proxy(8), zabbix_server(8), zabbix_js(1), zabbix_agent2(8), zabbix_web_service(8)

АВТОР

Alexei Vladishev <[email protected]>

Documentation

zabbix_sender

НАИМЕНОВАНИЕ

СИНТАКСИС

ОПИСАНИЕ

ПАРАМЕТРЫ

СТАТУС ЗАВЕРШЕНИЯ

ПРИМЕРЫ

СМОТРИТЕ ТАКЖЕ

АВТОР

Оглавление