Esta página incluye contenido traducido automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

Objeto de servicio

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

Servicio

El objeto servicio tiene las siguientes propiedades.

Propiedad Tipo Descripción
serviceid ID ID del servicio.

Comportamiento de la propiedad:
- solo lectura
- requerido para operaciones de actualización
algorithm integer Regla de cálculo de estado. Solo aplicable si existen servicios hijos.

Valores posibles:
0 - establecer el estado en OK;
1 - el más crítico si todos los hijos tienen problemas;
2 - el más crítico de los servicios hijos.

Comportamiento de la propiedad:
- requerido para operaciones de creación
name string Nombre del servicio.

Comportamiento de la propiedad:
- requerido para operaciones de creación
sortorder integer Posición del servicio utilizada para ordenar.

Valores posibles: 0-999.

Comportamiento de la propiedad:
- requerido para operaciones de creación
weight integer Peso del servicio.

Valores posibles: 0-1000000.

Por defecto: 0.
propagation_rule integer Regla de propagación de estado.

Valores posibles:
0 - (por defecto) propagar el estado del servicio tal cual - sin ningún cambio;
1 - aumentar el estado propagado por un propagation_value dado (de 1 a 5 niveles de severidad);
2 - disminuir el estado propagado por un propagation_value dado (de 1 a 5 niveles de severidad);
3 - ignorar este servicio - el estado no se propaga al servicio padre en absoluto;
4 - establecer un estado de servicio fijo usando un propagation_value dado.

Comportamiento de la propiedad:
- requerido si se establece propagation_value
propagation_value integer Valor de propagación de estado.

Valores posibles si propagation_rule se establece en "0" o "3":
0 - No clasificado.

Valores posibles si propagation_rule se establece en "1" o "2":
1 - Información;
2 - Advertencia;
3 - Media;
4 - Alta;
5 - Desastre.

Valores posibles si propagation_rule se establece en "4":
-1 - OK;
0 - No clasificado;
1 - Información;
2 - Advertencia;
3 - Media;
4 - Alta;
5 - Desastre.

Comportamiento de la propiedad:
- requerido si se establece propagation_rule
status integer Indica si el servicio está en estado OK o en estado de problema.

Si el servicio está en estado de problema, status es igual a:
- la severidad del problema más crítico;
- el estado más alto de un servicio hijo en estado de problema.

Si el servicio está en estado OK, status es igual a: -1.

Comportamiento de la propiedad:
- solo lectura
description string Descripción del servicio.
uuid string Identificador único universal, utilizado para vincular servicios importados a los ya existentes. Se genera automáticamente si no se proporciona.
created_at integer Marca de tiempo Unix cuando se creó el servicio.
readonly integer Acceso al servicio.

Valores posibles:
0 - Lectura-escritura;
1 - Solo lectura.

Comportamiento de la propiedad:
- solo lectura

Regla de estado

El objeto de regla de estado tiene las siguientes propiedades.

Propiedad Tipo Descripción
type entero Condición para establecer el estado (Nuevo estado).

Valores posibles:
0 - si al menos (N) servicios secundarios tienen el estado (Estado) o superior;
1 - si al menos (N%) de los servicios para niños tienen el estado (Estado) o superior;
2 - si menos de (N) los servicios para niños tienen el estado (Estado) o inferior;
3 - si menos del (N%) de los servicios para niños tienen el estado (Estado) o inferior;
4 - si el peso de los servicios para niños con el estado (Estado) o superior es al menos (W);
5 - si el peso de los servicios para niños con el estado (Estado) o superior es al menos (N%);
6 - si el peso de los servicios para niños con estado (Estado) o inferior es menor que (W);
7 - si el peso de los servicios para niños con estado (Estado) o a continuación es menor que (N%).

Donde:
- N (W) es limit_value;
- (Estado) es limit_status;
- (Nuevo estado) es new_status.

Comportamiento de la propiedad:
- obligatorio
limit_value entero Valor límite.

Valores posibles:
- para N y W: 1-100000;
- para N%: 1-100.

Comportamiento de la propiedad:
- obligatorio
limit_status entero Estado del límite.

Valores posibles:
-1 - OK;
0 - No clasificado;
1 - Información;
2 - Advertencia;< br>3 - Promedio;
4 - Alto;
5 - Desastre.

Comportamiento de la propiedad:
- obligatorio
new_status entero Nuevo valor de estado.

Valores posibles:
0 - No clasificado;
1 - Información;
2 - Advertencia;
3 - Promedio;< br>4 - Alto;
5 - Desastre.

Comportamiento de la propiedad:
- obligatorio

Etiqueta de servicio

El objeto de etiqueta de servicio tiene las siguientes propiedades.

Propiedad Tipo Descripción
tag cadena Nombre de etiqueta de servicio.

Comportamiento de la propiedad:
- obligatorio
value cadena Valor de etiqueta de servicio.

Alarma de servicio

Las alarmas de servicio no se pueden crear, actualizar ni eliminar a través de la API de Zabbix.

Los objetos de alarma de servicio representan el cambio de estado de un servicio. Tiene las siguientes propiedades.

Propiedad Tipo Descripción
clock marca de tiempo Hora en la que se produjo el cambio de estado del servicio.
value entero Estado del servicio.

Consulte la propiedad de estado del servicio para obtener una lista de valores posibles.

Etiqueta de problema

Las etiquetas de problema permiten vincular servicios con eventos de problema. El objeto de etiqueta de problema tiene las siguientes propiedades.

Propiedad Tipo Descripción
tag string Nombre de la etiqueta de problema.

Comportamiento de la propiedad:
- obligatorio
operator integer Condición de mapeo operador.

Valores posibles:
0 - (por defecto) Igual;
2 - Contiene.
value string Valor de la etiqueta de problema.