Documentation
Table of Contents
Objeto de tarea
Los siguientes objetos est¨¢n directamente relacionados con la API "tarea".
El objeto de tarea tiene las siguientes propiedades:
| Propiedad | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| taskid | ID | ID de la tarea. Comportamiento de la propiedad: - solo lectura |
| type | integer | Tipo de tarea. Valores posibles: 1 - Informaci¨®n de diagn¨®stico; 2 - Actualizar la configuraci¨®n del proxy; 6 - Ejecutar ahora. Comportamiento de la propiedad: - obligatorio |
| status | entero | Estado de la tarea. Valores posibles: 1 - nueva tarea; 2 - tarea en progreso; 3 - tarea completada; 4 - la tarea ha caducado. Comportamiento de la propiedad: - solo lectura |
| reloj | marca de tiempo | Hora en que se cre¨® la tarea. Comportamiento de la propiedad: - solo lectura |
| ttl | integer | El tiempo en segundos despu¨¦s del cual caduca la tarea. Comportamiento de la propiedad: - solo lectura |
| proxyid | ID | ID del proxy sobre el cual se recopila la estad¨ªstica de informaci¨®n de diagn¨®stico. Comportamiento de la propiedad: - compatible si tipo est¨¢ configurado en "Informaci¨®n de diagn¨®stico" o "Actualizar configuraci¨®n de proxy" |
| solicitud | objeto | Objeto de solicitud de tarea seg¨²n el tipo de tarea: El objeto de la tarea 'Ejecutar ahora' se describe en detalle a continuaci¨®n; Objeto de la tarea 'Actualizar configuraci¨®n de proxy' se describe en detalle a continuaci¨®n; El objeto de la tarea 'Informaci¨®n de diagn¨®stico' se describe en detalle a continuaci¨®n. Comportamiento de la propiedad: - obligatorio |
| resultado | objeto | Objeto de resultado de la tarea de informaci¨®n de diagn¨®stico. Puede contener NULL si el resultado a¨²n no est¨¢ listo. El objeto de resultado se describe en detalle a continuaci¨®n. Comportamiento de la propiedad: - solo lectura |
Objeto de solicitud 'Ejecutar ahora'
El objeto de solicitud de tarea 'Ejecutar ahora' tiene las siguientes propiedades.
| Propiedad | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| itemid | ID | ID de la m¨¦trica y reglas de descubrimiento de bajo nivel. |
Objeto de solicitud 'Actualizar configuraci¨®n de proxy'
El objeto de solicitud de tarea 'Actualizar configuraci¨®n de proxy' tiene las siguientes propiedades.
| Propiedad | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| proxy_hostids | matriz | IDs de proxy. |
Objeto de solicitud 'Informaci¨®n de diagn¨®stico'
El objeto de solicitud de tarea de informaci¨®n de diagn¨®stico tiene las siguientes propiedades. El objeto de solicitud de estad¨ªstica para todo tipo de propiedades es descrito en detalle a continuaci¨®n.
| Propiedad | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| historycache | objeto | Solicitud de estad¨ªstica de cach¨¦ de historial. Disponible en servidor y proxy. |
| valuecache | objeto | Solicitud de estad¨ªstica de cach¨¦ de elementos. Disponible en el servidor. |
| preprocessing | objeto | Solicitud de estad¨ªstica del administrador de preprocesamiento. Disponible en servidor y proxy. |
| alerting | objeto | Solicitud de estad¨ªstica del administrador de alertas. Disponible en el servidor. |
| lld | objeto | Solicitud de estad¨ªstica del administrador LLD. Disponible en el servidor. |
Objeto de solicitud de estad¨ªstica
El objeto de solicitud de estad¨ªstica se utiliza para definir qu¨¦ tipo de informaci¨®n se debe recopilar sobre los procesos internos del servidor/proxy. Tiene las siguientes propiedades.
| Propiedad | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| stats | consulta | Propiedades del objeto estad¨ªstico que se devolver¨¢n. La lista de campos disponibles para cada tipo de estad¨ªstica de informaci¨®n de diagn¨®stico se describe en detalle a continuaci¨®n. Valor predeterminado: extend devolver¨¢ todos los campos estad¨ªsticos disponibles. |
| top | objeto | Objeto para ordenar y limitar los valores estad¨ªsticos devueltos. La lista de campos disponibles para cada tipo de estad¨ªstica de informaci¨®n de diagn¨®stico se describe en detalle a continuaci¨®n. Ejemplo: { ¡°source.alerts¡±: 10 } |
Lista de campos estad¨ªsticos disponibles para cada tipo de solicitud de informaci¨®n de diagn¨®stico
Se pueden solicitar los siguientes campos estad¨ªsticos para cada tipo de propiedad de solicitud de informaci¨®n de diagn¨®stico.
| Tipo de diagn¨®stico | Campos disponibles | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| historycache | items | N¨²mero de m¨¦tricas almacenados en cach¨¦. |
| values | N¨²mero de valores almacenados en cach¨¦. | |
| memory | Estad¨ªsticas de memoria compartida (espacio libre, n¨²mero de fragmentos utilizados, n¨²mero de fragmentos libres, tama?o m¨¢ximo de fragmentos libres). | |
| memory.data | Historial de estad¨ªsticas de memoria compartida de cach¨¦ de datos. | |
| memory.index | Estad¨ªsticas de memoria compartida de cach¨¦ de ¨ªndice hist¨®rico. | |
| valuecache | items | N¨²mero de m¨¦tricas almacenadas en cach¨¦. |
| values | N¨²mero de valores almacenados en cach¨¦. | |
| memory | Estad¨ªsticas de memoria compartida (espacio libre, n¨²mero de fragmentos utilizados, n¨²mero de fragmentos libres, tama?o m¨¢ximo de fragmentos libres). | |
| mode | Modo de cach¨¦ de valores. | |
| preprocessing | valores | N¨²mero de valores en cola. |
| preproc.values | N¨²mero de valores en cola con pasos de preprocesamiento. | |
| alerting | alertas | N¨²mero de alertas en cola. |
| lld | rules | N¨²mero de reglas en cola. |
| values | N¨²mero de valores en cola. |
Lista de campos de ordenaci¨®n disponibles para cada tipo de solicitud de informaci¨®n de diagn¨®stico
Los siguientes campos estad¨ªsticos se pueden utilizar para ordenar y limitar las solicitudes de informaci¨®n.
| Tipo de diagn¨®stico | Campos disponibles | Tipo |
|---|---|---|
| historycache | valores | entero |
| valuecache | valores | entero |
| request.values | entero | |
| preprocessing | valores | entero |
| alerting | media.alerts | entero |
| source.alerts | entero | |
| lld | valores | entero |
Objeto de resultado estad¨ªstico
El objeto de resultado estad¨ªstico se recupera en el campo result del objeto de tarea.
| Propiedad | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| status | integer | Estado del resultado de la tarea. Valores posibles: -1: se produjo un error durante la realizaci¨®n de la tarea; 0: se crea el resultado de la tarea. Propiedad comportamiento: - solo lectura |
| data | cadena/objeto | Resultados seg¨²n el objeto de solicitud de estad¨ªstica de una tarea de informaci¨®n de diagn¨®stico particular. Contiene una cadena de mensaje de error si se produjo un error durante la realizaci¨®n de la tarea. |