Contexte

Afin de pouvoir recevoir des notifications, la source cfg-file-shinken comprend un certain nombre de méthodes de notifications qu'il faudra importer et appliquer sur les utilisateurs à notifier.

• Les méthodes de notifications livrées sont généralistes et ne permettent pas de répondre à tous les besoins.
• Si vous devez modifier un élément ( méthode de notification ou commande ) livré par un pack Shinken pour un besoin spécifique,
  • il est important de créer la vôtre,
  • car à la prochaine mise à jour de shinken vous proposera de remplacer vos modifications.

Cette page apporte des conseils sur l'utilisation optimale des packs livrés par Shinken.

Cohabiter avec un pack livré Shinken

Pourquoi ne faut-il pas modifier les éléments livrés dans le pack ?

Des différences vous seront proposées après la mise à jour et l'import de la source "cfg-file-shinken", il vous sera donc imposé de faire un choix entre ce que vous avez modifié et les modifications apportées par les mises à jour Shinken.

Création/Copie d'une méthode de notification

Dupliquer l'élément ( méthode de notification ) avec l'action "Cloner" de la liste ( voir la page Actions de masse ( Shinken admin ) ).

Nous vous conseillons de cloner une des méthodes de notifications existantes :

• email ( voir la page email - Méthode de notification )
• email-with-images ( voir la page email-with-images - Méthode de notification )

Ces méthodes utilisent deux commandes de notifications livrées dans le pack shinken,

• il faudra les remplacer par deux nouvelles commandes ( voir la page Créer des commandes de notification spécifique - bonnes pratiques )

Si vous voulez une totale indépendance, vous pouvez aussi cloner le script de notification utilisé ( qui sera différent en fonction du type de notification ).

• Ce n'est pas obligatoire, car nous prenons grand soin à maintenir une compatibilité ascendante,
• mais cela vous donnera une certitude de n'avoir aucun changement lorsque nous faisons évoluer ce script,
• et vous pourrez y apporter vos modifications si besoin, sans risque que nous les écrasions.
  • ci-dessous, remplacez :
    • TYPE_DE_NOTIFICATION par le type de notification ( EMAIL, SMS, ... )
    • SCRIPT_DE_NOTIFICATION par le nom du script de notification ( notify_by_email.py, ... )
    • MY_NAME_SCRIPT_DE_NOTIFICATION par le nom de votre script de notification.
      
      

mkdir /var/lib/shinken-user/libexec/notifications/TYPE_DE_NOTIFICATION
cd /var/lib/shinken-user/libexec/notifications/TYPE_DE_NOTIFICATION
cp /var/lib/shinken/libexec/notifications/SCRIPT_DE_NOTIFICATION MY_NAME_SCRIPT_DE_NOTIFICATION.py
chown -R shinken:shinken .

• Vos commandes devront pointer vers ce script :
  
  

/var/lib/shinken/libexec/notifications/TYPE_DE_NOTIFICATION/MY_NAME_SCRIPT_DE_NOTIFICATION ...