Page History

Onglet Général

Nom du Check

• Clé d'import: service_description
  

  Info
  title Les caractères ~!$%^

  Cette propriété est utilisée pour définir le nom du check. Les caractères suivants sont interdits : ~!%^

  &*"'|<>?,()=

  +
  2 checks associés sur le même hôte ne peuvent pas avoir le même nom

  /+ sont interdits dans ce champ.

  Un caractère non autorisé provoquera un compteur erreur

   C

  Info
  Le nom doit être unique pour les modèles de checks.

  Info
  Ce

  e

  champ ne peut pas rester vide

Modèles de Check hérité

• Clé d'import: use
  Les modèles de checks qui sont attachés à l'hôte pour au check pour hériter de leurs propriétés et leurs données.
  • L'ordre des modèles est important.
  • Une valeur définie dans 2 deux modèles prendra la valeur du modèle le plus proche du début de la liste.
  • Si vous définissez une valeur Les valeurs définit pour une propriété ou une donnée, elle sera serons prioritaire sur celle héritée celles héritées de modèles.
  Attaché sur les groupes

Utilisation d'

expression logique 

Il est possible d'utiliser des expressions logiques afin de mieux maitriser l'attachement d'un check. Les propriétés qui acceptent les expressions logiques sont :

• Attaché sur les groupes d'hôtes pour lesCheck appliqué à l'hôte ou Check appliqué au modèle d'hôte.
• Cette propriété est utilisée pour attacher ce check sur un ou plusieurs groupes d'hôtes.
  Utilisez la virgule (,) pour spécifier plusieurs hôtes.
  Attaché sur les hôtes (pour les Checks appliqués à l'hôte)
  Cette propriété est utilisée pour attacher ce check sur un ou plusieurs hôtes.
  Utilisez le menu déroulant pour spécifier un ou plusieurs hôtes.
  Attaché sur les modèles d'hôtes (pour les Checks appliqués aux modèles d'hôtes)

  Cette propriété est utilisée pour attacher ce check sur un ou plusieurs modèles d'hôtes.

  Panel
  Image Removed

• La page Logique des modèles décrit l'utilité des modèles d'hôtes et vous aidera à comprendre l'utilisation de cette propriété.

• Cliquer sur le champs (1) pour faire apparaître le menu déroulant (4) afin de sélectionner un ou plusieurs modèles d'hôtes.

• L'affichage du menu déroulant (4) s'adaptera à la saisie en cours (1).

• L'entête du menu déroulant (2) affiche le filtre actif ( la saisie en cours) mais également le nombre d'éléments filtrés par la saisie sur le nombre d'éléments total (3). 

Le champ d'édition permet de définir une expression conditionnelle. Cette expression va déterminer sur quels modèles d'hôtes le check va être attaché.

ExpressionDescriptionmodèleLe check s'attache sur tous les hôtes héritant de modèlemodèle1 | modèle2Le check s'attache sur tous les hôtes héritant soit de modèle1, soit de modèle2, soit des deux modèlesmodèle1 & modèle2Le check s'attache sur tous les hôtes héritant à le fois de modèle1 et de modèle2!modèleLe check s'attache sur tous les hôtes n'héritant pas de modèle( expression )Tous ces opérateurs peuvent être combinés et les parenthèses peuvent être utilisées pour former des expressions plus complexes

Une expression ne respectant pas ces règles ou comportant un caractère non autorisé provoquera un compteur d'erreur

URL externe
Cette propriété est utilisée pour définir une URL qui peut être utilisée pour fournir plus d'informations sur cet hôte.
N'importe quelle URL valide peut être mise, commençant par http://
Cette URL sera disponible dans l'interface de visualisation dans le volet détail présentant l'hôte.
Cela peut être pratique si vous désirez faire une description écrite détaillée de l'hôte, une procédure de reprise sur panne, ... qui sera visible pour les autres membres de l'équipe.
 Une url qui ne commence pas par http:// ou https:// provoquera un compteur erreur

• Liste des URL externes
  • Clé d'import: notes_multi_url

Cette propriété est utilisée pour définir plusieurs URL qui peuvent être utilisées pour fournir plus d'informations sur cet hôte.

