Objeto de tarea

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

Tarea

El objeto de tarea tiene las siguientes propiedades:

Propiedad	Tipo	Descripción
taskid	ID	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 configuración del proxy; 6 - Ejecutar ahora. Desde Zabbix 7.0.19, los usuarios de tipo Admin y Usuario pueden crear tareas 'Ejecutar ahora'. Tenga en cuenta que `task.get` siempre devuelve "7" (Resumen de ejecución de tarea). Comportamiento de la propiedad: - requerido
status	entero	Estado de la tarea. Valores posibles: 1 - nueva tarea; 2 - tarea en progreso; 3 - tarea completada; 4 - tarea expirada. Comportamiento de la propiedad: - solo lectura
clock	timestamp	Hora en que se creó la tarea. Comportamiento de la propiedad: - solo lectura
ttl	entero	El tiempo en segundos después del cual la tarea expira. Comportamiento de la propiedad: - solo lectura
proxyid	ID	ID del proxy sobre el que se recopila la estadística de información de diagnóstico. Comportamiento de la propiedad: - soportado si `type` está establecido en "Información de diagnóstico" o "Actualizar configuración del 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; El objeto de la tarea 'Actualizar configuración del 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: - requerido
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	ID	ID del elemento y de las reglas de descubrimiento de bajo nivel. Desde Zabbix 7.0.19, los usuarios de tipo Admin y User pueden 'Ejecutar ahora' elementos en los equipos para los que tengan permiso de lectura-escritura, o permiso de lectura y la acción `invoke_execute_now` habilitada para su rol. Lo mismo se aplica a los usuarios de tipo Admin para las reglas de descubrimiento de bajo nivel (LLD).

Objeto de solicitud de la tarea 'Actualizar configuración del proxy'

El objeto de solicitud de la tarea 'Actualizar configuración del proxy' tiene las siguientes propiedades.

Propiedad	Tipo	Descripción
proxyids	array	IDs de proxy.

Objeto de solicitud de '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ísticas para todos los tipos de propiedades se describe en detalle a continuación.

Propiedad	Tipo	Descripción
historycache	objeto	Solicitud de estadísticas de caché de historial. Disponible en servidor y proxy.
valuecache	objeto	Solicitud de estadísticas de caché de ítems. Disponible en servidor.
preprocessing	objeto	Solicitud de estadísticas del gestor de preprocesamiento. Disponible en servidor y proxy.
alerting	objeto	Solicitud de estadísticas del gestor de alertas. Disponible en servidor.
lld	objeto	Solicitud de estadísticas del gestor LLD. Disponible en servidor.

Objeto de solicitud de estadísticas

El objeto de solicitud de estadísticas se utiliza para definir qué tipo de información debe recopilarse sobre los procesos internos del servidor/proxy. Tiene las siguientes propiedades.

Propiedad	Tipo	Descripción
stats	query	Propiedades del objeto de estadísticas 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. Por defecto: `extend` devolverá todos los campos de estadísticas disponibles.
top	object	Objeto para ordenar y limitar los valores de estadísticas 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 elementos en caché.
	values	Número de valores en caché.
	memory	Estadísticas de memoria compartida (espacio libre, número de fragmentos usados, número de fragmentos libres, tamaño máximo del fragmento libre).
	memory.data	Estadísticas de memoria compartida de la caché de datos históricos.
	memory.index	Estadísticas de memoria compartida de la caché de índices históricos.
valuecache	items	Número de elementos en caché.
	values	Número de valores en caché.
	memory	Estadísticas de memoria compartida (espacio libre, número de fragmentos usados, número de fragmentos libres, tamaño máximo del fragmento libre).
	mode	Modo de caché de valores.
preprocessing	values	Número de valores en cola.
preprocessing	preproc.values	Número de valores en cola con pasos de preprocesamiento.
alerting	alerts	Número de alertas en cola.
lld	rules	Número de reglas en cola.
lld	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

Se pueden utilizar los siguientes campos estadísticos para ordenar y limitar la información solicitada.

Tipo de diagnóstico	Campos disponibles	Tipo
historycache	values	integer
valuecache	values	integer
valuecache	request.values	integer
preprocessing	values	integer
alerting	media.alerts	integer
alerting	source.alerts	integer
lld	values	integer

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	entero	Estado del resultado de la tarea. Valores posibles: -1 - se produjo un error durante la ejecución de la tarea; 0 - el resultado de la tarea se ha creado. Comportamiento de la propiedad: - solo lectura
data	cadena/objeto	Resultados según el objeto de solicitud estadística de la tarea de información de diagnóstico particular. Contiene una cadena de mensaje de error si se produjo un error durante la ejecución de la tarea.

Documentation