Šajā lapā
zabbix_sender
ZABBIX_SENDER(1) Vispārīgo komandu rokasgrāmata ZABBIX_SENDER(1)
NOSAUKUMS
zabbix_sender - Zabbix datu nosūtīšanas utilīta
SINTAKSE
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 konfigurācijas-fails [-z serveris] [-p ports] [-I IP-adrese]
[-t taimauts] [-s hosts] -k atslēga -o vērtība
zabbix_sender [-v] -c konfigurācijas-fails [-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-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] -i ievades-fails
zabbix_sender [-v] -c konfigurācijas-fails [-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 konfigurācijas-fails [-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] -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] -i ievades-fails
zabbix_sender [-v] -c konfigurācijas-fails [-z serveris] [-p ports] [-I IP-adrese]
[-t taimauts] [-s hosts] --tls-connect psk --tls-psk-identity PSK-iden‐
titāte --tls-psk-file PSK-fails [--tls-cipher13 šifra-virkne] [--tls-ci‐
pher šifra-virkne] -k atslēga -o vērtība
zabbix_sender [-v] -c konfigurācijas-fails [-z serveris] [-p ports] [-I IP-adrese]
[-t taimauts] [-s hosts] --tls-connect psk --tls-psk-identity PSK-iden‐
titāte --tls-psk-file PSK-fails [--tls-cipher13 šifra-virkne] [--tls-ci‐
pher šifra-virkne] [-T] [-N] [-r] -i ievades-fails
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 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 konfigurācijas-fails
Izmanto konfigurācijas-failu. Zabbix sender nolasa servera informāciju no
aģenta konfigurācijas faila. Aģentam nav jābūt palaistam, lai
zabbix_sender varētu nosūtīt datus. 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 konfigurācijas parametrā ServerActive.
Ja pakešu datu nosūtīšana uz kādu adresi neizdodas, turpmākās paketes
uz šo adresi netiek nosūtītas.
-z, --zabbix-server serveris
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ītos ierakstus.
-p, --port ports
Norāda Zabbix servera trapper porta numuru. Noklusējuma vērtība ir
10051. Izmantojot kopā ar --config, šī opcija aizstāj parametrā
ServerActive aģenta konfigurācijas failā norādītos porta ierakstus.
-I, --source-address IP-adrese
Norāda avota IP adresi. Izmantojot kopā ar --config, šī opcija
aizstāj aģenta konfigurācijas failā norādīto parametru SourceIP.
-t, --timeout sekundes
Norāda taimautu. Derīgais diapazons: 1-300 sekundes (noklusējums: 60).
-s, --host hosts
Norāda tā hosta nosaukumu, kuram pieder vienums (kā tas reģistrēts
Zabbix lietotāja saskarnē). Hosta 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 atslēga
Norāda vienuma atslēgu, uz kuru nosūtīt vērtību.
-o, --value vērtība
Norāda vienuma vērtību.
-i, --input-file ievades-fails
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ā
hosta 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 hosta 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ņ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.
• Rindas pārneses ekrēpsekvences (\n) tiek atbalstītas
virknēs pēdiņās.
• Rindas pārneses ekrēpsekvences 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
Papildinformāciju skatiet opcijas --input-file aprakstā.
Ja uzraudzītajam hostam, kuram tiek nosūtīta vērtība ar laikspiedogu,
ir apkopes periods ar tipu “no data”, šī vērtība tiks atmesta; tomēr
vērtību ar laikspiedogu var nosūtīt par 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
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ējums)
psk izveidot savienojumu, izmantojot TLS un iepriekš
koplietotu atslēgu
cert izveidot savienojumu, izmantojot TLS un sertifikātu
--tls-ca-file CA-fails
Pilns ceļš uz failu, kurā ir augstākā līmeņa CA sertifikāts(-i)
partnera sertifikāta pārbaudei.
--tls-crl-file CRL-fails
Pilns ceļš uz failu, kurā ir atsauktie sertifikāti.
--tls-server-cert-issuer sertifikāta-izdevējs
Atļautais servera sertifikāta izdevējs.
--tls-server-cert-subject sertifikāta-subjekts
Atļautais servera sertifikāta subjekts.
--tls-cert-file sertifikāta-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. Tai jāatbilst PSK identitātei, kas hostam
iestatīta Zabbix lietotāja saskarnē.
--tls-psk-file PSK-fails
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 šifra-virkne
Šifra 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 šifra-virkne
GnuTLS prioritātes virkne (TLS 1.2 un jaunākām versijām) vai OpenSSL
šifra 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ī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 zabbix.trapper -o
342.45
Nosūta 342.45 kā zabbix.trapper vienuma vērtību uzraudzītajam
hostam. Izmanto 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
zabbix.trapper -o 342.45
Nosūta 342.45 kā zabbix.trapper vienuma vērtību hostam Monitored
Host, izmantojot aģenta konfigurācijas failā definēto Zabbix
serveri.
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. Hosti 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 Zabbix serverim, kas
norādīts aģenta konfigurācijas failā. Defise ievades datos norāda,
ka hosts 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 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 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)