3 Découverte de bas niveau

Vue d'ensemble

La découverte de bas niveau (LLD) découvre automatiquement des entités (par exemple, des systèmes de fichiers, des interfaces réseau) sur un hôte et crée les éléments, déclencheurs et graphiques correspondants sans configuration manuelle pour chacun.

Pour utiliser LLD, vous créez une règle de découverte qui collecte des données JSON décrivant des entités, ainsi que des prototypes (élément, déclencheur, et graphique) pour chaque entité.

Le JSON renvoyé par la règle doit être un tableau d'objets, où chaque objet représente une entité découverte à l'aide de paires clé-valeur. Par exemple, une règle de découverte avec net.if.discovery peut renvoyer :

[
  {"{#IFNAME}": "lo"},
  {"{#IFNAME}": "eth0"}
]

Un ensemble correspondant d'éléments, de déclencheurs et de graphiques est ensuite créé à partir des prototypes, un par interface (lo et eth0).

Si les objets contiennent des clés au format {#MACRO}, ces macros sont utilisées directement dans les prototypes. Sinon, ou si des macros supplémentaires/personnalisées sont nécessaires, les macros peuvent être définies manuellement et associées aux champs JSON à l'aide de JSONPath.

LLD peut également créer des hôtes (par exemple, pour des machines virtuelles découvertes sur un hyperviseur) et prend en charge des règles de découverte imbriquées pour une découverte à plusieurs niveaux.

Les entités qui ne sont plus découvertes peuvent être automatiquement désactivées ou supprimées.

Configuration de la découverte de bas niveau

Nous illustrerons la découverte de bas niveau à l'aide d'un exemple de découverte du système de fichiers.

Pour configurer la découverte, procédez comme suit :

1. Accédez à Collecte de données > Modèles ou Hôtes.
2. Cliquez sur Découverte dans la ligne du modèle/hôte approprié.

3. Cliquez sur Créer une règle de découverte dans le coin supérieur droit de l'écran.
4. Renseignez le formulaire de la règle de découverte avec les informations requises.

Règle de découverte

Le formulaire de règle de découverte contient cinq onglets, représentant, de gauche à droite, le flux de données pendant la découverte :

• Règle de découverte - spécifiez quel élément intégré ou script personnalisé utiliser pour récupérer les données de découverte.
• Prétraitement - appliquez un prétraitement aux données découvertes.
• Macros LLD - permet d'extraire les valeurs des macros à utiliser dans les éléments, déclencheurs, etc. découverts.
• Filtres - permet de filtrer les valeurs découvertes.
• Remplacements - permet de modifier les éléments, déclencheurs, graphiques ou prototypes d'hôtes lorsqu'ils sont appliqués à des objets découverts spécifiques.

L'onglet Règle de découverte contient la clé d'élément à utiliser pour la découverte (ainsi que certains attributs généraux de la règle de découverte) :

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

Prétraitement

L’onglet Prétraitement vous permet de définir des règles de transformation à appliquer au résultat de la découverte. Une ou plusieurs transformations sont possibles à cette étape. 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 également :

• Détails du prétraitement
• Test du prétraitement

Notez que si la règle de découverte a été appliquée au hôte via un modèle, le contenu de cet onglet est en lecture seule.

Macros personnalisées

L’onglet Macros LLD permet de spécifier des macros personnalisées de découverte de bas niveau.

Les macros personnalisées sont utiles lorsque le JSON renvoyé ne contient pas déjà les macros requises. Par exemple :

• La clé native vfs.fs.discovery pour la découverte des systèmes de fichiers renvoie un JSON contenant certaines macros LLD prédéfinies, telles que {#FSNAME}, {#FSTYPE}. Ces macros peuvent être utilisées directement dans les prototypes d’éléments et de déclencheurs (voir les sections suivantes de cette page) ; il n’est pas nécessaire de définir des macros personnalisées ;
• L’élément agent vfs.fs.get renvoie également un JSON contenant des données sur le système de fichiers, mais sans macros LLD prédéfinies. Dans ce cas, vous pouvez définir vous-même les macros et les associer aux valeurs du JSON à l’aide de JSONPath :

Les valeurs extraites peuvent être utilisées dans les éléments, déclencheurs, etc. découverts. Notez que les valeurs seront extraites du résultat de la découverte et de toutes les étapes de prétraitement effectuées jusqu’à présent.

Filtre

Un filtre peut être utilisé pour générer des éléments, des déclencheurs et des graphiques réels uniquement pour les entités correspondant aux critères. L’onglet Filtres contient les définitions de filtres des règles de découverte qui vous permettent de filtrer les valeurs découvertes :

Par exemple, si vous vous intéressez uniquement aux systèmes de fichiers C:, D: et E:, vous pouvez saisir {#FSNAME} dans le champ Macro et ^C|^D|^E dans le champ Expression régulière.
Le filtrage est également possible par type de système de fichiers à l’aide de la macro {#FSTYPE} (par exemple, ^ext|^reiserfs) et par type de lecteur (pris en charge uniquement par l’agent Windows) à l’aide de la macro {#FSDRIVETYPE} (par exemple, fixed).

Pour tester une expression régulière, vous pouvez utiliser grep -E, par exemple :

for f in ext2 nfs reiserfs smbfs; 
do echo $f | grep -E '^ext|^reiserfs' || echo "SKIP: $f"; 
done

Remplacement

L’onglet Remplacements permet de définir des règles pour modifier la liste des prototypes d’éléments, de déclencheurs, de graphes, d’hôtes et de découverte, ou leurs attributs, pour les objets découverts qui répondent à certains critères.

Les remplacements (le cas échéant) sont affichés dans une liste réorganisable par glisser-déposer et exécutés dans l’ordre dans lequel ils sont définis. Pour configurer les détails d’un nouveau remplacement, cliquez sur dans le bloc Remplacements. Pour modifier un remplacement existant, cliquez sur son nom. Une fenêtre contextuelle s’ouvre et vous permet de modifier les détails de la règle de remplacement.

Tous les paramètres obligatoires sont signalés par des astérisques rouges.

Configuration d’une opération

Pour configurer les détails d’une nouvelle opération, cliquez sur dans le bloc Opérations. Pour modifier une opération existante, cliquez sur à côté de l’opération. Une fenêtre contextuelle s’ouvre et vous permet de modifier les détails de l’opération.

Paramètre			Description
Objet			Cinq types d’objets sont disponibles : Prototype d’élément Prototype de déclencheur Prototype de graphe Prototype d’hôte Prototype de découverte
Condition			Permet de filtrer les entités auxquelles l’opération doit être appliquée.
	Opérateur		Opérateurs pris en charge : est égal à - appliquer à ce prototype n’est pas égal à - appliquer à tous les prototypes sauf celui-ci contient - appliquer si le nom du prototype contient cette chaîne ne contient pas - appliquer si le nom du prototype ne contient pas cette chaîne correspond - appliquer si le nom du prototype correspond à l’expression régulière ne correspond pas - appliquer si le nom du prototype ne correspond pas à l’expression régulière
	Modèle		Une expression régulière ou une chaîne à rechercher.
	Objet : Prototype d’élément
		Création activée	Lorsque la case est cochée, des boutons apparaissent et permettent de remplacer les paramètres du prototype d’élément d’origine : Oui - l’élément sera ajouté dans un état activé. Non - l’élément sera ajouté à une entité découverte, mais dans un état désactivé.
		Découvrir	Lorsque la case est cochée, des boutons apparaissent et permettent de remplacer les paramètres du prototype d’élément d’origine : Oui - l’élément sera ajouté. Non - l’élément ne sera pas ajouté.
		Intervalle de mise à jour	Lorsque la case est cochée, deux options apparaissent et permettent de définir un intervalle différent pour l’élément : Délai - intervalle de mise à jour de l’élément. Les macros utilisateur, les macros LLD et les suffixes temporels (par exemple 30s, 1m, 2h, 1d) sont pris en charge (prise en charge des macros LLD rétablie dans Zabbix 7.4.11). Doit être défini sur 0 si un intervalle personnalisé est utilisé. Intervalle personnalisé - cliquez sur pour définir des intervalles flexibles ou planifiés. Pour plus d’informations, consultez la page Intervalles personnalisés.
		Historique	Lorsque la case est cochée, des boutons apparaissent et permettent de définir une période de conservation différente pour l’historique de l’élément : Ne pas conserver - si cette option est sélectionnée, l’historique ne sera pas conservé. Conserver jusqu’à - si cette option est sélectionnée, un champ de saisie permettant de définir la période de conservation apparaît à droite. Les macros utilisateur et les macros LLD sont prises en charge (prise en charge des macros LLD rétablie dans Zabbix 7.4.11).
		Tendances	Lorsque la case est cochée, des boutons apparaissent et permettent de définir une période de conservation différente pour les tendances de l’élément : Ne pas conserver - si cette option est sélectionnée, les tendances ne seront pas conservées. Conserver jusqu’à - si cette option est sélectionnée, un champ de saisie permettant de définir la période de conservation apparaît à droite. Les macros utilisateur et les macros LLD sont prises en charge (prise en charge des macros LLD rétablie dans Zabbix 7.4.11).
		Étiquettes	Lorsque la case est cochée, un nouveau bloc apparaît et permet de définir des paires étiquette-valeur. Les macros utilisateur et les macros LLD sont prises en charge. Ces étiquettes seront ajoutées aux étiquettes définies dans le prototype d’élément, même si les noms des étiquettes sont identiques.
	Objet : Prototype de déclencheur
		Création activée	Lorsque la case est cochée, des boutons apparaissent et permettent de remplacer les paramètres du prototype de déclencheur d’origine : Oui - le déclencheur sera ajouté dans un état activé. Non - le déclencheur sera ajouté à une entité découverte, mais dans un état désactivé.
		Découvrir	Lorsque la case est cochée, des boutons apparaissent et permettent de remplacer les paramètres du prototype de déclencheur d’origine : Oui - le déclencheur sera ajouté. Non - le déclencheur ne sera pas ajouté.
		Gravité	Lorsque la case est cochée, les boutons de gravité du déclencheur apparaissent et permettent de modifier sa gravité.
		Étiquettes	Lorsque la case est cochée, un nouveau bloc apparaît et permet de définir des paires étiquette-valeur. Les macros utilisateur et les macros LLD sont prises en charge. Ces étiquettes seront ajoutées aux étiquettes définies dans le prototype de déclencheur, même si les noms des étiquettes sont identiques.
	Objet : Prototype de graphe
		Découvrir	Lorsque la case est cochée, des boutons apparaissent et permettent de remplacer les paramètres du prototype de graphe d’origine : Oui - le graphe sera ajouté. Non - le graphe ne sera pas ajouté.
	Objet : Prototype d’hôte
		Création activée	Lorsque la case est cochée, des boutons apparaissent et permettent de remplacer les paramètres du prototype d’hôte d’origine : Oui - l’hôte sera créé dans un état activé. Non - l’hôte sera créé dans un état désactivé.
		Découvrir	Lorsque la case est cochée, des boutons apparaissent et permettent de remplacer les paramètres du prototype d’hôte d’origine : Oui - l’hôte sera découvert. Non - l’hôte ne sera pas découvert.
		Lier des modèles	Lorsque la case est cochée, un champ de saisie permettant de définir des modèles apparaît. Commencez à saisir le nom du modèle ou cliquez sur Sélectionner à côté du champ, puis sélectionnez les modèles dans la liste d’une fenêtre contextuelle. Les modèles de ce remplacement sont ajoutés à tous les modèles déjà liés au prototype d’hôte.
		Étiquettes	Lorsque la case est cochée, un nouveau bloc apparaît et permet de définir des paires étiquette-valeur. Les macros utilisateur et les macros LLD sont prises en charge. Ces étiquettes seront ajoutées aux étiquettes définies dans le prototype d’hôte, même si les noms des étiquettes sont identiques.
		Inventaire de l’hôte	Lorsque la case est cochée, des boutons apparaissent et permettent de sélectionner un mode d’inventaire différent pour le prototype d’hôte : Désactivé - ne pas renseigner l’inventaire de l’hôte Manuel - fournir les détails manuellement Automatisé - renseigner automatiquement les données d’inventaire de l’hôte à partir des métriques collectées.
	Objet : Prototype de découverte
		Création activée	Lorsque la case est cochée, des boutons apparaissent et permettent de remplacer les paramètres du prototype de découverte d’origine : Oui - la règle de découverte sera ajoutée dans un état activé. Non - la règle de découverte sera ajoutée dans un état désactivé.
		Découvrir	Lorsque la case est cochée, des boutons apparaissent et permettent de remplacer les paramètres du prototype de découverte d’origine : Oui - la règle de découverte sera ajoutée. Non - la règle de découverte ne sera pas ajoutée.
		Intervalle de mise à jour	Lorsque la case est cochée, deux options apparaissent et permettent de définir un intervalle différent pour la règle de découverte : Délai - intervalle de mise à jour de la règle. Les macros utilisateur, les macros LLD et les suffixes temporels (par exemple 30s, 1m, 2h, 1d) sont pris en charge. Doit être défini sur 0 si un intervalle personnalisé est utilisé. Intervalle personnalisé - cliquez sur pour définir des intervalles flexibles ou planifiés. Pour plus d’informations, consultez la page Intervalles personnalisés.

Boutons du formulaire

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

	Ajouter une règle de découverte. Ce bouton est disponible uniquement pour les nouvelles règles de découverte.
	Mettre à jour les propriétés d'une règle de découverte. Ce bouton est disponible uniquement pour les règles de découverte existantes.
	Créer une autre règle de découverte basée sur les propriétés de la règle de découverte actuelle.
	Effectuer immédiatement la découverte en fonction de la règle de découverte. La règle de découverte doit déjà exister. Voir plus de détails. Remarque : lors de l'exécution immédiate d'une découverte, le cache de configuration n'est pas mis à jour ; le résultat ne reflétera donc pas les modifications très récentes apportées à la configuration de la règle de découverte.
	Tester la configuration de la règle de découverte. Utilisez ce bouton pour vérifier les paramètres de configuration (tels que la connectivité et la validité des paramètres) sans appliquer définitivement de modifications.
	Supprimer la règle de découverte.
	Annuler la modification des propriétés de la règle de découverte.

Entités découvertes

Les captures d’écran ci-dessous illustrent l’apparence des éléments, déclencheurs et graphiques découverts dans la configuration de l’hôte. Les entités découvertes sont précédées d’un lien orange vers la règle de découverte dont elles proviennent.

Notez que les entités découvertes ne seront pas créées s’il existe déjà des entités avec les mêmes critères d’unicité, par exemple un élément avec la même clé ou un graphique portant le même nom. Dans ce cas, un message d’erreur s’affiche dans l’interface web indiquant que la règle de découverte de bas niveau n’a pas pu créer certaines entités. La règle de découverte elle-même ne deviendra toutefois pas non prise en charge parce qu’une entité n’a pas pu être créée et a dû être ignorée. La règle de découverte continuera à créer/mettre à jour les autres entités.

Si une entité découverte (hôte, système de fichiers, interface, etc.) cesse d’être découverte (ou ne correspond plus au filtre), les entités créées à partir de celle-ci peuvent être automatiquement désactivées puis finalement supprimées.

Les ressources perdues peuvent être automatiquement désactivées selon la valeur du paramètre Disable lost resources. Cela affecte les hôtes, éléments et déclencheurs perdus.

Les ressources perdues peuvent être automatiquement supprimées selon la valeur du paramètre Delete lost resources. Cela affecte les hôtes, groupes d’hôtes, éléments, déclencheurs et graphiques perdus.

Lorsque des entités découvertes deviennent « Non découvertes désormais », un indicateur de durée de vie s’affiche dans la liste des entités. Placez le pointeur de la souris dessus et un message s’affichera indiquant les détails de son statut.

Si des entités ont été marquées pour suppression, mais n’ont pas été supprimées au moment prévu (règle de découverte désactivée ou hôte de l’élément), elles seront supprimées lors du prochain traitement de la règle de découverte.

Les entités contenant d’autres entités marquées pour suppression ne seront pas mises à jour si elles sont modifiées au niveau de la règle de découverte. Par exemple, les déclencheurs basés sur LLD ne seront pas mis à jour s’ils contiennent des éléments marqués pour suppression.

Autres types de découverte

Vous trouverez plus de détails et des guides pratiques sur d'autres types de découverte prêts à l'emploi dans les sections suivantes :

• découverte des interfaces réseau
• découverte des processeurs et des cœurs de processeur
• découverte des OID SNMP
• découverte des objets JMX ;
• découverte à l'aide de requêtes SQL ODBC
• découverte des services Windows
• découverte des interfaces d'hôte dans Zabbix

Pour plus de détails sur le format JSON des éléments de découverte et un exemple de mise en œuvre de votre propre outil de découverte du système de fichiers sous forme de script Perl, consultez la création de règles LLD personnalisées.