The following objects are directly related to the task
API.
The task object has the following properties:
Property | Type | Description |
---|---|---|
taskid | string | (readonly) ID of the task. |
type (required) |
integer | Type of the task. Possible values: 1 - Diagnostic information; 6 - Check now. |
status | integer | (readonly) Status of the task. Possible values: 1 - new task; 2 - task in progress; 3 - task is completed; 4 - task is expired. |
clock | timestamp | (readonly) Time when the task was created. |
ttl | integer | (readonly) The time in seconds after which task expires. |
proxy_hostid | string | ID of the proxy about which diagnostic information statistic is collected. Ignored for 'Check now' tasks. |
request (required) |
object | Task request object according to the task type: Object of 'Check now' task is described in detail below; Object of 'Diagnostic information' task is described in detail below. |
result | object | (readonly) Result object of the diagnostic information task. May contain NULL if result is not yet ready. Result object is described in detail below. |
El objeto de solicitud de tarea 'Comprobar ahora' tiene las siguientes propiedades.
Propiedad | Tipo | Descripción |
---|---|---|
itemid | cadena | ID de la métrica y reglas de descubrimiento de bajo nivel. |
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 | Descripción |
---|---|---|
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. |
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 | Descripción |
---|---|---|
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 } |
Following statistic fields can be requested for each type of diagnostic information request property.
Diagnostic type | Available fields | Description |
---|---|---|
historycache | items | Number of cached items. |
values | Number of cached values. | |
memory | Shared memory statistics (free space, number of used chunks, number of free chunks, max size of free chunk). | |
memory.data | History data cache shared memory statistics. | |
memory.index | History index cache shared memory statistics. | |
valuecache | items | Number of cached items. |
values | Number of cached values. | |
memory | Shared memory statistics (free space, number of used chunks, number of free chunks, max size of free chunk). | |
mode | Value cache mode. | |
preprocessing | values | Number of queued values. |
preproc.values | Number of queued values with preprocessing steps. | |
alerting | alerts | Number of queued alerts. |
lld | rules | Number of queued rules. |
values | Number of queued values. |
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 |
El objeto de resultado estadístico se recupera en el campo result
del objeto de tarea.
Propiedad | Tipo | Descripción |
---|---|---|
status | entero | (solo lectura) 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. |
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. |