Šajā lapā
zabbix_sender
ZABBIX_SENDER(1) Vispārīgo komandu rokasgrāmata ZABBIX_SENDER(1)
NOSAUKUMS
zabbix_sender - Zabbix sūtītāja utilīta
KOPSAVILKUMS
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
APRAKSTS
zabbix_sender ir komandrindas utilīta uzraudzības datu nosūtīšanai
Zabbix serverim vai starpniekserverim. Zabbix serverī jāizveido
vienums ar tipu Zabbix trapper un atbilstošo atslēgu. Ņemiet vērā, ka
ienākošās vērtības tiks pieņemtas tikai no hosts, kas šim vienumam
norādīti laukā Allowed hosts.
OPCIJAS
-c, --config config-file
Izmanto config-file. Zabbix sender nolasa servera informāciju no
agentd konfigurācijas faila. Pēc noklusējuma Zabbix sender
nelasa nevienu konfigurācijas failu. Tiek atbalstīti tikai
parametri Hostname, ServerActive, SourceIP, TLSConnect,
TLSCAFile, TLSCRLFile, TLSServerCertIssuer,
TLSServerCertSubject, TLSCertFile, TLSKeyFile, TLSPSKIdentity
un TLSPSKFile. Hostname, kas definēts, izmantojot parametru
HostnameItem, netiks izmantots; šādā gadījumā hosts jānorāda
komandrindā (skatiet opciju -s). Datu nosūtīšanai tiek izmantotas
visas adreses, kas definētas aģenta ServerActive konfigurācijas
parametrā. Ja pakešu datu nosūtīšana uz vienu adresi neizdodas,
nākamās paketes uz šo adresi netiek nosūtītas.
-z, --zabbix-server server
Zabbix servera resursdatora nosaukums vai IP adrese. Ja hosts tiek
uzraudzīts, izmantojot starpniekserveri, tā vietā jāizmanto
starpniekservera resursdatora nosaukums vai IP adrese. Izmantojot
kopā ar --config, tiek ignorēti ServerActive parametra ieraksti,
kas norādīti agentd konfigurācijas failā.
-p, --port port
Norāda Zabbix servera trapper porta numuru. Noklusējuma vērtība
ir 10051. Izmantojot kopā ar --config, tiek ignorēti ServerActive
parametra porta ieraksti, kas norādīti agentd konfigurācijas failā.
-I, --source-address IP-address
Norāda avota IP adresi. Izmantojot kopā ar --config, tiek ignorēts
SourceIP parametrs, kas norādīts agentd konfigurācijas failā.
-t, --timeout seconds
Norāda taimautu. Derīgais diapazons: 1-300 sekundes
(noklusējuma vērtība: 60).
-s, --host host
Norāda tā host nosaukumu, kuram pieder vienums (kā tas reģistrēts
Zabbix lietotāja saskarnē). Host IP adrese un DNS nosaukums
nedarbosies. Izmantojot kopā ar --config, tiek ignorēts Hostname
parametrs, kas norādīts agentd konfigurācijas failā.
-k, --key key
Norāda vienuma atslēgu, uz kuru nosūtīt vērtību.
-o, --value value
Norāda vienuma vērtību.
-i, --input-file input-file
Ielādē vērtības no ievades faila. Norādiet - kā <input-file>, lai
nolasītu vērtības no standarta ievades. Katrā faila rindā ir ar
atstarpēm atdalīti elementi: <hostname> <key> <value>. Katra
vērtība jānorāda atsevišķā rindā. Katrā rindā jābūt 3 ar atstarpēm
atdalītiem ierakstiem: <hostname> <key> <value>, kur "hostname"
ir uzraudzītā host nosaukums, kā tas reģistrēts Zabbix lietotāja
saskarnē, "key" ir mērķa vienuma atslēga, bet "value" ir
nosūtāmā vērtība. Norādiet - kā <hostname>, lai izmantotu host
nosaukumu no aģenta konfigurācijas faila vai argumenta --host.
Ievades faila rindas piemērs:
"Linux DB3" db.connections 43
Vērtības tipam jābūt pareizi iestatītam Zabbix lietotāja
saskarnes vienuma konfigurācijā. Zabbix sender vienā savienojumā
nosūtīs līdz 250 vērtībām. Ievades faila saturam jābūt UTF-8
kodējumā. Visas ievades faila vērtības tiek nosūtītas secīgi no
augšas uz leju. Ieraksti jāformatē, ievērojot šādus noteikumus:
• Tiek atbalstīti ieraksti pēdiņās un bez pēdiņām.
• Pēdiņas ir dubultpēdiņas.
• Ieraksti, kuros ir atstarpes, jāiekļauj pēdiņās.
• Dubultpēdiņas un slīpsvītras rakstzīmes ierakstā, kas
atrodas pēdiņās, jāekranē ar slīpsvītru.
• Ierakstos bez pēdiņām ekranēšana netiek atbalstīta.
• Rindas padeves ekranēšanas secības (\n) tiek atbalstītas
virknēs pēdiņās.
• Rindas padeves ekranēšanas secības tiek noņemtas no
ieraksta beigām.
-T, --with-timestamps
Šo opciju var izmantot tikai kopā ar opciju --input-file.
Katrā ievades faila rindā jābūt 4 ar atstarpēm atdalītiem
ierakstiem: <hostname> <key> <timestamp> <value>. Laikspiedogs
jānorāda Unix laikspiedoga formātā. Ja uz mērķa vienumu attiecas
trigeri, visiem laikspiedogiem jābūt augošā secībā; pretējā
gadījumā notikumu aprēķins nebūs pareizs.
Ievades faila rindas piemērs:
"Linux DB3" db.connections 1429533600 43
Papildinformāciju skatiet opcijas --input-file aprakstā.
Ja vērtība ar laikspiedogu tiek nosūtīta hostam, kas atrodas
uzturēšanas režīmā “no data”, šī vērtība tiks atmesta; tomēr
vērtību ar laikspiedogu var nosūtīt par beigušos uzturēšanas
periodu, un tā tiks pieņemta.
-N, --with-ns
Šo opciju var izmantot tikai kopā ar opciju --with-timestamps.
Katrā ievades faila rindā jābūt 5 ar atstarpēm atdalītiem
ierakstiem: <hostname> <key> <timestamp> <ns> <value>.
Ievades faila rindas piemērs:
"Linux DB3" db.connections 1429533600 7402561 43
Papildinformāciju skatiet opcijas --input-file aprakstā.
-r, --real-time
Nosūta vērtības pa vienai, tiklīdz tās tiek saņemtas. To var
izmantot, nolasot datus no standarta ievades.
--tls-connect value
Kā izveidot savienojumu ar serveri vai starpniekserveri. Vērtības:
unencrypted
izveidot savienojumu bez šifrēšanas
(noklusējuma vērtība)
psk izveidot savienojumu, izmantojot TLS un iepriekš
koplietotu atslēgu
cert izveidot savienojumu, izmantojot TLS un
sertifikātu
--tls-ca-file CA-file
Pilns ceļš uz failu, kurā ir augstākā līmeņa CA sertifikāti
partnera sertifikāta pārbaudei.
--tls-crl-file CRL-file
Pilns ceļš uz failu, kurā ir atsauktie sertifikāti.
--tls-server-cert-issuer cert-issuer
Atļautais servera sertifikāta izdevējs.
--tls-server-cert-subject cert-subject
Atļautais servera sertifikāta subjekts.
--tls-cert-file cert-file
Pilns ceļš uz failu, kurā ir sertifikāts vai sertifikātu ķēde.
--tls-key-file key-file
Pilns ceļš uz failu, kurā ir privātā atslēga.
--tls-psk-identity PSK-identity
PSK-identity virkne.
--tls-psk-file PSK-file
Pilns ceļš uz failu, kurā ir iepriekš koplietotā atslēga.
--tls-cipher13 cipher-string
Šifru virkne OpenSSL 1.1.1 vai jaunākai versijai TLS 1.3
lietošanai. Ignorē noklusējuma šifru komplekta atlases kritērijus.
Šī opcija nav pieejama, ja OpenSSL versija ir vecāka par 1.1.1.
--tls-cipher cipher-string
GnuTLS prioritāšu virkne (TLS 1.2 un jaunākām versijām) vai
OpenSSL šifru virkne (tikai TLS 1.2). Ignorē noklusējuma šifru
komplekta atlases kritērijus.
-v, --verbose
Detalizētais režīms; -vv sniedz vēl vairāk informācijas.
-h, --help
Parāda šo palīdzību un iziet.
-V, --version
Izvada informāciju par versiju un iziet.
IZIETES STATUSS
Izejas statuss ir 0, ja vērtības tika nosūtītas un serveris tās visas
veiksmīgi apstrādāja. Ja dati tika nosūtīti, bet vismaz vienas vērtības
apstrāde neizdevās, izejas statuss ir 2. Ja datu nosūtīšana neizdevās,
izejas statuss ir 1.
PIEMĒRI
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -k mysql.queries -o
342.45
Nosūta 342.45 kā uzraudzītā host mysql.queries vienuma vērtību.
Izmanto uzraudzīto host un Zabbix serveri, kas definēti aģenta
konfigurācijas failā.
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitored Host" -k
mysql.queries -o 342.45
Nosūta 342.45 kā Monitored Host host mysql.queries vienuma
vērtību, izmantojot Zabbix serveri, kas definēts aģenta
konfigurācijas failā.
zabbix_sender -z 192.168.1.113 -i data_values.txt
Nosūta vērtības no faila data_values.txt Zabbix serverim ar IP
adresi 192.168.1.113. Host nosaukumi un atslēgas ir definēti
failā.
echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix_sender -c
/usr/local/etc/zabbix_agentd.conf -T -i -
Nosūta vērtību ar laikspogu no komandrindas Zabbix serverim, kas
norādīts aģenta konfigurācijas failā. Defise ievades datos
norāda, ka host nosaukums jāizmanto no tā paša konfigurācijas
faila.
echo '"Zabbix server" trapper.item ""' | zabbix_sender -z 192.168.1.113
-p 10000 -i -
Nosūta tukšu vienuma vērtību Zabbix serverim ar IP adresi
192.168.1.113, izmantojot 10000. portu, no komandrindas. Tukšas
vērtības jānorāda ar tukšām dubultpēdiņām.
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
Nosūta 342.45 kā mysql.queries vienuma vērtību Monitored Host
host serverim ar IP adresi 192.168.1.113, izmantojot TLS ar
sertifikātu.
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
Nosūta 342.45 kā mysql.queries vienuma vērtību Monitored Host
host serverim ar IP adresi 192.168.1.113, izmantojot TLS ar
iepriekš koplietotu atslēgu (PSK).
SKATIET ARĪ
Dokumentācija
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)