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 wyłącznie
z hostów określonych w polu Allowed hosts tej pozycji.
OPCJE
-c, --config config-file
Użyj config-file. zabbix_sender odczytuje informacje o serwerze
z pliku konfiguracji agentd. Agent nie musi być uruchomiony, aby
zabbix_sender mógł wysyłać dane. Domyślnie zabbix_sender nie
odczytuje żadnego pliku konfiguracji. Obsługiwane są wyłącznie
parametry Hostname, ServerActive, SourceIP, TLSConnect, TLSCAFile,
TLSCRLFile, TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile,
TLSKeyFile, TLSPSKIdentity i TLSPSKFile. 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 partie
danych 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 serwera Zabbix.
Wartość domyślna to 10051. Użycie razem z opcją --config powoduje
zastąpienie wpisów portów 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 jednym
połączeniu. 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 cytowania jest cudzysłów podwójny.
• Wpisy zawierające białe znaki muszą być ujęte
w cudzysłowy.
• Cudzysłowy podwójne i ukośniki odwrotne wewnątrz wpisu
ujętego w cudzysłowy muszą być poprzedzone ukośnikiem
odwrotnym.
• Wpisy nieujęte w cudzysłowy nie obsługują znaków
ucieczki.
• Sekwencje ucieczki znaku nowego wiersza (\n) są
obsługiwane w ciągach ujętych w cudzysłowy.
• Sekwencje ucieczki znaku nowego wiersza są usuwane
z końca wpisu.
-T, --with-timestamps
Tej opcji można używać wyłącznie 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 systemu 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 zawiera opis 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ć wyłącznie 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 zawiera opis opcji --input-file.
-r, --real-time
Wysyłaj wartości pojedynczo, natychmiast po ich otrzymaniu.
Można tego używać podczas odczytu 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 głównego urzędu
certyfikacji (CA) używane 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 tożsamości PSK. Musi odpowiadać tożsamości PSK ustawionej
dla hosta w frontend Zabbix.
--tls-psk-file PSK-file
Pełna ścieżka do pliku zawierającego klucz wstępnie współdzielony.
Klucz w tym pliku musi odpowiadać wartości PSK ustawionej dla
hosta w frontend Zabbix.
--tls-cipher13 cipher-string
Ciąg szyfrów dla OpenSSL 1.1.1 lub nowszego dla TLS 1.3.
Zastępuje domyślne kryteria wyboru zestawu szyfrów. Ta opcja nie
jest dostępna, jeśli wersja OpenSSL jest niższa niż 1.1.1.
--tls-cipher cipher-string
Ciąg priorytetów GnuTLS (dla TLS 1.2 i nowszych) lub ciąg szyfrów
OpenSSL (wyłącznie 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 zabbix.trapper -o
342.45
Wyślij 342.45 jako wartość pozycji zabbix.trapper 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
zabbix.trapper -o 342.45
Wyślij 342.45 jako wartość pozycji zabbix.trapper 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" zabbix.trapper ""' | 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
muszą być oznaczone pustymi cudzysłowami podwójnymi.
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
Wyślij 342.45 jako wartość pozycji zabbix.trapper 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 zabbix.trapper -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 zabbix.trapper 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)