This is the documentation page for an unsupported version of Zabbix.
Is this not what you were looking for? Switch to the current version or choose one from the drop-down menu.

1 Création d'un élément

Aperçu

Pour créer un élément dans l’interface web Zabbix, procédez comme suit :

  • Allez à : ConfigurationHôtes
  • Cliquez sur Éléments dans la rangée de l'hôte
  • Cliquez sur Créer un élément dans le coin supérieur droit de l'écran
  • Entrez les paramètres de l'élément dans le formulaire

Vous pouvez également créer un élément en ouvrant un élément existant, en appuyant sur le bouton Cloner, puis en enregistrant sous un autre nom.

Configuration

L'onglet Élément contient des attributs généraux des éléments :

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

Paramètre Description
Nom Nom de l'élément.
Notez que l'utilisation des macros positionnelles ($1,$2 ... $9 - se référant au premier, deuxième ... neuvième paramètre de la clé de l'élément) est maintenant obsolète.
Par exemple : Espace disque disponible sur 1$. Si la clé de l'élément est "vfs.fs.size[/,free]", la description changera automatiquement en "Espace disque libre sur /"
Type Type de l'élément. Voir les sections de type d'élément individuellement.
Clé Clé de l'élément.
Les clés d'élément prises en charge peuvent être trouvées dans les sections de type d'élément individuellement.
La clé doit être unique par hôte.
Si le type de clé est 'Agent Zabbix', 'Agent Zabbix (actif)', 'Vérification simple' ou 'Agrégation Zabbix', la valeur de clé doit être prise en charge par l'agent Zabbix ou par le serveur Zabbix.
Voir aussi : le format de clé correct.
Interface hôte Sélectionnez l'interface hôte. Ce champ est disponible lors de la modification d'un élément au niveau de l'hôte.
Type d'information Type de données stockées dans la base de données après avoir effectué des conversions, si nécessaire.
Numérique (non signé) - Entier 64 bits non signé
Numérique (float) - nombre à virgule flottante
Les valeurs négatives peuvent être stockées.
Plage autorisée: -999999999999,9999 à 999999999999,9999.
À partir de Zabbix 2.2, la réception de valeurs en notation scientifique est également prise en charge. Par exemple 1e+7, 1e-4.
Caractère - données de texte court
Log - Données textuelles longues avec des propriétés de journalisation facultatives (horodatage, source, gravité, logeventid)
Texte - données de texte long. Voir aussi les limites de données textuelles.
Unités Si un symbole d'unité est défini, Zabbix ajoutera le post-traitement à la valeur reçue et l'affichera avec le suffixe d'unité défini.
Par défaut, si la valeur brute dépasse 1000, elle est divisée par 1000 et affichée en conséquence. Par exemple, si vous définissez bps et recevez une valeur de 881764, celle-ci s'affiche sous la forme 881,76 Kbps.
Un traitement spécial est utilisé pour les unités B (octets), Bps (octets par seconde), qui sont divisés par 1024. Ainsi, si les unités sont définies sur B ou Bps, Zabbix affichera :
1 comme 1B/1Bps
1024 comme 1KB/1KBps
1536 comme 1.5KB/1.5KBps
Un traitement spécial est utilisé si les unités temporelles suivantes sont utilisées :
unixtime - traduit par "aaaa.mm.jj hh:mm:ss". Pour traduire correctement, la valeur reçue doit être un type d'information Numérique (non signé).
uptime - traduit en "hh:mm:ss" ou "N jours, hh:mm:ss"
Par exemple, si vous recevez la valeur 881764 (secondes), elle s'affichera comme "10 jours, 04:56:04"
s - traduit en "aaa MMM jjj hhh sss ms"; le paramètre est traité en nombre de secondes.
Par exemple, si vous recevez la valeur 881764 (secondes), elle s'affichera comme "10j 4h 56m"
Seulement 3 unités principales supérieures sont montrées, comme "1m 15d 5h" ou "2h 4m 46s". S'il n'y a pas de jours à afficher, seulement deux niveaux sont affichés - "1m 5h" (pas de minutes, secondes ou millisecondes sont affichées). Et sera traduit en "<1 ms" si la valeur est inférieure à 0.001.
Notez que si une unité est préfixée avec !, alors aucune modification post-traitement ne sera réalisée à l'unité. Voir aussi la liste noire des unités.
Intervalle de mise à jour Récupère une nouvelle valeur pour cet élément toutes les N secondes. L'intervalle de mise à jour maximum autorisé est 86400 secondes (1 jour).
Les suffixes temporels sont pris en charge, par exemple 30s, 1m, 2h, 1d, depuis Zabbix 3.4.0.
Les macros utilisateur et les macros LLD sont supportées.
Une seule macro doit remplir tout le champ. Plusieurs macros dans un champ ou des macros mélangées avec du texte ne sont pas supportées.
Remarque : S'il est défini sur "0", l'élément ne sera pas interrogé. Toutefois, si un intervalle personnalisé (flexible/planifié) existe également avec une valeur non nulle, l'élément sera interrogé pendant la durée de l'intervalle personnalisé.
Notez qu'un élément passif existant peu être interrogé immédiatement en cliquant sur le bouton Vérifier maintenant.
Intervalles personnalisés Vous pouvez créer des règles personnalisées pour vérifier l'élément :
Flexible - crée une exception à l'intervalle de mise à jour (intervalle avec fréquence différente)
Planification - crée un calendrier d'interrogation personnalisé.
Pour plus d'informations, voir les Intervalles personnalisés.
Les suffixes temporels sont pris en charge dans le champ Intervalle, par exemple 30s, 1m, 2h, 1d.
Les macros utilisateur et les macros LLD sont supportées.
Une seule macro doit remplir tout le champ. Plusieurs macros dans un champ ou des macros mélangées avec du texte ne sont pas supportées.
La planification est prise en charge depuis Zabbix 3.0.0.
Remarque : Non disponible pour les éléments actifs de l'agent Zabbix.
Période de stockage de l'historique Durée de conservation de l'historique détaillé dans la base de données (de 1 heure à 25 ans ; ou "0"). Les données plus anciennes seront supprimées par la procédure de nettoyage.
Stocké en secondes. Les suffixes temporels sont supportés, par exemple 2h, 1d.
Les macros utilisateurs sont supportées.
Cette valeur peut être remplacée globalement dans Administration → Général → Nettoyage. Si le paramètre global existe, un message d'avertissement s'affiche :

