Table of Contents

zabbix_sender
- NAME
- SKŁADNIA
- DESCRIPTION
- OPCJE
- KOD POWROTU
- PRZYKŁADY
- ZOBACZ TAKŻE
- AUTOR
- Indeks

zabbix_sender

Sekcja: Komendy użytkownika (1)
Zaktualizowano: 2021-06-01
Indeks Wróć do głównej zawartości

NAME

zabbix_sender - narzędzie Zabbix sender

SKŁADNIA

zabbix_sender [-v] -z serwer [-p port] [-I adres-IP] [-t limit-czasu] -s host -k klucz -o wartość
zabbix_sender [-v] -z serwer [-p port] [-I adres-IP] [-t limit-czasu] [-s host] [-T] [-N] [-r] -i plik-wejściowy
zabbix_sender [-v] -c plik-konfiguracyjny [-z serwer] [-p port] [-I adres-IP] [-t limit-czasu] [-s host] -k klucz -o wartość
zabbix_sender [-v] -c plik-konfiguracyjny [-z serwer] [-p port] [-I adres-IP] [-t limit-czasu] [-s host] [-T] [-N] [-r] -i plik-wejściowy
zabbix_sender [-v] -z serwer [-p port] [-I adres-IP] [-t limit-czasu] -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 podmiot-certyfikatu] --tls-cert-file plik-certyfikatu --tls-key-file plik-klucza [--tls-cipher13 ciąg-szyfru] [--tls-cipher ciąg-szyfru] -k klucz -o wartość
zabbix_sender [-v] -z serwer [-p port] [-I adres-IP] [-t limit-czasu] [-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 podmiot-certyfikatu] --tls-cert-file plik-certyfikatu --tls-key-file plik-klucza [--tls-cipher13 ciąg-szyfru] [--tls-cipher ciąg-szyfru] [-T] [-N] [-r] -i plik-wejściowy
zabbix_sender [-v] -c plik-konfiguracyjny [-z serwer] [-p port] [-I adres-IP] [-t limit-czasu] [-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 podmiot-certyfikatu] --tls-cert-file plik-certyfikatu --tls-key-file plik-klucza [--tls-cipher13 ciąg-szyfru] [--tls-cipher ciąg-szyfru] -k klucz -o wartość
zabbix_sender [-v] -c plik-konfiguracyjny [-z serwer] [-p port] [-I adres-IP] [-t limit-czasut] [-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 podmiot-certyfikatu] --tls-cert-file plik-certyfikatu --tls-key-file plik-klucza [--tls-cipher13 ciąg-szyfru] [--tls-cipher ciąg-szyfru] [-T] [-N] [-r] -i plik-wejściowy
zabbix_sender [-v] -z serwer [-p port] [-I adres-IP] [-t limit-czasu] -s host --tls-connect psk --tls-psk-identity identyfikator-PSK --tls-psk-file plik-PSK [--tls-cipher13 ciąg-szyfru] [--tls-cipher ciąg-szyfru] -k klucz -o wartość
zabbix_sender [-v] -z serwer [-p port] [-I adres-IP] [-t limit-czasu] [-s host] --tls-connect psk --tls-psk-identity identyfikator-PSK --tls-psk-file plik-PSK [--tls-cipher13 ciąg-szyfru] [--tls-cipher ciąg-szyfru] [-T] [-N] [-r] -i plik-wejściowy
zabbix_sender [-v] -c plik-konfiguracyjny [-z serwer] [-p port] [-I adres-IP] [-t limit-czasu] [-s host] --tls-connect psk --tls-psk-identity identyfikator-PSK --tls-psk-file plik-PSK [--tls-cipher13 ciąg-szyfru] [--tls-cipher ciąg-szyfru] -k klucz -o wartość
zabbix_sender [-v] -c plik-konfiguracyjny [-z serwer] [-p port] [-I adres-IP] [-t limit-czasu] [-s host] --tls-connect psk --tls-psk-identity identyfikator-PSK --tls-psk-file plik-PSK [--tls-cipher13 ciąg-szyfru] [--tls-cipher ciąg-szyfru] [-T] [-N] [-r] -i plik-wejściowy
zabbix_sender -h
zabbix_sender -V

DESCRIPTION

zabbix_sender jest narzędziem linii poleceń, który wysyła dane do serwera Zabbix lub proxy. Na serwerze Zabbix należy utworzyć pozycję Trapper Zabbix z odpowiednim kluczem. Należy pamiętać, że zwrócone będą akceptowane tylko z hostów określonych w polu Dopuszczalne hosty dla tej pozycji.

OPCJE