Ces URL seront disponibles pour tout module accroché au module ( ex: dans l'interface de Visualisation, elles seront affiché ).Cela peut être pratique si vous désirez faire une description écrite détaillée de l'hôte, une procédure de reprise sur panne, ou toute autre information qui sera visible pour les autres membres de l'équipe.
 Une URL qui ne commence pas par http:// ou https:// provoquera un compteur erreur
ActivéPermettre que cet élément soit pris en compte lors du passage de Staging en Production.
PackCette propriété permet de définir dans quel pack se trouve le check.

Onglet Données

• hôte pour un Check appliqué au modèle d'hôte.
• Attaché sur les modèles de cluster pour un Check appliqué au modèle de cluster.

Liste des opérateurs utilisable dans une expression logique dans leur ordre d'évaluation :

1. ! :  négation
   
2. & ou + : et logique
   
3. | ou , : ou logique

Exemples d'utilisation d'expression logique : 

( Les exemples sont donnés dans le cas de check appliqué à un modèle d'hôte, mais le comportement des expressions complexes est identique pour un check appliqué sur les groupes d'hôtes ou un check appliqué sur les modèles de cluster. )

linux&!windows

 Le check s'applique sur tous les hôtes héritant du modèle linux mais pas du modèle windows

pop3 & ( smtp | smtps )

Le check s'applique sur tous les hôtes héritant des modèles smtp et pop3, ou les modèles smtps et pop3

!esx

Attaché sur les groupes d'hôtes

• Clé d'import: hostgroup_name
  Cette propriété est utilisée pour attacher ce check sur un ou plusieurs groupes d'hôtes.
  Utilisez la virgule (,) pour spécifier plusieurs groupes d'hôtes. Tous les hôtes appartenant à un des groupes aura le check accroché. Il est possible d'utiliser des expressions logiques.

Attaché sur les hôtes ( pour les Checks appliqués à l'hôte ) ou Attaché sur les clusters

• Clé d'import: host_name
  Cette propriété est utilisée pour attacher ce check sur un ou plusieurs hôtes ( ou clusters ).
  Utilisez le menu déroulant pour spécifier un ou plusieurs hôtes ( ou clusters ).

Attaché sur les modèles d'hôtes ( pour les Checks appliqués aux modèles d'hôtes ) ou Attaché sur les modèles de clusters

• Clé d'import: host_name
  Cette propriété est utilisée pour attacher ce check sur un ou plusieurs modèles d'hôtes ( ou clusters ). Utiliser les virgules pour spécifier plusieurs modèles. Tous les hôtes  ( ou clusters )  héritant d'un des modèles spécifiés auront le check accroché.

  
  

  Panel
  Image Added

  La page Logique des modèles décrit l'utilité des modèles d'hôtes ( ou clusters ) et décrit l'utilisation de cette propriété.

  Cliquer sur le champ (1) pour faire apparaître le menu déroulant (4) afin de sélectionner un ou plusieurs modèles d'hôtes( ou clusters ).
  L'affichage du menu déroulant (4) s'adaptera à la saisie en cours (1).
  L'entête du menu déroulant (2) affiche le filtre actif ( la saisie en cours ) mais également le nombre d'éléments filtrés par la saisie sur le nombre d'éléments total (3). 
  Il est possible d'utiliser des expressions logiques.
  
  

Impact métier

• Clé d'import: business_impact
  Cette propriété permet de définir l'importance que l'on donne à un check pour le business. ( valeur numérique entre 0 et 5 dans les fichiers d'imports, mais affichée dans l'interface avec des étoiles ou des dollars suivant le niveau ):
  • du moins important ( 0 => * )
  • ( 1 => ** )
  • ( 2 => *** )
  • ( 3 => $$$$ )
  • ( 4 => $$$$$ )
  • au plus important ( 5 => $$$$$$ )
  La valeur par défaut est 2 ( *** ).

URL externe

• Clé d'import : notes_url
  Cette propriété est utilisée pour définir une URL qui peut être utilisée pour fournir plus d'information sur ce check.
  N'importe quelle URL valide peut être mise, commençant par http:// ou https://
  
  Cette URL sera disponible dans l'interface de visualisation dans le volet détail présentant le check.
  Cela peut être pratique pour faire une description écrite détaillée du check, une procédure de reprise sur panne... qui sera visible pour les autres membres de l'équipe.

  Info
  Une URL qui ne commence pas par http:// ou https:// provoquera un compteur d'erreur et il sera impossible d'enregistrer le check Les caractères "' et les espaces sont interdits dans ce champ .  Un caractère non autorisé provoquera un compteur d'erreur et il sera impossible d'enregistrer le check

Liste des URL externes

• Clé d'import : notes_multi_url
  
  Cette propriété est utilisée pour définir plusieurs URL qui peuvent être utilisées pour fournir plus d'informations sur ce check.

(1) Nom de l'URL ( label pour l'interface de visualisation ), Le nom à afficher est optionnel ( mais son absence montrera toujours un warning dans l'interface )

(2) Adresse de l'URL, N'importe quelle URL valide peut être utilisée, commençant par  http://  or  https://

(3) Icône pour l'UI de visualisation
(4) Type d'affichage dans l'interface de Visualisation

• Nouvel onglet,

• Pop-up de différente taille ( 30%, 40%, 50%, 60%, 70%, 80% de la taille de l'écran )

• Caché

(5) Valeur à copier-coller dans un fichier .cfg pour retrouver cette propriété dans l'état

(6) Passer la souris en survol du champ format fichier .cfg pour faire apparaître les boutons de copie du format ( gauche ) et d'édition du format ( droite ).

• Le bouton d'édition permet d'éditer la propriété URL externe soit en collant un format précédemment copié ou bien en écrivant le format.

Activé

• Clé d'import : enabled
  
  Permettre que cet élément soit pris en compte lors du passage de Staging en Production.

 Pack

• Clé d'import : pack

Permet de donner un nom commun à un ensemble d'éléments de Shinken.Ilsera ainsipossibledefiltrerpar ce nom commun dans les listes des éléments pour retrouver l'ensemble des éléments.

Cette propriété n'est pas héritable.

Onglet Données

Cet onglet définit des données qui pourront être utilisées par des variables ( voir la page Les Variables ( Remplacement dynamique de contenu - Anciennement les Macros )), notamment à l'utilisation de la commande ( voir la page Les commandes) de check. Consultez ces pages pour plus d'info

La valeur de la données pouvant être longue, il est possible d'agrandir le champ de la valeur afin d'améliorer la lisibilité du champs.

Pour agrandir le champ de la valeur, il faut maintenir le clic sur l'icône Image Addedsituée en bas à droite du champ et réajuster verticalement . 

Onglet Supervision

Période de maintenance planifiée

• Clé d'import : maintenance_period
  Cette propriété permet de définir une période de temps pendant laquelle le check sera en maintenance.
  En maintenance, les checks de l'hôte ( ou cluster ) seront toujours exécutés ( donc il n'y aura pas de manques dans les métriques ou l'historique de l'hôte ), mais les notifications et les commandes du gestionnaire d’événement ne seront pas lancées.

Vérification du statut de l'élément

Actif

Actif activé

• Clé d'import : active_checks_enabled
  Cette propriété permet de définir si Shinken ordonnance et lance la commande de vérification pour déterminer l'état de ce check.
  Ses valeurs peuvent être:
  • True: Shinken va ordonnancer et lancer la commande de vérification
  • False: Shinken ne va pas ordonnancer et lancer la commande de vérification

Commande de vérification

• Clé d'import : check_command
  Cette propriété permet de spécifier la commande qui est employée pour vérifier si le check est dans un statut en OK ou CRITIQUE.
  Si la propriété est vide, la commande de contrôle par défaut sera employée.
  
  Pour le passage de plusieurs arguments, le séparateur est !
  Exemple : mavaleur1!mavaleur2
  Pour Duplicate For Each : $VALUE1$!$VALUE2$
  

  Info
  Ce champ ne peut pas rester vide

Tag de poller

• Clé d'import : poller_tag
  Cette propriété permet de définir le poller_tag du check.
  Le check ne sera exécuté que par les Pollers ayant cette valeur dans la liste des Tags définie dans leur paramètre poller_tags.
  Par défaut, la valeur de Tag de Poller est "même comportement que son parent ( hôte ou cluster )".
  Si la valeur est "non tagué" :
  • Tous les Pollers n'ayant aucun poller_tag seront utilisés pour l'exécution
  • Ou tous les Pollers spécifiant qu'ils prennent aussi les checks non tagués

Période de vérification

• Clé d'import : check_period
  Cette propriété permet de choisir la période de supervision où sont faites les vérifications de l'état du check par Shinken.

Nombre maximum de tentatives de confirmation du statut du check

• Clé d'import : max_check_attempts
  Cette propriété permet de définir le nombre de tentatives où Shinken recommencera la commande de vérification d'un check si son résultat est autre chose que le statut OK.
  Mettre cette valeur à 1 impliquera que Shinken générera une alerte dès qu'il n'est plus en état OK, sans réessayer.
  Pour que Shinken ne fasse plus de vérification de statut de ce check, laissez cette propriété à 1, mais la commande de vérification doit être vide.
  
  

Intervalle entre les vérifications ( minutes )

• Clé d'import : check_interval
  Cette propriété permet de définir le temps entre deux vérifications de l'état du check.

  Info
  La limite est fixée à 2630880 ( soit cinq ans ).

  Info
  Une valeur non numérique provoquera un compteur erreur.

Intervalle de nouvelles tentatives de vérification d'état ( minutes )

• Clé d'import : retry_interval
  Cette propriété permet de définir le temps d'attente avant de relancer la commande de vérification du check après un premier état différent de OK.
  Ce nombre est en minutes.
  Une fois que le nombre de relances de commandes de vérifications a atteint la valeur max_check_attempts, le dernier état récupéré est validé et la cadence des vérifications revient à la valeur normale, définie dans la propriété Intervalle entre les vérifications.

Temps maximum d'exécution d'un check ( secondes )

• Clé d'import : check_running_timeout
  Cette propriété permet de définir la valeur en secondes du temps maximum permis pour le lancement d'une commande de supervision. Passé ce délai, la commande sera terminée. Si le check ou la commande définit également ce paramètre, leur valeur sera prioritaire par rapport à celle de l'hôte ( ou cluster ).
• Aucune valeur ou une valeur a -1, indique qu'il n'y a pas de Temps maximum défini.
  Si ni l'hôte ( ou clusters ), ni le check, ni la commande ne définissent ce paramètre, alors la valeur définie globalement pour Shinken ( via le fichier shinken.cfg et le paramètre check_running_timeout ) sera utilisée à la place.

Seuil d'alerte de l'utilisation CPU ( secondes )

• Clé d'import : warning_threshold_cpu_usage
  Nombre de secondes que peut consommer une commande avant d'apparaître en Warning dans le check 'Scheduler - Performance'.
  La valeur sera récupérée dans l'ordre, par la commande, par l'élément Check, par l'élément Hôte ( ou clusters ), ou par la valeur par défaut ( shinken.cfg:warning_threshold_cpu_usage )

Passif

Passif activé

• Clé d'import : passive_checks_enabled
  Cette propriété permet de définir si Shinken accepte les résultats de commandes de checks depuis des outils externes pour cet hôte ( ou clusters )
• Les résultats externes seront reçu via le démon Receiver de Shinken.
  Les valeurs possibles sont:
  • True: accepte les résultats de commandes de checks externes
  • False: n'accepte pas ces résultats

Vérification que l'état reçu des outils externes ne soit pas expiré

• Clé d'import : check_freshness
  Cette propriété permet de définir si Shinken doit vérifier que la date de réception du dernier état reçu des outils externes ne soit pas expirée ( trop vieille ). Si la date est plus antérieure à la période d'expiration, alors Shinken va forcer l'exécution de la commande de check.
  Ses valeurs peuvent être:
  • Activé: Shinken va vérifier l'expiration
  • Désactivé: Shinken ne vérifiera pas l'expiration

Seuil d'expiration des états reçus des outils externes ( secondes )

• Clé d'import : freshness_threshold
  Cette propriété permet de définir quand Shinken doit forcer la commande pour check si le dernier état reçu des outils externes est antérieur à ce seuil.
  Cette valeur est en secondes.

  Info
  La limite est fixée à 2630880 ( soit 5 ans ).

  Info
  Une valeur non numérique provoquera un compteur erreur.

Duplicate for Each

Nom de la donnée sur l'hôte ( ou cluster ) qui contiendra les valeurs utilisées pour la duplication des checks

• Clé d'import : duplicate_foreach
  Cette propriété est utilisée pour générer plusieurs checks dans l'Arbiter

Onglet Supervision

• Période de DOWNTIME récurrente
  Cette propriété permet de définir une période de temps pendant laquelle l'hôte sera en maintenance.
  En maintenance, les checks de l'hôte seront toujours exécutés (donc il n'y aura pas de manques dans les métriques ou l'historique de l'hôte), mais les notifications et les commandes du gestionnaire d’événement ne seront pas lancées.
  Période de vérification
  Cette propriété permet de choisir la période de supervision où sont faites les vérifications de l'état de l'hôte par Shinken.
  Commande de vérification
  Cette propriété permet de spécifier la commande qui est employée pour vérifier si le check est dans un statut en OK ou CRITIQUE.
  Si vous laissez vide cette propriété, la commande de contrôle par défaut sera employée.
  Ce champ ne peut pas rester vide
  Nombre maximum de tentatives de confirmation du statut du check
  Cette propriété permet de définir le nombre de tentatives où Shinken recommencera la commande de vérification d'un check si son résultat est autre chose que le statut OK
  Mettre cette valeur à 1 impliquera que Shinken générera une alerte dès qu'il n'est plus en état OK, sans réessayer
  Si vous ne désirez pas que Shinken fasse de vérification de statut de ce check, laissez cette propriété à 1, mais la commande de vérification doit être vide
  Une valeur non numérique provoquera un compteur erreur
  Ce champ ne peut pas rester vide
  Intervalle entre les vérifications (X minutes)
  Cette propriété permet de définir le temps entre 2 vérifications de l'état du check.
  Une valeur non numérique provoquera un compteur erreur
  Ce champ ne peut pas rester vide
  Intervalle de nouvelles tentatives de vérification d'état (X minutes)
  Cette propriété permet de définir le temps d'attente avant de relancer la commande de vérification du check après un premier état différent de OK.
  Ce nombre est en minutes.
  Une fois que le nombre de relances de commandes de vérifications a atteint la valeur max_check_attempts, le dernier état récupéré est validé et la cadence des vérifications revient à la valeur normale, définie dans la propriété Intervalle entre les vérifications
  Une valeur non numérique provoquera un compteur erreur
  Ce champ ne peut pas rester vide
  Temps maximum d'exécution d'un check
  Cette propriété permet de définir la valeur en secondes du temps maximum permis pour le lancement d'une commande de supervision. Passé ce délai, la commande sera terminée. Si le check ou la commande définit également ce paramètre, leur valeur sera prioritaire par rapport à celle de l'hôte.
  Aucune valeur ou une valeur a -1, indique qu'il n'y a pas de Temps maximum défini.
  Si ni l'hôte, ni le check, ni la commande ne définissent ce paramètre, alors la valeur définie globalement pour Shinken (via le fichier shinken.cfg et le paramètre check_running_timeout) sera utilisée à la place.
  Une valeur non numérique provoquera un compteur erreur
  Seuil d'alerte de l'utilisation CPU (sec)
  Nombre de secondes que peut consommer une commande avant d'apparaître en Warning dans le check 'Scheduler - Performance'
  La valeur sera récupérée dans l'ordre, par la commande, par l'élément Check, par l'élément Hôte, ou par la valeur par défaut (shinken.cfg:warning_threshold_cpu_usage)
  Une valeur non numérique provoquera un compteur erreur
  Les commandes de vérifications sont ordonnancées et lancées par Shinken
  Cette propriété permet de définir si Shinken ordonnance et lance la commande de vérification pour déterminer l'état de ce check.
  Ses valeurs peuvent être:
