El protocolo Áú»¢¶Ä²© 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 »å¾±°ù±ð³¦³¦¾±¨®²Ô 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 | complemento ¡ú agente |
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.
direction | agente ¡ú plugin |
response | ²õ¨ª |
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.
direction | complemento ¡ú 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.
»å¾±°ù±ð³¦³¦¾±¨®²Ô | 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.
direction | agente ¡ú complemento |
response | 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.
direction | agente ¡ú complemento |
response | 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 Exporter.
direction | complemento ¡ú agente |
response | 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.
direction | agente ¡ú complemento |
response | 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.
direction | agente ¡ú complemento |
response | ²õ¨ª |
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.
direction | complemento ¡ú agente |
response | 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