Skip to content

Commit

Permalink
Merge pull request #7 from david-moreau/zabbix-macro
Browse files Browse the repository at this point in the history
Zabbix macro
  • Loading branch information
Trikke76 committed Jun 14, 2024
2 parents c3d40d3 + 4fa080a commit f09c518
Showing 1 changed file with 13 additions and 10 deletions.
23 changes: 13 additions & 10 deletions docs/configuration/zabbix-macros.fr.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ Les macros sont l'un des concepts que vous devez comprendre dans Zabbix. Il exis




## Built-in macros

Elles correspondent à des macros interne à Zabbix, elles sont représentées via cette notation `{MACRO}`, la liste complète est disponible [ici](https://www.zabbix.com/documentation/7.0/en/manual/appendix/macros/supported_by_location). Chaque built-in macro peut-être utilisée dans un ou plusieurs cas.
Expand All @@ -22,10 +23,10 @@ La syntaxe d'une fonction de macro est la suivante : `{macro.func(params)}`

|Function|Description|
|--|--|
|[fmtnum](https://www.zabbix.com/documentation/7.0/en/manual/config/macros/macro_functions#fmtnum)|Number formatting to control the number of digits printed after the decimal point.|
|[fmttime](https://www.zabbix.com/documentation/7.0/en/manual/config/macros/macro_functions#fmttime)|Time formatting.|
|[iregsub](https://www.zabbix.com/documentation/7.0/en/manual/config/macros/macro_functions#iregsub)|Substring extraction by a regular expression match (case-insensitive).|
|[regsub](https://www.zabbix.com/documentation/7.0/en/manual/config/macros/macro_functions#regsub)|Substring extraction by a regular expression match (case-sensitive).|
|[fmtnum](https://www.zabbix.com/documentation/7.0/en/manual/config/macros/macro_functions#fmtnum)|Formatage des nombres pour contrôler le nombre de chiffres après la virgule.|
|[fmttime](https://www.zabbix.com/documentation/7.0/en/manual/config/macros/macro_functions#fmttime)|Formatage de l'heure|
|[iregsub](https://www.zabbix.com/documentation/7.0/en/manual/config/macros/macro_functions#iregsub)|Extraction de sous-chaînes de caractère par une expression régulière (insensible à la casse).|
|[regsub](https://www.zabbix.com/documentation/7.0/en/manual/config/macros/macro_functions#regsub)|Extraction d'une sous-chaîne de caractère à l'aide d'une expression régulière (sensible à la casse).|



Expand All @@ -36,13 +37,15 @@ Elles sont toujours précédé d'un **\$** et se note ainsi: `{$MACRO}`.

Il est important de noter que Zabbix priorise les user macros comme ceci:

1. macros au niveau de l'hôte (vérifié en premier).
2. macros définies pour les modèles de premier niveau de l'hôte (c'est-à-dire les modèles liés directement à l'hôte), triées par ID de modèle.
3. macros définies pour les modèles de deuxième niveau de l'hôte, triées par ID de modèle.
4. macros définies pour les modèles de troisième niveau de l'hôte, triées par ID de modèle, etc.
5. macros globales (vérifiées en dernier)

Ces macros sont utilisable à beaucoup d'[endrois](https://www.zabbix.com/documentation/7.0/en/manual/appendix/macros/supported_by_location_user), elles servent courrament à définir un seuil et servent de valeur par défaut dans un template qu'on peut surcharger au niveau des host-level macro.
1. host level macros (checked first)
2. macros définies dans les templates de 1er niveau (template directement lié au hos), trié par template ID
3. macros définies dans les templates de 2eme niveau (template directement lié au hos), trié par template ID
4. macros définies dans les templates de 3eme niveau (template directement lié au hos), trié par template ID
5. global macros (checked last)


Ces macros sont utilisable à beaucoup d'[endroit](https://www.zabbix.com/documentation/7.0/en/manual/appendix/macros/supported_by_location_user), elles servent courrament à définir un seuil et servent de valeur par défaut dans un template qu'on peut surcharger au niveau des host-level macro.

Afin d'avoir des templates réutilisables et fonctionnel dans une majorités de situation, il faut abuser des users macros.
Il est également conseillé de ne pas utiliser de macros globales lorsqu'elles ne sont pas nécessaires, car elles ne sont pas portables lors de l'exportation d'hôtes ou de modèles.
Expand Down

0 comments on commit f09c518

Please sign in to comment.