Versions Compared

Old Version 11

changes.mady.by.user Quentin Soubeyrol

Saved on

compared with

New Version Current

changes.mady.by.user Soubrié Grégoire

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Make by tools (01.00.01) - action=clean_macro_parameter
Scroll Ignore
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbookhtmltruefalse
scroll-eclipsehelpdocbooktrue
scroll-epubeclipsehelptrue
scroll-htmlepubtrue
Panel
titleSommaire

Table of Contents
stylenone

Contexte

La commande de notification notify-host-by-email permet d'envoyer un mail de notification sous le format suivant :

Image Removed
Panel

Image Added

Par défaut, la commande envoie le mail au serveur de mail local ( en ciblant "localhost" ).

Paramétrage

Le check La commande utilise la ligne de commande définition suivante :

Code Block
languagetext
themeEmacs
$NOTIFPLUGINDIR$/notify_by_email.py --title-tpl $NOTIFPLUGINDIR$/host_alert_title_template.tpl --content-tpl 
$NOTIFPLUGINDIR$/host_alert_content_template.tpl 
-F "$SENDER$" -r "$CONTACTEMAIL$" -n $NOTIFICATIONTYPE$ -H "$HOSTNAME$" 
--address "$HOSTADDRESS$" --url $MAILURL$ --huuid $HOSTUUID$ --state $HOSTSTATE$ 
--last-state $LASTHOSTSTATEID$ --last-change 
$LASTHOSTSTATECHANGE$  --last-check "$DATE$ $TIME$" --output "$HOSTOUTPUT$" --long-output "$LONGHOSTOUTPUT$" 
--ack-author "$ACKAUTHOR$" 
--ack-data "$ACKDATA$" --downtime-comment "$HOSTDOWNTIMECOMMENT$" --downtime-author "$HOSTDOWNTIMEAUTHOR$" 
--first-notification-delay 
"$HOSTFIRSTNOTIFICATIONDELAY$" --notification-number "$HOSTNOTIFICATIONNUMBER$" --realm "$HOSTREALM$"

Données communes

NomModifiable sur UnitésDéfautValeur par défaut à l'installation de ShinkenDescription
No Format
MAILURL

/etc/shinken/resource.d/email.cfg

---

http://127.0.0.1:7767

http://127.0.0.1:7767

L'adresse de l'UI de visualisation de Shinken. (dans le but par exemple de donner au contact un lien vers l'élément).

No Format
SENDER

/etc/shinken/resource.d/email.cfg

---
shinken@localhost
shinken@localhost

L'adresse mail de l'envoyeur, pour une notification mail.

No Format
NOTIFPLUGINDIR

/etc/shinken/resource.d/email.cfg

--- /var/lib/shinken/libexec/notifications/var/lib/shinken/libexec/notifications

Le répertoire dans lequel se trouve la commande de notification à exécuter.

Les commandes utilisent le mécanisme des Variables pour recevoir les informations spécifiques à l'élément de la notification ( voir la page Les Variables ( Remplacement dynamique de contenu - Anciennement les Macros ) )


Info
titleEnvoie vers un serveur de mail différent de localhost

A noter que l'option -S, permettant d'envoyer le mail vers un serveur mail différent de "localhost", n'est pas présente dans la commande.

Données de configuration du script d'envoi de mail

Excerpt Include
Utilisation des méthodes de notifications MAIL livrées par Shinken
Utilisation des méthodes de notifications MAIL livrées par Shinken
nopaneltrue

Données de fonctionnement indispensable pour une notification minimal

Excerpt
NomModifiable sur Description
No Format
HOSTNAME

L'hôte ( Onglet Général )

Nom

Données de fonctionnement

NomModifiable sur UnitésDéfautValeur par défaut à l'installation de ShinkenDescription
No Format
CONTACTEMAIL

l'utilisateur

( Onglet Général )

---------

email de l'utilisateur à notifier

Données pour compléter l'affichage du titre du mail

NomModifiable sur UnitésDéfautValeur par défaut à l'installation de ShinkenDescription
No Format
HOSTNAME

À ne pas modifier

---------

nom de l'hôte

Données pour compléter l'affichage du contenu du mail

NomModifiable sur UnitésDéfautValeur par défaut à l'installation de ShinkenDescription
No Format
HOSTNAME

À ne pas modifier

---------nom

de l'hôte

No Format
NOTIFICATIONTYPE

À ne pas modifier

---------

non modifiable

Le type de notification à envoyer. Cela correspond au type d'événement qui a été constaté sur l'élément.

Type de notification Description
PROBLEM   
(

Le statut de l'élément est non OK

)

.

RECOVERY   
(

L'élément avait un problème, mais est de nouveau dans un statut OK

)
No Format
HOSTREALM

À ne pas modifier

---------

Nom du royaume auquel appartien l'hôte

No Format
HOSTADDRESS

À ne pas modifier

---------

.

ACKNOWLEDGEMENT 

Un utilisateur a envoyé par l'interface web un accusé de réception par rapport à un problème survenu à un hôte ou à un check. Indique le nom et le motif de la prise en compte.

FLAPPINGSTART

L'élément est entré d'un contexte de FLAPPING.

FLAPPINGSTOP

L'élément est sorti d'un contexte de FLAPPING.

FLAPPINGDISABLED 

 La détection a été désactivée pendant la durée du FLAPPING.

DOWNTIMESTART

L'élément est entré d'une période programmée d'indisponibilité. Indique le nom et le motif de l'arrêt

DOWNTIMESTOP

L'élément est sorti d'une période programmée d'indisponibilité.

DOWNTIMECANCELLED 

La période programmée d'indisponibilité de l'élément a été annulée en cours.



No Format
HOSTADDRESS

L'hôte ( Onglet Général )

Adresse de l'hôte

No Format
HOSTSTATE

À ne pas modifier

---------Etat

non modifiable

État courant de l'hôte (

UP, DOWN, ou UNREACHABLE)

