Š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 uz
Zabbix serveri vai starpniekserveri. Zabbix serverī jāizveido Zabbix
trapper tipa vienums ar atbilstošo atslēgu. Ņemiet vērā, ka ienākošās
vērtības tiks pieņemtas tikai no hostiem, kas šī vienuma laukā Allowed
hosts ir norādīti kā atļautie.
OPCIJAS
-c, --config config-file
Izmanto config-file. Zabbix sūtītājs nolasa servera informāciju
no aģenta konfigurācijas faila. Aģentam nav jādarbojas, lai
zabbix_sender nosūtītu datus. Pēc noklusējuma Zabbix sūtītājs
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 konfigurācijas parametrā
ServerActive. Ja pakešu datu nosūtīšana uz kādu 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, šī opcija aizstāj parametrā ServerActive
aģenta konfigurācijas failā norādītās vērtības.
-p, --port port
Norāda Zabbix servera trapper porta numuru. Noklusējuma vērtība
ir 10051. Izmantojot kopā ar --config, šī opcija aizstāj aģenta
konfigurācijas faila parametrā ServerActive norādītos portus.
-I, --source-address IP-address
Norāda avota IP adresi. Izmantojot kopā ar --config, šī opcija
aizstāj aģenta konfigurācijas failā norādīto parametru SourceIP.
-t, --timeout seconds
Norāda taimautu. Derīgais diapazons: 1-300 sekundes (noklusējuma
vērtība: 60).
-s, --host host
Norāda hosts nosaukumu, kuram pieder vienums (kā tas reģistrēts
Zabbix lietotāja saskarnē). Hosts IP adrese un DNS nosaukums
nedarbosies. Izmantojot kopā ar --config, šī opcija aizstāj aģenta
konfigurācijas failā norādīto parametru Hostname.
-k, --key key
Norāda vienuma atslēgu, kurai 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 elementiem: <hostname> <key> <value>, kur "hostname" ir
uzraudzītā hosts nosaukums, kas 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 hosts 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 sūtītājs 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ņu rakstzīme ir dubultpēdiņa.
• 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 ekrānēšana netiek atbalstīta.
• Pēdiņās iekļautās virknēs tiek atbalstītas rindu pārneses
ekrāna sekvences (\n).
• Rindu pārneses ekrāna sekvences 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
elementiem: <hostname> <key> <timestamp> <value>. Laikspiedogs
jānorāda Unix laikspiedoga formātā. Ja mērķa vienumam ir trigeri,
kas uz to atsaucas, 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
Plašāku informāciju skatiet opcijas --input-file aprakstā.
Ja hosts, kas atrodas uzturēšanas periodā ar tipu “no data”,
saņem vērtību ar laikspiedogu, šī 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
elementiem: <hostname> <key> <timestamp> <ns> <value>.
Ievades faila rindas piemērs:
"Linux DB3" db.connections 1429533600 7402561 43
Plašāku informā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ējums)
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āts(-i)
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. Tai jāatbilst PSK identitātei, kas iestatīta
hostam Zabbix lietotāja saskarnē.
--tls-psk-file PSK-file
Pilns ceļš uz failu, kurā ir iepriekš koplietotā atslēga. Šajā
failā esošajai atslēgai jāatbilst hostam Zabbix lietotāja
saskarnē iestatītajai PSK vērtībai.
--tls-cipher13 cipher-string
Šifru virkne OpenSSL 1.1.1 vai jaunākai versijai TLS 1.3
lietošanai. Aizstāj 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). Aizstāj 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ības informāciju 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 zabbix.trapper -o
342.45
Nosūta 342.45 kā zabbix.trapper vienuma vērtību uzraudzītajam
hostam. Izmanto uzraudzīto hostu un Zabbix serveri, kas definēti
aģenta konfigurācijas failā.
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitored Host" -k
zabbix.trapper -o 342.45
Nosūta 342.45 kā zabbix.trapper vienuma vērtību hostam Monitored
Host, 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 uz Zabbix serveri ar IP
adresi 192.168.1.113. Hostu 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 laikspiedoga vērtību no komandrindas uz Zabbix serveri,
kas norādīts aģenta konfigurācijas failā. Defise ievades datos
norāda, ka hosts nosaukums jāizmanto no tā paša konfigurācijas
faila.
echo '"Zabbix server" zabbix.trapper ""' | zabbix_sender -z 192.168.1.113
-p 10000 -i -
Nosūta tukšu vienuma vērtību no komandrindas uz Zabbix serveri ar
IP adresi 192.168.1.113 un portu 10000. 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 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
Nosūta 342.45 kā zabbix.trapper vienuma vērtību hostam Monitored
Host uz serveri ar IP adresi 192.168.1.113, izmantojot TLS ar
sertifikātu.
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
Nosūta 342.45 kā zabbix.trapper vienuma vērtību hostam Monitored
Host uz serveri 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)