El protocolo Zabbix Agent 2 se basa en código, tamaño y modelo de datos.
Tipo | Tamaño | Comentarios |
---|---|---|
byte | 4 | Tipo de carga útil, actualmente solo se admite JSON. |
Tipo | Tamaño | Comentarios |
---|---|---|
byte | 4 | Tamaño de la carga útil actual en bytes. |
Tipo | Tamaño | Comentarios |
---|---|---|
byte | Definido por el campo size | datos en formato JSON. |
Estos parámetros están presentes en todas las solicitudes/respuestas:
Nombre | Tipo | Comentarios |
---|---|---|
id | uint32 | Para solicitudes: el identificador incremental utilizado para vincular solicitudes con respuestas. Único dentro de una dirección de solicitud (es decir, de agente a complemento o de complemento a agente). Para respuestas: ID de la solicitud correspondiente. |
type | uint32 | El tipo de solicitud. |
Una solicitud enviada por un complemento para escribir un mensaje de registro en el archivo de registro del agente.
direction | plugin → agent |
response | no |
Parámetros específicos de las solicitudes de registro:
Nombre | Tipo | Comentarios |
---|---|---|
severity | uint32 | La gravedad del mensaje (nivel de registro). |
message | cadena | El mensaje a registrar. |
Ejemplo:
Una solicitud enviada por el agente durante la fase de inicio del agente para obtener las métricas proporcionadas para registrar un complemento.
dirección | agente → plugin |
respuesta | sí |
Parámetros específicos para registrar solicitudes:
Nombre | Tipo | Comentarios |
---|---|---|
version | cadena | La versión del protocolo <principal>.<menor> |
Ejemplo:
Respuesta del complemento a la solicitud de registro.
dirección | plugin → agente |
response | n/a |
Parámetros específicos para registrar respuestas:
Nombre | Tipo | Comentarios |
---|---|---|
name | cadena | El nombre del complemento. |
metrics | matriz de cadenas (opcional) | Las métricas con descripciones tal como se utilizan en el complemento. Devuelve RegisterMetrics(). Ausente si se devuelve un error. |
interfaces | uint32 (opcional) | La máscara de bits de las interfaces admitidas por el complemento. Ausente si se devuelve un error. |
error | cadena (opcional) | Se devuelve un mensaje de error si no se puede iniciar un complemento. Ausente, si se devuelven métricas. |
Ejemplos:
o
Una solicitud para ejecutar la función Inicio de la interfaz Runner.
dirección | agente → complemento |
respuesta | no |
La solicitud no tiene parámetros específicos, solo contiene parámetros de datos comunes.
Ejemplo:
Una solicitud enviada por el agente para cerrar un complemento.
dirección | agente → complemento |
respuesta | no |
La solicitud no tiene parámetros específicos, solo contiene parámetros de datos comunes.
Ejemplo:
Una solicitud para ejecutar la función Exportar de la interfaz Exporter.
dirección | agente → complemento |
respuesta | no |
Parámetros específicos de las solicitudes de exportación:
Nombre | Tipo | Comentarios |
---|---|---|
key | cadena | La clave del complemento. |
parameters | matriz de cadenas (opcional) | Los parámetros para la función Export. |
Ejemplo:
Respuesta de la función Exportar de la interfaz Export.
dirección | complemento → agente |
respuesta | n/a |
Parámetros específicos para exportar respuestas:
Nombre | Tipo | Comentarios |
---|---|---|
value | cadena (opcional) | Valor de respuesta de la función Exportar. Ausente, si se devuelve un error. |
error | cadena (opcional) | Mensaje de error si la función Exportar no se ha ejecutado correctamente. Ausente, si se devuelve valor. |
Ejemplos:
o
Una solicitud para ejecutar la función Configurar de la interfaz Configurator.
dirección | agente → complemento |
respuesta | n/a |
Parámetros específicos de las solicitudes Configurar:
Nombre | Tipo | Comentarios |
---|---|---|
global_options | Objeto JSON | Objeto JSON que contiene opciones de configuración del agente global. |
private_options | Objeto JSON (opcional) | Objeto JSON que contiene opciones de configuración de complementos privados, si se proporcionan. |
Ejemplo:
Una solicitud para ejecutar la función Validar de la interfaz Configurator.
dirección | agente → complemento |
respuesta | sí |
Parámetros específicos de las solicitudes Validar:
Nombre | Tipo | Comentarios |
---|---|---|
private_options | Objeto JSON (opcional) | Objeto JSON que contiene opciones de configuración de complementos privados, si se proporcionan. |
Ejemplo:
Respuesta de la función Validar de la interfaz Configurator.
dirección | complemento → agente |
respuesta | n/a |
Parámetros específicos de las respuestas Validar:
Nombre | Tipo | Comentarios |
---|---|---|
error | cadena (opcional) | Se devuelve un mensaje de error si la función Validar no se ejecuta correctamente. Ausente si se ejecuta exitosamente. |
Ejemplo:
o