El protocol de l'agent Zabbix 2 es basa sobre el codi, mida i model de dades.
Tipus | Mida | Comentaris |
---|---|---|
Octet | 4 | Tipus de càrrega útil, actualment només s'admet JSON. |
Tipus | Mida | Comentaris |
---|---|---|
Byte | 4 | Mida de la càrrega actual, en octets. |
Tipus | Mida | Comentaris |
---|---|---|
Byte | Definit per el camp Size | Dades en format JSON. |
Aquest paràmetres són presents a totes les peticions/respostes:
Nom | Tipus | Comentaris |
---|---|---|
id | uint32 | Per a les peticions - l'identificador incremental emprat per enllaçar les peticions amb les respostes. Únic dins d'una direcció de petició (és a dir, d'agent a connector o de connector a agent). Per a les respostes - ID de la petició corresponent. |
type | uint32 | El tipus de petició. |
Petició enviada per un plug-in per escriure un missatge de registre a l'arxiu registre de l'agent.
direction | plugin → agent |
response | no |
Paràmetres específics de les peticions de registre:
Nom | Tipus | Comentaris |
---|---|---|
severity | uint32 | La gravetat del missatge (nivell de registre). |
message | string | El missatge a registrar. |
Exemple:
Petició enviada per l'agent durant la fase d'inici de l'agent per obtindre les mètriques proveïdes per enregistrar un plugin.
direction | agent → plugin |
response | yes |
Paràmetres específics de les peticions d'enregistrament:
Nom | Tipus | Comentaris |
---|---|---|
version | string | La versió del protocol <major>.<minor> |
Exemple:
resposta del plug-in a la petició d'enregistrament.
direction | plugin → agent |
réponse | n/a |
Paràmetres específics de les respostes d'enregistraments:
Nom | Tipus | Comentaris |
---|---|---|
name | string | El nom del plug-in. |
metrics | array of strings (optional) | Les mètriques amb les descripcions com s'empren al plug-in. Retorna RegisterMetrics(). Absent si es retorna un error. |
interfaces | uint32 (optional) | La màscara binària de les interfícies admeses per el plug-in. Absent si es retorna un error. |
error | string (optional) | Retorna un missatge d'error si no es pot engegar un plug-in. Absent si les mètriques són retornades. |
Exemples:
ou
Una petició d'execució de la funció Start de la interfície Runner.
direction | agent → plugin |
réponse | non |
La petició no té cap paràmetre específic, tret dels de dades comunes.
Exemple:
Una petició enviada per l'agent per aturar un plug-in.
direction | agent → plugin |
response | no |
La petició no té pas cap paràmetre específic, tret dels de dades comunes.
Exemple:
Una petició d'execució de la funció Export de l'interfície Exporter.
direction | agent → plugin |
response | no |
Paràmetres específics de les peticions d'exportació:
Nom | Tipus | Comentaris |
---|---|---|
key | string | La clau del plug-in. |
parameters | array of strings (opcional) | Els paràmetres de la funció Export. |
Exemple:
Resposta de la funció Export de la interfície Exporter.
direction | plugin → agent |
response | n/a |
Paràmetres específics de les respostes d'exportació:
Nom | Tipus | Comentaris |
---|---|---|
value | string (opcional) | Valor de la resposta de la funció Export. Absent si hi ha un error de retorn. |
error | string (opcional) | Missatge d'error si la funció Export no s'ha executat correctament. Absent, si hi ha un error retornat. |
Exemples:
or
Una petició per executar la funció Configure de la interfície Configurator.
direction | agent → plugin |
response | n/a |
Paràmetres específics de les peticions Configure:
Nom | Tipus | Comentaris |
---|---|---|
global_options | JSON object | Objecte JSON que conté les opcions de configuració globals de l'agent. |
private_options | JSON object (optional) | Objecte JSON que conté les opcions de configuració del plug-in privat, si es proporciona. |
Exemple:
Una petició per executar la funció Validate de la interfície Configurator.
direction | agent → plugin |
response | yes |
Paràmetres específics de les peticions Validate:
Nom | Tipus | Comentaris |
---|---|---|
private_options | JSON object (opcional) | Objecte JSON que conté les opcions de configuració del plug-in privat, si es proporciona. |
Exemple:
Resposta de la funció Validate de la interfície Configurator.
direction | plugin → agent |
response | n/a |
Paràmetres específics de les respostes Validate:
Nom | Tipus | Comentaris |
---|---|---|
error | string (opcional) | Es retorna un missatge d'error si la funció Validate no s'executa correctament. Absent si s'ha executat correctament. |
Exemple:
or