Il est recommandé de conserver les valeurs enregistrées le plus petit possible afin de réduire la taille de l'historique des valeurs dans la base de données. Au lieu de conserver un long historique de valeurs, vous pouvez conserver des données plus longues sur les tendances.
Si positionné à "0" aucune donnée ne sera stockée dans la table d'historique pour l'élément. Seuls les éléments dépendants et les données d'inventaire le l'hôte sont mis à jour.
Voir aussi Historique et tendances.
Période de stockage des tendances Durée de conservation de l'historique agrégé (horaire, min, max, moy, count) dans la base de données (de 1 jour à 25 ans ; ou "0"). Les données plus anciennes seront supprimées par la procédure de nettoyage.
Stocké en secondes.
Les suffixes temporels sont pris en charge, par exemple 24h, 1d. Les macros utilisateur sont supportées.
Cette valeur peut être remplacée globalement dans Administration → Général → Nettoyage. Si le paramètre global existe, un message d'avertissement s'affiche :

Remarque : La conservation des tendances n'est pas disponible pour les données non numériques - caractère, journaux et texte.
Si positionné à "0" aucune tendance n'est gardée. Voir aussi Historique et tendances.
Afficher la valeur Appliquez la correspondances des valeurs à cet élément. La correspondance des valeurs ne modifie pas les valeurs reçues, mais uniquement pour afficher les données.
Cela fonctionne avec des éléments entiers seulement. Par exemple, "Etats de service Windows".
Format de la date/heure dans les fichiers journaux Disponible pour les éléments de type Log uniquement. Espaces réservés pris en charge :
* y: Année (1970-2038)
* M : Mois (01-12)
* d : Jour (01-31)
* h : Heure (00-23)
* m: Minute (00-59)
* s: Secondes (00-59)
Si elle est vide, l'horodatage ne sera pas analysé.
Par exemple, considérez la ligne suivante du fichier de log de l'agent Zabbix :
"23480:20100328:154718.045 L'agent Zabbix a démarré. Zabbix 1.8.2 (révision 11211)." Il commence par six positions de caractères pour le PID, suivies de la date, de l'heure et du reste de la ligne.
Le format de l'heure du journal pour cette ligne serait "pppppp:aaaaMMjj:hhmmss".
Notez que les caractères "p" et ":" ne sont que des espaces réservés et peuvent être tout sauf "yMdhms".
Nouvelle application Entrez le nom d'une nouvelle application pour l'élément.
Applications Lier un élément à une ou plusieurs applications existantes.
Peupler le champs d'inventaire de l'hôte Vous pouvez sélectionner un champ d'inventaire hôte que la valeur de l'élément va remplir. Cela fonctionnera si le peuplement d'inventaire automatique est activée pour l'hôte.
Description Entrez une description de l'élément.
Activer Cochez la case pour activer l'élément afin qu'il soit traité.

