Page History

Contexte

L'envoi de mail se fait en utilisant des modèles de mail ( un pour le titre et un pour le contenu ).

Suivant le besoin, il sera nécessaire de changer le titre ou le contenu de vos mails. 

Pour cela, il y a quelques règles à respecter :

• ne JAMAIS modifier les fichiers livrés par Shinken
• dans vos propres modèles de mail, il ne faudra utiliser que les formats HTML et CSS qui sont reconnus par les clients de messagerie.

Cette page explique comment créer, utiliser et vérifier vos modèles de mail.

Modèle de mail livré avec Shinken

Shinken livre deux modèles de mail :

• un pour les hôtes et clusters
• un pour les checks 

Chacun est constitué de deux parties :

• un pour le titre du mail 
• un pour le contenu du mail

L'adresse des modèles de mail est définie dans la commande de notification

Par exemple, pour la commande notify-host-by-email ( voir la page NEW_PAGE - 003.5.6 - SEF-11240 - notify-host-by-email - Commande de notification ) les options suivantes définissent les chemins des fichiers :

--title-tpl $NOTIFPLUGINDIR$/host_alert_title_template.tpl

--content-tpl $NOTIFPLUGINDIR$/host_alert_content_template.tpl 

Bonnes pratiques

Cloner la méthode de notification

( voir la page NEW_PAGE - 003.5.6 - SEF-11240 - Créer une méthode de notification spécifique - bonnes pratiques )

il faudra, dans la nouvelle méthode de notification, modifier les commandes utilisée qui doivent être créé également.

Cloner les commandes de notification

( voir la page NEW_PAGE - 003.5.6 - SEF-11240 - Créer des commandes de notification spécifique - bonnes pratiques )

Il faudra, dans la nouvelle commande, modifié la "Ligne de commande" pour changer les deux options "--title-tpl" et "--content-tpl" afin de pointer sur les nouveaux fichiers créés dans l'étape suivante. 

$NOTIFPLUGINDIR$/notify_by_email.py --title-tpl $NOTIFPLUGINDIR$/host_alert_title_template_my_name.tpl --content-tpl
$NOTIFPLUGINDIR$/host_alert_content_template_my_name.tpl -F "$SENDER$" ...

Cloner des modèles de mail

Choisir un nom pour vos fichiers ( .tpl ),

Il est recommandé de conserver le préfixe [ host_ | service_ ] afin d'identifier plus facilement vos templates.

cd /var/lib/shinken/libexec/notifications
cp host_alert_title_template.tpl host_alert_title_template_my_name.tpl
cp host_alert_content_template.tpl host_alert_content_template_my_name.tpl

Editer des modèles de mail

Le script pour envoyer les mails utilise un modèle de génération nommé Jinja.

L'utilisation de Jinja est assez intuitive, mais voici tout de même quelques explications

Utilisation de Jinja

Le fichier (.tpl) utilise des données renvoyé par le script. Vous n'avez pas le nom sur le nommage des données, vous pouvez seulement les utiliser.

Voici la listes des données utilisables:

Hostname

Check name

Notification type

Notification delay

Notification number

Title notification

Realm

Check date

State

state_html

State duration

Last state

Output

Long output

Check name

View

Last state

Title notification

Acknowledge author

Acknowledge data

downtime_author

downtime_comment

Notification delay

Notification number

Realm

Il vous est possible de soumettre à conditions l'intégration dans le mail, de certaines parties du template.

    {% if shinken_var['my_var'] %}
        <!-- Ce code ne sera pris en compte que si la donnée shinken_var['my_var'] existe et est renseignée ->

        {{ shinken_var['my_var'] }} <!-- sera remplacé dans le mail, par le contenu de shinken_var['my_var'] ->
    {% endif %}

Il sera possible d'utiliser des boucles "for" pour créer un élément HTML à partir d'une liste ou d'objet, ou même d'attribué dynamiquement des classes à des éléments.

Documentation de Jinja

Vous pouvez trouvez toutes les informations concernant l'outil de templating Jinja à l'adresse suivante : Jinja Documentation.

Cependant, la documentation de la version utilisée par Shinken n'est plus édité, il se peut que quelques différences soient présentes avec la version que vous utiliserez.

L'utilisation du HTML et du CSS dans les mails.

En plus du template, certaines propriétés comme l'affichage des seuils permettent d'afficher des informations complexes et sous différents formats. Il sera alors possible d'intégrer ces informations dans les notifications par mails.

Il faudra prendre en compte les informations suivantes concernant l'utilisation du HTML et CSS dans vos notifications.

HTML

CSS

Les logiciels mails ( Thunderbird, Outlook, Spark, ... ) et les services de mails web ( gmail, outlook ) n'interprètent pas les balises de la même manière, voir certaines balises sont interprétées chez certains et pas chez d'autres.

Si vous souhaitez intégrer du HTML et du CSS dans les notifications mail, nous vous conseillons fortement d'identifier les clients mails qui le liront et de consulter le site Can I Email ( voir la page Can I Email ) qui est une source d'information fiable sur la prise en charge des balises web par les principaux clients mails du marché.

Shinken et le HTML/CSS

D'autres balises HTML sont interdites par Shinken pour des motifs de sécurité. Elles seront sauvegardées, mais ne seront ni interprétée, ni transmise lors des notifications.

Il s'agit des balises Script, d'image, d'input ou d'iframe. Bien que très utile, elles permettent trop de dérives pour être autorisées à passer dans le système.

Il sera possible d'intégrer ces éléments directement par le template mail, mais ils ne pourront être dynamiques en fonction de vos hôtes et/ou checks.

Variables dynamiques

Vous pouvez intégrer des variables dynamiques à l'HTML, elles seront interprétées par le système et vous permettent d'afficher des données précises ( voir la page LES VARIABLES ( Remplacement dynamique de contenu - Anciennement les MACROS ) )

Vous pouvez mettre un lien vers la page Shinken de votre hôte, ou pointer vers une donnée que vous aurez configurée.

Exemple

Exemple de HTML/CSS pris en charge par les notifications