[comment]: # ({d428738a-d428738a})
# 2 Macros utilisateurs supportées par emplacement

[comment]: # ({/d428738a-d428738a})

[comment]: # ({0586ac4e-f0afb8e0})
#### Aperçu

Cette section contient une liste des emplacements où les macros [définies par l'utilisateur](/manual/config/macros/user_macros) sont prises en charge.

::: noteclassic
Seules les macros utilisateur de niveau global sont prises en charge pour les *Actions*, la *Découverte réseau*, les *Proxys* et tous les emplacements répertoriés dans la section *Autres emplacements* de cette page.
Dans les emplacements mentionnés, les macros de niveau hôte et de niveau modèle ne seront pas résolues.
:::

::: noteclassic
Pour personnaliser les valeurs des macros (par exemple, raccourcir ou extraire des sous-chaînes spécifiques), vous pouvez utiliser les [fonctions de macro](/manual/config/macros/macro_functions).
:::

[comment]: # ({/0586ac4e-f0afb8e0})

[comment]: # ({bb611c5d-7cb4c86b})
#### Actions

Dans les [actions](/manual/config/notifications/action), les macros utilisateur peuvent être utilisées dans les champs suivants :

|Emplacement|<|Plusieurs macros/mix avec du texte^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|Notifications et commandes basées sur les déclencheurs|<|oui|
|Notifications internes basées sur les déclencheurs|<|oui|
|Notifications de mise à jour de problème|<|oui|
|Notifications et commandes basées sur les services|<|oui|
|Notifications de mise à jour des services|<|oui|
|Condition de période de temps|<|non|
|*Opérations*|<|<|
| |Durée de l'étape d'opération par défaut|non|
|^|Durée de l'étape|non|

[comment]: # ({/bb611c5d-7cb4c86b})

[comment]: # ({9d1364cf-f30645e0})
#### Hôtes/prototypes d’hôte

Dans la configuration d’un [hôte](/manual/config/hosts/host) et d’un [prototype
d’hôte](/manual/vm_monitoring/example#create-a-host-prototype), les macros
utilisateur peuvent être utilisées dans les champs suivants :

|Emplacement|<|Macros multiples/mélange avec du texte^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|IP/DNS de l’interface|<|DNS uniquement|
|Port de l’interface|<|non|
|*SNMP v1, v2*|<|<|
| |Communauté SNMP|oui|
|*SNMP v3*|<|<|
| |Nom de contexte|oui|
|^|Nom de sécurité|oui|
|^|Phrase secrète d’authentification|oui|
|^|Phrase secrète de confidentialité|oui|
|*IPMI*|<|<|
| |Nom d’utilisateur|oui|
|^|Mot de passe|oui|
|*Tags*^[2](supported_by_location_user#footnotes)^|<|<|
| |Noms des tags|oui|
|^|Valeurs des tags|oui|

[comment]: # ({/9d1364cf-f30645e0})

[comment]: # ({7be6d794-d51563d6})
#### Éléments / prototypes d’élément

Dans la configuration d’un [élément](/manual/config/items/item) ou d’un [prototype
d’élément](/manual/discovery/low_level_discovery/item_prototypes),
les macros utilisateur peuvent être utilisées dans les champs suivants :

|Emplacement|<|Macros multiples/mélange avec du texte^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|Nom de l’élément|<|oui|
|Paramètres de clé d’élément|<|oui|
|Intervalle de mise à jour|<|non|
|Intervalles personnalisés|<|non|
|Délai d’expiration (disponible pour les types d’élément [pris en charge](/manual/web_interface/frontend_sections/administration/general#timeouts))|<|non|
|Conserver jusqu’à (pour l’historique et les tendances)|<|non|
|Description|<|oui|
|*Élément calculé/agrégé*|<|<|
| |Formule (constantes d’expression et paramètres de fonction ; paramètres de clé d’élément ; (*élément agrégé uniquement*) conditions de filtre (nom du groupe d’hôtes et nom du tag))|oui|
|*Surveillance de base de données*|<|<|
| |Nom d’utilisateur|oui|
|^|Mot de passe|oui|
|^|Requête SQL|oui|
|*Agent HTTP*|<|<|
| |URL^[3](supported_by_location_user#footnotes)^|oui|
|^|Champs de requête|oui|
|^|Corps de la requête|oui|
|^|En-têtes (noms et valeurs)|oui|
|^|Codes d’état requis|oui|
|^|Proxy HTTP|oui|
|^|Nom d’utilisateur pour l’authentification HTTP|oui|
|^|Mot de passe pour l’authentification HTTP|oui|
|^|Fichier de certificat SSL|oui|
|^|Fichier de clé SSL|oui|
|^|Mot de passe de la clé SSL|oui|
|^|Hôtes autorisés|oui|
|*Agent JMX*|<|<|
| |Point de terminaison JMX|oui|
|*Élément script*|<|<|
| |Noms et valeurs des paramètres|oui|
|*Élément navigateur*|<|<|
| |Noms et valeurs des paramètres|oui|
|*Agent SNMP*|<|<|
| |OID SNMP|oui|
|*Agent SSH*|<|<|
| |Nom d’utilisateur|oui|
|^|Fichier de clé publique|oui|
|^|Fichier de clé privée|oui|
|^|Mot de passe|oui|
|^|Script|oui|
|*Agent TELNET*|<|<|
| |Nom d’utilisateur|oui|
|^|Mot de passe|oui|
|^|Script|oui|
|*Zabbix trapper*|<|<|
| |Hôtes autorisés|oui|
|*Tags*^[2](supported_by_location_user#footnotes)^|<|<|
| |Noms des tags|oui|
|^|Valeurs des tags|oui|
|*Étapes de prétraitement*|<|<|
| |Paramètres (y compris les scripts personnalisés)|oui|
| |Paramètres personnalisés de gestion des erreurs (champs *Définir la valeur sur* et *Définir l’erreur sur*)|oui|

[comment]: # ({/7be6d794-d51563d6})

[comment]: # ({04aa381c-747bd0ca})
#### Découverte de bas niveau

Dans une [règle de découverte de bas niveau
](/manual/discovery/low_level_discovery#configuring-lowlevel-discovery),
les macros utilisateur peuvent être utilisées dans les champs suivants :

|Emplacement|<|Macros multiples/mélange avec du texte^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|Paramètres de clé|<|oui|
|Intervalle de mise à jour|<|non|
|Intervalle personnalisé|<|non|
|Délai d'expiration (disponible pour les types d'élément [pris en charge](/manual/web_interface/frontend_sections/administration/general#timeouts))|<|non|
|Supprimer les ressources perdues|<|non|
|Désactiver les ressources perdues|<|non|
|Description|<|oui|
|*agent SNMP*|<|<|
| |OID SNMP|oui|
|*agent SSH*|<|<|
| |Nom d'utilisateur|oui|
|^|Fichier de clé publique|oui|
|^|Fichier de clé privée|oui|
|^|Mot de passe|oui|
|^|Script|oui|
|*agent TELNET*|<|<|
| |Nom d'utilisateur|oui|
|^|Mot de passe|oui|
|^|Script|oui|
|*Zabbix trapper*|<|<|
| |Hôtes autorisés|oui|
|*Moniteur de base de données*|<|<|
| |Nom d'utilisateur|oui|
|^|Mot de passe|oui|
|^|Requête SQL|oui|
|*agent JMX*|<|<|
| |Point de terminaison JMX|oui|
|*agent HTTP*|<|<|
| |URL^[3](supported_by_location_user#footnotes)^|oui|
|^|Champs de requête|oui|
|^|Corps de la requête|oui|
|^|En-têtes (noms et valeurs)|oui|
|^|Codes d'état requis|oui|
|^|Nom d'utilisateur pour l'authentification HTTP|oui|
|^|Mot de passe pour l'authentification HTTP|oui|
|*Filtres*|<|<|
| |Expression régulière|oui|
|*Remplacements*|<|<|
| |Filtres : expression régulière|oui|
|^|Opérations : intervalle de mise à jour (pour les prototypes d'élément)|non|
|^|Opérations : période de stockage de l'historique (pour les prototypes d'élément)|non|
|^|Opérations : période de stockage des tendances (pour les prototypes d'élément)|non|

[comment]: # ({/04aa381c-747bd0ca})

[comment]: # ({7c6ab06a-95f2f372})
#### Découverte réseau

Dans une [règle de découverte de réseau](/manual/discovery/network_discovery/rule), les macros utilisateur peuvent être utilisées dans les champs suivants :

|Emplacement|<|Plusieurs macros/mix avec du texte^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|Intervalle de mise à jour|<|non|
|*SNMP v1, v2*|<|<|
| |Communauté SNMP|oui|
|^|OID SNMP|oui|
|*SNMP v3*|<|<|
| |Nom du contexte|oui|
|^|Nom de sécurité|oui|
|^|Phrase secrète d'authentification|oui|
|^|Phrase secrète de confidentialité|oui|
|^|OID SNMP|oui|

[comment]: # ({/7c6ab06a-95f2f372})

[comment]: # ({3962fa7e-575d88fc})
#### Proxies

Dans une configuration de [proxy](/manual/distributed_monitoring/proxies#configuration),
les macros utilisateur peuvent être utilisées dans les champs suivants :

|Emplacement|<|Macros multiples/mélange avec du texte^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|*Adresse pour les agents actifs > Port* (si le proxy appartient à un groupe)|<|non|
|Adresse et port de l’interface (pour un proxy passif)|<|non|
|Délais d’expiration pour les types d’éléments|<|non|

[comment]: # ({/3962fa7e-575d88fc})

[comment]: # ({76ff2b0f-dbeb9eca})
#### Groupes de proxys

Dans une configuration de [groupe de proxys](/manual/distributed_monitoring/proxies/ha#configuring-a-proxy-group),
les macros utilisateur peuvent être utilisées dans les champs suivants :

|Emplacement|<|Macros multiples/mélange avec du texte^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|Période de basculement|<|non|
|Nombre minimal de proxys|<|non|

[comment]: # ({/76ff2b0f-dbeb9eca})

[comment]: # ({d5117b03-32b6aef1})
#### Modèles

Dans une configuration de [modèle](/manual/config/templates/template), les macros utilisateur peuvent être utilisées dans les champs suivants :

|Emplacement|<|Plusieurs macros/mix avec du texte^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|*Tags*^[2](supported_by_location_user#footnotes)^|<|<|
| |Noms de Tag |oui|
|^|Valeurs de Tag|oui|

[comment]: # ({/d5117b03-32b6aef1})

[comment]: # ({0d27e496-c78b04ef})
#### Déclencheurs

Dans la configuration d’un [déclencheur](/manual/config/triggers/trigger), les macros utilisateur peuvent être utilisées dans les champs suivants :

|Emplacement|<|Macros multiples/mélange avec du texte^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|Nom|<|oui|
|Données opérationnelles|<|oui|
|Expression (uniquement dans les constantes et les paramètres de fonction ; les macros secrètes ne sont pas prises en charge)|<|oui|
|Tag pour la correspondance|<|oui|
|Nom de l’entrée de menu|<|oui|
|URL de l’entrée de menu^[3](supported_by_location_user#footnotes)^|<|oui|
|Description|<|oui|
|*Tags*^[2](supported_by_location_user#footnotes)^|<|<|
| |Noms des tags|oui|
|^|Valeurs des tags|oui|

[comment]: # ({/0d27e496-c78b04ef})

[comment]: # ({423f6587-78f1f511})
#### Scénario Web

Dans une configuration de [scénario Web](/manual/web_monitoring), les macros utilisateur peuvent être utilisées dans les champs suivants :

|Emplacement|<|Plusieurs macros/mix avec du texte^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|Nom|<|oui|
|Intervalle de mise à jour|<|non|
|Agent|<|oui|
|Proxy HTTP|<|oui|
|Variables (valeurs uniquement)|<|oui|
|En-têtes (noms et valeurs)|<|oui|
|*Étapes*|<|<|
| |Nom|oui|
|^|URL^[3](supported_by_location_user#footnotes)^|oui|
|^|Variables (valeurs uniquement)|oui|
|^|En-têtes (noms et valeurs)|oui|
|^|Timeout|non|
|^|Chaîne requise|oui|
|^|Codes d'état requis|non|
|*Authentification*|<|<|
| |Utilisateur|oui|
|^|Mot de passe|oui|
|^|Certificat SSL|oui|
|^|Fichier de clé SSL|oui|
|^|Mot de passe de la clé SSL|oui|
|*Tags*^[2](supported_by_location_user#footnotes)^|<|<|
| |Noms des tags|oui|
|^|Valeurs des tags|oui|

[comment]: # ({/423f6587-78f1f511})

[comment]: # ({f63f6226-efe84e1d})
#### Autres emplacements

En plus des emplacements répertoriés ici, les macros utilisateur peuvent être utilisées dans les
champs suivants :

|Emplacement|<|Macros multiples/mélange avec du texte^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|Scripts globaux (URL, script, SSH, Telnet, IPMI), y compris le texte de confirmation|<|oui|
|Webhooks|<|<|
| |Script JavaScript|non|
|^|Nom du paramètre du script JavaScript|non|
|^|Valeur du paramètre du script JavaScript|oui|
|*Tableaux de bord*|<|<|
| |Colonne du type de données *Texte* dans le widget de tableau de bord *Top hosts*|oui|
|^|Paramètre *Description* dans les widgets de tableau de bord *Item value* et *Gauge*|oui|
|^|Paramètre *Text* de l’étiquette principale/secondaire dans le widget de tableau de bord *Honeycomb*|oui|
|^|Paramètre *URL*^[3](supported_by_location_user#footnotes)^ dans le widget de tableau de bord *URL*|oui|
|*Utilisateurs → Utilisateurs → Média*|<|<|
| |Période d’activité|oui|
|*Administration → Général → Interface graphique*|<|<|
| |Temps de travail|non|
|*Administration → Général → Délais d’expiration*|<|<|
| |Délais d’expiration pour les types d’éléments|non|
|*Administration → Général → Connecteurs*|<|<|
| |URL|oui|
|^|Nom d’utilisateur|oui|
|^|Mot de passe|oui|
|^|Jeton Bearer|oui|
|^|Délai d’expiration|non|
|^|Proxy HTTP|oui|
|^|Fichier de certificat SSL|oui|
|^|Fichier de clé SSL|oui|
|^|Mot de passe de la clé SSL|oui|
|*Alertes → Types de média → Modèles de message*|<|<|
| |Sujet|oui|
|^|Message|oui|
|*Alertes → Types de média → Script*|<|<|
| |Paramètres du script|oui|
|*Alertes → Types de média → Type de média*|<|<|
| |Champs *Username* et *Password* pour le type de média *Email* (lorsque *Authentication* est défini sur "Username and password" ; les [macros secrètes](/manual/config/macros/user_macros#configuration) sont recommandées)|oui|

Pour une liste complète de toutes les macros prises en charge dans Zabbix, voir les [macros prises en charge](/manual/appendix/macros/supported_by_location).

[comment]: # ({/f63f6226-efe84e1d})

[comment]: # ({3f947571-5a370e78})
##### Notes de bas de page

^**1**^ Si plusieurs macros dans un champ ou des macros mélangées à du texte ne sont pas prises en charge pour l'emplacement, une seule macro doit remplir tout le champ.

^**2**^ Les macros utilisées dans les noms et les valeurs des tags sont résolues uniquement lors du processus de génération d'événements.

^**3**^ Les URL qui contiennent une [macro secrète](/manual/config/macros/user_macros#configuration) ne fonctionneront pas, car la macro qu'elles contiennent sera résolue comme "\*\*\*\*\*\*".

[comment]: # ({/3f947571-5a370e78})