8 Correspondance des valeurs

Présentation

Le mappage de valeurs permet de configurer une représentation plus conviviale des valeurs reçues à l'aide de mappages entre des valeurs numériques/de chaîne et des représentations de chaîne.

Par exemple, lorsque la valeur d'un élément est « 0 » ou « 1 », des mappages de valeurs peuvent être utilisés pour représenter ces valeurs de manière plus conviviale :

  • 0 → Non disponible
  • 1 → Disponible

Les mappages de valeurs pour les types de sauvegarde de données peuvent être configurés comme suit :

  • F → Complet
  • D → Différentiel
  • I → Incrémentiel

Les plages de valeurs pour la tension peuvent être configurées comme suit :

  • <=209 → Faible
  • 210-230 → OK
  • >=231 → Élevé

Le mappage de valeurs est utilisé dans le frontend Zabbix et les notifications envoyées par les types de média.

La substitution de la valeur reçue par la représentation configurée est effectuée à la fois dans le frontend Zabbix et sur le serveur ; cependant, le serveur gère la substitution uniquement dans les cas suivants :

Les mappages de valeurs sont configurés sur des modèles ou des hôtes. Une fois configurés, ils sont disponibles pour tous les éléments du modèle ou de l'hôte respectif. Lors de la configuration des éléments, spécifiez le nom d'un mappage de valeurs précédemment configuré dans le paramètre Mappage de valeurs.

Il n'y a pas d'héritage de mappage de valeurs - les hôtes et les modèles n'héritent pas des mappages de valeurs des modèles liés. Les éléments de modèle sur un hôte continueront d'utiliser les mappages de valeurs configurés sur le modèle.

Les mappages de valeurs peuvent être utilisés avec des éléments ayant des types d'informations Numérique (non signé), Numérique (float) et Caractère.

Les mappages de valeurs sont exportés/importés avec le modèle ou l'hôte respectif. Ils peuvent également être mis à jour en masse à l'aide des formulaires de mise à jour en masse hôte et modèle.

Configuration

Pour configurer un mappage de valeurs, suivez ces étapes :

1. Ouvrez le formulaire de configuration de l’hôte ou du modèle.

2. Dans l’onglet Mappage de valeurs, cliquez sur Ajouter pour ajouter un nouveau mappage de valeurs, ou cliquez sur le nom d’un mappage existant pour le modifier.

Paramètres d’un mappage de valeurs :

Paramètre Description
Nom Nom unique pour l’ensemble des mappages de valeurs.
Mappages Règles individuelles pour mapper des valeurs numériques/chaînes vers des représentations sous forme de chaîne.

Le mappage est appliqué dans l’ordre des règles, qui peuvent être réorganisées par glisser-déposer.
Type Type de mappage :
égal à - les valeurs égales seront mappées ;
supérieur ou égal à - les valeurs égales ou supérieures seront mappées ;
inférieur ou égal à - les valeurs égales ou inférieures seront mappées ;
dans l’intervalle - les valeurs comprises dans l’intervalle seront mappées ; l’intervalle s’exprime sous la forme <number1>-<number2> ou <number> ; plusieurs intervalles sont pris en charge (par exemple, 1-10,101-110,201) ;
regexp - les valeurs correspondant à l’expression régulière seront mappées (les expressions régulières globales ne sont pas prises en charge) ;
par défaut - toutes les autres valeurs seront mappées, à l’exception de celles disposant d’un mappage spécifique.

Pour les intervalles de mappage, seuls les types de valeurs numériques (supérieur ou égal à, inférieur ou égal à, dans l’intervalle) sont pris en charge.
Valeur Valeur entrante (peut contenir un intervalle ou une expression régulière, selon le type de mappage).
Mappé vers Représentation sous forme de chaîne (jusqu’à 64 caractères) pour la valeur entrante.

Tous les champs de saisie obligatoires sont marqués d’un astérisque rouge.

Lors de l’affichage du mappage de valeurs dans la liste, seuls les trois premiers mappages sont visibles, trois points indiquant que d’autres mappages existent.

Exemple de correspondance de valeurs

L’un des éléments d’agent prédéfinis, Zabbix agent ping, utilise une correspondance de valeurs au niveau du modèle, « Zabbix agent ping status », pour afficher ses valeurs.

Dans le formulaire de configuration de l’élément, vous pouvez trouver une référence à cette correspondance de valeurs dans le champ Value mapping :

Cette correspondance est utilisée dans la section Monitoring → Latest data pour afficher « Up » (avec la valeur brute entre parenthèses).

Dans la section Latest data, les valeurs affichées sont raccourcies à 20 caractères. Si une correspondance de valeurs est utilisée, ce raccourcissement ne s’applique pas à la valeur correspondante, mais uniquement à la valeur brute (affichée entre parenthèses).

Sans correspondance de valeurs prédéfinie, vous ne verriez que « 1 », ce qui pourrait être difficile à comprendre.