Objet service

Les objets suivants sont directement liés à l'API service.

Service

L'objet service possède les propriétés suivantes.

Propriété Type Description
serviceid ID ID du service.

Comportement de la propriété :
- lecture seule
- obligatoire pour les opérations de mise à jour
algorithm integer Règle de calcul du statut. Applicable uniquement si des services enfants existent.

Valeurs possibles :
0 - définir le statut sur OK ;
1 - le plus critique si tous les enfants ont des problèmes ;
2 - le plus critique des services enfants.

Comportement de la propriété :
- obligatoire pour les opérations de création
name string Nom du service.

Comportement de la propriété :
- obligatoire pour les opérations de création
sortorder integer Position du service utilisée pour le tri.

Valeurs possibles : 0-999.

Comportement de la propriété :
- obligatoire pour les opérations de création
weight integer Poids du service.

Valeurs possibles : 0-1000000.

Par défaut : 0.
propagation_rule integer Règle de propagation du statut.

Valeurs possibles :
0 - (par défaut) propager le statut du service tel quel, sans aucune modification ;
1 - augmenter le statut propagé d'une valeur propagation_value donnée (de 1 à 5 niveaux de sévérité) ;
2 - diminuer le statut propagé d'une valeur propagation_value donnée (de 1 à 5 niveaux de sévérité) ;
3 - ignorer ce service - le statut n'est pas propagé au service parent ;
4 - définir un statut de service fixe à l'aide d'une valeur propagation_value donnée.

Comportement de la propriété :
- obligatoire si propagation_value est défini
propagation_value integer Valeur de propagation du statut.

Valeurs possibles si propagation_rule est défini sur "0" ou "3" :
0 - Non classé.

Valeurs possibles si propagation_rule est défini sur "1" ou "2" :
1 - Information ;
2 - Avertissement ;
3 - Moyen ;
4 - Élevé ;
5 - Désastre.

Valeurs possibles si propagation_rule est défini sur "4" :
-1 - OK ;
0 - Non classé ;
1 - Information ;
2 - Avertissement ;
3 - Moyen ;
4 - Élevé ;
5 - Désastre.

Comportement de la propriété :
- obligatoire si propagation_rule est défini
status integer Indique si le service est dans l'état OK ou dans un état de problème.

Si le service est dans un état de problème, status est égal soit à :
- la sévérité du problème le plus critique ;
- le statut le plus élevé d'un service enfant en état de problème.

Si le service est dans l'état OK, status est égal à : -1.

Comportement de la propriété :
- lecture seule
description string Description du service.
uuid string Identifiant unique universel, utilisé pour lier les services importés à ceux qui existent déjà. Généré automatiquement s'il n'est pas fourni.
created_at integer Horodatage Unix de la création du service.
readonly integer Accès au service.

Valeurs possibles :
0 - Lecture-écriture ;
1 - Lecture seule.

Comportement de la propriété :
- lecture seule

Règle de statut

L'objet de règle de statut possède les propriétés suivantes.

Propriété Type Description
type integer Condition pour définir le statut (Nouveau statut).

Valeurs possibles :
0 - si au moins (N) services enfants ont le statut (Statut) ou supérieur ;
1 - si au moins (N%) des services enfants ont le statut (Statut) ou supérieur ;
2 - si moins de (N) services enfants ont le statut (Statut) ou inférieur ;
3 - si moins de (N%) des services enfants ont le statut (Statut) ou inférieur ;
4 - si le poids des services enfants ayant le statut (Statut) ou supérieur est d'au moins (W) ;
5 - si le poids des services enfants ayant le statut (Statut) ou supérieur est d'au moins (N%) ;
6 - si le poids des services enfants ayant le statut (Statut) ou inférieur est inférieur à (W) ;
7 - si le poids des services enfants ayant le statut (Statut) ou inférieur est inférieur à (N%).

Où :
- N (W) correspond à limit_value ;
- (Statut) correspond à limit_status ;
- (Nouveau statut) correspond à new_status.

Comportement de la propriété :
- obligatoire
limit_value integer Valeur limite.

Valeurs possibles :
- pour N et W : 1-100000 ;
- pour N% : 1-100.

Comportement de la propriété :
- obligatoire
limit_status integer Statut limite.

Valeurs possibles :
-1 - OK ;
0 - Non classé ;
1 - Information ;
2 - Avertissement ;
3 - Moyen ;
4 - Élevé ;
5 - Désastre.

Comportement de la propriété :
- obligatoire
new_status integer Valeur du nouveau statut.

Valeurs possibles :
0 - Non classé ;
1 - Information ;
2 - Avertissement ;
3 - Moyen ;
4 - Élevé ;
5 - Désastre.

Comportement de la propriété :
- obligatoire

Balise de service

L’objet de balise de service possède les propriétés suivantes.

Propriété Type Description
tag string Nom de la balise de service.

Comportement de la propriété :
- obligatoire
value string Valeur de la balise de service.

Alarme de service

Les alarmes de service ne peuvent pas être créées, mises à jour ou supprimées directement via l'API Zabbix.

Les objets d'alarme de service représentent un changement d'état d'un service. Ils possèdent les propriétés suivantes.

Propriété Type Description
clock timestamp Heure à laquelle le changement d'état du service s'est produit.
value integer Statut du service.

Consultez la propriété status du service pour obtenir la liste des valeurs possibles.

Tag de problème

Les tags de problème permettent de lier des services à des événements de problème. L'objet de tag de problème possède les propriétés suivantes.

Propriété Type Description
tag string Nom du tag de problème.

Comportement de la propriété :
- obligatoire
operator integer Opérateur de condition de correspondance.

Valeurs possibles :
0 - (par défaut) Égal à ;
2 - Contient.
value string Valeur du tag de problème.