3 Macros de découverte de bas niveau

Aperçu

Il existe un type de macro utilisé dans la fonction de découverte de bas niveau (LLD) :

{#MACRO} 

Cette macro est utilisée dans une règle LLD et renvoie les valeurs réelles des noms de système de fichiers, des interfaces réseau et des OID SNMP.

Ces macros peuvent être utilisées pour créer des prototypes d’éléments, de déclencheurs et de graphes. Ensuite, lors de la découverte de systèmes de fichiers réels, d'interfaces réseau, etc., ces macros sont remplacées par des valeurs réelles et servent de base à la création d'éléments réels, de déclencheurs et de graphiques.

Ces macros sont également utilisées pour créer des prototypes d'hôte et de groupe d'hôtes dans la découverte de machines virtuelles.

Certaines macros de découverte de bas niveau sont "pré-packagées" avec la fonction LLD dans Zabbix - {#FSNAME}, {#FSTYPE}, {#IFNAME}, {#SNMPINDEX}, {#SNMPVALUE}. Cependant, l'adhésion à ces noms n'est pas obligatoire lors de la création d'une règle de découverte de bas niveau personnalisée. Vous pouvez utiliser n’importe quel autre nom de macro LLD et vous référer à ce nom.

Emplacements pris en charge

Les macros LLD peuvent être utilisées :

• dans le filtre de règle de découverte de bas niveau
• pour les prototypes d'éléments dans
  • nom
  • paramètres de clé
  • unités
  • intervalle de mise à jour
  • période de stockage de l'historique
  • période de stockage des tendances
  • OID SNMP
  • champs capteur IPMI
  • formule de calcul des éléments
  • script SSH et Telnet
  • requêtes SQL de la surveillance de base de données
  • champs endpoint de l'élément JMX
  • descriptions
  • depuis Zabbix 4.0 également dans :
    • étapes de pré-traitement de la valeur de l'élément
    • champs URL de l'agent HTTP
    • champs requête HTTP de l'agent HTTP
    • champs corps de requête de l'agent HTTP
    • champs code d'état requis de l'agent HTTP
    • champs clé et valeur de l'en-tête de l'agent HTTP
    • champs utilisateur de l'authentification de l'agent HTTP
    • champs mot de passe de l'authentification de l'agent HTTP
    • champs HTTP proxy de l'agent HTTP
    • champs fichier de certificat SSL de l'agent HTTP
    • champs fichier de clé SSH de l'agent HTTP
    • champs mot de passe de la clé SSH de l'agent HTTP
    • champs expiration HTTP de l'agent HTTP
• pour les prototypes de déclencheurs dans
  • nom
  • expression (uniquement dans les constantes et les paramètres de fonction)
  • URLs
  • descriptions
  • nom et valeurs des tags d'événement
• pour les prototypes de graphe dans
  • nom
• pour les prototypes d'hôtes dans
  • nom
  • nom visible
  • nom de prototype de groupe d'hôtes
  • (voir la liste complète)

Dans tous ces endroits, les macros LLD peuvent être utilisées dans le contexte de macros utilisateur.

Utilisation des fonctions de macro

Les fonctions de macros sont prises en charge avec les macros de découverte de bas niveau (sauf dans le filtre de règle de découverte de bas niveau), ce qui permet d'extraire une certaine partie de la valeur de la macro à l'aide d'une expression régulière.

Par exemple, vous pouvez extraire le nom du client et le numéro d’interface de la macro LLD suivante pour pouvoir positionner des tags sur des événements :

{#IFALIAS}=customername_1

Pour ce faire, la fonction macro regsub peut être utilisée avec la macro dans le champ valeur du tag d'événement d'un prototype de déclencheur :

Pour plus d'informations sur la syntaxe de la fonction de macro, voir : Fonctions de macro

Les fonctions de macros sont prises en charge dans les macros de découverte de bas niveau depuis Zabbix 4.0.

Footnotes

¹ In the fields marked with ¹ a single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.