7 Abrufen

Überblick

Zabbix get ist ein Befehlszeilenprogramm, das zur Kommunikation mit dem Zabbix Agent verwendet werden kann und die benötigten Informationen vom Agent abruft.

Das Programm wird in der Regel zur Fehlerbehebung von Zabbix Agents verwendet.

Siehe auch die Python-Bibliothek für Zabbix, die eine integrierte Funktionalität bietet, um wie Zabbix get zu arbeiten.

Ausführen von Zabbix get

Ein Beispiel für das Ausführen von Zabbix get unter UNIX, um den Prozessorlastwert vom Agent abzurufen:

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

Ein weiteres Beispiel für das Ausführen von Zabbix get zum Erfassen einer Zeichenkette von einer Website:

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

Beachten Sie, dass der Datenpunktschlüssel hier ein Leerzeichen enthält, daher werden Anführungszeichen verwendet, um den Datenpunktschlüssel für die Shell zu kennzeichnen. Die Anführungszeichen sind nicht Teil des Datenpunktschlüssels; sie werden von der Shell entfernt und nicht an den Zabbix Agent übergeben.

Wenn ein Datenpunktschlüssel nicht unterstützt wird, gibt Zabbix get den Exit-Code 1 zurück.

Zabbix get akzeptiert die folgenden Befehlszeilenparameter:

-s --host <Host-Name oder IP>             Host-Namen oder IP-Adresse eines Hosts angeben
-p --port <Portnummer>                    Portnummer des auf dem Host laufenden Agent angeben (Standard: 10050)
-I --source-address <IP-Adresse>          Quell-IP-Adresse angeben
-t --timeout <Sekunden>                   Timeout angeben. Gültiger Bereich: 1-600 Sekunden (Standard: 30 Sekunden)
-k --key <Datenpunktschlüssel>            Schlüssel des Datenpunkts angeben, für den der Wert abgerufen werden soll
-P --protocol <Wert>                      Für die Kommunikation mit dem Agent verwendetes Protokoll. Werte:
                                            auto - Verbindung über JSON-Protokoll herstellen, bei Bedarf auf Klartextprotokoll zurückfallen und erneut versuchen (Standard)
                                            json - Verbindung über JSON-Protokoll herstellen
                                            plaintext - Verbindung über Klartextprotokoll herstellen, bei dem nur der Datenpunktschlüssel gesendet wird (6.4.x und ältere Versionen)
-h --help                                 Diese Hilfemeldung anzeigen
-V --version                              Versionsnummer anzeigen

--tls-connect <Wert>                      Art der Verbindung zum Agent. Werte:
                                            unencrypted - Verbindung ohne Verschlüsselung herstellen (Standard)
                                            psk - Verbindung über TLS und einen Pre-Shared Key herstellen
                                            cert - Verbindung über TLS und ein Zertifikat herstellen
--tls-ca-file <CA-Datei>                  Vollständiger Pfadname zu einer Datei mit den Zertifikaten der obersten CA(s) zur Verifizierung des Peer-Zertifikats
--tls-crl-file <CRL-Datei>                Vollständiger Pfadname zu einer Datei mit gesperrten Zertifikaten
--tls-agent-cert-issuer <Zertifikatsaussteller>   Zulässiger Aussteller des Agent-Zertifikats
--tls-agent-cert-subject <Zertifikatssubjekt> Zulässiges Subjekt des Agent-Zertifikats
--tls-cert-file <Zertifikatsdatei>        Vollständiger Pfadname zu einer Datei mit dem Zertifikat oder der Zertifikatskette
--tls-key-file <Schlüsseldatei>           Vollständiger Pfadname zu einer Datei mit dem privaten Schlüssel
--tls-psk-identity <PSK-Identität>        Eindeutige, groß-/kleinschreibungssensitive Zeichenkette zur Identifizierung des Pre-Shared Key
--tls-psk-file <PSK-Datei>                Vollständiger Pfadname zu einer Datei mit dem Pre-Shared Key
--tls-cipher13 <cipher-string>            Cipher-String für OpenSSL 1.1.1 oder neuer für TLS 1.3. Überschreibt die Standardkriterien für die Auswahl der Chiffriersuite. Diese Option ist nicht verfügbar, wenn die OpenSSL-Version kleiner als 1.1.1 ist
--tls-cipher <cipher-string>              GnuTLS-Prioritätsstring (für TLS 1.2 und höher) oder OpenSSL-Cipher-String (nur für TLS 1.2). Überschreibt die Standardkriterien für die Auswahl der Chiffriersuite

Siehe auch die Zabbix get manpage für weitere Informationen.

Zabbix get unter Windows kann auf ähnliche Weise ausgeführt werden:

zabbix_get.exe [options]