Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

3 Protocole de l'agent Zabbix 2

Aperçu

Cette rubrique fournit des informations sur :

  • Agent2 -> Serveur : demande de vérifications actives

  • Serveur -> Agent2 : réponse de vérifications actives

  • Agent2 -> Serveur : demande de données agent

  • Serveur -> Agent2 : réponse des données agent

Demande de vérifications actives

La demande de vérifications actives est utilisée pour obtenir les vérifications actives à traiter par l'agent. Cette requête est envoyée par l'agent au démarrage, puis avec des intervalles RefreshActiveChecks.

Champ Type Obligatoire Valeur
request string oui vérifications actives
host string oui Nom d'hôte.
version string oui La version de l'agent : <majeur>.<mineur>.
host_metadata string non Le paramètre de configuration HostMetadata ou la valeur de métrique HostMetadataItem.
interface string non La valeur métrique du paramètre de configuration HostInterface ou HostInterfaceItem.
IP string non La première IP du paramètre de configuration ListenIP s'il est défini.
port number non La valeur du paramètre de configuration ListenPort s'il est défini et non le port d'écoute par défaut de l'agent.

Exemple:

{
        · "request": "active checks",
        · "host": "Zabbix server",
        · "version": "6.0",
        · "host_metadata": "mysql,nginx",
        · "hostinterface": "zabbix.server.lan"
        · "ip": "159.168.1.1",
        · "port": 12050
       }

Réponse de vérifications actives

La réponse de vérifications actives est renvoyée par le serveur à l'agent après le traitement de la demande de vérifications actives.

Champ Type Obligatoire Valeur
response string oui success | failed
info string non Informations d'erreur en cas d'échec.
data array of objects non Éléments de vérifications actives.
key string non Clé d'élément avec macros développées.
itemid number non Identificateur d'élément.
delay string non Intervalle de mise à jour de l'élément.
lastlogsize number non Dernière taille du journal de l'élément.
mtime number non Heure de l'élément.
regexp tableau d'objets non Expressions régulières globales.
name string non Nom de l'expression régulière globale.
expression string non Expression régulière globale.
expression_type number non Type d'expression régulière globale.
exp_delimiter string non Délimiteur global d'expression régulière.
case_sensitive number non Paramètre global de sensibilité à la casse des expressions régulières.

Exemple:

{
        · "response": "success",
        · "data": [
        · {
        · "key": "log[/home/zabbix/logs/zabbix_agentd.log]",
        · "itemid": 1234,
        · "delay": "30s",
        · "lastlogsize": 0,
        · "mtime": 0
        · },
        · {
        · "key": "agent.version",
        · "itemid": 5678,
        · "delay": "10m",
        · "lastlogsize": 0,
        · "mtime": 0
        · }
        · ]
       }

Demande de données agent

La demande de données agent contient les valeurs d'élément collectées.

Champ Type Obligatoire Valeur
request string oui agent data
host string oui Nom d'hôte.
version string oui La version de l'agent : <majeur>.<mineur>.
session string oui Identifiant de session unique généré à chaque démarrage de l'agent.
data array of objects oui Valeurs des éléments.
id number oui L'identifiant de la valeur (compteur incrémental utilisé pour vérifier les valeurs dupliquées en cas de problèmes de réseau).
itemid number oui Identificateur d'élément.
calue string non La valeur de l'élément.
lastlogsize number non Dernière taille du journal de l'élément.
mtime number non Heure de l'élément.
state number non L'état de l'élément.
source string non Source du journal des événements de valeur.
eventid number non La valeur eventid du journal des événements.
severity number non La sévérité du journal des événements de la valeur.
timestamp number non Horodatage du journal des événements de la valeur.
clock number oui L'horodatage de la valeur (secondes depuis Epoch).
ns number oui La valeur d'horodatage en nanosecondes.

Exemple:

{
        · "request": "agent data",
        · "data": [
        · {
        · "id": 1,
        · "itemid": 5678,
        · "value": "2.4.0",
        · "clock": 1400675595,
        · "ns": 76808644
        · },
        · {
        · "id": 2,
        · "itemid": 1234,
        · "lastlogsize": 112,
        · "value": " 19845:20140621:141708.521 Starting Zabbix Agent [<hostname>]. Zabbix 2.4.0 (revision 50000).",
        · "clock": 1400675595,
        · "ns": 77053975
        · }
        · ],
        · "host": "Zabbix server",
        · "version": "6.0",
        · "sessionid": "1234456akdsjhfoui"
       }

### Réponse des données agent

La réponse de données agent est renvoyée par le serveur à l'agent après le traitement de la demande de données agent.

Champ Type Obligatoire Valeur
response string oui success | failed
info string oui Résultats du traitement des éléments.

Exemple:

{
        · "response": "success",
        · "info": "processed: 2; failed: 0; total: 2; seconds spent: 0.003534"
       }