1 Création d'un élément

Vue d'ensemble

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

• Accédez à : Data collection > Hosts
• Cliquez sur Items dans la ligne de l'hôte
• Cliquez sur Create item 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 cliquant sur le bouton Clone, puis en l'enregistrant sous un autre nom.

Configuration

L’onglet Élément contient les attributs généraux de l’élément.

Tous les champs obligatoires sont signalés par un astérisque rouge.

Paramètre	Description
Nom	Nom de l’élément. Les macros utilisateur sont prises en charge.
Type	Type d’élément. Consultez les sections consacrées aux différents types d’éléments.
Clé	Clé de l’élément (jusqu’à 2048 caractères). Les clés d’élément prises en charge sont indiquées dans les sections consacrées aux différents types d’éléments. 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 le serveur Zabbix. Voir également le format correct de la clé.
Type d’information	Type de données telles qu’elles sont stockées dans la base de données après les conversions éventuelles. Numérique (non signé) - entier non signé de 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. Numérique (flottant) - nombre à virgule flottante de 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 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. Caractère - données textuelles courtes. Journal - données textuelles longues avec des propriétés facultatives liées aux journaux (horodatage, source, gravité, logeventid). Texte - données textuelles longues. Voir également les limites des données textuelles. Binaire - nombre binaire (pris en charge uniquement pour les éléments dépendants). Les éléments renvoyant des valeurs de type binaire ne sont pas pris en charge dans les formules d’éléments calculés ni dans les expressions de déclencheurs. 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.
Interface de l’hôte	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.
Unités	Si un symbole d’unité est défini, Zabbix applique un post-traitement à la valeur reçue de l’élément 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 reçue → valeur affichée) : B - octets (1024 → 1 KB) Bps - octets par seconde (1024 → 1 KBps) s - secondes, affichées avec jusqu’à trois unités de temps non nulles les plus grandes (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 reçue de l’élément doit être de type Numérique (non signé). 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 le 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é, consultez Suffixes des valeurs d’élément.
Intervalle de mise à jour	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 l’intégralité du champ. Plusieurs macros dans un champ ou des macros mélangées à du texte ne sont pas prises en charge. Remarque : l’intervalle de mise à jour ne peut être défini sur « 0 » que si des intervalles personnalisés existent avec une valeur différente de zéro. S’il est défini sur « 0 » et qu’un intervalle personnalisé (flexible ou planifié) existe avec une valeur différente de zéro, l’élément sera interrogé pendant la durée de l’intervalle personnalisé. Notez que la première interrogation de l’élément après son activation ou après une modification de l’intervalle de mise à jour peut avoir lieu avant la valeur configurée. Les nouveaux éléments seront vérifiés dans les 60 secondes suivant leur création, sauf s’ils utilisent un intervalle de mise à jour planifié ou flexible et que l’Intervalle de mise à jour est défini sur 0. Un élément passif existant peut être interrogé immédiatement en cliquant sur le bouton Exécuter 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 une fréquence différente). Planification - crée un calendrier d’interrogation personnalisé. Pour plus d’informations, consultez Intervalles personnalisés. Les suffixes de temps sont pris en charge dans le champ Intervalle, par exemple : 30s, 1m, 2h, 1d. Les macros utilisateur sont prises en charge. Une seule macro doit remplir l’intégralité du champ. Plusieurs macros dans un champ ou des macros mélangées à du texte ne sont pas prises en charge.
Délai d’expiration	Définissez le délai d’expiration de la vérification de l’élément (disponible pour les types d’éléments pris en charge). Sélectionnez l’option de délai d’expiration : Global - le délai d’expiration du proxy ou le délai d’expiration global est utilisé (affiché dans le champ Délai d’expiration grisé). Remplacement - un délai d’expiration personnalisé est utilisé (défini dans le champ Délai d’expiration ; plage autorisée : 1 - 600s). Les suffixes de temps, par exemple 30s, 1m, ainsi que les macros utilisateur sont pris en charge. Cliquer sur le lien Délais d’expiration permet de configurer les délais d’expiration du proxy ou les délais d’expiration globaux (si aucun proxy n’est utilisé). Notez que le lien Délais d’expiration est visible uniquement pour les utilisateurs de type Super administrateur disposant des autorisations nécessaires pour les sections de l’interface Administration > Général ou Administration > Proxies.
Historique	Sélectionnez l’une des options suivantes : Ne pas stocker - 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 leur historique. Ce paramètre ne peut pas être remplacé par les paramètres globaux du housekeeper. Stocker jusqu’à - 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. La valeur est stockée en secondes. Les suffixes de temps sont pris en charge, par exemple : 2h, 1d. Les macros utilisateur sont prises en charge. La valeur Stocker jusqu’à peut être remplacée globalement dans Administration > Housekeeping. Si un paramètre de remplacement global 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 : Remplacé par les paramètres globaux du housekeeper (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 historique de valeurs long, vous pouvez conserver plus longtemps les données de tendance. Voir également Historique et tendances.
Tendances	Sélectionnez l’une des options suivantes : Ne pas stocker - les tendances ne sont pas stockées. Ce paramètre ne peut pas être remplacé par les paramètres globaux du housekeeper. Stocker jusqu’à - spécifiez la durée de conservation de l’historique agrégé (minimum, maximum, moyenne et nombre horaires) dans la base de données (de 1 jour à 25 ans). Les données plus anciennes seront supprimées par le housekeeper. La valeur est stockée en secondes. Les suffixes de temps sont pris en charge, par exemple : 24h, 1d. Les macros utilisateur sont prises en charge. La valeur Stocker jusqu’à peut être remplacée globalement dans Administration > Housekeeping. Si un paramètre de remplacement global 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 : Remplacé par les paramètres globaux du housekeeper (7d). Remarque : la conservation des tendances n’est pas disponible pour les données non numériques : caractère, journal et texte. Voir également Historique et tendances.
Mappage de valeurs	Appliquez un mappage de valeurs à cet élément. Le mappage de valeurs ne modifie pas les valeurs reçues ; il sert uniquement à afficher les données. Il fonctionne avec les éléments Numérique (non signé), Numérique (flottant) et Caractère. Par exemple, « États des services Windows ».
Format de l’heure du journal	Disponible uniquement pour les éléments de type Journal. 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 le champ est laissé vide, l’horodatage sera défini sur 0 en temps Unix, ce qui représente le 1er janvier 1970. Par exemple, considérons 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 de l’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 remplacés par n’importe quels caractères, à l’exception de « yMdhms ».
Remplit le champ d’inventaire de l’hôte	Vous pouvez sélectionner un champ d’inventaire de l’hôte que la valeur de l’élément remplira. Cela fonctionne si le remplissage automatique de l’inventaire est activé pour l’hôte. Ce champ n’est pas disponible si le Type d’information est défini sur « Journal ».
Description	Saisissez une description de l’élément. Les macros utilisateur sont prises en charge.
Activé	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 de l’historique (à l’exception de sa dernière valeur, qui est conservée pour les journaux).
Dernières données	Cliquez sur le lien pour afficher les dernières données de l’élément. Ce lien est disponible uniquement lors de la modification d’un élément existant.

L’onglet Étiquettes permet de définir les étiquettes au niveau de l’élément.

Prétraitement des valeurs des éléments

L’onglet Prétraitement vous permet de définir des règles de transformation pour les valeurs reçues.

Test d’un é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é avant même l’enregistrement de l’élément.

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

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

• Zabbix agent
• agent SNMP (v1, v2, v3)
• agent IPMI
• vérifications SSH
• vérifications Telnet
• agent JMX
• vérifications simples (à l’exception des éléments icmpping* et vmware.*)
• éléments internes Zabbix
• éléments calculés
• vérifications externes
• moniteur de base de données
• agent HTTP
• script
• navigateur

Pour tester un élément, cliquez sur le bouton Tester en bas du formulaire de configuration de l’élément.

Notez que le bouton Tester est désactivé pour les éléments qui ne peuvent pas être testés (comme les vérifications actives et les vérifications simples exclues). Les éléments calculés ne peuvent pas être testés lorsque le paramètre de configuration StartHistoryPollers est défini sur 0.

Le formulaire de test de l’élément contient des champs correspondant aux paramètres requis de l’hôte (adresse de l’hôte, port, test avec le serveur/proxy (nom du proxy)) ainsi qu’aux détails propres à l’élément (tels que la communauté SNMPv2 ou les identifiants de sécurité SNMPv3). Ces champs tiennent compte du contexte :

• Les valeurs sont préremplies lorsque cela est possible, par exemple pour les éléments nécessitant un agent, en récupérant 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 remplis 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, les champs d’adresse de l’hôte et de proxy sont désactivés pour les éléments calculés).

Pour tester l’élément, cliquez sur Obtenir la valeur. Si la valeur est récupérée avec succès, elle est renseignée dans le champ Valeur. La valeur actuelle (le cas échéant) est déplacée vers le champ Valeur précédente, tandis que le champ Heure précédente est calculé, c’est-à-dire la différence de temps entre les deux valeurs (clics). Le système tente également de détecter une séquence EOL et de basculer vers CRLF s’il détecte "\\n\\r" dans la valeur récupérée.

Cliquez sur Obtenir la valeur et tester pour tester le prétraitement.

Les valeurs récupérées depuis un hôte et les résultats des tests sont tronqués à une taille maximale de 512 Ko 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 de plus de 512 Ko sont tout de même traitées intégralement par le serveur Zabbix.

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

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 situés en bas du formulaire vous permettent d'effectuer plusieurs opérations.

	Ajouter un élément. Ce bouton est disponible uniquement 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 obtenir 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).