On this page
zabbix_sender
ZABBIX_SENDER(1) Vispārīgo komandu rokasgrāmata ZABBIX_SENDER(1)
NOSAUKUMS
zabbix_sender - Zabbix datu nosūtīšanas utilīta
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] -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] -i ievades-fails
zabbix_sender [-v] -z serveris [-p ports] [-I IP-adrese] [-t taimauts] -s
hosts --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 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-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 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-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 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-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 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-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 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-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 ievades-fails
zabbix_sender [-v] -z serveris [-p ports] [-I IP-adrese] [-t taimauts] -s
hosts --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file
PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -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-identity --tls-psk-file
PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string]
[-T] [-N] [-r] -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-iden‐
tity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-ci‐
pher cipher-string] -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-iden‐
tity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-ci‐
pher cipher-string] [-T] [-N] [-r] -i ievades-fails
zabbix_sender -h
zabbix_sender -V
APRAKSTS
zabbix_sender ir komandrindas utilīta monitoringa datu nosūtīšanai uz
Zabbix serveris vai starpniekserveris. Zabbix serverī ir 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 hosts, kas norādīti šī
vienuma laukā Allowed hosts.
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, Server‐
Active, SourceIP, TLSConnect, TLSCAFile, TLSCRLFile,
TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile, TLSKey‐
File, TLSPSKIdentity un TLSPSKFile. Hostname, kas definēts ar
parametru HostnameItem, netiks izmantots; šajā gadījumā hosts
nosaukums jānorāda komandrindā (skatiet opciju -s). Visas
adreses, kas definētas aģents ServerActive konfigurācijas
parametrā, tiek izmantotas datu nosūtīšanai. Ja pakešdatu
nosūtīšana uz vienu adresi neizdodas, nākamās paketes uz šo
adresi netiek sūtītas.
-z, --zabbix-server serveris
Zabbix servera hosts nosaukums vai IP adrese. Ja hosts tiek
uzraudzīts ar starpniekserveris palīdzību, tā vietā jāizmanto
starpniekserveris hosts nosaukums vai IP adrese. Lietojot kopā
ar --config, pārraksta agentd konfigurācijas failā norādītā
parametra ServerActive ierakstus.
-p, --port ports
Norādīt Zabbix servera trapper porta numuru, kas darbojas uz
servera. Noklusējums ir 10051. Lietojot kopā ar --config,
pārraksta agentd konfigurācijas failā norādītā parametra
ServerActive porta ierakstus.
-I, --source-address IP-adrese
Norādīt avota IP adresi. Lietojot kopā ar --config, pārraksta
agentd konfigurācijas failā norādīto parametru SourceIP.
-t, --timeout sekundes
Norādīt taimautu. Derīgais diapazons: 1-300 sekundes (noklusējums: 60)
-s, --host hosts
Norādīt hosts nosaukumu, kuram pieder vienums (kā reģistrēts
Zabbix lietotāja saskarne). Hosts IP adrese un DNS nosaukums
nedarbosies. Lietojot kopā ar --config, pārraksta agentd
konfigurācijas failā norādīto parametru Hostname.
-k, --key atslēga
Norādīt vienuma atslēgu, uz kuru nosūtīt vērtību.
-o, --value vērtība
Norādīt vienuma vērtību.
-i, --input-file ievades-fails
Ielādēt vērtības no ievades faila. Norādiet - kā <input-file>,
lai lasītu vērtības no standarta ievades. Katra faila rinda
satur ar atstarpēm atdalītus laukus: <hostname> <key> <value>.
Katra vērtība jānorāda savā rindā. Katrā rindā jābūt 3 ar
atstarpēm atdalītiem ierakstiem: <hostname> <key> <value>, kur
"hostname" ir uzraudzītā hosts nosaukums, kā reģistrēts Zabbix
lietotāja saskarne, "key" ir mērķa vienuma atslēga un "value" -
nosūtāmā vērtība. Norādiet - kā <hostname>, lai izmantotu hosts
nosaukumu no aģents 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 saskarne. 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 vērtības no ievades faila tiek nosū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.
• Ierakstiem ar atstarpēm jābūt pēdiņās.
• Dubultpēdiņas un atpakaļslīpsvītras rakstzīmes citētā ie‐
rakstā jāekranē ar atpakaļslīpsvītru.
• Ekranēšana netiek atbalstīta ierakstiem bez pēdiņām.
• Rindpārlēces sekvences (\n) tiek atbalstītas citētās
virknēs.
• Rindpārlēces sekvences tiek apgrieztas 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 trigeris,
kas uz to atsaucas, visiem laika zīmogiem jābūt augošā secībā,
pretējā gadījumā notikumu aprēķins nebūs korekts.
Ievades faila rindas piemērs:
"Linux DB3" db.connections 1429533600 43
Papildinformāciju skatiet opcijā --input-file.
Ja vērtība ar laika zīmogu tiek nosūtīta hosts, kas atrodas “no data”
uzturēšanas tipā, šī vērtība tiks atmesta; tomēr ir iespējams
nosūtīt vērtību ar laika zīmogu uz 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 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.
--tls-connect value
Kā izveidot savienojumu ar serveris vai starpniekserveris. 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, kas satur augstākā līmeņa CA sertifikātus
vienādranga sertifikāta pārbaudei.
--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 režīmā.
Pārraksta noklusējuma šifru kopas 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). Pārraksta 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.
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.
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ā hosts vienumam
mysql.queries. Izmantot uzraudzīto hosts un Zabbix serveris,
kas definēti aģents konfigurācijas failā.
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 hosts "Monitored Host" vienumam
mysql.queries, izmantojot Zabbix serveris, kas definēts aģents
konfigurācijas failā.
zabbix_sender -z 192.168.1.113 -i data_values.txt
Nosūtīt vērtības no faila data_values.txt uz Zabbix serveris ar
IP 192.168.1.113. Hosts 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ūtīt vērtību ar laika zīmogu no komandrindas uz Zabbix
serveris, kas norādīts aģents konfigurācijas failā. Domuzīme
ievades datos norāda, ka arī hosts 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 serveris ar IP adresi
192.168.1.113 un portu 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 hosts "Monitored Host" vienumam
mysql.queries 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 hosts "Monitored Host" vienumam
mysql.queries uz serveri ar IP 192.168.1.113, izmantojot TLS ar
iepriekš koplietotu atslēgu (PSK).
SKATĪT 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)