Documentation
Table of Contents
3 Protocole de l'agent Áú»¢¶Ä²© 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": "Áú»¢¶Ä²© 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 Áú»¢¶Ä²© Agent [<hostname>]. Áú»¢¶Ä²© 2.4.0 (revision 50000).",
¡¤ "clock": 1400675595,
¡¤ "ns": 77053975
¡¤ }
¡¤ ],
¡¤ "host": "Áú»¢¶Ä²© 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"
}Heartbeat message
The heartbeat message is sent by an active agent to Áú»¢¶Ä²© server/proxy every HeartbeatFrequency seconds (configured in the Áú»¢¶Ä²© agent 2 configuration file).
It is used to monitor the availability of active checks.
| Field | Type | Mandatory | Value |
|---|---|---|---|
| request | string | yes | active check heartbeat |
| host | string | yes | The host name. |
| heartbeat_freq | number | yes | The agent heartbeat frequency (HeartbeatFrequency configuration parameter). |