Áú»¢¶Ä²©

3 V¨¦rifications passives et actives des agents

Aper?u

Cette section fournit des d¨¦tails sur les v¨¦rifications passives et actives effectu¨¦es par l'agent Áú»¢¶Ä²©.

Áú»¢¶Ä²© utilise un protocole de communication bas¨¦ sur JSON pour communiquer avec l'agent Áú»¢¶Ä²©.

Voir aussi les d¨¦tails de protocole de l'Agent Áú»¢¶Ä²© 2.

V¨¦rifications passives

Une v¨¦rification passive est une simple demande de donn¨¦es. Le serveur ou le proxy Áú»¢¶Ä²© demande des donn¨¦es (par exemple, la charge du processeur) et l'agent Áú»¢¶Ä²© renvoie le r¨¦sultat au serveur.

**Requ¨ºte du serveur **

Pour la d¨¦finition de l'en-t¨ºte et de la longueur des donn¨¦es, veuillez vous reporter aux d¨¦tails du protocole.

<item key>

R¨¦ponse de l'agent

<DATA>[\0<ERROR>]

Ci-dessus, la partie entre crochets est facultative et n'est envoy¨¦e que pour les ¨¦l¨¦ments non support¨¦s.

Par exemple, pour les ¨¦l¨¦ments support¨¦s :

1. Le serveur ouvre une connexion TCP
2. Le serveur envoie <HEADER><DATALEN>agent.ping
3. L'agent lit la requ¨ºte et r¨¦pond avec <HEADER><DATALEN>1
4. Le serveur traite les donn¨¦es pour obtenir la valeur, '1' dans notre cas
5. La connexion TCP est ferm¨¦e

Pour les ¨¦l¨¦ments non support¨¦s :

1. Le serveur ouvre une connexion TCP
2. Le serveur envoie <HEADER><DATALEN>vfs.fs.size[/nono]
3. L'agent lit la demande et r¨¦pond avec <HEADER><DATALEN>ZBX_NOTSUPPORTED\0Cannot obtain filesystem information: [2] No such file or directory
4. Le serveur traite les donn¨¦es et modifie l'¨¦tat de l'¨¦l¨¦ment ¨¤ non support¨¦ avec le message d'erreur sp¨¦cifi¨¦.
5. La connexion TCP est ferm¨¦e

V¨¦rifications actives

Les v¨¦rifications actives n¨¦cessitent un traitement plus complexe. L'agent doit d'abord r¨¦cup¨¦rer sur le(s) serveur(s) une liste d'¨¦l¨¦ments pour un traitement ind¨¦pendant.

Les serveurs ¨¤ partir desquels obtenir les v¨¦rifications actives sont r¨¦pertori¨¦s dans le param¨¨tre 'ServerActive' du fichier de configuration de l'agent. La fr¨¦quence des demandes pour ces v¨¦rifications est d¨¦fini par le param¨¨tre 'RefreshActiveChecks' dans le m¨ºme fichier de configuration. Cependant, si le rafra?chissement des v¨¦rifications actives ¨¦choue, il sera r¨¦essay¨¦ apr¨¨s 60 secondes (cod¨¦es en dur).

L'agent envoie alors p¨¦riodiquement les nouvelles valeurs au(x) serveur(s).

Obtenir la liste des ¨¦l¨¦ments

Requ¨ºte de l'agent

La requ¨ºte des 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 de RefreshActiveChecks.

{
         "request": "active checks",
         "host": "Áú»¢¶Ä²© server",
         "host_metadata": "mysql,nginx",
         "hostinterface": "zabbix.server.lan",
         "ip": "159.168.1.1",
         "port": 12050
       }

R¨¦ponse du serveur

La r¨¦ponse des v¨¦rifications actives est renvoy¨¦e par le serveur ¨¤ l'agent apr¨¨s le traitement de la requ¨ºte de v¨¦rifications actives.

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

Le serveur doit r¨¦pondre avec succ¨¨s.

Par exemple :

1. L'agent ouvre une connexion TCP
2. L'agent demande la liste des v¨¦rifications
3. Le serveur r¨¦pond avec une liste d'¨¦l¨¦ments (cl¨¦ d'¨¦l¨¦ment, d¨¦lai)
4. L'agent analyse la r¨¦ponse
5. La connexion TCP est ferm¨¦e
6. L'agent commence la collecte p¨¦riodique des donn¨¦es

Envoi des donn¨¦es collect¨¦es

Envois de l'agent

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

{
         "request": "agent data",
         "data": [
           {
             "host": "Áú»¢¶Ä²© server",
             "key": "agent.version",
             "value": "2.4.0",
             "clock": 1400675595,
             "ns": 76808644
           },
           {
             "host": "Áú»¢¶Ä²© server",
             "key": "log[/home/zabbix/logs/zabbix_agentd.log]",
             "lastlogsize": 112,
             "value": " 19845:20140621:141708.521 Starting Áú»¢¶Ä²© Agent [<hostname>]. Áú»¢¶Ä²© 2.4.0 (revision 50000).",
             "clock": 1400675595,
             "ns": 77053975
           }
         ],
         "session": "1234456akdsjhfoui"
       }

Un identifiant virtuel est attribu¨¦ ¨¤ chaque valeur. L'ID de valeur est un simple compteur croissant, unique au sein d'une session de donn¨¦es (identifi¨¦ par le jeton de session). Cet ID est utilis¨¦ pour supprimer les valeurs en double qui pourraient ¨ºtre envoy¨¦es dans des environnements de mauvaise connectivit¨¦.

R¨¦ponse du serveur

La r¨¦ponse de donn¨¦es d'agent est renvoy¨¦e par le serveur ¨¤ l'agent apr¨¨s le traitement de la demande de donn¨¦es d'agent.

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

::: noteimportant Si l'envoi de certaines valeurs ¨¦choue sur le serveur (par exemple, parce que l'h?te ou l'¨¦l¨¦ment a ¨¦t¨¦ d¨¦sactiv¨¦ ou supprim¨¦), l'agent ne r¨¦essayera pas d'envoyer ces valeurs. :::

Par exemple :

1. L'agent ouvre une connexion TCP
2. L'agent envoie une liste de valeurs
3. Le serveur traite les donn¨¦es et renvoie le statut
4. La connexion TCP est ferm¨¦e

Notez que dans l'exemple ci-dessus, le statut non pris en charge pour vfs.fs.size[/nono] est indiqu¨¦ par la valeur "state" de 1 et le message d'erreur dans la propri¨¦t¨¦ "value".

Ancien protocole XML