База знаний
Войти

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

Параметры:

  • -c, --config config-file – использование файла конфигурации config-file. Sender считывает сведения о Сервере из файла конфигурации agentd. По умолчанию sender не читает ни один конфигурационный файл. Поддерживаются только параметры Hostname, ServerActive, SourceIP, TLSConnect, TLSCAFile, TLSCRLFile, TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile, TLSKeyFile, TLSPSKIdentity и TLSPSKFile. Все адреса, определенные в параметре конфигурации Агента ServerActive, используются для отправки данных. Если отправка пакетных данных на один адрес не удается, следующие пакеты на этот адрес не отправляются;
  • -z, --zabbix-server сервер – имя хоста или IP-адрес Сервера. Если узел сети контролируется Прокси-сервером, вместо него следует использовать имя хоста или IP-адрес Прокси-сервера. При использовании вместе с --config переопределяет запись параметра ServerActive, указанного в файле конфигурации agentd;
  • -p, --port порт – номер порта траппера Сервера, запущенного на Сервере. Значение по умолчанию – 10051. При использовании вместе с --config переопределяет значение порта параметра ServerActive, указанного в файле конфигурации agentd;
  • -I, --source-address IP-адрес – исходящий IP-адрес. При использовании вместе с --config, переопределяет параметр SourceIP, указанный в файле конфигурации agentd;
  • -t, --Timeout тайм-аут – время ожидания (тайм-аут). Допустимый диапазон: 1-300 секунд (по умолчанию: 60);
  • -s, --host узел-сети – имя узла сети, которому принадлежит элемент данных (как зарегистрировано в веб-интерфейсе). IP-адрес хоста и DNS-имя работать не будут. При использовании вместе с --config, переопределяет параметр Hostname, указанный в файле конфигурации agentd;
  • -k, --key ключ – ключ элемента данных для отправки значения;
  • -o, --value значение – значение элемента данных;
  • -i, --input-file входной-файл – загрузка значений из входного файла. Указать - (знак минуса) как <input-file>, чтобы считывать значения из стандартного ввода. Каждая строка файла содержит разделенные пробелом <узел-сети> <ключ> <значение>. Каждое значение должно быть указано в отдельной строке. Каждая строка должна содержать 3 разделенных пробелом поля <узел-сети> <ключ> <значение>, где узел-сети – это имя отслеживаемого узла сети, как зарегистрировано в веб-интерфейсе, ключ – это ключ целевого элемента, а значение – значение для отправки. Указать - (знак минуса) в качестве значения поля <узел-сети>, чтобы использовать имя узла сети из файла конфигурации Агента или из аргумента --host.

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

"Linux DB3" db.connections 43

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

  • поддерживаются записи в кавычках и без кавычек;
  • двойная кавычка – это символ, заключающий в кавычки;
  • поля с пробелами должны быть заключены в кавычки;
  • символы двойных кавычек и обратной косой черты внутри заключенной в кавычки записи должны быть экранированы обратной косой чертой (обратный слеш);
  • экранирование не поддерживается в записях без кавычек;
  • Escape-последовательности перевода строки (\n) поддерживаются в строках, заключенных в кавычки;
  • экранирующие последовательности перевода строки обрезаются с конца записи.
  • -T, --with-timestamps – этот параметр можно использовать только с параметром --input-file.

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

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

"Linux DB3" db.connections 1429533600 43

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

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