-c, --config plik-konfiguracyjny
Używapliku-konfiguracyjnego. Zabbix sender odczytuje szczegóły serwera z pliku konfiguracyjnego agenta. Domyślnie Zabbix sender nie czyta żadnego pliku konfiguracyjnego. Tylko parametry Hostname, ServerActive, SourceIP, TLSConnect, TLSCAFile, TLSCRLFile, TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile, TLSKeyFile, TLSPSKIdentity and TLSPSKFile są obsługiwane. Wszystkie adresy w parametrze konfiguracyjnymServerActive są wykorzystywane do wysyłania danych.Jeżeli wysyłanie danych wsadowych nie powiedzie się na jeden adres, następne dane wsadowe nie są już wysyłane na ten adres.

-z, --zabbix-server serwer
Określa nazwę lub adres IP serwera Zabbix. Jeżeli host jest monitorowany przez proxy, nalezy użyć nazwę lub adres IP tego proxy. Kiedy jest używane razem z parametrem --config, zastępuje parametr ServerActive określony w pliku konfiguracyjnym agenta.

-p, --port port
Określa port Trappera uruchomionego na serwerze Zabbix. Domyślnie jest to 10051. Kiedy jest używane razem z parametrem --config, zastępuje wartość portu określonego w parametrze ServerActive w pliku konfiguracyjnym agenta.

-I, --source-address adres-IP
Określa źródłowy adres IP. W połączeniu z parametrem --config, zastępuje parametr SourceIP określony w pliku konfiguracyjnym agenta.

-t, --timeout sekundy
Określa limit czasu. Prawidłowy zakres: 1-300 sekund (domyślnie: 60)

-s, --host host
Określa nazwę hosta do którego należy pozycja (zarejestrowany w frontendzie Zabbix). Adres IP lub nazwa DNS nie będą działać. Kiedy jest użyte razem z parametrem --config, nadpisuje parametr Hostname w pliku konfiguracyjnym agenta.

-k, --key klucz
Określa klucz pozycji, dla którego ma zostać wysłana wartość.

-o, --value value
Określa wartość pozycji.

-i, --input-file plik-wejściowy
Ładuje wartości z pliku wejściowego. Określenie - jaki <plik-wejściowy> powoduje odczytanie wartości ze standardowego wejścia. Każdy wiersz pliku zawiera białe znaki oddzielane: <nazwa hosta> <klucz> <wartość>.Każda wartość musi być określona w osobnym wierszu. Każdy wiersz musi zawierać 3 wartości rozdzielane białymi znakami: <nazwa hosta> <klucz> <wartość>, gdzie "nazwa hosta" to nazwa monitorowanego hosta zarejestrowana w frontendzie Zabbix, "klucz" to klucz pozycji docelowej, a "wartość" - wartość do wysłania. Określenie - jaki <nazwa hosta> powoduje użycie nazwy hosta z pliku konfiguracyjnego agenta lub z parametru --host.

Przykładowa linia pliku wejściowego:

"Linux DB3" db.connections 43

Typ wartości musi być poprawnie ustawion w konfiguracji pozycji frontendu Zabbix. Zabbix sender podczas jednego połączenia wyśle do 250 wartości. Zawartość pliku wejściowego musi być zakodowana w UTF-8. Wszystkie wartości z pliku wejściowego są wysyłane od góry do dołu. Wpisy muszą być sformatowane zgodnie z następującymi regułami:

Obsługiwane są wpisy cytowane i niecytowane.
Cudzysłów podwójny to znak cytowania.
Wpisy z białymi znakami musza być cytowane.
Znaki cudzysłowu i ukośnika odwrotnego w cytowanym wpisie muszą być poprzedzone ukośnikiem odwrotnym.
Znaki ucieczki nie są obsługiwane w wpisach niecytowanych.
Znak ucieczki nowej linii (\n) są obsługiwane w wpisach cytowanych.
Znak ucieczki nowej linii jest wycinany z końca wpisu.

-T, --with-timestamps
Ta opcja może być określona tylko z parametrem --input-file.

Każdy wiersz pliku wejściowego musi zawierać 4 wartości rozdzielone białymi znakami: <nazwa hosta> <klucz> <znacznik czasu> <wartość>. Znaczniki czasu powinien być określony w formacie UNIX. Jeśli docelowa pozycja posiada wyzwalacze odwołujące się do niego, wszystkie znaczniki czasu muszą być w porządku rosnącym, w przeciwnym razie obliczenie zdarzenia nie będzie poprawne.

Przykładowy wiersz pliku wejściowego:

"Linux DB3" db.connections 1429533600 43

Aby uzyskać więcej informacji, zobacz opcję --input-file.

