Objet service

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

Service

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

Property 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 de l'état. Applicable uniquement si des services enfants existent.

Valeurs possibles:
0 - définir l'état sur OK;
1 - le plus critique si tous les enfants ont des problèmes;
2 - le plus critique parmi les 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 de l'état.

Valeurs possibles:
0 - (par défaut) propager l'état du service tel quel - sans aucune modification;
1 - augmenter l'état propagé d'une valeur propagation_value donnée (de 1 à 5 niveaux de gravité);
2 - diminuer l'état propagé d'une valeur propagation_value donnée (de 1 à 5 niveaux de gravité);
3 - ignorer ce service - l'état n'est pas du tout propagé au service parent;
4 - définir un état 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 de l'état.

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 un état OK ou en problème.

Si le service est dans un état de problème, status est égal soit à la gravité du problème le plus critique, soit au statut le plus élevé d'un service enfant en état de problème.

Si le service est dans un é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 déjà existants. 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 au moins égal à (W) ;
5 - si le poids des services enfants ayant le statut (Statut) ou supérieur est au moins égal à (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 des propriétés :
- obligatoire
limit_value integer Valeur limite.

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

Comportement des propriétés :
- 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 des propriétés :
- 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 des propriétés :
- 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 ont les propriétés suivantes.

Property Type Description
clock timestamp Heure à laquelle le changement d'état du service s'est produit.

Consultez la propriété status du service pour une liste des valeurs possibles.
value integer Statut du service.

Balise de problème

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

Property Type Description
tag string Nom de la balise de problème.

Property behavior:
- required
operator integer Opérateur de la condition de mappage.

Valeurs possibles :
0 - (default) Égal à;
2 - Contient.
value string Valeur de la balise de problème.