zabbix_sender

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

[ ]{#lbAB}

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

zabbix_sender — утилита Zabbix для отправки метрик [ ]{#lbAC}

СИНТАКСИС

zabbix_sender [-v] -z сервер [-p порт] [-I IP-адрес] [-t тайм-аут] -s узел сети -k ключ -o значение
zabbix_sender [-v] -z сервер [-p порт] [-I IP-адрес] [-t тайм-аут] [-s узел сети] [-T] [-N] [-r] [-g] -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] [-g] -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 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 ключ -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 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] [-g] -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 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 ключ -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 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] [-g] -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] [-g] -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] [-g] -i входной-файл
zabbix_sender -h
zabbix_sender -V [ ]{#lbAD}

ОПИСАНИЕ

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

ПАРАМЕТРЫ

-c, --config config-file
Использовать config-file. Zabbix sender считывает сведения о сервере из файла конфигурации agentd. По умолчанию Zabbix sender не считывает никакой файл конфигурации. Поддерживаются только параметры Hostname, ServerActive, SourceIP, TLSConnect, TLSCAFile, TLSCRLFile, TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile, TLSKeyFile, TLSPSKIdentity и TLSPSKFile. Имя узла сети, заданное через параметр 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 значений в одном соединении. Ограничение размера для отправки значений из входного файла зависит от размера, описанного в протоколе обмена данными Zabbix. Содержимое входного файла должно быть в кодировке UTF-8. Все значения из входного файла отправляются последовательно, сверху вниз. Записи должны быть отформатированы по следующим правилам:

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

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

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

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

"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
Отправлять значения по одному сразу после их получения. Это можно использовать при чтении из стандартного ввода.

-g, --group
Группировать значения по узлам сети и отправлять для каждого узла сети отдельным пакетом.

--tls-connect value
Как подключаться к серверу или прокси. Значения:

[ ]{#lbAF}

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
Вывести информацию о версии и выйти.

[ ]{#lbAG}

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

Статус завершения равен 0, если значения были отправлены и все они были успешно обработаны сервером. Если данные были отправлены, но обработка хотя бы одного из значений не удалась, статус завершения равен 2. Если отправка данных не удалось, статус завершения будет 1.

[ ]{#lbAH}

ПРИМЕРЫ

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).

[ ]{#lbAI}

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

Документация 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) [ ]{#lbAJ}

Оглавление

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

СИНТАКСИС

ОПИСАНИЕ

ПАРАМЕТРЫ

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

ПРИМЕРЫ

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

АВТОР

Этот документ был создан: 11 июня 2021 года, 08:42:39 GMT