zabbix_sender

ZABBIX_SENDER(1)            Руководство по общим командам           ZABBIX_SENDER(1)

ИМЯ
       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] -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-iden‐
       tity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-ci‐
       pher 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-iden‐
       tity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-ci‐
       pher cipher-string] [-T] [-N] [-r] -i input-file
       zabbix_sender -h
       zabbix_sender -V

ОПИСАНИЕ
       zabbix_sender - это утилита командной строки для отправки данных
       мониторинга на сервер Zabbix или прокси. На сервере Zabbix должен быть
       создан элемент данных типа Zabbix trapper с соответствующим ключом.
       Обратите внимание, что входящие значения будут приниматься только от
       узлов сети, указанных в поле Allowed hosts для этого элемента данных.

ПАРАМЕТРЫ
       -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). Для отправки данных используются все адреса,
              заданные в конфигурационном параметре agent ServerActive. Если
              отправка пакетных данных на один адрес завершается неудачей,
              последующие пакеты на этот адрес не отправляются.

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

       -p, --port port
              Указать номер порта Zabbix trapper, работающего на сервере.
              По умолчанию 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>,
              чтобы использовать имя узла сети из файла конфигурации agent или
              из аргумента --host.

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

               "Linux DB3" db.connections 43

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

                     • Поддерживаются записи в кавычках и без кавычек.

                     • Символом кавычек является двойная кавычка.

                     • Записи, содержащие пробелы, должны быть заключены в
                       кавычки.

                     • Символы двойной кавычки и обратной косой черты внутри
                       записи в кавычках должны экранироваться обратной косой
                       чертой.

                     • Экранирование не поддерживается в записях без кавычек.

                     • Последовательности экранирования перевода строки (\n)
                       поддерживаются в строках в кавычках.

                     • Последовательности экранирования перевода строки
                       удаляются с конца записи.

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

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

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

               "Linux DB3" db.connections 1429533600 43

              Дополнительные сведения см. в описании параметра --input-file.

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

       -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 value
              Способ подключения к серверу или прокси. Значения:

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

                   psk         подключение с использованием TLS и
                               предварительно разделенного ключа

                   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
              Полный путь к файлу, содержащему предварительно разделенный ключ.

       --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, заданные в файле конфигурации agent.

       zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitored Host"  -k
       mysql.queries -o 342.45
              Отправить 342.45 как значение элемента данных mysql.queries
              узла сети Monitored Host, используя сервер Zabbix, заданный в
              файле конфигурации agent.

       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, указанный в файле конфигурации agent. Дефис во
              входных данных означает, что имя хоста также должно быть взято
              из того же файла конфигурации.

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

СМ. ТАКЖЕ
       Documentation

       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)