Obtenir

Vue d'ensemble

Zabbix get est un utilitaire en ligne de commande qui peut être utilisé pour communiquer avec l'agent Zabbix et récupérer les informations requises depuis l'agent.

L'utilitaire est généralement utilisé pour le dépannage des agents Zabbix.

Voir aussi la bibliothèque Python pour Zabbix, qui dispose d'une fonctionnalité intégrée permettant de fonctionner comme Zabbix get.

Exécution de Zabbix get

Voici un exemple d’exécution de Zabbix get sous UNIX pour obtenir la valeur de charge du processeur à partir de l’agent :

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

Autre exemple d’exécution de Zabbix get pour capturer une chaîne depuis un site web :

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

Notez que la clé d’élément contient ici un espace, donc des guillemets sont utilisés pour indiquer la clé d’élément au shell. Les guillemets ne font pas partie de la clé d’élément ; ils seront supprimés par le shell et ne seront pas transmis à l’agent Zabbix.

Si une clé d’élément n’est pas prise en charge, Zabbix get renverra le code de sortie 1.

Zabbix get accepte les paramètres de ligne de commande suivants :

-s --host <host name or IP>             Spécifie le nom d’hôte ou l’adresse IP d’un hôte
-p --port <port number>                 Spécifie le numéro de port de l’agent exécuté sur l’hôte (par défaut : 10050)
-I --source-address <IP address>        Spécifie l’adresse IP source
-t --timeout <seconds>                  Spécifie le délai d’attente. Plage valide : 1-600 secondes (par défaut : 30 secondes)
-k --key <item key>                     Spécifie la clé de l’élément dont il faut récupérer la valeur
-P --protocol <value>                   Protocole utilisé pour communiquer avec l’agent. Valeurs :
                                            auto - se connecte en utilisant le protocole JSON, avec repli et nouvelle tentative en protocole texte brut (par défaut)
                                            json - se connecte en utilisant le protocole JSON
                                            plaintext - se connecte en utilisant le protocole texte brut, où seule la clé d’élément est envoyée (versions 6.4.x et antérieures)
-h --help                               Affiche ce message d’aide
-V --version                            Affiche le numéro de version

--tls-connect <value>                   Mode de connexion à l’agent. Valeurs :
                                            unencrypted - connexion sans chiffrement (par défaut)
                                            psk - connexion en utilisant TLS et une clé prépartagée
                                            cert - connexion en utilisant TLS et un certificat
--tls-ca-file <CA file>                 Chemin complet d’un fichier contenant les certificats de l’AC racine pour la vérification du certificat du pair
--tls-crl-file <CRL file>               Chemin complet d’un fichier contenant les certificats révoqués
--tls-agent-cert-issuer <cert issuer>   Émetteur de certificat d’agent autorisé
--tls-agent-cert-subject <cert subject> Sujet de certificat d’agent autorisé
--tls-cert-file <cert file>             Chemin complet d’un fichier contenant le certificat ou la chaîne de certificats
--tls-key-file <key file>               Chemin complet d’un fichier contenant la clé privée
--tls-psk-identity <PSK-identity>       Chaîne unique, sensible à la casse, utilisée pour identifier la clé prépartagée
--tls-psk-file <PSK-file>               Chemin complet d’un fichier contenant la clé prépartagée
--tls-cipher13 <cipher-string>          Chaîne de chiffrement pour OpenSSL 1.1.1 ou version ultérieure pour TLS 1.3. Remplace les critères de sélection de la suite de chiffrement par défaut. Cette option n’est pas disponible si la version d’OpenSSL est inférieure à 1.1.1
--tls-cipher <cipher-string>            Chaîne de priorité GnuTLS (pour TLS 1.2 et versions ultérieures) ou chaîne de chiffrement OpenSSL (uniquement pour TLS 1.2). Remplace les critères de sélection de la suite de chiffrement par défaut

Voir aussi la page de manuel Zabbix get pour plus d’informations.

Zabbix get sous Windows peut être exécuté de manière similaire :

zabbix_get.exe [options]