This is a translation of the original English documentation page. Help us make it better.

9 Table de correspondance des valeurs

Aperçu

Pour une représentation plus "humaine" des valeurs reçues, vous pouvez utiliser des tables de correspondances de valeurs qui contiennent le mappage entre les valeurs numériques/chaînes et les représentations sous forme de chaîne.

Les tables de correspondances de valeurs peuvent être utilisés à la fois dans l'interface Zabbix et dans les notifications par types de médias.

Par exemple, un élément qui a la valeur '0' ou '1' peut utiliser le mappage de valeurs pour représenter les valeurs sous une forme lisible par l'homme :

  • '0' => 'Not Available'
  • '1' => 'Available'

Ou, une table de correspondances de valeurs liée à la sauvegarde pourrait être :

  • 'F' => 'Full'
  • 'D' => 'Differential'
  • 'I' => 'Incremental'

Dans un autre exemple, les plages de valeurs de tension peuvent être mappées :

  • '<=209' => 'Low'
  • '210-230' => 'OK'
  • '>=231' => 'High'

Les mappages de valeurs sont définis au niveau du modèle ou de l'hôte. Une fois définis, ils deviennent disponibles pour tous les éléments du modèle ou de l'hôte respectif. Il n'y a pas d'héritage de table de valeurs - un élément de modèle sur un hôte utilise toujours la table de valeurs du modèle ; lier un modèle avec des tables de correspondances de valeurs à l'hôte ne fait pas que l'hôte hérite des tables de valeurs.

Lors de la configuration des éléments, vous pouvez utiliser une table de valeurs pour "humaniser" la façon dont une valeur d'élément sera affichée. Pour ce faire, vous vous référez au nom d'une table de valeurs précédemment définie dans le champ * Mappage de valeurs *.

Le mappage de valeurs peut être utilisé avec des éléments ayant des informations de type Numérique (non signé), Numérique (flottant) et Caractère.

Les mappages de valeurs peuvent être exportés/importés avec le modèle ou l'hôte respectif.

Les mappages de valeurs peuvent être mis à jour en masse. Les formulaires de mise à jour en masse de l'hôte et du modèle ont tous deux un onglet Mappage de valeurs pour la mise à jour en masse des mappages de valeurs.

Configuration

Pour définir une de valeurs :

  • Ouvrir un formulaire de configuration d'hôte ou de modèle
  • Accédez à l'onglet Table de correspondance
  • Cliquez sur Ajouter pour ajouter une nouvelle table
  • Cliquez sur le nom d'une table existante pour la modifier

Paramètres d'une table de correspondance de valeurs :

Paramètre Description
Nom Nom unique d'un ensemble des correspondances de valeurs.
Correspondances Règles de correspondances individuelles pour le mappage des valeurs numériques/chaînes aux représentations sous forme de chaîne.
Le mappage est appliqué selon l'ordre des règles de mappage. Il est possible de réorganiser les mappages en faisant glisser.
Seuls les types de valeurs numériques sont pris en charge pour les plages de mappage (types de mappage est supérieur ou égal à, est inférieur ou égal à, est dans la plage).
Type Type de mappage :
égal - des valeurs égales seront mappées
est supérieur ou égal à - des valeurs égales ou supérieures seront mappées
est inférieur ou égal à - les valeurs égales ou inférieures seront mappées
est dans la plage - les valeurs dans la plage seront mappées ; la plage est exprimée sous la forme <nombre1>-<nombre2>, ou <nombre>. Plusieurs plages sont prises en charge (par exemple, 1-10 101-110 201)
expression régulière : les valeurs correspondant à l'expression régulière seront mappées (les expressions régulières globales ne sont pas prises en charge)
* *défaut** - toutes les valeurs en attente seront mappées, à l'exception de celles avec des mappages spécifiques
Valeur Valeur entrante.
Selon le type de mappage, peut également contenir une plage ou une expression régulière.
Correspond à Représentation sous forme de chaîne pour la valeur entrante.

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

Lorsque la table de correspondances de valeurs est affichée dans la liste, seuls les trois premiers mappages de celle-ci sont visibles, tandis que trois points indiquent qu'il existe d'autres mappages.

Comment cela fonctionne

Par exemple, l'un des éléments d'agent prédéfinis 'Zabbix agent ping' utilise une table de correspondance de valeurs au niveau du modèle appelée 'Zabbix agent ping status' pour afficher ses valeurs.

Dans le formulaire de configuration de l'élément, vous pouvez voir une référence à cette table de correspondance de valeurs dans le champ Table de correspondance :

Ainsi, dans Surveillance → # Dernières données, la table de correspondance est utilisée pour afficher 'Up' (avec la valeur brute entre parenthèses).

Dans la section Dernières données, les valeurs affichées sont réduites à 20 symboles. Si la table de correspondance de valeurs est utilisée, ce raccourcissement n'est pas appliqué à la valeur mappée, mais uniquement à la valeur brute (affichée entre parenthèses).

Une valeur affichée sous une forme lisible par l'homme est également plus facile à comprendre lors de la réception de notifications.

Sans une table de correspondance de valeurs prédéfinie, vous n'obtiendriez que ceci :

Donc, dans ce cas, vous devrez soit deviner ce que signifie le '1', soit effectuer une recherche dans la documentation pour le savoir.