На странице
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] -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» с соответствующим ключом.
Обратите внимание, что входящие значения будут приниматься только от
узлов сети, указанных в поле «Разрешённые узлы сети» для этого элемента
данных.
ПАРАМЕТРЫ
-c, --config config-file
Использовать config-file. zabbix_sender считывает сведения о
сервере из конфигурационного файла agentd. Агент не должен быть
запущен, чтобы zabbix_sender мог отправлять данные. По умолчанию
zabbix_sender не считывает никакие конфигурационные файлы.
Поддерживаются только параметры Hostname, ServerActive,
SourceIP, TLSConnect, TLSCAFile, TLSCRLFile,
TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile,
TLSKeyFile, TLSPSKIdentity и TLSPSKFile. Значение Hostname,
заданное через параметр 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
значений за одно соединение. Содержимое входного файла должно
быть в кодировке UTF-8. Все значения из входного файла
отправляются последовательно, сверху вниз. Записи должны быть
отформатированы по следующим правилам:
• Поддерживаются записи в кавычках и без кавычек.
• Для заключения в кавычки используются двойные кавычки.
• Записи, содержащие пробелы, должны быть заключены в кавычки.
• Символы двойных кавычек и обратной косой черты внутри
записи в кавычках должны экранироваться обратной косой
чертой.
• Экранирование не поддерживается в записях без кавычек.
• В строках в кавычках поддерживаются escape-последовательности
перевода строки (\n).
• Escape-последовательности перевода строки удаляются из
конца записи.
-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 value
Способ подключения к серверу или прокси. Значения:
unencrypted
подключаться без шифрования (по умолчанию)
psk подключаться с использованием TLS и
предварительно установленного ключа
cert подключаться с использованием TLS и сертификата
--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-psk-identity PSK-identity
Строка идентификатора PSK. Должна совпадать с идентификатором
PSK, заданным для узла сети в веб-интерфейсе Zabbix.
--tls-psk-file PSK-file
Полное имя файла, содержащего предварительно установленный ключ.
Ключ в этом файле должен совпадать со значением PSK, заданным
для узла сети в веб-интерфейсе Zabbix.
--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 zabbix.trapper -o
342.45
Отправить 342.45 в качестве значения элемента данных
zabbix.trapper контролируемого узла сети. Использовать
контролируемый узел сети и сервер Zabbix, заданные в
конфигурационном файле агента.
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitored Host" -k
zabbix.trapper -o 342.45
Отправить 342.45 в качестве значения элемента данных
zabbix.trapper узла сети Monitored Host, используя сервер 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 server" zabbix.trapper ""' | 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 zabbix.trapper -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 в качестве значения элемента данных
zabbix.trapper узла сети Monitored Host на сервер с IP-адресом
192.168.1.113, используя TLS с сертификатом.
zabbix_sender -z 192.168.1.113 -s "Monitored Host" -k zabbix.trapper -o
342.45 --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd"
--tls-psk-file /home/zabbix/zabbix_agentd.psk
Отправить 342.45 в качестве значения элемента данных
zabbix.trapper узла сети Monitored Host на сервер с IP-адресом
192.168.1.113, используя TLS с предварительно установленным
ключом (PSK).
СМ. ТАКЖЕ
Документация
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)