On this page
zabbix_sender
ZABBIX_SENDER(1) Podręcznik poleceń ogólnych ZABBIX_SENDER(1)
NAZWA
zabbix_sender - narzędzie wysyłające Zabbix
SKŁADNIA
zabbix_sender [-v] -z serwer [-p port] [-I adres-IP] [-t timeout] -s
host -k key -o value
zabbix_sender [-v] -z serwer [-p port] [-I adres-IP] [-t timeout] [-s
host] [-T] [-N] [-r] -i plik-wejściowy
zabbix_sender [-v] -c plik-konfiguracyjny [-z serwer] [-p port] [-I adres-IP]
[-t timeout] [-s host] -k key -o value
zabbix_sender [-v] -c plik-konfiguracyjny [-z serwer] [-p port] [-I adres-IP]
[-t timeout] [-s host] [-T] [-N] [-r] -i plik-wejściowy
zabbix_sender [-v] -z serwer [-p port] [-I adres-IP] [-t timeout] -s
host --tls-connect cert --tls-ca-file plik-CA [--tls-crl-file plik-CRL]
[--tls-server-cert-issuer wystawca-certyfikatu] [--tls-server-cert-subject
temat-certyfikatu] --tls-cert-file plik-certyfikatu --tls-key-file plik-klucza
[--tls-cipher13 ciąg-szyfrów] [--tls-cipher ciąg-szyfrów] -k key -o
value
zabbix_sender [-v] -z serwer [-p port] [-I adres-IP] [-t timeout] [-s
host] --tls-connect cert --tls-ca-file plik-CA [--tls-crl-file
plik-CRL] [--tls-server-cert-issuer wystawca-certyfikatu]
[--tls-server-cert-subject temat-certyfikatu] --tls-cert-file plik-certyfikatu
--tls-key-file plik-klucza [--tls-cipher13 ciąg-szyfrów] [--tls-cipher
ciąg-szyfrów] [-T] [-N] [-r] -i plik-wejściowy
zabbix_sender [-v] -c plik-konfiguracyjny [-z serwer] [-p port] [-I adres-IP]
[-t timeout] [-s host] --tls-connect cert --tls-ca-file plik-CA
[--tls-crl-file plik-CRL] [--tls-server-cert-issuer wystawca-certyfikatu]
[--tls-server-cert-subject temat-certyfikatu] --tls-cert-file plik-certyfikatu
--tls-key-file plik-klucza [--tls-cipher13 ciąg-szyfrów] [--tls-cipher
ciąg-szyfrów] -k key -o value
zabbix_sender [-v] -c plik-konfiguracyjny [-z serwer] [-p port] [-I adres-IP]
[-t timeout] [-s host] --tls-connect cert --tls-ca-file plik-CA
[--tls-crl-file plik-CRL] [--tls-server-cert-issuer wystawca-certyfikatu]
[--tls-server-cert-subject temat-certyfikatu] --tls-cert-file plik-certyfikatu
--tls-key-file plik-klucza [--tls-cipher13 ciąg-szyfrów] [--tls-cipher
ciąg-szyfrów] [-T] [-N] [-r] -i plik-wejściowy
zabbix_sender [-v] -c plik-konfiguracyjny [-z serwer] [-p port] [-I adres-IP]
[-t timeout] [-s host] --tls-connect cert --tls-ca-file plik-CA
[--tls-crl-file plik-CRL] [--tls-server-cert-issuer wystawca-certyfikatu]
[--tls-server-cert-subject temat-certyfikatu] --tls-cert-file plik-certyfikatu
--tls-key-file plik-klucza [--tls-cipher13 ciąg-szyfrów] [--tls-cipher
ciąg-szyfrów] -k key -o value
zabbix_sender [-v] -c plik-konfiguracyjny [-z serwer] [-p port] [-I adres-IP]
[-t timeout] [-s host] --tls-connect cert --tls-ca-file plik-CA
[--tls-crl-file plik-CRL] [--tls-server-cert-issuer wystawca-certyfikatu]
[--tls-server-cert-subject temat-certyfikatu] --tls-cert-file plik-certyfikatu
--tls-key-file plik-klucza [--tls-cipher13 ciąg-szyfrów] [--tls-cipher
ciąg-szyfrów] [-T] [-N] [-r] -i plik-wejściowy
zabbix_sender [-v] -z serwer [-p port] [-I adres-IP] [-t timeout] -s
host --tls-connect psk --tls-psk-identity tożsamość-PSK --tls-psk-file
plik-PSK [--tls-cipher13 ciąg-szyfrów] [--tls-cipher ciąg-szyfrów] -k
key -o value
zabbix_sender [-v] -z serwer [-p port] [-I adres-IP] [-t timeout] [-s
host] --tls-connect psk --tls-psk-identity tożsamość-PSK --tls-psk-file
plik-PSK [--tls-cipher13 ciąg-szyfrów] [--tls-cipher ciąg-szyfrów]
[-T] [-N] [-r] -i plik-wejściowy
zabbix_sender [-v] -c plik-konfiguracyjny [-z serwer] [-p port] [-I adres-IP]
[-t timeout] [-s host] --tls-connect psk --tls-psk-identity tożsamość-PSK
--tls-psk-file plik-PSK [--tls-cipher13 ciąg-szyfrów] [--tls-cipher
ciąg-szyfrów] -k key -o value
zabbix_sender [-v] -c plik-konfiguracyjny [-z serwer] [-p port] [-I adres-IP]
[-t timeout] [-s host] --tls-connect psk --tls-psk-identity tożsamość-PSK
--tls-psk-file plik-PSK [--tls-cipher13 ciąg-szyfrów] [--tls-cipher
ciąg-szyfrów] [-T] [-N] [-r] -i plik-wejściowy
zabbix_sender -h
zabbix_sender -V
OPIS
zabbix_sender jest narzędziem wiersza poleceń do wysyłania danych moni‐
toringu do serwera lub proxy Zabbix. Na serwerze Zabbix powinna zostać
utworzona pozycja typu Zabbix trapper z odpowiednim kluczem. Należy pa‐
miętać, że przychodzące wartości będą akceptowane tylko od hostów okre‐
ślonych w polu Allowed hosts dla tej pozycji.
OPCJE
-c, --config plik-konfiguracyjny
Użyj plik-konfiguracyjny. Zabbix sender odczytuje szczegóły ser‐
wera z pliku konfiguracyjnego agentd. Domyślnie Zabbix sender nie
odczytuje żadnego pliku konfiguracyjnego. Obsługiwane są tylko pa‐
rametry Hostname, ServerActive, SourceIP, TLSConnect, TLSCAFile,
TLSCRLFile, TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile,
TLSKeyFile, TLSPSKIdentity i TLSPSKFile. Hostname zdefiniowany za
pomocą parametru HostnameItem nie zostanie pobrany; w takim przy‐
padku nazwę hosta należy podać w wierszu poleceń (zobacz opcję
-s). Wszystkie adresy zdefiniowane w parametrze konfiguracyjnym
ServerActive agenta są używane do wysyłania danych. Jeśli wysyła‐
nie partii danych do jednego adresu nie powiedzie się, kolejne
partie nie będą wysyłane na ten adres.
-z, --zabbix-server serwer
Nazwa hosta lub adres IP serwera Zabbix. Jeśli host jest monito‐
rowany przez proxy, należy zamiast tego użyć nazwy hosta proxy
lub jego adresu IP. Użyte razem z --config nadpisuje wpisy para‐
metru ServerActive określone w pliku konfiguracyjnym agentd.
-p, --port port
Określ numer portu trappera serwera Zabbix działającego na ser‐
werze. Domyślnie jest to 10051. Użyte razem z --config nadpisuje
wpisy portu parametru ServerActive określone w pliku konfigura‐
cyjnym agentd.
-I, --source-address adres-IP
Określ źródłowy adres IP. Użyte razem z --config nadpisuje para‐
metr SourceIP określony w pliku konfiguracyjnym agentd.
-t, --timeout sekundy
Określ timeout. Prawidłowy zakres: 1-300 sekund (domyślnie: 60)
-s, --host host
Określ nazwę hosta, do którego należy pozycja (zgodnie z rejes‐
tracją w frontendzie Zabbix). Adres IP hosta i nazwa DNS nie za‐
działają. Użyte razem z --config nadpisuje parametr Hostname
określony w pliku konfiguracyjnym 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 plik-wejściowy
Wczytaj wartości z pliku wejściowego. Podaj - jako <input-file>,
aby odczytać wartości ze standardowego wejścia. Każda linia pliku
zawiera wpisy rozdzielone białymi znakami: <hostname> <key> <va‐
lue>. Każda wartość musi być podana w osobnej linii. Każda linia
musi zawierać 3 wpisy rozdzielone białymi znakami: <hostname>
<key> <value>, gdzie "hostname" to nazwa monitorowanego hosta
zarejestrowana w frontendzie Zabbix, "key" to klucz docelowej po‐
zycji, a "value" - wartość do wysłania. Podaj - jako <hostname>,
aby użyć nazwy hosta z pliku konfiguracyjnego agenta lub z argu‐
mentu --host.
Przykład linii pliku wejściowego:
"Linux DB3" db.connections 43
Typ wartości musi być poprawnie ustawiony w konfiguracji pozycji
w frontendzie Zabbix. Zabbix sender wyśle do 250 wartości w jed‐
nym połączeniu. Zawartość pliku wejściowego musi być zakodowana
w UTF-8. Wszystkie wartości z pliku wejściowego są wysyłane se‐
kwencyjnie, od góry do dołu. Wpisy muszą być sformatowane zgodnie
z następującymi zasadami:
• Obsługiwane są wpisy w cudzysłowie i bez cudzysłowu.
• Znakiem cytowania jest podwójny cudzysłów.
• Wpisy zawierające białe znaki muszą być ujęte w cudzysłów.
• Znaki podwójnego cudzysłowu i ukośnika odwrotnego wewnątrz
wpisu w cudzysłowie muszą być poprzedzone ukośnikiem od‐
wrotnym.
• Escaping nie jest obsługiwany we wpisach bez cudzysłowu.
• Sekwencje ucieczki znaku nowej linii (\n) są obsługiwane
w ciągach ujętych w cudzysłów.
• Sekwencje ucieczki znaku nowej linii są usuwane z końca
wpisu.
-T, --with-timestamps
Ta opcja może być używana tylko z opcją --input-file.
Każda linia pliku wejściowego musi zawierać 4 wpisy rozdzielone
białymi znakami: <hostname> <key> <timestamp> <value>. Znacznik
czasu powinien być podany w formacie Unix timestamp. Jeśli doce‐
lowa pozycja ma wyzwalacze, które się do niej odwołują, wszystkie
znaczniki czasu muszą być w kolejności rosnącej, w przeciwnym ra‐
zie obliczanie zdarzeń nie będzie poprawne.
Przykład linii pliku wejściowego:
"Linux DB3" db.connections 1429533600 43
Więcej szczegółów można znaleźć w opcji --input-file.
Jeśli wartość ze znacznikiem czasu zostanie wysłana dla hosta,
który znajduje się w konserwacji typu „brak danych”, to wartość
ta zostanie odrzucona; jednak możliwe jest wysłanie wartości ze
znacznikiem czasu dla wygasłego okresu konserwacji i zostanie ona
zaakceptowana.
-N, --with-ns
Ta opcja może być używana tylko z opcją --with-timestamps.
Każda linia pliku wejściowego musi zawierać 5 wpisów rozdzielo‐
nych białymi znakami: <hostname> <key> <timestamp> <ns> <value>.
Przykład linii pliku wejściowego:
"Linux DB3" db.connections 1429533600 7402561 43
Więcej szczegółów można znaleźć w opcji --input-file.
-r, --real-time
Wysyłaj wartości pojedynczo, natychmiast po ich odebraniu. Może
to być używane podczas odczytu ze standardowego wejścia.
--tls-connect value
Sposób połączenia z serwerem lub proxy. Wartości:
unencrypted
połącz bez szyfrowania (domyślnie)
psk połącz przy użyciu TLS i klucza współdzielonego
cert połącz przy użyciu TLS i certyfikatu
--tls-ca-file plik-CA
Pełna ścieżka do pliku zawierającego certyfikaty nadrzędnych urzę‐
dów CA do weryfikacji certyfikatu strony zdalnej.
--tls-crl-file plik-CRL
Pełna ścieżka do pliku zawierającego unieważnione certyfikaty.
--tls-server-cert-issuer wystawca-certyfikatu
Dozwolony wystawca certyfikatu serwera.
--tls-server-cert-subject temat-certyfikatu
Dozwolony temat certyfikatu serwera.
--tls-cert-file plik-certyfikatu
Pełna ścieżka do pliku zawierającego certyfikat lub łańcuch cer‐
tyfikatów.
--tls-key-file plik-klucza
Pełna ścieżka do pliku zawierającego klucz prywatny.
--tls-psk-identity tożsamość-PSK
Ciąg tożsamości PSK.
--tls-psk-file plik-PSK
Pełna ścieżka do pliku zawierającego klucz współdzielony.
--tls-cipher13 ciąg-szyfrów
Ciąg szyfrów dla OpenSSL 1.1.1 lub nowszego dla TLS 1.3. Nadpisu‐
je 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 ciąg-szyfrów
Ciąg priorytetów GnuTLS (dla TLS 1.2 i nowszych) lub ciąg szyfrów
OpenSSL (tylko dla TLS 1.2). Nadpisuje domyślne kryteria wyboru
zestawu szyfrów.
-v, --verbose
Tryb szczegółowy, -vv dla większej liczby szczegółów.
-h, --help
Wyświetl tę pomoc i zakończ.
-V, --version
Wyświetl informacje o wersji i zakończ.
KOD ZAKOŃCZENIA
Kod zakończenia wynosi 0, jeśli wartości zostały wysłane i wszystkie z
nich zostały pomyślnie przetworzone przez serwer. Jeśli dane zostały wy‐
słane, ale przetwarzanie co najmniej jednej z 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ść dla pozycji mysql.queries monitorowa‐
nego hosta. Użyj monitorowanego hosta i serwera Zabbix zdefinio‐
wanych w pliku konfiguracyjnym agenta.
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitored Host" -k
mysql.queries -o 342.45
Wyślij 342.45 jako wartość dla pozycji mysql.queries hosta Moni‐
tored Host, używając serwera Zabbix zdefiniowanego w pliku konfi‐
guracyjnym agenta.
zabbix_sender -z 192.168.1.113 -i data_values.txt
Wyślij wartości z pliku data_values.txt do serwera Zabbix o adre‐
sie 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 konfiguracyjnym agenta. Myślnik w da‐
nych wejściowych oznacza, że nazwa hosta również powinna zostać
użyta z tego samego pliku konfiguracyjnego.
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
muszą być oznaczone 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ść dla pozycji mysql.queries hosta Moni‐
tored Host do serwera o IP 192.168.1.113 przy użyciu TLS z cer‐
tyfikatem.
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ść dla pozycji mysql.queries hosta Moni‐
tored Host do serwera o IP 192.168.1.113 przy użyciu TLS z klu‐
czem 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)