7 Get

Przegląd

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

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

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

Uruchamianie Zabbix get

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

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

Inny przykład uruchomienia Zabbix get do przechwycenia 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ę, dlatego 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 Zabbix agent.

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śl nazwę hosta lub adres IP hosta
-p --port <port number>                 Określ numer portu agent uruchomionego na hoście (domyślnie: 10050)
-I --source-address <IP address>        Określ źródłowy adres IP
-t --timeout <seconds>                  Określ limit czasu. Prawidłowy zakres: 1-600 sekund (domyślnie: 30 sekund)
-k --key <item key>                     Określ klucz pozycji, dla której ma zostać pobrana wartość
-P --protocol <value>                   Protokół używany do komunikacji z agent. Wartości:
                                            auto - połącz przy użyciu protokołu JSON, w razie niepowodzenia wróć i ponów próbę z protokołem tekstowym (domyślnie)
                                            json - połącz przy użyciu protokołu JSON
                                            plaintext - połącz przy użyciu protokołu tekstowego, w którym wysyłany jest tylko klucz pozycji (wydania 6.4.x i starsze)
-h --help                               Wyświetl ten komunikat pomocy
-V --version                            Wyświetl numer wersji

--tls-connect <value>                   Sposób połączenia z agent. 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 <CA file>                 Pełna ścieżka do pliku zawierającego certyfikaty głównych urzędów certyfikacji (CA) do weryfikacji certyfikatu strony zdalnej
--tls-crl-file <CRL file>               Pełna ścieżka do pliku zawierającego unieważnione certyfikaty
--tls-agent-cert-issuer <cert issuer>   Dozwolony wystawca certyfikatu agent
--tls-agent-cert-subject <cert subject> Dozwolony temat certyfikatu agent
--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 ciąg znaków rozróżniający wielkość liter, używany do identyfikacji klucza współdzielonego
--tls-psk-file <PSK-file>               Pełna ścieżka do pliku zawierającego klucz współdzielony
--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

Zobacz także stronę podręcznika Zabbix get, aby uzyskać więcej informacji.

Zabbix get w systemie Windows można uruchomić podobnie:

zabbix_get.exe [options]