1 Création d'un élément

Aperçu

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

• Allez dans : Collecte de données > Hôtes
• Cliquez sur Éléments sur la ligne de l’hôte
• Cliquez sur Créer un élément dans le coin supérieur droit de l’écran
• Saisissez 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 l’enregistrant sous un autre nom.

Configuration

L'onglet Item contient les attributs généraux de l'élément.

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

Parameter	Description
Name	Nom de l'élément. Les macros utilisateur sont prises en charge.
Type	Type d'élément. Voir les sections individuelles sur les types d'élément.
Key	Clé de l'élément (jusqu'à 2048 caractères). Les clés d'élément prises en charge se trouvent dans les sections individuelles des types d'élément. La clé doit être unique au sein d'un même hôte. Si le type de clé est 'Zabbix agent', 'Zabbix agent (active)' ou 'Simple check', la valeur de la clé doit être prise en charge par Zabbix agent ou Zabbix serveur. Voir aussi: le format de clé correct.
Type of information	Type de données tel qu'il est stocké dans la base de données après les conversions éventuelles. Numeric (unsigned) - entier non signé sur 64 bits. Notez qu'une valeur à virgule flottante, si elle est reçue pour un élément entier, sera tronquée de sa partie décimale. Numeric (float) - nombre à virgule flottante sur 64 bits. Ce type permet une précision d'environ 15 chiffres et une plage allant approximativement de -1.79E+308 à 1.79E+308 (à l'exception de PostgreSQL 11 et des versions antérieures). La réception de valeurs en notation scientifique est également prise en charge. Par exemple 1.23E+7, 1e308, 1.1E-4. Character - données textuelles courtes. Log - données textuelles longues avec des propriétés liées aux journaux en option (horodatage, source, gravité, logeventid). Text - données textuelles longues. Voir aussi les limites des données textuelles. Binary - nombre binaire (pris en charge uniquement pour les éléments dépendants). Les éléments renvoyant des valeurs avec le type de données binaire ne sont pas pris en charge dans les formules d'éléments calculés ni dans les expressions de déclencheur. Pour les clés d'élément qui renvoient des données dans un seul format spécifique, le type d'information correspondant est sélectionné automatiquement.
Host interface	Sélectionnez l'interface de l'hôte. Ce champ est disponible lors de la modification d'un élément au niveau de l'hôte.
Units	Si un symbole d'unité est défini, Zabbix applique un post-traitement à la valeur de l'élément reçue et l'affiche avec le suffixe d'unité spécifié. Symboles d'unité pris en charge avec un formatage spécial (et exemples de valeur d'élément reçue → valeur affichée): B - octets (1024 → 1 KB) Bps - octets par seconde (1024 → 1 KBps) s - secondes, affichées en utilisant jusqu'à trois des plus grandes unités de temps non nulles (881764 → 10d 4h 56m) uptime - temps écoulé au format hh:mm:ss ou N jours, hh:mm:ss (881764 → 10 days, 04:56:04) unixtime - horodatage Unix, formaté comme yyyy.mm.dd hh:mm:ss (881764 → 1970-01-11 04:56:04 AM); pour un formatage correct, la valeur d'élément reçue doit être Numeric (unsigned). Pour les autres unités (telles que Hz, W, etc.), si la valeur reçue dépasse 1000, elle est divisée par 1000 et affichée avec un préfixe correspondant (5000 → 5 KHz, 881764 → 881.76 KW). Si le symbole d'unité est précédé de !, la conversion d'unité et l'ajout de préfixe sont désactivés (1024 !B → 1024 B, 61 !s → 61 s). Pour plus d'exemples et de détails sur les symboles d'unité et la conversion d'unité, voir Suffixes de valeur d'élément.
Update interval	Récupérer une nouvelle valeur pour cet élément toutes les N secondes. L'intervalle de mise à jour maximal autorisé est de 86400 secondes (1 jour). Les suffixes de temps sont pris en charge, par exemple 30s, 1m, 2h, 1d. Les macros utilisateur sont prises en charge. 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 prises en charge. Note: l'intervalle de mise à jour ne peut être défini sur '0' que si des intervalles personnalisés existent avec une valeur non nulle. S'il est défini sur '0' et qu'un intervalle personnalisé (flexible ou planifié) existe avec une valeur non nulle, l'élément sera interrogé pendant la durée de l'intervalle personnalisé. Note que la première interrogation de l'élément après son activation ou après un changement d'intervalle de mise à jour peut se produire plus tôt que la valeur configurée. Les nouveaux éléments seront vérifiés dans les 60 secondes suivant leur création, sauf s'ils ont un intervalle de mise à jour Planification ou Flexible et que le Update interval est défini sur 0. Un élément passif existant peut être interrogé immédiatement en cliquant sur le bouton Execute now button.
Custom intervals	Vous pouvez créer des règles personnalisées pour la vérification de l'élément: Flexible - crée une exception à l'Update interval (intervalle avec une fréquence différente). Scheduling - crée un planning d'interrogation personnalisé. Pour des informations détaillées, voir Intervalles personnalisés. Les suffixes de temps sont pris en charge dans le champ Interval, par exemple 30s, 1m, 2h, 1d. Les macros utilisateur sont prises en charge. 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 prises en charge.
Timeout	Définissez le délai d'attente de vérification de l'élément (disponible pour les types d'élément pris en charge). Sélectionnez l'option de délai d'attente: Global - le délai d'attente du proxy/global est utilisé (affiché dans le champ Timeout grisé). Override - un délai d'attente personnalisé est utilisé (défini dans le champ Timeout; plage autorisée: 1 - 600s). Les suffixes de temps, par exemple 30s, 1m, et les macros utilisateur sont pris en charge. En cliquant sur le lien Timeouts, vous pouvez configurer les délais d'attente du proxy ou les délais d'attente globaux (si aucun proxy n'est utilisé). Notez que le lien Timeouts n'est visible que pour les utilisateurs de type Super admin disposant des autorisations sur les sections de l'interface Administration > General ou Administration > Proxies.
History	Sélectionnez l'une des options suivantes: Do not store - l'historique de l'élément n'est pas stocké. Utile pour les éléments maîtres si seuls les éléments dépendants doivent conserver l'historique. Ce paramètre ne peut pas être remplacé par les paramètres globaux du housekeeper. Store up to - spécifiez la durée de conservation de l'historique détaillé dans la base de données (de 1 heure à 25 ans). Les données plus anciennes seront supprimées par le housekeeper. Stocké en secondes. Les suffixes de temps sont pris en charge, par exemple 2h, 1d. Les macros utilisateur sont prises en charge. La valeur Store up to peut être remplacée globalement dans Administration > Housekeeping. Si un paramètre global de remplacement existe, une icône d'information orange est affichée. Si vous placez le pointeur de la souris dessus, un message d'avertissement s'affiche, par exemple Overridden by global housekeeper settings (1d). Il est recommandé de conserver les valeurs enregistrées pendant la durée la plus courte possible afin de réduire la taille de l'historique des valeurs dans la base de données. Au lieu de stocker un long historique des valeurs, vous pouvez stocker des données de tendances sur une période plus longue. Voir aussi Historique et tendances.
Trends	Sélectionnez l'une des options suivantes: Do not store - les tendances ne sont pas stockées. Ce paramètre ne peut pas être remplacé par les paramètres globaux du housekeeper. Store up to - spécifiez la durée de conservation de l'historique agrégé (min, max, moy, count horaires) dans la base de données (de 1 jour à 25 ans). Les données plus anciennes seront supprimées par le housekeeper. Stocké en secondes. Les suffixes de temps sont pris en charge, par exemple 24h, 1d. Les macros utilisateur sont prises en charge. La valeur Store up to peut être remplacée globalement dans Administration > Housekeeping. Si un paramètre global de remplacement existe, une icône d'information orange est affichée. Si vous placez le pointeur de la souris dessus, un message d'avertissement s'affiche, par exemple Overridden by global housekeeper settings (7d). Note: la conservation des tendances n'est pas disponible pour les données non numériques - character, log et text. Voir aussi Historique et tendances.
Value mapping	Appliquer un mappage de valeurs à cet élément. Le mappage de valeurs ne modifie pas les valeurs reçues, il sert uniquement à l'affichage des données. Il fonctionne avec les éléments Numeric(unsigned), Numeric(float) et Character. Par exemple, "Windows service states".
Log time format	Disponible uniquement pour les éléments de type Log. 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: Seconde (00-59). Si laissé vide, l'horodatage sera défini sur 0 en temps Unix, représentant le 1er janvier 1970. Par exemple, considérez la ligne suivante du fichier journal de Zabbix agent: " 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)." Elle commence par six positions de caractères pour le PID, suivies de la date, de l'heure et du reste du message. Le format d'heure du journal pour cette ligne serait "pppppp:yyyyMMdd:hhmmss". Notez que les caractères "p" et ":" sont des espaces réservés et peuvent être n'importe quels caractères sauf "yMdhms".
Populates host inventory field	Vous pouvez sélectionner un champ d'inventaire de l'hôte que la valeur de l'élément renseignera. Cela fonctionnera si le remplissage automatique de l'inventaire est activé pour l'hôte. Ce champ n'est pas disponible si Type of information est défini sur 'Log'.
Description	Saisissez une description de l'élément. Les macros utilisateur sont prises en charge.
Enabled	Cochez la case pour activer l'élément afin qu'il soit traité. Lorsque vous désactivez l'élément, il est immédiatement supprimé du cache d'historique (sauf sa dernière valeur, qui est conservée pour les journaux).
Latest data	Cliquez sur le lien pour afficher les dernières données de l'élément. Ce lien n'est disponible que lors de la modification d'un élément déjà existant.

