Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Reverted from v. 6

Introduction

 

Shinken supports optional escalation of contact notifications for hosts and checks. Escalation of host and check notifications is accomplished by defining escalation objects.

When Are Notifications Escalated?

Notifications are escalated if and only if one or more escalation definitions matches the current notification that is being sent out. If a host or check notification does not have any valid escalation definitions that applies to it, the contact group(s) specified in either the host group or check definition will be used for the notification.

Look at the example below:

Enterprise permet en option de définir des niveaux d'escalade sur les contacts et les checks. Cette option est activée en définissant des "escalation objects."

Quand les notifications sont-elles escaladées ?

Les notifications sont escaladées si et seulement si une ou plusieurs définitions d'escalade correspondent à la notification qui est envoyée. Si un hôte ou une notification n'a pas de définitions d'escalade valides qui s'y appliquent, le groupe ( s) de contact spécifié dans le groupe d'hôtes ou le check sera utilisée pour la notification.

Voyons un exemple:

PropriétéValeur
PropertyValue
NameTo-level-2
first_notification_time60
last_notification_time120
contact_groupsnt-admins,managers

It will use the interval length for the value you set for first/last notification time. Here, it will escalate after 1 hour problem, and stop at 2 hours.

Contact Groups

When defining notification escalations, it is important to keep in mind that any contact groups that were members of "lower" escalations (i.e. those with lower notification time ranges) should also be included in "higher" escalation definitions. This should be done to ensure that anyone who gets notified of a problem continues to get notified as the problem is escalated.

 

Example:

Il utilisera la valeur d'intervalle de temps défini pour la 1ère/dernière notification. Dans cet exemple, il escaladera 1 heure après le problème,et s'arrêtera 2 heures après. 

Groupes de contacts

Lorsqu'on définit les escalades de notifications, il est important de garder à l'esprit qu'il faut inclure dans la définition la plus haute tous les contacts qui étaient en définition la plus basse. Cela permet de garantir que tout le monde continuera d'être prévenu en cas d'escalade. 

 

Exemple:

PropriétéValeur
PropertyValue
NameTo-level-2
first_notification_time60
last_notification_time120
contact_groupsnt-admins,managers
Property
Propriété
Value
Valeur
NameTo-everyone
first_notification_time120
last_notification_time240
contact_groupsnt-admins,managers,everyone

 


The first (or "lowest") escalation level includes both the Le 1er niveau (ou "le plus bas") comprend à la fois le groupe nt-admins and et les managers contact groups. The last (or "highest") escalation level includes the . Le dernier niveau (ou "le plus élevé") comprend le groupe nt-admins, les managers, and everyone contact groups.

Notice that the nt-admins contact group is included in both escalation definitions. This is done so that they continue to get paged if there are still problems after the first two check notifications are sent out. The managers contact group first appears in the "lower" escalation definition - they are first notified when the third problem notification gets sent out. We want the managers group to continue to be notified if the problem continues past five notifications, so they are also included in the "higher" escalation definition.

Overlapping Escalation Ranges

Notification escalation definitions can have notification ranges that overlap. Take the following example:

 

 

et tout le monde dans le groupe. 

Notez que le groupe de contacts nt-admins est défini dans les 2 niveaux d'escalade. Cela leur permet de continuer d'être avertis si il y a toujours un problème après que les 2 premières notifications ont été envoyées. Idem pour le groupe de contacts "managers", qui doivent continuer d'être avertis également.  

Superposer des plages d'escalade 

La définition des notifications d'escalade peut s'étaler sur plusieurs plages. Prenons l'exemple suivant : 

 

 

PropriétéValeur
PropertyValue
NameTo-level-2
first_notification_time60
last_notification_time240
contact_groupsnt-admins,managers
Property
Propriété
Value
Valeur
NameTo-everyone
first_notification_time120
last_notification_time0
contact_groupson-call-support

 