• True: Shinken va ordonnancer et lancer la commande de vérification
False: Shinken ne va pas ordonnancer et lancer la commande de vérification
Shinken accepte les états reçus depuis des outils externes pour cet hôte
Cette propriété permet de définir si Shinken accepte les résultats de commandes de checks depuis des outils externes pour cet hôte.
Les résultats externes seront reçu via le démon Receiver de Shinken.
Les valeurs possibles sont:
• True: accepte les résultats de commandes de checks externes
False: n'accepte pas ces résultats
Duplicate for each - Dupliqué pour chaque valeur de la Donnée de l'hôte
Cette propriété est utilisé pour générer plusieurs checks dans l'arbiter avec une seule définition de check dans le Synchronizer. Shinken comprend cette propriété comme : Crée un check pour chaque Valeur valeur de cette propriété.

Le nom du check doit contenir un $KEY$.
En créant un check pour chaque valeur, Shinken remplacera le $KEY$ par cette Valeur.
$KEY$ est aussi utilisable dans la commande de vérification check command si nécessaire, pour son exécution.
Des paramètres peuvent être fournis aux checks ( appelés appelé $VALUE$ si il n' y en a qu'un ou $VALUE_x_$, avec x valant de 1 à n ).

Métrologie

Lire et stocker les métriques

