zabbix_sender

Sekcja: Polecenia użytkownika (1)
Zaktualizowano: 2021-06-01
Indeks Powrót do głównego spisu treści


[ ]{#lbAB}

NAME

zabbix_sender - narzędzie Zabbix sender [ ]{#lbAC}

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] [-g] -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] [-g] -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-szyfrów] [--tls-cipher ciąg-szyfrów] -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-szyfrów] [--tls-cipher ciąg-szyfrów] [-T] [-N] [-r] [-g] -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-szyfrów] [--tls-cipher ciąg-szyfrów] -k klucz -o wartość
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-szyfrów] [--tls-cipher ciąg-szyfrów] [-T] [-N] [-r] [-g] -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 tożsamość-PSK --tls-psk-file plik-PSK [--tls-cipher13 ciąg-szyfrów] [--tls-cipher ciąg-szyfrów] -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 tożsamość-PSK --tls-psk-file plik-PSK [--tls-cipher13 ciąg-szyfrów] [--tls-cipher ciąg-szyfrów] [-T] [-N] [-r] [-g] -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 tożsamość-PSK --tls-psk-file plik-PSK [--tls-cipher13 ciąg-szyfrów] [--tls-cipher ciąg-szyfrów] -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 tożsamość-PSK --tls-psk-file plik-PSK [--tls-cipher13 ciąg-szyfrów] [--tls-cipher ciąg-szyfrów] [-T] [-N] [-r] [-g] -i plik-wejściowy
zabbix_sender -h
zabbix_sender -V [ ]{#lbAD}

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. [ ]{#lbAE}

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 konfiguracyjnego. Obsługiwane są tylko parametry Hostname, ServerActive, SourceIP, TLSConnect, TLSCAFile, TLSCRLFile, TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile, TLSKeyFile, TLSPSKIdentity oraz TLSPSKFile.
Hostname zdefiniowany za pomocą parametru HostnameItem nie zostanie pobrany; w takim przypadku 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łanie partii danych do jednego adresu zakończy się niepowodzeniem, kolejne partie nie będą 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 proxy lub jego adresu IP. W przypadku użycia razem z --config nadpisuje wpisy parametru ServerActive określone w pliku konfiguracji agentd.

-p, --port port
Określ numer portu trappera serwera Zabbix działającego na serwerze. Wartość domyślna to 10051. W przypadku użycia razem z --config nadpisuje wpisy portu parametru ServerActive określone w pliku konfiguracji agentd.

-I, --source-address IP-address
Określ źródłowy adres IP. W przypadku użycia razem z --config nadpisuje parametr SourceIP określony 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 (zgodnie z rejestracją w frontendzie Zabbix). Adres IP hosta ani nazwa DNS nie zadziałają. W przypadku użycia razem z --config nadpisuje parametr Hostname określony 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. Podaj - jako <input-file>, aby odczytywać wartości ze standardowego wejścia. Każdy wiersz pliku zawiera wpisy rozdzielone białymi znakami: <hostname> <key> <value>. Każda wartość musi być określona w osobnym wierszu. Każdy wiersz 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 pozycji, a „value” — wartość do wysłania. Podaj - jako <hostname>, aby użyć nazwy hosta z pliku konfiguracji agenta lub z argumentu --host.

Przykład wiersza pliku wejściowego:

"Linux DB3" db.connections 43

Typ wartości musi być poprawnie ustawiony w konfiguracji pozycji we frontendzie Zabbix.
Zabbix sender wyśle do 250 wartości w jednym połączeniu.
Limit rozmiaru dla wysyłania wartości z pliku wejściowego zależy od rozmiaru opisanego w protokole komunikacyjnym Zabbix.
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 i nieujęte w cudzysłów.
  • 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 ujętego w cudzysłów muszą być poprzedzone ukośnikiem odwrotnym.
  • Escaping nie jest obsługiwany we wpisach nieujętych w cudzysłów.
  • 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 razem z opcją --input-file.

Każdy wiersz 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 docelowa pozycja ma wyzwalacze odwołujące się do niej, wszystkie znaczniki czasu muszą być w kolejności rosnącej, w przeciwnym razie obliczanie zdarzeń nie będzie poprawne.

Przykład wiersza pliku wejściowego:

"Linux DB3" db.connections 1429533600 43

Więcej szczegółów można znaleźć przy opcji --input-file.

Jeśli wartość ze znacznikiem czasu zostanie wysłana dla hosta, który znajduje się w konserwacji typu „brak danych”, to ta wartość 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 razem z opcją --with-timestamps.

Każdy wiersz pliku wejściowego musi zawierać 5 wpisó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 szczegółów można znaleźć przy 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.

-g, --group
Grupuj wartości według hostów i wysyłaj je do każdego hosta w osobnej partii.

--tls-connect value
Sposób połączenia z serwerem lub proxy. Wartości:

[ ]{#lbAF}

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.

[ ]{#lbAG}

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.

[ ]{#lbAH}

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

[ ]{#lbAI}

ZOBACZ TAKŻE

Dokumentacja https://www.zabbix.com/manuals

zabbix_agentd(8), zabbix_get(1), zabbix_proxy(8), zabbix_server(8), zabbix_js(1), zabbix_agent2(8), zabbix_web_service(8) [ ]{#lbAJ}

Indeks

NAZWA

STRESZCZENIE

OPIS

OPCJE

STATUS WYJŚCIA

PRZYKŁADY

ZOBACZ TAKŻE

AUTOR


Ten dokument został utworzony: 08:42:39 GMT, 11 czerwca 2021 r.