In the example aboveDans cet exemple:

  • The les groupes de contact nt-admins and managers contact groups get notified on between 1 and 2 hours
  • All three contact groups get notified between 2 and 4 hours
  • Only the on-call-support contact group gets notified after 4 hours

 

Escalations based on time short time

It's also interesting to see that with escalation based on time, if the notification interval is longer than the next escalation time, it's this last value that will be taken into account.

Let take an example :

Host:

  • et managers seront notifiés entre 1 et 2 heures  
  • Les 3 contacts seront notifiés entre 2 et 4 heures  
  • Seul le centre de support sera notifié après 4 heures 

 

Escalades basées sur un temps court 

Il est intéressant de voir qu'avec les escalades basées sur le temps, si l'intervalle de notification est plus long que le temps de la prochaine escalade, alors c'est la dernière valeur qui sera prise en compte. 

Prenons un exemple :

Host:

PropriétéValeur
PropertyValue
Namesrv-important
notification interval1440
escalationsTo-level-2


Then with the escalations objectAvec l'objet escalade:

Property
Propriété
Value
Valeur
NameTo-level-2
first_notification_time60
last_notification_time 120
contact groupslevel2

 

Here let say you have a problem HARD on the check at Ici, considérons que vous avez un problème HARD sur le check à t=0. It will notify the host contacts. The next notification should be at Le contact de l'hôte sera notifié. La prochaine notification devrait être à t=1440 minutes, so tomorrow. It's ok for classic notifications, but not for escalated ones.donc demain. Ça va pour des notifications simples, mais pas pour celles avec escalade.

Ici, à Here, at t=60 minutes, the escalation will raise, you will notify the level2 contact group.

So you can put large notification_interval and still have quick escalations times.

 

Time Period Restrictions

Under normal circumstances, escalations can be used at any time that a notification could normally be sent out for the host or check.

This "notification time window" is determined by the notification period directive in the host or check configuration.

You can optionally restrict escalations so that they are only used during specific time periods by using the "escalation_period" directive in the escalation configuration.

If you use the "escalation_period" directive to specify a time period which the escalation can be used, the escalation will only be used during that time. If you do not specify any escalation period directive, the escalation can be used at any time within the "notification time window" for the host or check.

Escalated notifications are still subject to the normal time restrictions imposed by the "notification_period" directive in a host or check definition, so the timeperiod you specify in an escalation definition should be a subset of that larger "notification time window".

State Restrictions

If you would like to restrict the escalation definition so that it is only used when the host or check is in a particular state, you can use the scalation options directive in the escalation definition. If you do not use the "escalation_options" directive, the escalation can be used when the host or check is in any state.

l'escalade sera lancée, le niveau 2 sera notifié.  

Vous pouvez donc définir un intervalle large de notification et toujours avoir des escalades rapides. 

 

Restrictions sur période de temps

Dans des circonstances normales, les escalades peuvent être utilisées à n'importe quel moment pendant lequel une notification peut être envoyée. 

Cette  "fenêtre de notification" est déterminée par le paramètre "période de notification" dans la définition de l'hôte ou du check. 

Vous pouvez en option restreindre les escalades afin qu'elles ne soient utilisées que durant des périodes définies en utilisant le paramètre  "escalation_period" dans sa configuration.

Si vous utilisez ce paramètre, l'escalade n'aura lieu que pendant cette période définie.  

Les escalades de notifications restent soumises aux restrictions imposées par le paramètre "notification_period" des hôtes et des check, donc la période de temps définie dans la définition de l'escalade doit être à l'intérieur de cette plus grande période de notifications.

Restrictions d'état

Si vous souhaitez restreindre les escalades en fonction de l'état d'un hôte ou d'un service, vous pouvez utiliser la directive "escalation_options" dans la définition de l'escalade. Si vous n'utilisez pas cette directive, l'escalade peut être utilisée quand les hôte ou les checks sont dans n'importe quels états.