• Clé d'import : process_perf_data
  
  Notifications activéesCette propriété permet de définir si Shinken va envoyer des notifications aux utilisateurs listés comme cibles ( Utilisateurs ou Groupes d'utilisateurs) sur ce check.
• Les notifications sont envoyées:
  • Premièrement après la fin de la période de nouvelle tentative, une fois que l'état CRITICAL est confirmé.
  • ensuite après chaque intervalle de notification, exprimé en minutes
  • quand l'hôte redevient OK
doit lire et stocker les métriques issues de la commande de vérification du check.
Les valeurs possibles sont:
• Vrai: Shinken va envoyer les notificationslire et stocker les métriques issues de la commande de vérification
• Faux: Shinken n'enverra pas les notifications
  
UtilisateursCette propriété est utilisée pour définir quels sont les utilisateurs à notifier.
Groupes d'utilisateurs
Cette propriété est utilisée pour définir quels sont les groupes d'utilisateurs à notifier.
Intervalle de temps entre les notifications (x minutes)
Cette propriété permet de définir les intervalles de temps entre les notifications.
Cette valeur est en minutes.
Note: la valeur 0 sur cette propriété signifie que seule la première notification sera envoyée.
Une valeur non numérique provoquera un compteur erreur
Période de temps de notification
Cette propriété permet de définir la période de temps durant laquelle les notifications sont autorisées.
En dehors de cette période, aucune notification ne sera envoyée.
Par défaut, il n'y a pas de période de temps, et donc les notifications ne seront jamais bloquées.
Options de notification
Cette propriété permet de définir quels sont états de l'hôte qui provoquent l'envoi des notifications
La valeur est une liste d'options séparées par des virgules:
• d: envoie une notification sur un état CRITIQUE
• r: envoie une notification lors d'un rétablissement (signifie que l'hôte redevient OK)
• f: envoie une notification quand l'hôte commence ou sort du contexte FLAPPING
• s: envoie une notification quand l'hôte entre ou sort d'une période de maintenance
n: n'envoie aucune notification
Par défaut, toutes les notifications sont autorisées.
Une option non autorisée provoquera un compteur erreur
Décalage de la première notification
Cette propriété permet de définir combien de minutes Shinken doit attendre avant d'envoyer la première notification.
Ce temps additionnel peut être mis à profit par les utilisateurs pour prendre en compte l'hôte depuis l'interface de visualisation avant que la notification ne soit envoyée.
Par défaut la valeur est 0, ceci signifie que la première notification sera envoyée sans attendre.
Une valeur non numérique provoquera un compteur erreur

