zabbix_sender
Sadaļa: Lietotāja komandas (1)
Atjaunināts: 2021-06-01
Index Atgriezties uz galveno saturu
[ ]{#lbAB}
NOSAUKUMS
zabbix_sender - Zabbix nosūtīšanas utilīta [ ]{#lbAC}
KOPSAVILKUMS
zabbix_sender [-v] -z serveris [-p ports] [-I
IP-adrese] [-t taimauts] -s hosts -k atslēga -o
vērtība
zabbix_sender [-v] -z serveris [-p ports] [-I
IP-adrese] [-t taimauts] [-s hosts] [-T]
[-N] [-r] [-g] -i ievades-fails
zabbix_sender [-v] -c config-file [-z serveris]
[-p ports] [-I IP-adrese] [-t taimauts] [-s
hosts] -k atslēga -o vērtība
zabbix_sender [-v] -c config-file [-z serveris]
[-p ports] [-I IP-adrese] [-t taimauts] [-s
hosts] [-T] [-N] [-r] [-g] -i ievades-fails
zabbix_sender [-v] -z serveris [-p ports] [-I
IP-adrese] [-t taimauts] -s hosts --tls-connect
cert --tls-ca-file CA-fails [--tls-crl-file CRL-fails]
[--tls-server-cert-issuer sertifikāta-izdevējs]
[--tls-server-cert-subject sertifikāta-subjekts] --tls-cert-file
sertifikāta-fails --tls-key-file atslēgas-fails [--tls-cipher13
šifra-virkne] [--tls-cipher šifra-virkne] -k atslēga
-o vērtība
zabbix_sender [-v] -z serveris [-p ports] [-I
IP-adrese] [-t taimauts] [-s hosts] --tls-connect
cert --tls-ca-file CA-fails [--tls-crl-file CRL-fails]
[--tls-server-cert-issuer sertifikāta-izdevējs]
[--tls-server-cert-subject sertifikāta-subjekts] --tls-cert-file
sertifikāta-fails --tls-key-file atslēgas-fails [--tls-cipher13
šifra-virkne] [--tls-cipher šifra-virkne] [-T]
[-N] [-r] [-g] -i ievades-fails
zabbix_sender [-v] -c config-file [-z serveris]
[-p ports] [-I IP-adrese] [-t taimauts] [-s
hosts] --tls-connect cert --tls-ca-file CA-fails
[--tls-crl-file CRL-fails] [--tls-server-cert-issuer
sertifikāta-izdevējs] [--tls-server-cert-subject sertifikāta-subjekts]
--tls-cert-file sertifikāta-fails --tls-key-file atslēgas-fails
[--tls-cipher13 šifra-virkne] [--tls-cipher
šifra-virkne] -k atslēga -o vērtība
zabbix_sender [-v] -c config-file [-z serveris]
[-p ports] [-I IP-adrese] [-t taimauts] [-s
hosts] --tls-connect cert --tls-ca-file CA-fails
[--tls-crl-file CRL-fails] [--tls-server-cert-issuer
sertifikāta-izdevējs] [--tls-server-cert-subject sertifikāta-subjekts]
--tls-cert-file sertifikāta-fails --tls-key-file atslēgas-fails
[--tls-cipher13 šifra-virkne] [--tls-cipher
šifra-virkne] [-T] [-N] [-r] [-g] -i ievades-fails
zabbix_sender [-v] -z serveris [-p ports] [-I
IP-adrese] [-t taimauts] -s hosts --tls-connect
psk --tls-psk-identity PSK-identitāte --tls-psk-file
PSK-fails [--tls-cipher13 šifra-virkne] [--tls-cipher
šifra-virkne] -k atslēga -o vērtība
zabbix_sender [-v] -z serveris [-p ports] [-I
IP-adrese] [-t taimauts] [-s hosts] --tls-connect
psk --tls-psk-identity PSK-identitāte --tls-psk-file
PSK-fails [--tls-cipher13 šifra-virkne] [--tls-cipher
šifra-virkne] [-T] [-N] [-r] [-g] -i ievades-fails
zabbix_sender [-v] -c config-file [-z serveris]
[-p ports] [-I IP-adrese] [-t taimauts] [-s
hosts] --tls-connect psk --tls-psk-identity PSK-identitāte
--tls-psk-file PSK-fails [--tls-cipher13 šifra-virkne]
[--tls-cipher šifra-virkne] -k atslēga -o vērtība
zabbix_sender [-v] -c config-file [-z serveris]
[-p ports] [-I IP-adrese] [-t taimauts] [-s
hosts] --tls-connect psk --tls-psk-identity PSK-identitāte
--tls-psk-file PSK-fails [--tls-cipher13 šifra-virkne]
[--tls-cipher šifra-virkne] [-T] [-N] [-r] [-g]
-i ievades-fails
zabbix_sender -h
zabbix_sender -V [ ]{#lbAD}
APRAKSTS
zabbix_sender ir komandrindas utilīta monitoringa datu sūtīšanai uz Zabbix serveri vai starpniekserveri. Zabbix serverī jāizveido vienums ar tipu Zabbix trapper un atbilstošu atslēgu. Ņemiet vērā, ka ienākošās vērtības tiks pieņemtas tikai no hostiem, kas norādīti šī vienuma laukā Allowed hosts. [ ]{#lbAE}
OPCIJAS
-c, --config config-file
Izmantot config-file. Zabbix sender nolasa servera informāciju no
agentd konfigurācijas faila. Pēc noklusējuma Zabbix sender nenolasa
nevienu konfigurācijas failu. Tiek atbalstīti tikai parametri Hostname,
ServerActive, SourceIP, TLSConnect, TLSCAFile, TLSCRLFile,
TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile,
TLSKeyFile, TLSPSKIdentity un TLSPSKFile.
Hosts, kas definēts ar parametru HostnameItem, netiks izmantots; šajā gadījumā hosta nosaukums jānorāda komandrindā (skatiet opciju -s).
Datu sūtīšanai tiek izmantotas visas adreses, kas definētas aģenta konfigurācijas parametrā ServerActive.
Ja pakešdatu sūtīšana uz vienu adresi neizdodas, nākamās paketes uz šo adresi netiek sūtītas.
-z, --zabbix-server server
Zabbix servera hosta nosaukums vai IP adrese. Ja hosts tiek uzraudzīts ar
starpniekserveri, tā vietā jāizmanto starpniekservera hosta nosaukums vai IP adrese. Lietojot
kopā ar --config, pārraksta aģenta konfigurācijas failā norādītās
parametra ServerActive vērtības.
-p, --port port
Norādiet serverī darbojošā Zabbix servera trapper porta numuru.
Noklusējuma vērtība ir 10051. Lietojot kopā ar --config, pārraksta
aģenta konfigurācijas failā norādītās parametra ServerActive porta
vērtības.
-I, --source-address IP-address
Norādiet avota IP adresi. Lietojot kopā ar --config,
pārraksta aģenta konfigurācijas failā norādīto parametru SourceIP.
-t, --timeout seconds
Norādiet noildzi. Derīgais diapazons: 1-300 sekundes (noklusējums: 60)
-s, --host host
Norādiet hosta nosaukumu, kuram pieder vienums (kā reģistrēts Zabbix
lietotāja saskarnē). Hosta IP adrese un DNS nosaukums nedarbosies. Lietojot
kopā ar --config, pārraksta aģenta konfigurācijas failā norādīto
parametru Hostname.
-k, --key key
Norādiet vienuma atslēgu, uz kuru nosūtīt vērtību.
-o, --value value
Norādiet vienuma vērtību.
-i, --input-file input-file
Ielādēt 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 lauki: <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ā hosta nosaukums, kā reģistrēts Zabbix
lietotāja saskarnē, "key" ir mērķa vienuma atslēga un "value" — nosūtāmā vērtība.
Norādiet - kā <hostname>, lai izmantotu hosta nosaukumu no aģenta
konfigurācijas faila vai no argumenta --host.
Ievades faila rindas piemērs:
"Linux DB3" db.connections 43
Vērtības tipam jābūt pareizi iestatītam vienuma konfigurācijā Zabbix lietotāja saskarnē. Zabbix sender vienā savienojumā nosūtīs līdz 250 vērtībām. Izmēra ierobežojums vērtību sūtīšanai no ievades faila ir atkarīgs no izmēra, kas aprakstīts Zabbix komunikācijas protokolā. Ievades faila saturam jābūt UTF-8 kodējumā. Visas vērtības no ievades faila tiek sūtītas secīgi no augšas uz leju. Ierakstiem jābūt formatētiem saskaņā ar šādiem noteikumiem:
- Tiek atbalstīti ieraksti pēdiņās un bez pēdiņām.
- Dubultpēdiņa ir citēšanas rakstzīme.
- Ieraksti ar atstarpēm jāliek pēdiņās.
- Dubultpēdiņas un atpakaļslīpsvītras rakstzīmes citētā ierakstā jāatceļ ar atpakaļslīpsvītru.
- Atcelšana netiek atbalstīta ierakstos bez pēdiņām.
- Rindpārejas atcelšanas secības (\n) tiek atbalstītas citētās virknēs.
- Rindpārejas atcelš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>. Laika zīmogs jānorāda Unix timestamp formātā. Ja mērķa vienumam ir trigeri, kas uz to atsaucas, visiem laika zīmogiem 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 opcijā --input-file.
Ja hostam, kas atrodas uzturēšanas režīmā ar tipu “nav datu”, tiek nosūtīta vērtība ar laika zīmogu, šī vērtība tiks atmesta; tomēr ir iespējams nosūtīt vērtību ar laika zīmogu par uzturēšanas periodu, kam beidzies termiņš, 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 opcijā --input-file.
-r, --real-time
Sūtīt vērtības pa vienai, tiklīdz tās tiek saņemtas. To var izmantot,
lasot no standarta ievades.
-g, --group
Grupēt vērtības pēc hostiem un sūtīt katram hostam atsevišķā paketē.
--tls-connect value
Kā izveidot savienojumu ar serveri vai starpniekserveri. Vērtības:
[ ]{#lbAF}
nešifrēts
savienoties bez šifrēšanas (noklusējums)
<!-- -->
psk
savienoties, izmantojot TLS un iepriekš koplietotu atslēgu
<!-- -->
cert
savienoties, izmantojot TLS un sertifikātu
<!-- -->
--tls-ca-file CA-file
Pilns ceļš uz failu, kas satur augstākā līmeņa CA sertifikātus
vienādranga sertifikāta verifikācijai.
--tls-crl-file CRL-file
Pilns ceļš uz failu, kas satur atsauktos sertifikātus.
--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, kas satur sertifikātu vai sertifikātu ķēdi.
--tls-key-file key-file
Pilns ceļš uz failu, kas satur privāto atslēgu.
--tls-psk-identity PSK-identity
PSK identitātes virkne.
--tls-psk-file PSK-file
Pilns ceļš uz failu, kas satur iepriekš koplietoto atslēgu.
--tls-cipher13 cipher-string
Šifru virkne OpenSSL 1.1.1 vai jaunākai versijai TLS 1.3 vajadzībām. Aizstāj
noklusējuma šifru kopas atlases kritērijus. Šī opcija nav pieejama, ja
OpenSSL versija ir mazā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 kopas atlases kritērijus.
-v, --verbose
Izvērstais režīms, -vv papildu detalizācijai.
-h, --help
Parādīt šo palīdzību un iziet.
-V, --version
Izvadīt versijas informāciju un iziet.
[ ]{#lbAG}
IZEJAS 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.
[ ]{#lbAH}
PIEMĒRI
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -k mysql.queries -o 342.45\
Nosūtīt 342.45 kā vērtību uzraudzītā hosta mysql.queries vienumam. Izmantot aģenta konfigurācijas failā definēto uzraudzīto hostu un Zabbix serveri.
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitored Host" -k mysql.queries -o 342.45\
Nosūtīt 342.45 kā vērtību hosta Monitored Host mysql.queries vienumam, izmantojot aģenta konfigurācijas failā definēto Zabbix serveri.
zabbix_sender -z 192.168.1.113 -i data_values.txt
Nosūtīt 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ētas failā.
echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix_sender -c
/usr/local/etc/zabbix_agentd.conf -T -i -\
Nosūtīt laika zīmogu saturošu vērtību no komandrindas uz Zabbix serveri, kas norādīts aģenta konfigurācijas failā. Domuzīme ievades datos norāda, ka arī hosta 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ūtīt tukšu vienuma vērtību uz Zabbix serveri ar IP adresi 192.168.1.113 portā 10000 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ūtīt 342.45 kā vērtību hosta Monitored Host mysql.queries vienumam uz serveri ar IP 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ūtīt 342.45 kā vērtību hosta Monitored Host mysql.queries vienumam uz serveri ar IP 192.168.1.113, izmantojot TLS ar iepriekš koplietotu atslēgu (PSK).
[ ]{#lbAI}
SKATĪT ARĪ
Dokumentācija https://www.zabbix.com/manuals
zabbix_agentd(8), zabbix_get(1), zabbix_proxy(8), zabbix_server(8), zabbix_js(1), zabbix_agent2(8), zabbix_web_service(8) [ ]{#lbAJ}
Saturs
Šis dokuments tika izveidots: 08:42:39 GMT, 2021. gada 11. jūnijā