Page History

Contexte

Afin de pouvoir recevoir des notifications, Shinken comprend un certain nombre de commandes qu'il faudra importer et appliquer sur les utilisateurs à notifier.

• Les commandes 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 surchargé et les modifications apportées par les mises à jour Shinken.

Création d'une commande pour les notifications

Création d'une commande

Corps de la commande

Les commandes sont exécutées par le Reactionner ( voir la page Le Reactionner ) lorsque les conditions définies par la Logique de notification sont réunies.

• Elles ont pour font
• Elles ont permettent l'utilisation des Variable pour avoir accés aux informations des éléments ( voir la page Les Variables ( Remplacement dynamique de contenu - Anciennement les Macros ) ).
• Ces informations concernant Hôtes, Clusters, Check, Utilisateurs peuvent venir de différents endroits :
  • Une donnée globale,
  • L'élément à l'origine de la notification,
  • Le contact à notifier,
  • La notification en elle-même, notamment son type.

Voir un listing NON Exaustifs des informations qui peuvent etre pertinent dans une notification, mais la pageLes Variables ( Remplacement dynamique de contenu - Anciennement les Macros ), vous donne la liste complete de ce qui est accessible.

Variables globales

Vous pouvez utiliser dans votre commande des Variables globales.

• L'intérêt est d'avoir des informations fixes pour toutes vos commandes de notification.
• Nous vous conseillons de rajouter dans le répertoire /etc/shinken/resource.d votre fichier de définition de variable globale ( Voir la page Données globales ( Répertoire resource.d ) ).
• Pour information, les variables globales suivantes sont disponibles, pour inspiration, dans les notifications livrées par défaut.

Variables liées à l'élément

Dans le cas d'une notification de l'hôte, les variables de l'hôte sont disponibles.

• Dans le cas d'une notification d'un check, les variables l'hôte et du check sont toutes les deux disponibles.
• De la même façon que les variables globales, toutes les variables des éléments peuvent être utilisées, mais les variables suivantes sont spécifiquement utiles :

Variables liées au contact

Variables liées à la notification

Des variables spéciales permettent d'avoir des données concernant la notification en elle-même et la raison pour laquelle elle a été envoyée.

Partir d'une méthode de notification existante

Pour une première commande de notification, vous pouvez vous aussi duppliquer une commande existante et la modifier.

• La page Créer/Cloner des commandes de notification MAIL ( basé sur le script SHINKEN notify_by_email.py ) vous en détaille un exemple.