• Escalades
  • Cette propriété permet de lier ce check à une ou plusieurs définitions d'escalade.
    Si, au bout d'un certain temps (défini dans l'escalade), le check n'est toujours pas revenu OK ou pas pris en compte (Contexte ACKNOWLEDGE ou DOWNTIME), la règle d'escalade sera appliquée.

Onglet Expert

• • ne va pas lire et stocker les métriques issues de la commande de vérification

SLA

Seuil d'avertissement

• Clé d'import : sla_warning_threshold
  
  Cette propriété permet de définir un seuil d'avertissement pour le module SLA.
  La valeur doit être un nombre décimal entre 0 ( inclus ) et 100 ( inclus ) avec jusqu'à 3 chiffres après la virgule.
  
  

Seuil critique

• Clé d'import : sla_critical_threshold
  
  Cette propriété permet de définir un seuil critique pour le module SLA.
  La valeur doit être un nombre décimal entre 0 ( inclus ) et 100 ( inclus ) avec jusqu'à 3 chiffres après la virgule.

Onglet Notifications

Notifications activées

• Clé d'import : notifications_enabled
  Cette propriété permet de définir si Shinken va envoyer des notifications aux utilisateurs listés comme cibles ( Utilisateurs ou Groupes d'utilisateurs ) sur ce check.
  Les notifications sont envoyées:
  • Premièrement après la fin de la période de nouvelle tentative, une fois que l'état CRITICAL est confirmé.
  • Ensuite après chaque intervalle de notification, exprimé en minutes
  • Quand le check redevient OK
  
  Les valeurs possibles sont:
  • Vrai: Shinken va envoyer les notifications
  • Faux: Shinken n'enverra pas les notifications

Utilisateurs

• Clé d'import : contacts
  Cette propriété est utilisée pour définir quels sont les utilisateurs à notifier.

Groupes d'utilisateurs

• Clé d'import : contacts_groups
  Cette propriété est utilisée pour définir quels sont les groupes d'utilisateurs à notifier.

Intervalle de temps entre les notifications ( minutes )

• Clé d'import : notification_interval
  Cette propriété permet de définir les intervalles de temps entre les notifications.
  Cette valeur est en minutes.
  
  Note: la valeur 0 sur cette propriété signifie que seule la première notification sera envoyée.

Période de temps de notification

• Clé d'import : notification_period
  Cette propriété permet de définir la période de temps durant laquelle les notifications sont autorisées.
  En dehors de cette période, aucune notification ne sera envoyée.
  
  Par défaut, il n'y a pas de période de temps, et donc les notifications ne seront jamais bloquées.
  

Options de notification

• Clé d'import : notification_options
  Cette propriété permet de définir quels états et contextes du check peuvent envoyer des notifications.
  La valeur est une liste d'options séparées par des virgules:
  • c: envoie une notification sur un état CRITIQUE
  • w: envoie une notification sur un état AVERTISSEMENT
  • u: envoie une notification sur un état INCONNU
  • d:envoie une notification sur un état CRITIQUE et AVERTISSEMENT
  • r: envoie une notification lors d'un rétablissement ( signifie que l’état redevient OK )
  • f: envoie une notification lors de l’entrée ou la sortie en FLAPPING
  • s: envoie une notification lors de l’entrée ou la sortie en DOWNTIME
  • n: désactive toutes les notifications
  Par défaut, tous les états permettent d'envoyer une notification.

Décalage de la première notification ( minutes )

• Clé d'import : first_notification_delay
  Cette propriété permet de définir combien de minutes Shinken doit attendre avant d'envoyer la première notification.
  Ce temps additionnel peut être mis à profit par les utilisateurs pour prendre en compte le check depuis l'interface de visualisation avant que la notification ne soit envoyée.
  
  Par défaut la valeur est 0, ceci signifie que la première notification sera envoyée sans attendre.

Escalades

• Clé d'import : escalations
  Cette propriété permet de lier ce check à une ou plusieurs définitions d'escalade.
  
  Si, au bout d'un certain temps, le check n'est toujours pas revenu OK ou pas pris en compte ( Contexte ACKNOWLEDGE ou DOWNTIME ), la règle d'escalade sera appliquée.
  

Onglet Expert

Envoyer une notification à chaque retour en erreur du check

• Clé d'import : is_volatile
  Cette propriété permet de forcer Shinken à envoyer une notification pour chaque retour en erreur d'un check.
  
  • Si non forcé, Shinken va vérifier l'état du check avant de lancer une notification ( avec un nombre maximum de confirmation du statut ), puis ne va envoyer de notification des notifications que tous lesintervalle  intervals de notifications ( typiquement une fois par jour par défaut ).Mais si
  • Dans le cas contraire cette option est activée, tous ces vérifications systèmes seront désactivéesdésactivés, et une notification sera envoyée pour chaque check retournant un statut en erreur.
    
  Vérification que l'état reçu des outils externes ne soit pas expiréCette propriété permet de définir si Shinken doit vérifier que la date de réception du dernier état reçu des outils externes ne soit pas expirée (trop vieille). Si la date est plus antérieure à la période d'expiration, alors Shinken va forcer l'exécution de la commande de check.
  Ses valeurs peuvent être:
• Activé: Shinken va vérifier l'expiration
Désactivé: Shinken ne vérifiera pas l'expiration


Seuil d'expiration des états reçus des outils externes ( x secondes )

Cette propriété permet de définir quand Shinken doit forcer la commande pour check si le dernier état reçu des outils externes est antérieur à ce seuil.
Cette valeur est en secondes.
Une valeur non numérique provoquera un compteur erreur
Détection du flapping activée
Cette propriété permet de définir si la détection du Contexte FLAPPING est actif sur cette hôte.
Peut être:
• Vrai: active la détection du contexte FLAPPING.
Faux: désactive la détection du contexte FLAPPING.
Options de la détection du flapping
Cette propriété permet de définir quel statut d'un check sont pris en compte pour le calcul de pourcentage de FLAPPING.
C'est une combinaison de l'un ou de plusieurs valeurs:
• o = statut OK
• d = statuts CRITICAL
u = statuts UNREACHABLE
Le séparateur est la virgule.
o est obligatoire.
Exemple: o,d,u
Une option non autorisée provoquera un compteur erreur

• check retournant un statut en erreur.

Paramétrage du Flapping

Détection du flapping activée

• Clé d'import : flap_detection_enabled
  Cette propriété permet de définir si la détection du Contexte FLAPPING est actif.
  Peut être:
  • Vrai: active la détection du contexte FLAPPING.
  • Faux: désactive la détection du contexte FLAPPING.

Options de la détection du flapping

• Clé d'import : flap_detection_options
  Cette propriété permet de définir quel statut d'un check sont pris en compte pour le calcul du % de FLAPPING.
  C'est une combinaison de l'un ou de plusieurs valeurs:
  • o = statuts OK
  • w = statuts WARNING
  • c = statuts CRITICAL
  • u = statuts UNREACHABLE
  Le séparateur est la virgule. La valeur o est obligatoire.
  Exemple: o,w,u

Sortie du Contexte FLAPPING

• Clé d'import : low_flap_threshold
  Sur les 21 derniers statuts, chaque fois qu'un statut est différent du précédent ( de OK à Warning par exemple ), le % de FLAPPING augmente. Donc 10 changements représenteront un % de flapping de 50% et 20 représenteront 100%.
  Si ce % calculé est inférieur au % de sortie du Contexte FLAPPING, alors le Contexte ne sera plus FLAPPING.
  

Entrée du Contexte FLAPPING

• Sortie du Contexte FLAPPINGClé d'import : high_flap_threshold
  Sur les 21 derniers statuts, chaque fois qu'un statut est différent du précédent ( de OK a Warning par exemple ), le % de FLAPPING augmente. Donc pour 10 changements, cela représentera un % de FLAPPING de 50% et pour 20, cela représentera 100%.
  Si ce % calculé est supérieur au % d'entrée dans le Contexte FLAPPING, alors le Contexte de check deviendra FLAPPING.
  Entrée du Contexte FLAPPING
  Sur les 21 derniers Statuts, chaque fois qu'un statut est différent du précédent (de OK a Warning par exemple), le % de Flapping augmente. Donc 10 changements représentera une % de flapping de 50% et 20 représentera 100%.
  Si ce % calculé est supérieur au % de sortie du Contexte FLAPPING, alors le Contexte du check ne sera plus FLAPPING.
  , le % de FLAPPING augmente. Donc pour 10 changements, cela représentera un % de FLAPPING de 50% et pour 20, cela représentera 100%.
  Si ce % calculé est supérieur au % d'entrée dans le Contexte FLAPPING, alors le Contexte deviendra FLAPPING.
  Il sortira de ce Contexte quand ce pourcentage calculé sera inférieur au % de sortie du Contexte FLAPPING.
  

Modulations

Modulations d'impact métier

• Clé d'import : business_impact_modulations
  Cette propriété permet de définir une ou plusieurs modulations d'impact métier. Les modulations ont une période de temps durant laquelle elles sont actives.
  Pendant cette période, la valeur d'impact métier sera changée par celle de la modulation.

Modulations de données

• Clé d'import : macromodulations
  Cette propriété permet de définir une ou plusieurs modulations de données. Les modulations ont une période de temps durant laquelle elles sont actives.
  Pendant cette période, les données du check seront changées par celle de la modulation.
  

Modulations des résultats

• Clé d'import : resultmodulations
  Cette propriété permet de définir une ou plusieurs modulations de résultats. ( maximum 4 )
  Les modulations de résultats redéfinissent le statut de sortie d'un check, en fonction de son statut initial, d'une période de temps, ou de sa sortie.
  

Anchor
event_handler event_handler

Gestionnaire d'événements

Gestionnaire d'événements activé

• Clé d'import : event_handler_enabled
  Lire et stocker les métriques
  Cette propriété permet de définir si Shinken doit lire et stocker les métriques issues de la commande de vérification.
  Les valeurs possibles sont:
• Vrai: Shinken va lire et stocker les métriques issues de la commande de vérification de l'hôte
Faux: Shinken ne va pas lire et stocker les métriques issues de la commande de vérification de l'hôte
Gestionnaire d'événements activé
Cette propriété permet de définir si Shinken va lancer une commande ( définie par le paramètre Commande lancée par le paramètre commande de gestionnaire d'événementsévènements) à des étapes spécifiques du statut de l'hôtedu check:
• quand l'hôte le cehck passe d'un état OK à un état à problème ( CRITICAL ou UNKNOWN )
• à chaque vérification additionnelle, donc un nombre maximum de confirmation du statut

Si la propriété est:
• Vrai: va lancer la commande quand nécessaire
• Faux: ne va pas lancer cette commande
  
Commande lancée par le gestionnaire d'événements
Cette propriété permet de définir la commande que lancera le gestionnaire d’événement pour cet hôte.
Modulations d'impact métier
Cette propriété permet de définir une ou plusieurs modulations d'impact métier. Les modulations ont une période de temps durant laquelle elles sont actives.
Pendant cette période, la valeur d'impact métier du check sera changée par celle de la modulation.
Si aucune modulation d'impact métier n'est définie, le check aura le même comportement que son hôte.
Modulations de données
Cette propriété permet de définir une ou plusieurs modulations de données. Les modulations ont une période de temps durant laquelle elles sont actives.
Pendant cette période, les données du check seront changées par celle de la modulation.
Modulations des résultatsCette propriété permet de définir une ou plusieurs modulations de résultats. (maximum 4). Les modulations de résultats redéfinissent le statut de sortie d'un check, en fonction de son statut initial, d'une période de temps, ou de sa sortie.
Ordre de définition
Ordre de définition

Tag de reactionner

• Clé d'import : reactionner_tag
  Cette propriété permet de définir le reactionner_tag du check.
  La commande du gestionnaire d'événement définie sur ce check sera exécutée uniquement par les Reactionners qui ont dans leur paramètre reactionner_tags la valeur définie par cette propriété.  Remarque : ce Tag n'est utile que pour la commande de Gestionnaire d'événements. Les notifications utilisent le tag défini sur la commande de notification.
  
  Par défaut, la valeur de Tag de Reactionner est non tagué, donc les Reactionners n'ayant aucun reactionner_tag gérons les événements des checks d'un hôte ( ou cluster ) non tagué, car la valeur par défaut pour les Reactionners est aussi non tagué.

Commande lancée par le gestionnaire d'événements

• Clé d'import : event_handler
  Cette propriété permet de définir la commande que lancera le gestionnaire d'évènements.

Autre

Ordre de définition

• Clé d'import : definition_order
  Ordre de définition