Documentation
Table of Contents
1 Protocole d'¨¦change de donn¨¦es Serveur-Proxy
Aper?u
L'¨¦change de donn¨¦es Serveur-Proxy est bas¨¦ sur le format JSON.
Les messages de requ¨ºte et de r¨¦ponse doivent commencer par l¡¯en-t¨ºte et la longueur des donn¨¦es.
Proxy passif
Requ¨ºte de configuration du proxy
La requ¨ºte proxy config est envoy¨¦e par le serveur pour fournir au proxy ses donn¨¦es de configuration. Cette requ¨ºte est envoy¨¦e toutes les ProxyConfigFrequency (param¨¨tre de configuration au niveau du serveur) secondes.
| nom | type de valeur | description | |||
|---|---|---|---|---|---|
| serveur¡úproxy : | |||||
| request | cha?ne | 'proxy config' | |||
| <table> | objet | un ou plusieurs objets avec des donn¨¦es <table> | |||
| fields | tableau | tableau de noms de champs | |||
| - | cha?ne | nom de champs | |||
| data | tableau | tableau de lignes | |||
| - | tableau | tableau de colonnes | |||
| - | cha?ne,nombre | valeur de la colonne dont le type d¨¦pend du type de colonne dans le sch¨¦ma de base de donn¨¦es | |||
| proxy¡úserveur : | |||||
| response | cha?ne | les informations de succ¨¨s de la requ¨ºte ('success' ou 'failed') | |||
| version | cha?ne | la version du proxy (<majeure>.<mineure>.<build>) | |||
Exemple :
serveur¡úproxy :
{
"request": "proxy config",
"globalmacro":{
"fields":[
"globalmacroid",
"macro",
"value"
],
"data":[
[
2,
"{$SNMP_COMMUNITY}",
"public"
]
]
},
"hosts":{
"fields":[
"hostid",
"host",
"status",
"ipmi_authtype",
"ipmi_privilege",
"ipmi_username",
"ipmi_password",
"name",
"tls_connect",
"tls_accept",
"tls_issuer",
"tls_subject",
"tls_psk_identity",
"tls_psk"
],
"data":[
[
10001,
"Template OS Linux",
3,
-1,
2,
"",
"",
"Template OS Linux",
1,
1,
"",
"",
"",
""
],
[
10050,
"Template App Áú»¢¶Ä²© Agent",
3,
-1,
2,
"",
"",
"Template App Áú»¢¶Ä²© Agent",
1,
1,
"",
"",
"",
""
],
[
10105,
"Logger",
0,
-1,
2,
"",
"",
"Logger",
1,
1,
"",
"",
"",
""
]
]
},
"interface":{
"fields":[
"interfaceid",
"hostid",
"main",
"type",
"useip",
"ip",
"dns",
"port",
"bulk"
],
"data":[
[
2,
10105,
1,
1,
1,
"127.0.0.1",
"",
"10050",
1
]
]
},
...
}proxy¡úserveur :
Requ¨ºte du proxy
La requ¨ºte proxy data est utilis¨¦e pour obtenir de la part du proxy des donn¨¦es sur la disponibilit¨¦ de l'h?te, l'historique, la d¨¦couverte et l'auto-enregistrement. Cette demande est envoy¨¦e toutes les ProxyDataFrequency (param¨¨tre de configuration au niveau du serveur) secondes.
| nom | type de valeur | description | |
|---|---|---|---|
| serveur¡úproxy : | |||
| request | cha?ne | 'proxy data' | |
| proxy¡úserveur : | |||
| session | cha?ne | jeton de session de donn¨¦es | |
| host availability | tableau | (optionnel) tableau d'objets de donn¨¦es de disponibilit¨¦ d'h?te | |
| hostid | nombre | id de l'h?te | |
| disponible | nombre | disponibilit¨¦ de l'agent Áú»¢¶Ä²© 0, HOST_AVAILABLE_UNKNOWN - inconnu 1, HOST_AVAILABLE_TRUE - disponible 2, HOST_AVAILABLE_FALSE - indisponible |
|
| error | cha?ne | Message d'erreur de l'agent Áú»¢¶Ä²© ou cha?ne vide | |
| snmp_disponible | nombre | disponibilit¨¦ de l'agent SNMP 0, HOST_AVAILABLE_UNKNOWN - inconnu 1, HOST_AVAILABLE_TRUE - disponible 2, HOST_AVAILABLE_FALSE - indisponible |
|
| snmp_error | cha?ne | Message d'erreur de l'agent SNMP ou cha?ne vide | |
| ipmi_disponible | nombre | disponibilit¨¦ de l'agent IPMI 0, HOST_AVAILABLE_UNKNOWN - inconnu 1, HOST_AVAILABLE_TRUE - disponible 2, HOST_AVAILABLE_FALSE - indisponible |
|
| ipmi_error | cha?ne | Message d'erreur de l'agent IPMI ou cha?ne vide | |
| jmx_disponible | nombre | disponibilit¨¦ de l'agent JMX 0, HOST_AVAILABLE_UNKNOWN - inconnu 1, HOST_AVAILABLE_TRUE - disponible 2, HOST_AVAILABLE_FALSE - indisponible |
|
| jmx_error | cha?ne | Message d'erreur de l'agent JMX ou cha?ne vide | |
| history data | tableau | (optionnel) tableau d'objets de donn¨¦es d'historique | |
| itemid | nombre | id de l'¨¦l¨¦ment | |
| clock | nombre | horodatage de la valeur de l'¨¦l¨¦ment (secondes) | |
| ns | nombre | horodatage de la valeur de l'¨¦l¨¦ment (nanosecondes) | |
| value | cha?ne | (optionnel) valeur de l'¨¦l¨¦ment | |
| id | nombre | id de la valeur (compteur croissant, unique dans une session de donn¨¦es) | |
| timestamp | nombre | (optionnel) horodatage des ¨¦l¨¦ments de type de journal | |
| source | cha?ne | (optionnel) valeur source de l'¨¦l¨¦ment eventlog | |
| severity | nombre | (optionnel) valeur de gravit¨¦ de l'¨¦l¨¦ment eventlog | |
| eventid | nombre | (optionnel) valeur de l'id de l'¨¦v¨¦nement de l'¨¦l¨¦ment eventlog | |
| state | cha?ne | (optionnel) statut de l'¨¦l¨¦ment 0, ITEM_STATE_NORMAL 1, ITEM_STATE_NOTSUPPORTED |
|
| lastlogsize | nombre | (optionnel) derni¨¨re taille du fichier journal des ¨¦l¨¦ments de type journal | |
| mtime | nombre | (optionnel) heure de modification des ¨¦l¨¦ments de type journal | |
| discovery data | tableau | (optionnel) tableau d'objets de donn¨¦es de d¨¦couverte | |
| clock | nombre | l'horodatage des donn¨¦es de d¨¦couverte | |
| druleid | nombre | id de la r¨¨gle de d¨¦couverte | |
| dcheckid | nombre | id de v¨¦rification de d¨¦couverte ou null pour les donn¨¦es de r¨¨gle de d¨¦couverte | |
| type | nombre | le type de v¨¦rification de d¨¦couverte : -1 donn¨¦es de r¨¨gle de d¨¦couverte 0, SVC_SSH - V¨¦rification du service SSH 1, SVC_LDAP - V¨¦rification du service LDAP 2, SVC_SMTP - V¨¦rification du service SMTP 3, SVC_FTP - V¨¦rification du service FTP 4, SVC_HTTP - V¨¦rification du service HTTP 5, SVC_POP - V¨¦rification du service POP 6, SVC_NNTP - V¨¦rification du service NNTP 7, SVC_IMAP - V¨¦rification du service IMAP 8, SVC_TCP - V¨¦rification de la disponibilit¨¦ du TCP 9, SVC_AGENT - Agent Áú»¢¶Ä²© 10, SVC_SNMPv1 - Agent SNMPv1 11, SVC_SNMPv2 - Agent SNMPv2 12, SVC_ICMPPING - Ping ICMP 13, SVC_SNMPv3 - Agent SNMPv3 14, SVC_HTTPS - V¨¦rification du service HTTPS 15, SVC_TELNET - V¨¦rification de la disponibilit¨¦ de Telnet |
|
| ip | cha?ne | L'adresse IP de l'h?te | |
| dns | cha?ne | Le nom DNS de l'h?te | |
| port | nombre | (optionnel) num¨¦ro de port du service | |
| key_ | cha?ne | (optionnel) la cl¨¦ d'¨¦l¨¦ment pour la v¨¦rification de d¨¦couverte de type 9 SVC_AGENT | |
| value | cha?ne | (optionnel) valeur re?ue du service, peut ¨ºtre vide pour la plupart des services | |
| status | nombre | (optionnel) statut du service : 0, DOBJECT_STATUS_UP - Service UP 1, DOBJECT_STATUS_DOWN - Service DOWN |
|
| auto registration | tableau | (optionnel) tableau d'objets de donn¨¦es d'enregistrement automatique | |
| clock | nombre | l'horodatage des donn¨¦es d'enregistrement automatique | |
| host | cha?ne | le nom de l'h?te | |
| ip | cha?ne | (optionnel) L'adresse IP de l'h?te | |
| dns | cha?ne | (optionnel) le nom DNS r¨¦solu depuis l'adresse IP | |
| port | cha?ne | (optionnel) le port de l'h?te | |
| host_metadata | cha?ne | (optionnel) les m¨¦tadonn¨¦es de l'h?te envoy¨¦es par l'agent (en fonction du param¨¨tre de configuration de l'agent HostMetadata ou HostMetadataItem) | |
| tasks | tableau | (optionnel) tableau de t?ches | |
| type | nombre | le type de t?che : 0, ZBX_TM_TASK_PROCESS_REMOTE_COMMAND_RESULT - r¨¦sultat de la commande ¨¤ distance |
|
| status | nombre | le statut d'ex¨¦cution de la commande ¨¤ distance : 0, ZBX_TM_REMOTE_COMMAND_COMPLETED - commande ¨¤ distance termin¨¦e avec succ¨¨s 1, ZBX_TM_REMOTE_COMMAND_FAILED - commande ¨¤ distance ¨¦chou¨¦e |
|
| error | cha?ne | (optionnel) le message d'erreur | |
| parent_taskid | nombre | l'id de la t?che parent | |
| more | nombre | (optionnel) 1 - il y a plus de donn¨¦es d'historique ¨¤ envoyer | |
| clock | nombre | (optionnel) horodatage de transfert de donn¨¦es (secondes) | |
| ns | nombre | (optionnel) horodatage de transfert de donn¨¦es (nanosecondes) | |
| version | cha?ne | la version du proxy (<majeure>.<mineure>.<build>) | |
| serveur¡úproxy : | |||
| response | cha?ne | les informations de succ¨¨s de la requ¨ºte ('success' ou 'failed') | |
| tasks | tableau | (optionnel) tableau de t?ches | |
| type | nombre | le type de t?che : 1, ZBX_TM_TASK_PROCESS_REMOTE_COMMAND - commande ¨¤ distance |
|
| clock | nombre | l'heure de cr¨¦ation de la t?che | |
| ttl | nombre | le temps en secondes apr¨¨s lequel la t?che expire | |
| commandtype | nombre | le type de commande ¨¤ distance : 0, ZBX_SCRIPT_TYPE_CUSTOM_SCRIPT - utilise un script personnalis¨¦ 1, ZBX_SCRIPT_TYPE_IPMI - utilise IPMI 2, ZBX_SCRIPT_TYPE_SSH - utilise SSH 3, ZBX_SCRIPT_TYPE_TELNET - utilise Telnet 4, ZBX_SCRIPT_TYPE_GLOBAL_SCRIPT - utilise un script global (actuellement ¨¦quivalent au script personnalis¨¦) |
|
| command | cha?ne | la commande ¨¤ distance ¨¤ ex¨¦cuter | |
| execute_on | nombre | la cible d'ex¨¦cution pour les scripts personnalis¨¦s : 0, ZBX_SCRIPT_EXECUTE_ON_AGENT - ex¨¦cute le script sur l'agent 1, ZBX_SCRIPT_EXECUTE_ON_SERVER - ex¨¦cute le script sur le server 2, ZBX_SCRIPT_EXECUTE_ON_PROXY - ex¨¦cute le script sur le proxy |
|
| port | nombre | (optionnel) le port pour les commandes telnet et SSH | |
| authtype | nombre | (optionnel) le type d'authentification pour les commandes telnet et SSH | |
| username | cha?ne | (optionnel) le nom d'utilisateur pour les commandes telnet et SSH | |
| password | cha?ne | (optionnel) le mot de passe pour les commandes telnet et SSH | |
| publickey | cha?ne | (optionnel) la cl¨¦ publique pour les commandes SSH | |
| privatekey | cha?ne | (optionnel) la cl¨¦ priv¨¦e pour les commandes SSH | |
| parent_taskid | nombre | l'id de la t?che parent | |
| hostid | nombre | l'id de l'h?te cible | |
Exemple :
serveur¡úproxy :
proxy¡úserveur :
{
"session": "12345678901234567890123456789012"
"host availability":[
{
"hostid":10106,
"disponible":1,
"error":"",
"snmp_disponible":0,
"snmp_error":"",
"ipmi_disponible":0,
"ipmi_error":"",
"jmx_disponible":0,
"jmx_error":""
},
{
"hostid":10107,
"disponible":1,
"error":"",
"snmp_disponible":0,
"snmp_error":"",
"ipmi_disponible":0,
"ipmi_error":"",
"jmx_disponible":0,
"jmx_error":""
}
],
"history data":[
{
"itemid":"12345",
"clock":1478609647,
"ns":332510044,
"value":"52956612",
"id": 1
},
{
"itemid":"12346",
"clock":1478609647,
"ns":330690279,
"state":1,
"value":"Cannot find information for this network interface in /proc/net/dev.",
"id": 2
}
],
"discovery data":[
{
"clock":1478608764,
"drule":2,
"dcheck":3,
"type":12,
"ip":"10.3.0.10",
"dns":"vdebian",
"status":1
},
{
"clock":1478608764,
"drule":2,
"dcheck":null,
"type":-1,
"ip":"10.3.0.10",
"dns":"vdebian",
"status":1
}
],
"auto registration":[
{
"clock":1478608371,
"host":"Logger1",
"ip":"10.3.0.1",
"dns":"localhost",
"port":"10050"
},
{
"clock":1478608381,
"host":"Logger2",
"ip":"10.3.0.2",
"dns":"localhost",
"port":"10050"
}
],
"tasks":[
{
"type": 0,
"status": 0,
"parent_taskid": 10
},
{
"type": 0,
"status": 1,
"error": "No permissions to execute task.",
"parent_taskid": 20
}
],
"version":"3.4.0"
}serveur¡úproxy :
{
"response": "success",
"tasks":[
{
"type": 1,
"clock": 1478608371,
"ttl": 600,
"commandtype": 2,
"command": "restart_service1.sh",
"execute_on": 2,
"port": 80,
"authtype": 0,
"username": "userA",
"password": "password1",
"publickey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe",
"privatekey": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd",
"parent_taskid": 10,
"hostid": 10070
},
{
"type": 1,
"clock": 1478608381,
"ttl": 600,
"commandtype": 1,
"command": "restart_service2.sh",
"execute_on": 0,
"authtype": 0,
"username": "",
"password": "",
"publickey": "",
"privatekey": "",
"parent_taskid": 20,
"hostid": 10084
}
]
}Proxy actif
Requ¨ºte proxy heartbeat
La requ¨ºte proxy heartbeat est envoy¨¦e par le proxy pour signaler que le proxy est en cours d'ex¨¦cution. Cette requ¨ºte est envoy¨¦e tous les HeartbeatFrequency (param¨¨tre de configuration au niveau du proxy) secondes.
| nom | type de valeur | description | |
|---|---|---|---|
| proxy¡úserveur : | |||
| request | cha?ne | 'proxy heartbeat' | |
| host | cha?ne | type de valeur | |
| version | cha?ne | la version du proxy (<majeure>.<mineure>.<build>) | |
| serveur¡úproxy : | |||
| response | cha?ne | les informations de succ¨¨s de la requ¨ºte ('success' ou 'failed') | |
proxy¡úserveur :
serveur¡úproxy :
Requ¨ºte Proxy config
La requ¨ºte proxy config est envoy¨¦e par le proxy pour obtenir les donn¨¦es de configuration du proxy. Cette requ¨ºte est envoy¨¦e tous les ConfigFrequency (param¨¨tre de configuration au niveau du proxy) secondes.
| nom | type de valeur | description | |||
|---|---|---|---|---|---|
| proxy¡úserveur : | |||||
| request | cha?ne | 'proxy config' | |||
| host | cha?ne | proxy name | |||
| version | cha?ne | the proxy version (<major>.<minor>.<build>) | |||
| serveur¡úproxy : | |||||
| request | cha?ne | 'proxy config' | |||
| <table> | objet | un ou plusieurs objets avec des donn¨¦es <table> | |||
| fields | tableau | tableau des noms de champs | |||
| - | cha?ne | nom du champs | |||
| data | tableau | tableau de lignes | |||
| - | tableau | tableau de colonnes | |||
| - | cha?ne,nombre | valeur de la colonne dont le type d¨¦pend du type de colonne dans le sch¨¦ma de base de donn¨¦es | |||
| proxy¡úserveur : | |||||
| response | cha?ne | les informations de succ¨¨s de la requ¨ºte ('success' ou 'failed') | |||
Exemple :
proxy¡úserveur :
serveur¡úproxy :
{
"globalmacro":{
"fields":[
"globalmacroid",
"macro",
"value"
],
"data":[
[
2,
"{$SNMP_COMMUNITY}",
"public"
]
]
},
"hosts":{
"fields":[
"hostid",
"host",
"status",
"ipmi_authtype",
"ipmi_privilege",
"ipmi_username",
"ipmi_password",
"name",
"tls_connect",
"tls_accept",
"tls_issuer",
"tls_subject",
"tls_psk_identity",
"tls_psk"
],
"data":[
[
10001,
"Template OS Linux",
3,
-1,
2,
"",
"",
"Template OS Linux",
1,
1,
"",
"",
"",
""
],
[
10050,
"Template App Áú»¢¶Ä²© Agent",
3,
-1,
2,
"",
"",
"Template App Áú»¢¶Ä²© Agent",
1,
1,
"",
"",
"",
""
],
[
10105,
"Logger",
0,
-1,
2,
"",
"",
"Logger",
1,
1,
"",
"",
"",
""
]
]
},
"interface":{
"fields":[
"interfaceid",
"hostid",
"main",
"type",
"useip",
"ip",
"dns",
"port",
"bulk"
],
"data":[
[
2,
10105,
1,
1,
1,
"127.0.0.1",
"",
"10050",
1
]
]
},
...
}proxy¡úserveur :
Requ¨ºte Proxy data
La requ¨ºte proxy data est envoy¨¦e par le proxy pour fournir la disponibilit¨¦ d'un h?te, les donn¨¦es d'historique, de d¨¦couverte et d'enregistrement automatique. Cette requ¨ºte est envoy¨¦e toutes les DataSenderFrequency (param¨¨tre de configuration au niveau du proxy) secondes.
| nom | type de valeur | description | |
|---|---|---|---|
| proxy¡úserveur : | |||
| request | cha?ne | 'proxy data' | |
| host | cha?ne | le nom du proxy | |
| session | cha?ne | jeton de donn¨¦es de session | |
| host availability | tableau | (optionnel) tableau d'objets de donn¨¦es de disponibilit¨¦ d'h?te | |
| hostid | nombre | id de l'h?te | |
| disponible | nombre | disponibilit¨¦ de l'agent Áú»¢¶Ä²© 0, HOST_AVAILABLE_UNKNOWN - inconnu 1, HOST_AVAILABLE_TRUE - disponible 2, HOST_AVAILABLE_FALSE - indisponible |
|
| error | cha?ne | message d'erreur de l'agent Áú»¢¶Ä²© ou cha?ne vide | |
| snmp_disponible | nombre | disponibilit¨¦ de l'agent SNMP 0, HOST_AVAILABLE_UNKNOWN - inconnu 1, HOST_AVAILABLE_TRUE - disponible 2, HOST_AVAILABLE_FALSE - indisponible |
|
| snmp_error | cha?ne | message d'erreur de l'agent SNMP ou cha?ne vide | |
| ipmi_disponible | nombre | disponibilit¨¦ de l'agent IPMI 0, HOST_AVAILABLE_UNKNOWN - inconnu 1, HOST_AVAILABLE_TRUE - disponible 2, HOST_AVAILABLE_FALSE - indisponible |
|
| ipmi_error | cha?ne | message d'erreur de l'agent IPMI ou cha?ne vide | |
| jmx_disponible | nombre | disponibilit¨¦ de l'agent JMX 0, HOST_AVAILABLE_UNKNOWN - inconnu 1, HOST_AVAILABLE_TRUE - disponible 2, HOST_AVAILABLE_FALSE - indisponible |
|
| jmx_error | cha?ne | message d'erreur de l'agent JMX ou cha?ne vide | |
| history data | tableau | (optionnel) tableau d'objets de donn¨¦es d'historique | |
| itemid | nombre | id de l'¨¦l¨¦ment | |
| clock | nombre | horodatage de la valeur de l'¨¦l¨¦ment (secondes) | |
| ns | nombre | horodatage de la valeur de l'¨¦l¨¦ment (nanosecondes) | |
| value | cha?ne | (optionnel) valeur de l'¨¦l¨¦ment | |
| id | nombre | id de la valeur (compteur croissant, unique dans une session de donn¨¦es) | |
| timestamp | nombre | (optionnel) horodatage des ¨¦l¨¦ments de type journal | |
| source | cha?ne | (optionnel) valeur de la source de l'¨¦l¨¦ment eventlog | |
| severity | nombre | (optionnel) valeur de la s¨¦v¨¦rit¨¦ de l'¨¦l¨¦ment eventlog | |
| eventid | nombre | (optionnel) valeur de l'id de l'¨¦v¨¦nement de l'¨¦l¨¦ment eventlog | |
| state | cha?ne | (optionnel) ¨¦tat de l'¨¦l¨¦ment 0, ITEM_STATE_NORMAL 1, ITEM_STATE_NOTSUPPORTED |
|
| lastlogsize | nombre | (optionnel) derni¨¨re taille du journal pour les ¨¦l¨¦ments de type journal | |
| mtime | nombre | (optionnel) heure de modification des ¨¦l¨¦ments de type journal | |
| discovery data | tableau | (optionnel) tableau d'objet de donn¨¦es de d¨¦couverte | |
| clock | nombre | horodatage des donn¨¦es de d¨¦couverte | |
| druleid | nombre | id de la r¨¨gle de d¨¦couverte | |
| dcheckid | nombre | l'id de la v¨¦rification de d¨¦couverte ou null pour les donn¨¦es de r¨¨gle de d¨¦couverte | |
| type | nombre | le type de v¨¦rification de d¨¦couverte : -1 donn¨¦es de r¨¨gle de d¨¦couverte 0, SVC_SSH - v¨¦rification du service SSH 1, SVC_LDAP - v¨¦rification du service LDAP 2, SVC_SMTP - v¨¦rification du service SMTP 3, SVC_FTP - v¨¦rification du service FTP 4, SVC_HTTP - v¨¦rification du service HTTP 5, SVC_POP - v¨¦rification du service POP 6, SVC_NNTP - v¨¦rification du service NTP 7, SVC_IMAP - v¨¦rification du service IMAP 8, SVC_TCP - v¨¦rification de la disponibilit¨¦ du port TCP 9, SVC_AGENT - agent Áú»¢¶Ä²© 10, SVC_SNMPv1 - agent SNMPv1 11, SVC_SNMPv2 - agent SNMPv2 12, SVC_ICMPPING - ping ICMP 13, SVC_SNMPv3 - agent SNMPv3 14, SVC_HTTPS - v¨¦rification du service HTTPS 15, SVC_TELNET - v¨¦rification disponibilit¨¦ de Telnet |
|
| ip | cha?ne | l'adresse IP de l'h?te | |
| dns | cha?ne | le nom DNS de l'h?te | |
| port | nombre | (optionnel) num¨¦ro du port du service | |
| key_ | cha?ne | (optionnel) la cl¨¦ d'¨¦l¨¦ment pour les v¨¦rifications de d¨¦couverte de type 9 SVC_AGENT | |
| value | cha?ne | (optionnel) valeur re?ue du service, peut ¨ºtre vide pour la plupart des services | |
| auto registration | tableau | (optionnel) tableau d'objets de donn¨¦es d'enregistrement automatique | |
| status | nombre | (optionnel) statut du service : 0, DOBJECT_STATUS_UP - Service UP 1, DOBJECT_STATUS_DOWN - Service DOWN |
|
| clock | nombre | horodatage des donn¨¦es d'enregistrement automatique | |
| host | cha?ne | nom de l'h?te | |
| ip | cha?ne | (optionnel) l'adresse IP de l'h?te | |
| dns | cha?ne | (optionnel) le nom DNS r¨¦solu depuis l'adresse IP | |
| port | cha?ne | (optionnel) le port de l'h?te | |
| host_metadata | cha?ne | (optionnel) les metadatas de l'h?te envoy¨¦es par l'agent (bas¨¦es sur les param¨¨tres de configuration de l'agent HostMetadata ou HostMetadataItem) | |
| tasks | tableau | (optionnel) tableau de t?ches | |
| type | nombre | le type de t?che : 0, ZBX_TM_TASK_PROCESS_REMOTE_COMMAND_RESULT - r¨¦sultat de la commande ¨¤ distance |
|
| status | nombre | le statut d'ex¨¦cution de la commande ¨¤ distance : 0, ZBX_TM_REMOTE_COMMAND_COMPLETED - commande ¨¤ distance ex¨¦cut¨¦e avec succ¨¨s 1, ZBX_TM_REMOTE_COMMAND_FAILED - commande ¨¤ distance ¨¦chou¨¦e |
|
| error | cha?ne | (optionnel) le message d'erreur | |
| parent_taskid | nombre | l'id de la t?che parent | |
| more | nombre | (optionnel) 1 - il y a plus de donn¨¦es d'historique ¨¤ envoyer | |
| clock | nombre | (optionnel) horodatage des donn¨¦es de transfert (secondes) | |
| ns | nombre | (optionnel) horodatage des donn¨¦es de transfert (nanosecondes) | |
| version | cha?ne | la version du proxy (<majeure>.<mineure>.<build>) | |
| serveur¡úproxy : | |||
| response | cha?ne | les informations de succ¨¨s de la requ¨ºte ('success' ou 'failed') | |
| tasks | tableau | (optionnel) tableau de t?ches | |
| type | nombre | le type de t?che : 1, ZBX_TM_TASK_PROCESS_REMOTE_COMMAND - commande ¨¤ distance |
|
| clock | nombre | l'heure de cr¨¦ation de la t?che | |
| ttl | nombre | le temps en secondes apr¨¨s lequel la t?che expire | |
| commandtype | nombre | le type de commande ¨¤ distance : 0, ZBX_SCRIPT_TYPE_CUSTOM_SCRIPT - utilise un script personnalis¨¦ 1, ZBX_SCRIPT_TYPE_IPMI - utilise IPMI 2, ZBX_SCRIPT_TYPE_SSH - utilise SSH 3, ZBX_SCRIPT_TYPE_TELNET - utilise Telnet 4, ZBX_SCRIPT_TYPE_GLOBAL_SCRIPT - utilise un script global (actuellement ¨¦quivalent au script personnalis¨¦) |
|
| command | cha?ne | la commande ¨¤ distance ¨¤ ex¨¦cuter | |
| execute_on | nombre | la cible d'ex¨¦cution pour les scripts personnalis¨¦s : 0, ZBX_SCRIPT_EXECUTE_ON_AGENT - ex¨¦cute le script sur l'agent 1, ZBX_SCRIPT_EXECUTE_ON_SERVER - ex¨¦cute le script sur le server 2, ZBX_SCRIPT_EXECUTE_ON_PROXY - ex¨¦cute le script sur le proxy |
|
| port | nombre | (optionnel) le port pour les commandes telnet et SSH | |
| authtype | nombre | (optionnel) le type d'authentication pour les commandes SSH | |
| username | cha?ne | (optionnel) le nom d'utilisateur pour les commandes telnet et SSH | |
| password | cha?ne | (optionnel) le mot de passe pour les commandes telnet et SSH | |
| publickey | cha?ne | (optionnel) la cl¨¦ publique pour les commandes SSH | |
| privatekey | cha?ne | (optionnel) la cl¨¦ priv¨¦e pour les commandes SSH | |
| parent_taskid | nombre | l'id de la t?che parent | |
| hostid | nombre | l'id de h?te cible | |
Exemple :
proxy¡úserveur :
{
"request": "proxy data",
"host": "Proxy #12",
"session": "12345678901234567890123456789012",
"host availability":[
{
"hostid":10106,
"disponible":1,
"error":"",
"snmp_disponible":0,
"snmp_error":"",
"ipmi_disponible":0,
"ipmi_error":"",
"jmx_disponible":0,
"jmx_error":""
},
{
"hostid":10107,
"disponible":1,
"error":"",
"snmp_disponible":0,
"snmp_error":"",
"ipmi_disponible":0,
"ipmi_error":"",
"jmx_disponible":0,
"jmx_error":""
}
],
"history data":[
{
"itemid":"12345",
"clock":1478609647,
"ns":332510044,
"value":"52956612",
"id": 1
},
{
"itemid":"12346",
"clock":1478609647,
"ns":330690279,
"state":1,
"value":"Cannot find information for this network interface in /proc/net/dev.",
"id": 2
}
],
"discovery data":[
{
"clock":1478608764,
"drule":2,
"dcheck":3,
"type":12,
"ip":"10.3.0.10",
"dns":"vdebian",
"status":1
},
{
"clock":1478608764,
"drule":2,
"dcheck":null,
"type":-1,
"ip":"10.3.0.10",
"dns":"vdebian",
"status":1
}
],
"auto registration":[
{
"clock":1478608371,
"host":"Logger1",
"ip":"10.3.0.1",
"dns":"localhost",
"port":"10050"
},
{
"clock":1478608381,
"host":"Logger2",
"ip":"10.3.0.2",
"dns":"localhost",
"port":"10050"
}
],
"tasks":[
{
"type": 2,
"clock":1478608371,
"ttl": 600,
"commandtype": 2,
"command": "restart_service1.sh",
"execute_on": 2,
"port": 80,
"authtype": 0,
"username": "userA",
"password": "password1",
"publickey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe",
"privatekey": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd",
"parent_taskid": 10,
"hostid": 10070
},
{
"type": 2,
"clock":1478608381,
"ttl": 600,
"commandtype": 1,
"command": "restart_service2.sh",
"execute_on": 0,
"authtype": 0,
"username": "",
"password": "",
"publickey": "",
"privatekey": "",
"parent_taskid": 20,
"hostid": 10084
}
],
"tasks":[
{
"type": 0,
"status": 0,
"parent_taskid": 10
},
{
"type": 0,
"status": 1,
"error": "No permissions to execute task.",
"parent_taskid": 20
}
],
"version":"3.4.0"
}serveur¡úproxy :
{
"response": "success",
"tasks":[
{
"type": 1,
"clock": 1478608371,
"ttl": 600,
"commandtype": 2,
"command": "restart_service1.sh",
"execute_on": 2,
"port": 80,
"authtype": 0,
"username": "userA",
"password": "password1",
"publickey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe",
"privatekey": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd",
"parent_taskid": 10,
"hostid": 10070
},
{
"type": 1,
"clock": 1478608381,
"ttl": 600,
"commandtype": 1,
"command": "restart_service2.sh",
"execute_on": 0,
"authtype": 0,
"username": "",
"password": "",
"publickey": "",
"privatekey": "",
"parent_taskid": 20,
"hostid": 10084
}
]
}Compatibilit¨¦ descendante
Le serveur prend en charge la compatibilit¨¦ avec les versions ant¨¦rieures en acceptant les anciennes requ¨ºtes nomm¨¦es host availability, history data, discovery data et auto registration.