Pobierz

Przegląd

Zabbix get to narzędzie wiersza poleceń, które można używać do komunikacji z agent i pobierania wymaganych informacji z agenta.

To narzędzie jest zwykle używane do rozwiązywania problemów z agentami Zabbix.

Zobacz także bibliotekę Python dla Zabbix, która ma wbudowaną funkcjonalność pozwalającą działać podobnie jak Zabbix get.

Uruchamianie Zabbix get

Przykład uruchomienia Zabbix get w systemie UNIX w celu pobrania wartości obciążenia procesora z agenta:

cd bin
./zabbix_get -s 127.0.0.1 -p 10050 -k system.cpu.load[all,avg1]

Inny przykład uruchomienia Zabbix get w celu pobrania ciągu znaków ze strony internetowej:

cd bin
./zabbix_get -s 192.168.1.1 -p 10050 -k "web.page.regexp[www.example.com,,,\"USA: ([a-zA-Z0-9.-]+)\",,\1]"

Zwróć uwagę, że klucz pozycji zawiera tutaj spację, więc do oznaczenia klucza pozycji dla powłoki użyto cudzysłowów. Cudzysłowy nie są częścią klucza pozycji; zostaną usunięte przez powłokę i nie zostaną przekazane do agenta Zabbix.

Jeśli klucz pozycji nie jest obsługiwany, Zabbix get zwróci kod wyjścia 1.

Zabbix get akceptuje następujące parametry wiersza poleceń:

-s --host <host name or IP>             Określa nazwę hosta lub adres IP hosta
-p --port <port number>                 Określa numer portu agenta działającego na hoście (domyślnie: 10050)
-I --source-address <IP address>        Określa źródłowy adres IP
-t --timeout <seconds>                  Określa limit czasu. Prawidłowy zakres: 1-600 sekund (domyślnie: 30 sekund)
-k --key <item key>                     Określa klucz pozycji, dla której ma zostać pobrana wartość
-P --protocol <value>                   Protokół używany do komunikacji z agentem. Wartości:
                                            auto - łączy przy użyciu protokołu JSON, w razie niepowodzenia przełącza się i ponawia próbę z protokołem tekstowym (domyślnie)
                                            json - łączy przy użyciu protokołu JSON
                                            plaintext - łączy przy użyciu protokołu tekstowego, w którym wysyłany jest tylko klucz pozycji (wersje 6.4.x i starsze)
-h --help                               Wyświetla ten komunikat pomocy
-V --version                            Wyświetla numer wersji

--tls-connect <value>                   Sposób łączenia się z agentem. Wartości:
                                            unencrypted - łączy bez szyfrowania (domyślnie)
                                            psk - łączy przy użyciu TLS i współdzielonego klucza
                                            cert - łączy przy użyciu TLS i certyfikatu
--tls-ca-file <CA file>                 Pełna ścieżka do pliku zawierającego certyfikaty głównego urzędu CA do weryfikacji certyfikatu partnera
--tls-crl-file <CRL file>               Pełna ścieżka do pliku zawierającego certyfikaty unieważnione
--tls-agent-cert-issuer <cert issuer>   Dozwolony wystawca certyfikatu agenta
--tls-agent-cert-subject <cert subject> Dozwolony podmiot certyfikatu agenta
--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>       Unikalny, rozróżniający wielkość liter ciąg używany do identyfikacji współdzielonego klucza
--tls-psk-file <PSK-file>               Pełna ścieżka do pliku zawierającego współdzielony klucz
--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 (tylko dla TLS 1.2). Zastępuje domyślne kryteria wyboru zestawu szyfrów

Więcej informacji można znaleźć w stronie podręcznika Zabbix get.

Zabbix get w systemie Windows można uruchomić w podobny sposób:

zabbix_get.exe [options]