Table of Contents

zabbix_sender

zabbix_sender

Секција: Корисничке команде (1)
Ажурирано: 2021-06-01
Index Return to Main Contents ------------------------------------------------------------------------

НАЗИВ

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-identity --tls-psk-file PSK-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 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 -h
zabbix_sender -V

ОПИС

zabbix_sender је алат командне линије за слање података о надгледању на Zabbix сервер или прокси. На Zabbix серверу треба се направити ставка типа Zabbix trapper са одговарајућим кључeм. Обратите пажњу, да ће долазне вредности бити прихваћене само од домаћина наведених у 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). Све адресе дефинисане у конфигурационом параметру агента ServerActive се користе за слање података. Ако слање серије података не успе на једну адресу, следеће серије се не шаљу на ту адресу.

-z, --zabbix-server server Име домаћина или IP адреса Zabbix сервера. Ако је домаћин надгледан преко проксија, треба користити име домаћина проксија или IP адресу проксија. Када се користи заједно са --config, надјачава уносе параметра ServerActive наведеног у agentd конфигурационој датотеци.

-p, --port port Наведите број порта на коме ради Zabbix server 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> да бисте користили име домаћина од агента конфигурационе датотеке или из аргумента --host.

Пример линије кода улазне датотеке:

"Linux DB3" db.connections 43

Тип вредности мора бити исправно подешен у конфигурацији ставке Zabbix корисничког интерфејса. Zabbix пошиљалац ће послати до 250 вредности у једној вези. Size limit за слање вредности из улазне датотеке зависи од величине описане у Zabbix комуникационом протоколу. Садржај улазне датотеке мора бити у UTF-8 енкодирању. Све вредности из улазне датотеке се шаљу узастопним редоследом одозго надоле. Уноси морају бити форматирани према следећим правилима:

Подржани су цитирани и нецитирани уноси.
Двоструки наводник је знак за цитирање.
Уноси са размацима морају бити цитирани.
Двоструки наводник и обрнута коса црта унутар цитираних уноса морају бити избегнути обрнутом косом цртом.
Излаз није подржан у уносима који нису цитирани.
Излазне секвенце за прелазак у нови ред (\n) су подржане у стринговима под наводницима.
Излазне секвенце за прелазак у нови ред се скраћују са краја уноса.

-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 Потпуна путања ка датотеци, која садржи 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 сервер дефинисан у конфигурационој датотеци агента.

zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitored Host" -k mysql.queries -o 342.45

Пошаљи 342.45 као вредност за mysql.queries ставку 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" 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).