Na tej stronie
zabbix_sender
ZABBIX_SENDER(1) Podręcznik poleceń ogólnych ZABBIX_SENDER(1)
NAZWA
zabbix_sender - narzędzie zabbix_sender
SKŁADNIA
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
OPIS
zabbix_sender to narzędzie wiersza poleceń służące do wysyłania
danych monitorowania do serwera Zabbix lub proxy. Na serwerze Zabbix
należy utworzyć pozycję typu Zabbix trapper z odpowiednim kluczem.
Należy pamiętać, że wartości przychodzące będą akceptowane tylko od
hostów określonych w polu Allowed hosts tej pozycji.
OPCJE
-c, --config config-file
Użyj config-file. zabbix_sender odczytuje szczegóły serwera z
pliku konfiguracji agentd. Domyślnie zabbix_sender nie odczytuje
żadnego pliku konfiguracji. Obsługiwane są tylko parametry
Hostname, ServerActive, SourceIP, TLSConnect, TLSCAFile,
TLSCRLFile, TLSServerCertIssuer, TLSServerCertSubject,
TLSCertFile, TLSKeyFile, TLSPSKIdentity i TLSPSKFile. Parametr
Hostname zdefiniowany za pomocą parametru HostnameItem nie
zostanie pobrany; w takim przypadku nazwę hosta należy określić
w wierszu poleceń (zobacz opcję -s). Wszystkie adresy
zdefiniowane w parametrze konfiguracji agentd ServerActive są
używane do wysyłania danych. Jeśli wysyłanie danych
wsadowych do jednego adresu nie powiedzie się, kolejne wsady nie
są wysyłane na ten adres.
-z, --zabbix-server server
Nazwa hosta lub adres IP serwera Zabbix. Jeśli host jest
monitorowany przez proxy, należy użyć nazwy hosta lub adresu IP
proxy. Użycie razem z opcją --config powoduje zastąpienie wpisów
parametru ServerActive określonych w pliku konfiguracji agentd.
-p, --port port
Określ numer portu, na którym działa trapper Zabbix serwera.
Wartość domyślna to 10051. Użycie razem z opcją --config
powoduje zastąpienie wpisów portu parametru ServerActive
określonych w pliku konfiguracji agentd.
-I, --source-address IP-address
Określ źródłowy adres IP. Użycie razem z opcją --config powoduje
zastąpienie parametru SourceIP określonego w pliku konfiguracji
agentd.
-t, --timeout seconds
Określ limit czasu. Prawidłowy zakres: 1-300 sekund (domyślnie:
60).
-s, --host host
Określ nazwę hosta, do którego należy pozycja (zarejestrowaną
w frontend Zabbix). Adres IP hosta ani nazwa DNS nie będą
działać. Użycie razem z opcją --config powoduje zastąpienie
parametru Hostname określonego w pliku konfiguracji agentd.
-k, --key key
Określ klucz pozycji, do której ma zostać wysłana wartość.
-o, --value value
Określ wartość pozycji.
-i, --input-file input-file
Wczytaj wartości z pliku wejściowego. Określ - jako <input-file>,
aby odczytywać wartości ze standardowego wejścia. Każdy wiersz
pliku zawiera elementy rozdzielone białymi znakami:
<hostname> <key> <value>. Każda wartość musi być określona
w osobnym wierszu. Każdy wiersz musi zawierać 3 elementy
rozdzielone białymi znakami: <hostname> <key> <value>, gdzie
„hostname” to nazwa monitorowanego hosta zarejestrowana
w frontend Zabbix, „key” to docelowy klucz pozycji, a „value”
to wartość do wysłania. Określ - jako <hostname>, aby użyć nazwy
hosta z pliku konfiguracji agent lub z argumentu --host.
Przykład wiersza pliku wejściowego:
"Linux DB3" db.connections 43
Typ wartości musi być prawidłowo ustawiony w konfiguracji pozycji
w frontend Zabbix. zabbix_sender wyśle do 250 wartości w ramach
jednego połączenia. Zawartość pliku wejściowego musi być
zakodowana w UTF-8. Wszystkie wartości z pliku wejściowego są
wysyłane sekwencyjnie, od góry do dołu. Wpisy muszą być
sformatowane zgodnie z następującymi zasadami:
• Obsługiwane są wpisy ujęte w cudzysłowy i nieujęte
w cudzysłowy.
• Znakiem używanym do ujmowania w cudzysłowy jest
podwójny cudzysłów.
• Wpisy zawierające białe znaki muszą być ujęte
w cudzysłowy.
• Znaki podwójnego cudzysłowu i odwrotnego ukośnika
wewnątrz wpisu ujętego w cudzysłowy muszą być poprzedzone
odwrotnym ukośnikiem.
• Wpisach nieujętych w cudzysłowy nie można stosować
znaków ucieczki.
• W łańcuchach ujętych w cudzysłowy obsługiwane są
sekwencje ucieczki znaku nowego wiersza (\n).
• Sekwencje ucieczki znaku nowego wiersza są usuwane
z końca wpisu.
-T, --with-timestamps
Tej opcji można używać tylko razem z opcją --input-file.
Każdy wiersz pliku wejściowego musi zawierać 4 elementy
rozdzielone białymi znakami: <hostname> <key> <timestamp>
<value>. Znacznik czasu należy określić w formacie znacznika
czasu Unix. Jeśli docelowa pozycja ma odwołujące się do niej
wyzwalacze, wszystkie znaczniki czasu muszą być uporządkowane
rosnąco, w przeciwnym razie obliczanie zdarzeń nie będzie
prawidłowe.
Przykład wiersza pliku wejściowego:
"Linux DB3" db.connections 1429533600 43
Więcej informacji można znaleźć w opisie opcji --input-file.
Jeśli wartość ze znacznikiem czasu zostanie wysłana dla hosta,
który znajduje się w okresie konserwacji typu „no data”, wartość
ta zostanie odrzucona; można jednak wysłać wartość ze znacznikiem
czasu przypadającym na zakończony okres konserwacji i zostanie
ona zaakceptowana.
-N, --with-ns
Tej opcji można używać tylko razem z opcją --with-timestamps.
Każdy wiersz pliku wejściowego musi zawierać 5 elementów
rozdzielonych białymi znakami: <hostname> <key> <timestamp> <ns>
<value>.
Przykład wiersza pliku wejściowego:
"Linux DB3" db.connections 1429533600 7402561 43
Więcej informacji można znaleźć w opisie opcji --input-file.
-r, --real-time
Wysyłaj wartości pojedynczo, natychmiast po ich otrzymaniu.
Można tego używać podczas odczytywania danych ze standardowego
wejścia.
--tls-connect value
Sposób łączenia z serwerem lub proxy. Wartości:
unencrypted
połączenie bez szyfrowania (domyślnie)
psk połączenie z użyciem TLS i klucza wstępnie
współdzielonego
cert połączenie z użyciem TLS i certyfikatu
--tls-ca-file CA-file
Pełna ścieżka do pliku zawierającego certyfikaty najwyższego
poziomu CA służące do weryfikacji certyfikatu peera.
--tls-crl-file CRL-file
Pełna ścieżka do pliku zawierającego unieważnione certyfikaty.
--tls-server-cert-issuer cert-issuer
Dozwolony wystawca certyfikatu serwera.
--tls-server-cert-subject cert-subject
Dozwolony podmiot certyfikatu serwera.
--tls-cert-file cert-file
Pełna ścieżka do pliku zawierającego certyfikat lub łańcuch
certyfikatów.
--tls-key-file key-file
Pełna ścieżka do pliku zawierającego klucz prywatny.
--tls-psk-identity PSK-identity
Ciąg identyfikatora PSK.
--tls-psk-file PSK-file
Pełna ścieżka do pliku zawierającego klucz wstępnie współdzielony.
--tls-cipher13 cipher-string
Ciąg szyfru dla OpenSSL 1.1.1 lub nowszego używanego z TLS 1.3.
Zastępuje domyślne kryteria wyboru zestawu szyfrów. Ta opcja nie
jest dostępna, jeśli wersja OpenSSL jest starsza niż 1.1.1.
--tls-cipher cipher-string
Ciąg priorytetów GnuTLS (dla TLS 1.2 i nowszych) lub ciąg szyfru
OpenSSL (tylko dla TLS 1.2). Zastępuje domyślne kryteria wyboru
zestawu szyfrów.
-v, --verbose
Tryb szczegółowy; -vv wyświetla więcej informacji.
-h, --help
Wyświetl tę pomoc i zakończ działanie.
-V, --version
Wyświetl informacje o wersji i zakończ działanie.
KOD ZAKOŃCZENIA
Kod zakończenia wynosi 0, jeśli wartości zostały wysłane i wszystkie
zostały pomyślnie przetworzone przez serwer. Jeśli dane zostały
wysłane, ale przetwarzanie co najmniej jednej wartości nie powiodło się,
kod zakończenia wynosi 2. Jeśli wysyłanie danych nie powiodło się, kod
zakończenia wynosi 1.
PRZYKŁADY
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -k mysql.queries -o
342.45
Wyślij 342.45 jako wartość pozycji mysql.queries monitorowanego
hosta. Użyj monitorowanego hosta i serwera Zabbix zdefiniowanych
w pliku konfiguracji agent.
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitored Host" -k
mysql.queries -o 342.45
Wyślij 342.45 jako wartość pozycji mysql.queries hosta Monitored
Host, używając serwera Zabbix zdefiniowanego w pliku konfiguracji
agent.
zabbix_sender -z 192.168.1.113 -i data_values.txt
Wyślij wartości z pliku data_values.txt do serwera Zabbix
o adresie IP 192.168.1.113. Nazwy hostów i klucze są zdefiniowane
w pliku.
echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix_sender -c
/usr/local/etc/zabbix_agentd.conf -T -i -
Wyślij wartość ze znacznikiem czasu z wiersza poleceń do serwera
Zabbix określonego w pliku konfiguracji agent. Myślnik w danych
wejściowych oznacza, że nazwa hosta również powinna zostać użyta
z tego samego pliku konfiguracji.
echo '"Zabbix server" trapper.item ""' | zabbix_sender -z 192.168.1.113
-p 10000 -i -
Wyślij pustą wartość pozycji do serwera Zabbix o adresie IP
192.168.1.113 na porcie 10000 z wiersza poleceń. Puste wartości
należy oznaczać pustymi podwójnymi cudzysłowami.
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
Wyślij 342.45 jako wartość pozycji mysql.queries hosta Monitored
Host do serwera o adresie IP 192.168.1.113, używając TLS
z certyfikatem.
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
Wyślij 342.45 jako wartość pozycji mysql.queries hosta Monitored
Host do serwera o adresie IP 192.168.1.113, używając TLS
z kluczem wstępnie współdzielonym (PSK).
ZOBACZ TAKŻE
Dokumentacja
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)