zabbix_sender
Sekcja: Komendy użytkownika (1)
Zaktualizowano: 2021-06-01
Indeks Wróć do głównej zawartoś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] -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 [ ]{#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 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:
[ ]{#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
Ten dokument został stworzony o: 08:42:39 GMT,11 czerwca, 2021