Abrufen
Übersicht
Zabbix get ist ein Befehlszeilenwerkzeug, das zur Kommunikation mit dem Zabbix Agent verwendet werden kann, um die erforderlichen Informationen vom Agent abzurufen.
Das Dienstprogramm wird in der Regel zur Fehlerbehebung bei Zabbix Agenten verwendet.
Siehe auch die Python-Bibliothek für Zabbix, die über eine integrierte Funktionalität verfügt, um sich wie Zabbix get zu verhalten.
Zabbix get ausführen
Ein Beispiel für die Ausführung 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 die Ausführung von Zabbix get zum Erfassen einer Zeichenfolge 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 Datenpunkt-Schlüssel hier ein Leerzeichen enthält, daher werden Anführungszeichen verwendet, um den Datenpunkt-Schlüssel für die Shell zu kennzeichnen. Die Anführungszeichen sind nicht Teil des Datenpunkt-Schlüssels; sie werden von der Shell entfernt und nicht an den Zabbix Agent übergeben.
Wenn ein Datenpunkt-Schlüssel nicht unterstützt wird, gibt Zabbix get den Exit-Code 1 zurück.
Zabbix get akzeptiert die folgenden Befehlszeilenparameter:
-s --host <host name or IP> Hostnamen oder IP-Adresse eines Hosts angeben
-p --port <port number> Portnummer des auf dem Host laufenden Agent angeben (Standard: 10050)
-I --source-address <IP address> Quell-IP-Adresse angeben
-t --timeout <seconds> Timeout angeben. Gültiger Bereich: 1-600 Sekunden (Standard: 30 Sekunden)
-k --key <item key> Schlüssel des abzurufenden Datenpunkts angeben
-P --protocol <value> Protokoll für die Kommunikation mit dem Agent. Werte:
auto - Verbindung über das JSON-Protokoll herstellen, bei Fehler auf Klartextprotokoll zurückfallen und erneut versuchen (Standard)
json - Verbindung über das JSON-Protokoll herstellen
plaintext - Verbindung über das Klartextprotokoll herstellen, bei dem nur der Datenpunkt-Schlüssel gesendet wird (6.4.x und ältere Versionen)
-h --help Diese Hilfemeldung anzeigen
-V --version Versionsnummer anzeigen
--tls-connect <value> Verbindungsart zum Agent. Werte:
unencrypted - ohne Verschlüsselung verbinden (Standard)
psk - Verbindung über TLS und einen vorab gemeinsam genutzten Schlüssel herstellen
cert - Verbindung über TLS und ein Zertifikat herstellen
--tls-ca-file <CA file> Vollständiger Pfad zu einer Datei mit den Zertifikaten der obersten CA(s) zur Überprüfung des Zertifikats des Gegenübers
--tls-crl-file <CRL file> Vollständiger Pfad zu einer Datei mit widerrufenen Zertifikaten
--tls-agent-cert-issuer <cert issuer> Zulässiger Aussteller des Agent-Zertifikats
--tls-agent-cert-subject <cert subject> Zulässiger Betreff des Agent-Zertifikats
--tls-cert-file <cert file> Vollständiger Pfad zu einer Datei mit dem Zertifikat oder der Zertifikatskette
--tls-key-file <key file> Vollständiger Pfad zu einer Datei mit dem privaten Schlüssel
--tls-psk-identity <PSK-identity> Eindeutige, groß-/kleinschreibungssensitive Zeichenfolge zur Identifizierung des vorab gemeinsam genutzten Schlüssels
--tls-psk-file <PSK-file> Vollständiger Pfad zu einer Datei mit dem vorab gemeinsam genutzten Schlüssel
--tls-cipher13 <cipher-string> Cipher-String für OpenSSL 1.1.1 oder neuer für TLS 1.3. Überschreibt die Standardauswahl der Cipher Suites. Diese Option ist nicht verfügbar, wenn die OpenSSL-Version kleiner als 1.1.1 ist
--tls-cipher <cipher-string> GnuTLS-Prioritätszeichenfolge (für TLS 1.2 und höher) oder OpenSSL-Cipher-String (nur für TLS 1.2). Überschreibt die Standardauswahl der Cipher SuitesWeitere Informationen finden Sie auch auf der Zabbix get manpage.
Zabbix get kann unter Windows auf ähnliche Weise ausgeführt werden:
zabbix_get.exe [options]