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 :
- lors du remplissage de l'inventaire de l'hôte ;
- lors du développement de macros prises en charge}, {ITEM.LASTVALUE}, {EVENT.OPDATA} et {EVENT.CAUSE.OPDATA}.
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 une correspondance de valeurs, procédez comme suit :
1. Ouvrez le formulaire de configuration de l'hôte ou du modèle.
2. Dans l'onglet Correspondance des valeurs, cliquez sur Ajouter pour ajouter une nouvelle correspondance de valeurs, ou cliquez sur le nom d'une correspondance existante pour la modifier.
Paramètres d'une correspondance de valeurs :
| Paramètre | Description | |
|---|---|---|
| Nom | Nom unique de l'ensemble des correspondances de valeurs. | |
| Correspondances | Règles individuelles permettant de faire correspondre des valeurs numériques ou textuelles à des représentations textuelles. La correspondance est appliquée dans l'ordre des règles, qui peuvent être réorganisées par glisser-déposer. |
|
| Type | Type de correspondance : equals - les valeurs égales seront mises en correspondance ; is greater than or equals - les valeurs égales ou supérieures seront mises en correspondance ; is less than or equals - les valeurs égales ou inférieures seront mises en correspondance ; in range - les valeurs comprises dans l'intervalle seront mises en correspondance ; l'intervalle est exprimé 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 mises en correspondance (les expressions régulières globales ne sont pas prises en charge) ; default - toutes les valeurs restantes seront mises en correspondance, à l'exception de celles ayant des correspondances spécifiques. Pour les correspondances d'intervalles, seuls les types de valeurs numériques (is greater than or equals, is less than or equals, in range) sont pris en charge. |
|
| Valeur | Valeur reçue (peut contenir un intervalle ou une expression régulière, selon le type de correspondance). | |
| Correspond à | Représentation textuelle (jusqu'à 64 caractères) de la valeur reçue. | |
Tous les champs de saisie obligatoires sont signalés par un astérisque rouge.
Lors de l'affichage de la correspondance de valeurs dans la liste, seules les trois premières correspondances sont visibles ; trois points indiquent que d'autres correspondances existent.
Exemple de correspondance de valeurs
L’un des éléments prédéfinis de l’agent 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 trouverez une référence à cette correspondance de valeurs dans le champ Correspondance de valeurs :
Cette correspondance est utilisée dans la section Surveillance → Dernières données pour afficher « Up » (avec la valeur brute entre parenthèses).
Dans la section Dernières données, les valeurs affichées sont limitées à 20 caractères. Si une correspondance de valeurs est utilisée, cette limitation 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.
