7 Get

Aperçu

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.

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

Voir également la bibliothèque Python pour Zabbix, qui intègre une fonctionnalité permettant d'agir comme Zabbix get.

Exécution de Zabbix get

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

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

Voici un 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 qu’ici, la clé d’élément contient un espace, des guillemets sont donc utilisés pour indiquer la clé d’élément à l’interpréteur de commandes. Les guillemets ne font pas partie de la clé d’élément ; ils seront supprimés par l’interpréteur de commandes 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écifier le nom d’hôte ou l’adresse IP d’un hôte
-p --port <port number>                 Spécifier le numéro de port de l’agent exécuté sur l’hôte (par défaut : 10050)
-I --source-address <IP address>        Spécifier l’adresse IP source
-t --timeout <seconds>                  Spécifier le délai d’attente. Plage valide : 1-600 secondes (par défaut : 30 secondes)
-k --key <item key>                     Spécifier la clé de l’élément pour lequel récupérer la valeur
-P --protocol <value>                   Protocole utilisé pour communiquer avec l’agent. Valeurs :
                                            auto - se connecter en utilisant le protocole JSON, puis revenir au protocole en texte brut et réessayer si nécessaire (par défaut)
                                            json - se connecter en utilisant le protocole JSON
                                            plaintext - se connecter en utilisant le protocole en texte brut où seule la clé d’élément est envoyée (versions 6.4.x et antérieures)
-h --help                               Afficher ce message d’aide
-V --version                            Afficher le numéro de version

--tls-connect <value>                   Méthode de connexion à l’agent. Valeurs :
                                            unencrypted - se connecter sans chiffrement (par défaut)
                                            psk - se connecter en utilisant TLS et une clé pré-partagée
                                            cert - se connecter en utilisant TLS et un certificat
--tls-ca-file <CA file>                 Chemin complet vers un fichier contenant les certificats de la ou des autorités de certification racines pour la vérification du certificat du pair
--tls-crl-file <CRL file>               Chemin complet vers 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 vers un fichier contenant le certificat ou la chaîne de certificats
--tls-key-file <key file>               Chemin complet vers 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 vers 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 par défaut de la suite cryptographique. 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 supérieur) ou chaîne de chiffrement OpenSSL (uniquement pour TLS 1.2). Remplace les critères de sélection par défaut de la suite cryptographique

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]