Jeżeli wartość ze znacznikiem czasu jest wysyłana do hosta, który jest w stanie utrzymania w trybie “brak danych”, wtedy wartość zostaje pominięta; jednakże jest możliwość wysłania wartości z znacznikiem czasu w przypadku wygasłego stanu utrzymania i zostanie ona zaakceptowana.

-N, --with-ns
Ta opcja może być określona tylko z parametrem --with-timestamps.

Każdy wiersz pliku wejściowego musi zawierać 5 wartości rozdzielanymi białymi znakami: <nazwa hosta> <klucz> <znacznik czasu> <ns> <wartość>.

Przykładowy wiersz pliku wejściowego:

"Linux DB3" db.connections 1429533600 7402561 43

Aby uzyskać więcej informacji, zobacz opcję --input-file.

-r, --real-time
Wysyła wartości jeden po drugim gdy tylko zostaną odebrane. Opcja ta może być użyta przy odczycie z standardowego wejścia.

--tls-connect wartość
Określa sposób łączenia się do serwera lub proxy. Wartości:

unencrypted
połącz bez szyfrowania (domyślnie)

psk
połącz za pomocą TLS oraz klucza współdzielonego

cert
połącz za pomocą TLS oraz certyfikatu

--tls-ca-file plik-CA
Pełna ścieżka do pliku zawierającego certyfikaty urzędu certyfikacji dla weryfikacji certyfikatów równorzędnych.

--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.

--tls-server-cert-subject podmiot-certyfikatu
Dozwolony podmiot certyfikatu.

--tls-cert-file plik-certyfikatu
Pełna ścieżka do pliku zawierającego certyfikat lub łańcuch certyfikatów.

--tls-key-file klucz-prywatny
Pełna ścieżka do pliku zawierającego klucz prywatny.

--tls-psk-identity identyfikator-PSK
Ciąg znaków identyfikatora PSK.

--tls-psk-file plik-PSK
Pełna ścieżka do pliku zawierającego klucz współdzielony.

--tls-cipher13 ciąg-szyfru
Ciąg szyfru 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żeli wersja OpenSSL jest starsza niż 1.1.1.

--tls-cipher ciąg-szyfru
Łańcuch priorytetów GnuTLS (dla TLS 1.2 i nowszych) lub łańcuch szyfrujący OpenSSL (tylko dla TLS 1.2). Zastępuje domyślne kryteria wyboru zestawu szyfrów.

-v, --verbose
Tryb szczegółowy, -vv dla jeszcze więcej szczegółów.

-h, --help
Wypisuje tę pomoc i kończy działanie.

-V, --version
Wypisuje informacje o wersji i kończy działanie.

KOD POWROTU

Kod powrotu jest równy 0 jeżeli wartości zostały wysłane i wszystkie z nich zostały pomyślnie przetworzone przez serwer. Jeśli dane zostały wysłane, ale przetwarzanie chociaż jednej z nich nie powiodło się, kod powrotu wynosi 2. Jeśli wysyłanie danych nie powiodło się, kod powrotu jest równy 1.

PRZYKŁADY

zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -k mysql.queries -o 342.45

Wysyła 342.45 jako wartość dla pozycji mysql.queries monitorowanego hosta. Używa monitorowanego hosta i serwer Zabbix zdefiniowanego w pliku konfiguracyjnym agenta.

zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitorowany Host" -k mysql.queries -o 342.45

Wysyła 342.45 jako wartość dla pozycji mysql.queries dla hosta Monitorowany Host na serwer Zabbix zdefiniowany w pliku konfiguracyjnym agenta.

zabbix_sender -z 192.168.1.113 -i data_values.txt

Wysyła 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 -

Wysyła wartość ze znacznikiem czasu z wiersza poleceń do serwera Zabbix określonego w pliku konfiguracyjnym agenta. Myślnik w danych wejściowych wskazuje, że nazwa hosta powinna być pobrana również z tego samego pliku konfiguracyjnego.

echo '"Zabbix server" trapper.item ""' | zabbix_sender -z 192.168.1.113 -p 10000 -i -

Wysyła pustą wartość pozycji do serwera Zabbix z adresem IP 192.168.1.113 na porcie 10000 z wiersza poleceń. Puste wartości musza być zawarte w podwójnych cudzysłowach.

zabbix_sender -z 192.168.1.113 -s "Monitorowany 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

Wysyła 342.45 jako wartość dla pozycji mysql.queries dla hosta Monitorowany Host do serwera o adresie IP 192.168.1.113 używając TLS razem z certyfikatem.

zabbix_sender -z 192.168.1.113 -s "Monitorowany 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

Wysyła 342.45 jako wartość dla pozycji mysql.queries dla hosta Monitorowany Host do serwera o adresie IP 192.168.1.113 używając TLS razem z kluczem współdzielonym (PSK).