Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Únase a nuestro proyecto de traducción y ayude a traducir la documentación de Zabbix a su lengua materna.

> Objeto de tarea

Los siguientes objetos están directamente relacionados con la API task.

El objeto de tarea tiene las siguientes propiedades:

Propiedad Tipo Descripción
taskid cadena ID de la tarea.

Comportamiento de la propiedad:
- solo lectura
type entero 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
clock 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
proxy_hostid cadena ID del proxy sobre el cual se recopila la estadística de información de diagnóstico.

Comportamiento de la propiedad:
- compatible si type está configurado en "Información de diagnóstico" o "Actualizar configuración de proxy"
request 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
result 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 Descripción
itemid cadena ID del elemento 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 Descripción
proxy_hostids matriz ID 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 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.

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 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 }
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 Descripción
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 Descripción
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.