Propriétés de l'hôte

Excerpt IncludeMise en place du Pack windowsMise en place du Pack windowsnopaneltrue

Résultat

Exemple

Panel

Image Removed

Interprétation

Statut

Il peut prendre deux valeurs  OK / CRITIQUE / ATTENTION   /   INCONNU .

Le statut va dépendre du retour de sonde et de la configuration spécifique du check pour les données suivantes :
  • THRESHOLD_CPU_STOLEN_CRITICAL,
  • THRESHOLD_CPU_STOLEN_WARNING,
    • CHECK_SHINKEN_TIMEOUT
    Voici un tableau récapitulatif du statut attendu suivant le retour de sonde :
    Les vérifications communes
    Excerpt IncludeListe des événements sur les démons modifiant le résultat des checksListe des événements sur les démons modifiant le résultat des checksnopaneltrue
    Les vérifications spécifiques

    Situation

    Statut

    En fonction du pourcentage de CPU volé :

    • Si c'est  supérieur  à THRESHOLD_CPU_STOLEN_CRITICAL (  par défaut : 10 %  )

    CRITIQUE

    En fonction du pourcentage de CPU volé :

    • Si c'est supérieur  à THRESHOLD_CPU_STOLEN_WARNING(  par défaut : 5%  )

    ATTENTION

    OK, CRITICAL )

    Données pour compléter l'affichage du contenu du mail

    Excerpt Include
    notify-host-by-email-with-images - Commande de notification
    notify-host-by-email-with-images - Commande de notification
    nopaneltrue

    Exemples

    Notification type - PROBLEM

    Panel

    Image Added

    Notification type - RECOVERY

    Panel

    Image Added

    Si la sonde n'a pas eu de réponse avant le temps maximum

    Si supérieur  àCHECK_SHINKEN_TIMEOUT (  par défaut : 3 sec ) INCONNU

    Résultat

    Renvoi au format texte : 

    • Si le démon fonctionne correctement, la version installée et le temps qu'a pris le check pour établir la  communication avec le check.

    Résultat Long

    Précise le fonctionnement des modules du Broker, leur statut, le nombre de redémarrages lors des 24 dernières heures, la date de dernier redémarrage et les sous-modules

    Description des erreurs

    Excerpt IncludeLes vérifications communes à tous les démonsLes vérifications communes à tous les démonsnopaneltrue Excerpt IncludeLes vérifications de vol de CPULes vérifications de vol de CPUnopaneltrue