L'onglet Tags permet de définir des tags au niveau de l'élément.

Prétraitement des valeurs d'élément

L'onglet Preprocessing permet de définir des règles de transformation pour les valeurs reçues.

Test d'élément

Il est possible de tester un élément et, s'il est correctement configuré, d'obtenir une valeur réelle en retour. Le test peut être effectué même avant l'enregistrement d'un élément.

Le test est disponible pour les éléments d'hôte et de modèle, les prototypes d'élément et les règles de découverte bas niveau. Le test n'est pas disponible pour les éléments actifs.

Le test d'élément est disponible pour les types d'éléments passifs suivants :

• Zabbix agent
• SNMP agent (v1, v2, v3)
• IPMI agent
• SSH checks
• Telnet checks
• JMX agent
• Simple checks (except icmpping*, vmware.* items)
• Zabbix internal
• Calculated items
• External checks
• Database monitor
• HTTP agent
• Script
• Browser

Pour tester un élément, cliquez sur le bouton Test en bas du formulaire de configuration de l'élément. Notez que le bouton Test sera désactivé pour les éléments qui ne peuvent pas être testés (comme les vérifications actives, les vérifications simples exclues).

Le formulaire de test d'élément comporte des champs pour les paramètres d'hôte requis (adresse de l'hôte, port, test avec serveur/proxy (nom du proxy)) et des détails spécifiques à l'élément (tels que la communauté SNMPv2 ou les identifiants de sécurité SNMPv3). Ces champs sont contextuels :

• Les valeurs sont préremplies lorsque cela est possible, c'est-à-dire pour les éléments nécessitant un agent, en prenant les informations de l'interface agent sélectionnée de l'hôte.
• Les valeurs doivent être saisies manuellement pour les éléments de modèle.
• Les valeurs des macros en texte brut sont résolues.
• Les champs dont la valeur (ou une partie de la valeur) est un secret ou une macro Vault sont vides et doivent être saisis manuellement. Si un paramètre d'élément contient une valeur de macro secrète, le message d'avertissement suivant s'affiche : "Item contains user-defined macros with secret values. Values of these macros should be entered manually."
• Les champs sont désactivés lorsqu'ils ne sont pas nécessaires dans le contexte du type d'élément (par exemple, le champ d'adresse de l'hôte et le champ proxy sont désactivés pour les éléments calculés)

Pour tester l'élément, cliquez sur Get value. Si la valeur est récupérée avec succès, elle remplira le champ Value, en déplaçant la valeur actuelle (le cas échéant) vers le champ Previous value, tout en calculant le champ Prev. time, c'est-à-dire la différence de temps entre les deux valeurs (clics), et en essayant de détecter une séquence EOL et de passer à CRLF si "\n\r" est détecté dans la valeur récupérée.

Cliquez sur Get value and test pour tester le prétraitement.

Les valeurs récupérées depuis un hôte et les résultats de test sont tronqués à une taille maximale de 512 KB lorsqu'ils sont envoyés à l'interface. Si un résultat est tronqué, une icône d'avertissement s'affiche. La description de l'avertissement s'affiche au survol de la souris. Notez que les données supérieures à 512 KB sont toujours entièrement traitées par le serveur Zabbix.

Si la configuration est incorrecte, un message d'erreur s'affiche, décrivant la cause possible.

Une valeur récupérée avec succès depuis un hôte peut également être utilisée pour tester les étapes de prétraitement.

Boutons du formulaire

Les boutons en bas du formulaire permettent d'effectuer plusieurs opérations.

	Ajouter un élément. Ce bouton n'est disponible que pour les nouveaux éléments.
	Mettre à jour les propriétés d'un élément.
	Créer un autre élément à partir des propriétés de l'élément actuel.
	Exécuter immédiatement une vérification pour une nouvelle valeur d'élément. Pris en charge uniquement pour les vérifications passives (voir plus de détails). Remarque : lors de la vérification immédiate d'une valeur, le cache de configuration n'est pas mis à jour ; la valeur ne reflétera donc pas les modifications très récentes de la configuration de l'élément.
	Tester si la configuration de l'élément est correcte en obtenant une valeur.
	Supprimer l'historique et les tendances de l'élément.
	Supprimer l'élément.
	Annuler la modification des propriétés de l'élément.

Limites des données textuelles

Les limites des données textuelles dépendent du backend de base de données. Avant d'être stockées dans la base de données, les valeurs textuelles sont tronquées afin de correspondre à la limite du type de valeur de la base de données :

Limite des scripts personnalisés

La longueur disponible pour les scripts personnalisés dépend de la base de données utilisée :

Délai d'attente de l'élément

Le délai d'attente de l'élément spécifie combien de temps Zabbix doit attendre avant d'interrompre la vérification en la considérant comme échouée.

Lorsque le délai d'attente est atteint, la vérification est interrompue même si la récupération des données n'est pas terminée. Si les données sont reçues partiellement, l'élément devient non pris en charge et un message d'erreur est consigné (par exemple, si les données sont collectées avec succès pour un seul des plusieurs OID dans une vérification SNMP).

Pour de nombreux types d'éléments, vous pouvez définir des délais d'attente d'élément flexibles :

• par élément unique
• par type d'élément (au niveau du proxy)
• par type d'élément (au niveau global interface)

Un délai d'attente personnalisé par élément unique est utile si vous souhaitez spécifier un délai plus long pour un élément particulier, tout en conservant des délais d'attente faibles pour les autres éléments.

Priorité des délais d'attente

1. Le délai d'attente d'un élément unique remplace tout autre délai d'attente.
2. Les délais d'attente au niveau du proxy remplacent les délais d'attente globaux.

Le délai d'attente provenant de la configuration du serveur Zabbix ou du proxy ne joue aucun rôle dans les vérifications pour lesquelles des délais d'attente flexibles sont définis.

Prise en charge des délais d'attente flexibles

Les délais d'attente flexibles des éléments sont pris en charge pour les types d'éléments suivants :

• agent Zabbix (vérifications passives et actives)
• agent SNMP (sauf les vérifications SNMP héritées¹)
• Vérification simple (sauf icmpping* et les éléments VMware²)
• agent SSH
• agent Telnet
• Vérification externe
• Surveillance de base de données
• Script
• agent HTTP

• Navigateur

  ¹ Pour les vérifications SNMP héritées (interrogation d'un seul OID), les paramètres de délai d'attente du serveur ou du proxy s'appliquent.
  ² Pour les éléments icmpping*, la valeur du délai d'attente est spécifiée directement dans la clé de l'élément. Les éléments de surveillance VMware utilisent leur propre paramètre VMwareTimeout issu de la configuration du serveur ou du proxy.

Éléments non pris en charge

Les éléments non pris en charge sont signalés avec le statut Non pris en charge et sont toujours revérifiés selon leur intervalle de mise à jour standard.

Un élément devient non pris en charge si sa valeur ne peut pas être récupérée pour une raison quelconque (par exemple, erreur de connexion, aucun collecteur configuré pour traiter l'élément). De plus, les éléments qui ne reçoivent pas de données historiques restent dans le statut Non pris en charge. Il s'agit d'un comportement attendu : un élément ne passe au statut Normal que lorsqu'il reçoit de nouvelles données historiques valides.

Comme les problèmes, les éléments non pris en charge sont réévalués uniquement lorsque de nouvelles données sont reçues, même s'il n'existe plus de données historiques pour cet élément. Autrement dit, les éléments et les déclencheurs changent d'état uniquement lors de la réception de nouvelles données. Cependant, si une expression de déclencheur inclut une fonction date et heure et/ou nodata(), le déclencheur sera recalculé toutes les 30 secondes (voir temps de calcul des déclencheurs pour plus de détails).