Les champs des types d'éléments spécifiques sont décrits dans les pages correspondantes.

Lors de la modification d'un élément au niveau d’un modèle existant sur un hôte, un certain nombre de champs sont en lecture seule. Vous pouvez utiliser le lien dans l'en-tête du formulaire et accéder au niveau du modèle et les modifier à cet endroit là, en gardant à l'esprit que les modifications au niveau du modèle modifieront l'élément pour tous les hôtes auxquels le modèle est lié.

Pré-traitement de la valeur de l'élément

L'onglet Pré-traitement permet de définir des règles de transformation pour les valeurs reçues. Une ou plusieurs transformations sont possibles avant d'enregistrer des valeurs dans la base de données. Les transformations sont exécutées dans l'ordre dans lequel elles sont définies. Tout le pré-traitement est effectué par le serveur Zabbix. Voir aussi : Détails du pré-traitement

Les macros utilisateur et les macros utilisateur avec contexte sont supportées dans les paramètres de pré-traitement des valeurs d'élément.

​Un élément peut devenir non supporté si l'une des étapes du pré-traitement échoue.

Transformation Description
Expression régulière Faites correspondre la valeur à l'expression régulière <pattern> et remplacez la valeur par <sortie>. L'expression régulière prend en charge l'extraction de maximum 10 groupes capturés avec la séquence \N. Si la valeur d'entrée ne correspond pas, l'élément n'est pas pris en charge. \\Paramètres :
pattern - expression régulière
sortie - modèle du format de sortie. Une séquence d'échappement \N (où N=1...9) est remplacée par le Nième groupe correspondant. Une séquence d'échappement \0 est remplacée par le texte correspondant.
Pris en charge depuis la version 3.4.0.
Veuillez vous référer à la section des expressions régulières pour quelques exemples.
Réduire Supprime les caractères spécifiés au début et à la fin de la valeur.
Réduire à droite Supprime les caractères spécifiés à la fin de la valeur.
Réduire à gauche Supprime les caractères spécifiés au début de la valeur.
XML XPath Extraire une valeur ou un fragment à partir des données XML à l'aide de la fonctionnalité XPath.
Pour que cette option fonctionne, le serveur Zabbix doit être compilé avec la prise en charge de libxml.
Exemples :
number(/document/item/value) va extraire 10 de <document><item><value>10</value></item></document>
number(/document/item/@attribute) va extraire 10 de <document><item attribute="10"></item></document>
/document/item va extraire <item><value>10</value></item> de <document><item><value>10</value></item></document>
Notez que les espaces de noms ne sont pas supportés.
Pris en charge depuis 3.4.0.
Chemin JSON Extraire une valeur ou un fragment à partir de données JSON en utilisant un sous-ensemble simple de fonctionnalités JSONPath.
JSONPath peut être spécifié en utilisant la notation par points :
$.document.item[0].value
ou la notation par crochets :
$['document']['item'][0]['value']
La première, la notation par points, ne peut être utilisée que si les noms d'objet sont composés de caractères alphanumériques + underscore :
$.document.item_0.value
Si le nom de l'objet contient d'autres caractères, e. g. blancs, tirets, vous devez utiliser la notation entre crochets :
$['document']['item 0']['value-0']
Les deux notations peuvent être mélangées :
$.document['item'][0].value
Pour les deux notations, seuls les chemins directs vers des objets uniques sont pris en charge.
L'extraction de plusieurs valeurs n'est pas prise en charge.
Plus d'exemples :
$.document.item.value va extraire 10 de {"document":{"item":{"value": 10}}}
$.document.item va extraire {"value": 10} de {"document":{"item":{"value": 10}}}
$['a document'].item.value va extraire 10 de {"a document":{"item":{"value":10}}}
$.document.items[1].value va extraire 20 de {"document":{"items":[{"value":10}, {"value":20}]}}
Pris en charge depuis 3.4.0.
Multiplicateur personnalisé Multiplie la valeur par l'entier ou la valeur à virgule flottante spécifiée.
Utilisez cette option pour convertir les valeurs reçues en KB, MBps, etc. en B,Bps. Sinon, Zabbix ne peut pas définir correctement les prefixes (K, M, G etc).
Notez que si le type d'information de l'élément est Numérique (non signé), les valeurs entrantes avec une partie décimale seront réduites (c.-à-d. que "0.9" deviendra "0") avant que le multiplicateur personnalisé soit appliqué.
À partir de Zabbix 2.2, l'utilisation de la notation scientifique est également supportée. Exemple : 1e+70.
Changement simple Calcule la différence entre la valeur actuelle et la valeur précédente.
Évalué en tant que valeur-prev_valeur, où
value - valeur actuelle ; prev_valeur - valeur reçue précédemment.
Une seule opération de modification par élément est autorisé.
Changement par seconde Calcule la variation de la valeur (différence entre la valeur actuelle et la précédente valeur) par seconde.
Evalué comme (valeur-prev_valeur)/(time-prev_time), où
valeur - valeur actuelle ; prev_valeur - valeur précédente reçue ; temps - heure actuelle (timestamp) ; prev_time - heure de la précédente valeur (timestamp).
Ce paramètre est extrêmement utile pour obtenir la vitesse par seconde pour une valeur en constante augmentation. Si la valeur actuelle est inférieure à la valeur précédente, Zabbix supprime cette différence (n'enregistre rien) et attend une autre valeur. Cela permet de fonctionner correctement avec, par exemple, un wrapping (débordement) de compteurs SNMP 32 bits.
Remarque : Comme ce calcul peut produire des nombres à virgule flottante, il est recommandé de définir le 'Type d'information' à Numérique (flottant), même si les valeurs brutes entrantes sont des entiers. Ceci est particulièrement pertinent pour les petits nombres où la partie décimale compte. Si les valeurs en virgule flottante sont grandes et peuvent dépasser la longueur du champ 'flottant', auquel cas la valeur entière peut être perdue, il est réellement suggéré d'utiliser Numérique (non signé) et de réduire ainsi seulement la partie décimale.
Une seule opération de modification par élément est autorisée.
Booléen à décimal Convertie la valeur du format booléen à décimal. La représentation textuelle est traduite en 0 ou 1. Ainsi, 'VRAI' est stocké en tant que 1 et 'FAUX' est stocké en tant que 0. Toutes les valeurs sont comparées de manière insensible à la casse. Les valeurs actuellement reconnues sont, pour :
VRAI - vrai, t, oui, y, ok, activé, up, en cours d'exécution, disponible, maître
FAUX - faux, f, non, n, err, désactivé, off, inutilisé, désactivé, indisponible, esclave
De plus, toute valeur numérique non nulle est considérée comme VRAIE et zéro est considéré comme FAUX.
Les valeurs suivantes sont supportées depuis la version 4.0.0: ok, master, err, slave.
Octal à décimal Convertie la valeur au format octal en décimal.
Hexadécimal à décimal Convertie la valeur au format hexadécimal en décimal.

Si vous utilisez un multiplicateur personnalisé ou une valeur de stockage dans Modification par seconde pour les éléments ayant le type d'informations défini sur Numérique (non signé) et que la valeur calculée résultante est réellement un nombre flottant, la valeur calculée est toujours acceptée comme correcte, en tronquant la partie décimale et en stockant la valeur en entier

Boutons de formulaire

Les boutons en bas des formulaires permettent de réaliser plusieurs opérations.

Ajoute un élément. Ce bouton est disponible uniquement pour les nouveaux éléments.
Mets à jour les propriétés d'un élément.
Créé un autre élément basé sur les propriétés de l'élément actuel.
Exécute une vérification pour un nouvel élément immédiatement. Supporté pour les vérifications passives uniquement (voir plus de détails).
Notez que quand une valeur est vérifiée immédiatement, le cache de configuration n'est pas mis à jour, ainsi la valeur ne reflétera pas les modifications très récentes apportées à la configuration des éléments.
Supprime l'historique et les tendances de l'élément.
Supprime l'élément.
Annule l'édition des propriétés de l'élément.

Limites de données de texte

Les limites de données de texte dépendent du moteur de base de données. Avant de stocker les valeurs de texte dans la base de données, elles sont tronquées pour correspondre à la limite du type de valeur de base de données :

Base de données Type d'information
Caractère Log Texte
MySQL 255 caractères 65536 octets 65536 octets
PostgreSQL 255 caractères 65536 caractères 65536 caractères
Oracle 255 caractères 65536 caractères 65536 caractères
IBM DB2 255 octets 2048 octets 2048 octets

Liste noire des unités

Par défaut, la spécification d'une unité pour un élément entraîne l'ajout d'un préfixe multiplicateur. Par exemple, une valeur entrante '2048' avec l'unité 'B' serait affichée sous la forme '2KB'.

Toute unité, cependant, peut être empêchée d'être convertie en utilisant un préfixe !, Par exemple ''!B ''. Pour mieux illustrer le fonctionnement de la conversion avec et sans la liste noire, voir les exemples de valeurs et d’unités suivants :

1024 !B → 1024 B
       1024 B → 1 KB
       61 !s → 61 s
       61 s → 1m 1s
       0 !uptime → 0 uptime
       0 uptime → 00:00:00
       0 !! → 0 !
       0 ! → 0

Avant Zabbix 4.0, il y avait une liste noire d'unité codée en dur comprenant ms, rpm, RPM, %. Cette liste noire est devenue obsolète, ainsi la méthode correcte de mise en liste noire de ces unités est !ms, !rpm, !RPM, !%.

Éléments non supportés

Un élément peut ne plus être pris en charge si sa valeur ne peut pas être récupérée pour une raison quelconque. Ces éléments sont toujours revérifiés à un intervalle fixe, configurable dans la section Administration.

Les éléments non supportés sont signalés comme ayant un état NON SUPPORTÉ.

Unsupported items

An item can become unsupported if its value cannot be retrieved for some reason. Such items are still rechecked at a fixed interval, configurable in Administration section.

Unsupported items are reported as having a NOT SUPPORTED state.

Form buttons

Buttons at the bottom of the form allow to perform several operations.

Add an item. This button is only available for new items.
Update the properties of an item.
Create another item based on the properties of the current item.
Execute a check for a new item value immediately. Supported for passive checks only (see more details).
Note that when checking for a value immediately, configuration cache is not updated, thus the value will not reflect very recent changes to item configuration.
Delete the item history and trends.
Delete the item.
Cancel the editing of item properties.