Table of Contents

zabbix_sender

zabbix_sender

Раздел: Пользовательские команды (1)
Обновлено: 2021-06-01
Оглавление Вернуться на главную

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

zabbix_sender - утилита Zabbix для отправки метрик

СИНТАКСИС

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 config-file [-z сервер] [-p порт] [-I IP-адрес] [-t тайм-аут] [-s узел-сети] -k ключ -o значение
zabbix_sender [-v] -c config-file [-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-file [--tls-crl-file CRL-file] [--tls-server-cert-issuer эмитент] [--tls-server-cert-subject субъект] --tls-cert-file cert-file --tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k ключ -o значение
zabbix_sender [-v] -z сервер [-p порт] [-I IP-адрес] [-t тайм-аут] [-s узел-сети] --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-server-cert-issuer эмитент] [--tls-server-cert-subject субъект] --tls-cert-file cert-file --tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] [-T] [-N] [-r] -i входной-файл
zabbix_sender [-v] -c config-file [-z сервер] [-p порт] [-I IP-адрес] [-t тайм-аут] [-s узел-сети] --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-server-cert-issuer эмитент] [--tls-server-cert-subject субъект] --tls-cert-file cert-file --tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k ключ -o значение
zabbix_sender [-v] -c config-file [-z сервер] [-p порт] [-I IP-адрес] [-t тайм-аут] [-s узел-сети] --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-server-cert-issuer эмитент] [--tls-server-cert-subject субъект] --tls-cert-file cert-file --tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] [-T] [-N] [-r] -i входной-файл
zabbix_sender [-v] -z сервер [-p порт] [-I IP-адрес] [-t тайм-аут] -s узел-сети --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k ключ -o значение
zabbix_sender [-v] -z сервер [-p порт] [-I IP-адрес] [-t тайм-аут] [-s узел-сети] --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 входной-файл
zabbix_sender [-v] -c config-file [-z сервер] [-p порт] [-I IP-адрес] [-t тайм-аут] [-s узел-сети] --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k ключ -o значение
zabbix_sender [-v] -c config-file [-z сервер] [-p порт] [-I IP-адрес] [-t тайм-аут] [-s узел-сети] --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 входной-файл
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 порт
Укажите номер порта траппера 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 входной-файл
Загрузить значения из входного файла. Укажите «-» (знак минуса) как <input-file>, чтобы считывать значения из стандартного ввода. Каждая строка файла содержит разделённые пробелом: <узел-сети> <ключ> <значение>. Каждое значение должно быть указано в отдельной строке. Каждая строка должна содержать 3 разделённых пробелом поля: <узел-сети> <ключ> <значение>, где «узел-сети» - это имя отслеживаемого узла сети, как зарегистрировано в веб-интерфейсе Zabbix, «ключ» - это ключ целевого элемента, а «значение» - значение для отправки. Укажите «-» (знак минуса) в качестве значения поля <узел-сети>, чтобы использовать имя узла сети из файла конфигурации агента или из аргумента --host.

Пример строки входного файла:

"Linux DB3" db.connections 43

Тип значения должен быть правильно задан в настройках элемента данных в веб-интерфейсе Zabbix. Zabbix sender отправит до 250 значений за одно соединение. Ограничение размера для отсылаемых данных из входного файла зависит от размера, описанного в протоколе коммуникации Zabbix. Содержимое входного файла должно быть в кодировке UTF-8. Все значения из входного файла отправляются последовательно сверху вниз. Записи должен быть отформатированы, используя следующие правила:

Поддерживаются записи в кавычках и без кавычек.
Двойная кавычка - это символ, заключающий в кавычки.
Поля с пробелами должны быть заключены в кавычки.
Символы двойных кавычек и обратной косой черты внутри заключённой в кавычки записи должны быть экранированы обратной косой чертой (обратный слэш).
Экранирование не поддерживается в записях без кавычек.
Escape-последовательности перевода строки (\n) поддерживаются в строках, заключённых в кавычки.
Экранирующие последовательности перевода строки обрезаются с конца записи.

-T, --with-timestamps
Этот параметр можно использовать только с параметром --input-file.

Каждая строка входного файла должна содержать 4 разделённых пробелами поля: <узел-сети> <ключ> <метка-времени> <значение>. <Метка-времени> должна быть указана в формате Unix timestamp. Если целевой элемент данных имеет триггеры, ссылающиеся на него, то все метки времени должны быть в порядке возрастания, в противном случае вычисление событий будет неправильным.

Пример строки входного файла:

"Linux DB3" db.connections 1429533600 43

Для получения более подробной информации, пожалуйста, смотрите опцию --input-file.

Если значение с меткой времени отправляется для хоста, который находится в обслуживании с типом “без данных”, то это значение будет отброшено; однако, возможно отправить значение с меткой времени для истекшего периода обслуживания, и оно будет принято.

-N, --with-ns
Этот параметр можно использовать только с параметром --with-timestamps.

Каждая строка входного файла должна содержать 5 полей, разделённых пробелами: <узел-сети> <ключ> <метка-времени> <наносекунды> <значение>.

Пример строки входного файла:

"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 эмитент
Разрешённый эмитент сертификата сервера.

--tls-server-cert-subject субъект
Разрешённый субъект сертификата сервера.

--tls-cert-file cert-file
Полный путь к файлу, содержащему сертификат или цепочку сертификатов.

--tls-key-file key-file
Полный путь к файлу, содержащему закрытый ключ (private key).

--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 в Наблюдаемый узел на Zabbix сервер с 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 в Наблюдаемый узел на Zabbix сервер с 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)

АВТОР

Алексей Владышев <[email protected]>

Documentation

zabbix_sender

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

СИНТАКСИС

ОПИСАНИЕ

ПАРАМЕТРЫ

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

ПРИМЕРЫ

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

АВТОР

Оглавление