On this page
zabbix_sender
ZABBIX_SENDER(1) Vispārīgo komandu rokasgrāmata ZABBIX_SENDER(1)
NOSAUKUMS
zabbix_sender - Zabbix sūtītāja utilīta
SYNOPSIS
zabbix_sender [-v] -z serveris [-p ports] [-I IP-adrese] [-t noildze] -s
hosts -k atslēga -o vērtība
zabbix_sender [-v] -z serveris [-p ports] [-I IP-adrese] [-t noildze] [-s
hosts] [-T] [-N] [-r] -i ievades-fails
zabbix_sender [-v] -c konfigurācijas-fails [-z serveris] [-p ports] [-I IP-adrese]
[-t noildze] [-s hosts] -k atslēga -o vērtība
zabbix_sender [-v] -c konfigurācijas-fails [-z serveris] [-p ports] [-I IP-adrese]
[-t noildze] [-s hosts] [-T] [-N] [-r] -i ievades-fails
zabbix_sender [-v] -z serveris [-p ports] [-I IP-adrese] [-t noildze] -s
hosts --tls-connect cert --tls-ca-file CA-fails [--tls-crl-file CRL-fails]
[--tls-server-cert-issuer cert-izdevējs] [--tls-server-cert-subject
cert-subjekts] --tls-cert-file cert-fails --tls-key-file atslēgas-fails
[--tls-cipher13 šifra-rinda] [--tls-cipher šifra-rinda] -k atslēga -o
vērtība
zabbix_sender [-v] -z serveris [-p ports] [-I IP-adrese] [-t noildze] [-s
hosts] --tls-connect cert --tls-ca-file CA-fails [--tls-crl-file
CRL-fails] [--tls-server-cert-issuer cert-izdevējs]
[--tls-server-cert-subject cert-subjekts] --tls-cert-file cert-fails
--tls-key-file atslēgas-fails [--tls-cipher13 šifra-rinda] [--tls-cipher
šifra-rinda] [-T] [-N] [-r] -i ievades-fails
zabbix_sender [-v] -c konfigurācijas-fails [-z serveris] [-p ports] [-I IP-adrese]
[-t noildze] [-s hosts] --tls-connect cert --tls-ca-file CA-fails
[--tls-crl-file CRL-fails] [--tls-server-cert-issuer cert-izdevējs]
[--tls-server-cert-subject cert-subjekts] --tls-cert-file cert-fails
--tls-key-file atslēgas-fails [--tls-cipher13 šifra-rinda] [--tls-cipher
šifra-rinda] -k atslēga -o vērtība
zabbix_sender [-v] -c konfigurācijas-fails [-z serveris] [-p ports] [-I IP-adrese]
[-t noildze] [-s hosts] --tls-connect cert --tls-ca-file CA-fails
[--tls-crl-file CRL-fails] [--tls-server-cert-issuer cert-izdevējs]
[--tls-server-cert-subject cert-subjekts] --tls-cert-file cert-fails
--tls-key-file atslēgas-fails [--tls-cipher13 šifra-rinda] [--tls-cipher
šifra-rinda] [-T] [-N] [-r] -i ievades-fails
zabbix_sender [-v] -c konfigurācijas-fails [-z serveris] [-p ports] [-I IP-adrese]
[-t noildze] [-s hosts] --tls-connect cert --tls-ca-file CA-fails
[--tls-crl-file CRL-fails] [--tls-server-cert-issuer cert-izdevējs]
[--tls-server-cert-subject cert-subjekts] --tls-cert-file cert-fails
--tls-key-file atslēgas-fails [--tls-cipher13 šifra-rinda] [--tls-cipher
šifra-rinda] -k atslēga -o vērtība
zabbix_sender [-v] -c konfigurācijas-fails [-z serveris] [-p ports] [-I IP-adrese]
[-t noildze] [-s hosts] --tls-connect cert --tls-ca-file CA-fails
[--tls-crl-file CRL-fails] [--tls-server-cert-issuer cert-izdevējs]
[--tls-server-cert-subject cert-subjekts] --tls-cert-file cert-fails
--tls-key-file atslēgas-fails [--tls-cipher13 šifra-rinda] [--tls-cipher
šifra-rinda] [-T] [-N] [-r] -i ievades-fails
zabbix_sender [-v] -z serveris [-p ports] [-I IP-adrese] [-t noildze] -s
hosts --tls-connect psk --tls-psk-identity PSK-identitāte --tls-psk-file
PSK-fails [--tls-cipher13 šifra-rinda] [--tls-cipher šifra-rinda] -k
atslēga -o vērtība
zabbix_sender [-v] -z serveris [-p ports] [-I IP-adrese] [-t noildze] [-s
hosts] --tls-connect psk --tls-psk-identity PSK-identitāte --tls-psk-file
PSK-fails [--tls-cipher13 šifra-rinda] [--tls-cipher šifra-rinda]
[-T] [-N] [-r] -i ievades-fails
zabbix_sender [-v] -c konfigurācijas-fails [-z serveris] [-p ports] [-I IP-adrese]
[-t noildze] [-s hosts] --tls-connect psk --tls-psk-identity PSK-iden‐
titāte --tls-psk-file PSK-fails [--tls-cipher13 šifra-rinda] [--tls-ci‐
pher šifra-rinda] -k atslēga -o vērtība
zabbix_sender [-v] -c konfigurācijas-fails [-z serveris] [-p ports] [-I IP-adrese]
[-t noildze] [-s hosts] --tls-connect psk --tls-psk-identity PSK-iden‐
titāte --tls-psk-file PSK-fails [--tls-cipher13 šifra-rinda] [--tls-ci‐
pher šifra-rinda] [-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 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 hosts, kas norādīti šī vienuma laukā
Allowed hosts.
OPCIJAS
-c, --config config-file
Izmantot config-file. Zabbix sender nolasa servera informāciju no
aģenta 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
ar parametru HostnameItem, netiks izmantots; šajā gadījumā
hostname jānorāda komandrindā (skatiet opciju -s). Visas adreses,
kas definētas aģenta konfigurācijas parametrā ServerActive, tiek
izmantotas datu nosūtīšanai. Ja pakešdatu nosūtīšana uz kādu
adresi neizdodas, nākamās paketes uz šo adresi netiek sūtītas.
-z, --zabbix-server serveris
Zabbix servera resursdatora nosaukums vai IP adrese. Ja hosts
tiek uzraudzīts ar starpniekserveri, tā vietā jāizmanto
starpniekservera resursdatora nosaukums vai IP adrese. Ja
izmanto kopā ar --config, pārraksta agentd konfigurācijas failā
norādītos ServerActive parametra ierakstus.
-p, --port ports
Norādīt Zabbix servera trapper porta numuru, kas darbojas uz
servera. Noklusējums ir 10051. Ja izmanto kopā ar --config,
pārraksta agentd konfigurācijas failā norādītos ServerActive
parametra porta ierakstus.
-I, --source-address IP-adrese
Norādīt avota IP adresi. Ja izmanto kopā ar --config, pārraksta
agentd konfigurācijas failā norādīto SourceIP parametru.
-t, --timeout sekundes
Norādīt noildzi. Derīgs 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. Ja izmanto kopā ar --config, pārraksta agentd
konfigurācijas failā norādīto Hostname parametru.
-k, --key atslēga
Norādīt vienuma atslēgu, kurai sū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ā <ievades-fails>,
lai nolasītu vērtības no standarta ievades. Katrā faila rindā ir
atstarpēm atdalīti: <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, kas reģistrēts Zabbix lietotāja
saskarne, "key" ir mērķa vienuma atslēga, bet "value" - sūtāmā
vērtība. Norādiet - kā <hostname>, lai izmantotu hostname 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 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īgā
secībā no augšas uz leju. Ieraksti jāformatē, ievērojot šādus
noteikumus:
• Atbalstīti gan pēdiņās ietverti, gan neietverti ieraksti.
• Dubultpēdiņas ir pēdiņu rakstzīme.
• Ieraksti ar atstarpēm ir jāietver pēdiņās.
• Dubultpēdiņas un slīpsvītras rakstzīmes pēdiņās ietvertā
ierakstā ir jāekranē ar slīpsvītru.
• Ekranēšana neietvertos ierakstos netiek atbalstīta.
• Rindas pārtraukuma ekrānsecības (\n) tiek atbalstītas
pēdiņās ietvertās virknēs.
• Rindas pārtraukuma ekrānsecī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 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 opcijā --input-file.
Ja hosts, kuram tiek sūtīta vērtība ar laikspiedogu, atrodas
"no data" apkopes tipā, šī vērtība tiks atmesta; tomēr ir iespējams
nosūtīt vērtību ar laikspiedogu uz beigušos apkopes 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
Plašāku informā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 vērtība
Kā izveidot savienojumu ar serveri vai starpniekserveri. Vērtības:
unencrypted
savienojums bez šifrēšanas (noklusējums)
psk savienojums, izmantojot TLS un iepriekš koplietotu atslēgu
cert savienojums, izmantojot TLS un sertifikātu
--tls-ca-file CA-fails
Pilns ceļš uz failu, kurā ir augstākā līmeņa CA sertifikāti
vienaudža sertifikāta verifikācijai.
--tls-crl-file CRL-fails
Pilns ceļš uz failu, kurā ir atsauktie sertifikāti.
--tls-server-cert-issuer cert-izdevējs
Atļautais servera sertifikāta izdevējs.
--tls-server-cert-subject cert-subjekts
Atļautais servera sertifikāta subjekts.
--tls-cert-file cert-fails
Pilns ceļš uz failu, kurā ir sertifikāts vai sertifikātu ķēde.
--tls-key-file atslēgas-fails
Pilns ceļš uz failu, kurā ir privātā atslēga.
--tls-psk-identity PSK-identitāte
PSK identitātes virkne.
--tls-psk-file PSK-fails
Pilns ceļš uz failu, kurā ir iepriekš koplietotā atslēga.
--tls-cipher13 šifra-rinda
Šifra rinda OpenSSL 1.1.1 vai jaunākam TLS 1.3. Pārraksta
noklusējuma šifru kopas atlases kritērijus. Šī opcija nav pieejama,
ja OpenSSL versija ir vecāka par 1.1.1.
--tls-cipher šifra-rinda
GnuTLS prioritātes rinda (TLS 1.2 un jaunākam) vai OpenSSL šifra
rinda (tikai TLS 1.2). Pārraksta noklusējuma šifru kopas atlases
kritērijus.
-v, --verbose
Detalizēts režīms, -vv - vēl detalizētāk.
-h, --help
Parādīt šo palīdzību un iziet.
-V, --version
Izvadīt versijas informāciju un iziet.
IZIETAS STATUSS
Izejas statuss ir 0, ja vērtības tika nosūtītas un serveris 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ā mysql.queries vienuma vērtību uzraudzītajam
hosts. Izmantot uzraudzīto hosts 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ūtīt 342.45 kā mysql.queries vienuma vērtību hosts 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ūtīt vērtības no faila data_values.txt uz Zabbix serveri ar IP
adresi 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 no komandrindas laikspiedogu vērtību uz Zabbix serveri,
kas norādīts aģenta konfigurācijas failā. Domuzīme ievades datos
norāda, ka hostname arī 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 vienuma tukšu vērtību uz Zabbix serveri 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ā mysql.queries vienuma vērtību hosts 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 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ā mysql.queries vienuma vērtību hosts Monitored
Host uz serveri ar IP adresi 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)