Onglet : Général

Nom

• Clé d'import : host_name
• Cette propriété permet de définir le nom utilisé pour identifier l'hôte.
• Son contenu est accessible par l'intermédiaire de la variable $HOSTNAME$ .

Nom d'affichage pour l'interface de Visualisation

• Clé d'import : visualisation_name
• Cette propriété permet de définir le nom qui sera affiché dans l'interface de Visualisation
• Son contenu est accessible par l'intermédiaire de la variable $HOSTVISUALISATIONNAME$ 

Remarque 1 : Si vous ne spécifiez pas de nom d'affichage pour l'interface de visualisation, la propriété vaudra par défaut le nom de l'hôte.

Remarque 2 : Dans un premier temps, cette valeur est uniquement utilisée pour la Vue météo.

Description

• Clé d'import : display_name
  • Cette propriété permet de définir une description de l'hôte qui pourra être affichée dans les interfaces web.
  • Son contenu est accessible par l'intermédiaire de la variable $HOSTDISPLAYNAME$ .
  • Remarque : 
    • Si vous ne spécifiez pas la propriété, sa valeur par défaut sera le nom de l'hôte.
    • Le nom de ce paramètre display_name peut prêter à confusion, car sa traduction en français signifie nom d'affichage.
      Il s'agit d'une obligation historique.
      Nous avons défini une nouvelle propriété qui sera utilisée pour le nom "d'affichage" dans les interfaces ⇒ visualisation_name.
      
      

Adresse

• Clé d'import : address
  
  Cette propriété permet de définir l'adresse de l’hôte. Habituellement, il s'agit de l'adresse IP, bien que cela puisse être n'importe quelle valeur ( pour peu qu'elle soit utile pour la détermination du statut de l'hôte ).
  Vous pouvez utiliser un FQDN pour l'adresse, mais gardez à l'esprit que si le DNS n'est pas disponible, les vérifications ne pourront pas être faites.
  Son contenu est accessible par l'intermédiaire de la variable  $HOSTADDRESS$  .
  
  

  Si vous ne spécifiez pas une adresse, la propriété vaudra par défaut le nom de l'hôte. Il y a un risque à utiliser le mécanisme par défaut - Si le DNS n'est pas disponible, la plupart des checks échoueront, car les sondes dont ils dépendent ne seront pas capables de résoudre le nom de l'hôte. Un mécanisme de détection des doublons peut être activé par votre administrateur Shinken dans la configuration du Synchronizer. Suivant le seuil de tolérance choisi, les doublons d'adresses entre plusieurs hôtes seront alors signalés via : un avertissement (  principalement pour vous informer qu'autre hôte utilise cette adresse  ). une erreur (  l'hôte pourra être sauvegardé, mais ne pourra pas être mis en supervision  ). ou une interdiction (  la sauvegarde sera bloquée  ). La page "Adresses dupliquées" décrit tous les cas de figure possibles suivant la configuration pour le mécanisme de détection de doublons. HOSTDISPLAYNAME

Modèles d'hôte appliqués

• Clé d'import : use
  
  Les modèles d'hôtes qui sont attachés à l'hôte pour hériter de leurs propriétés et de leurs données.
  L'ordre des modèles est important.

Il existe un code couleur, correspondant aux différents états des modèles d'hôtes. 

Ajouter dans le groupe d'hôtes

• Clé d'import : hostgroups
  
  Cette propriété permet de lister les groupes d'hôtes auxquels cet hôte appartient.
  
  Ajouter un groupe d'hôte à cet hôte a le même effet que de rajouter cet hôte dans le groupe voulu ( dans la page d'édition du groupe d'hôte ).
  
  L'ordre dans lequel vous listez les groupes d'hôtes n'a pas d'incidence.
  Cette propriété gère l'héritage additif ( voir la page Héritage additif (le +) ).

Tout comme pour les modèles d'hôte, il existe un code couleur, correspondant aux différents états des modèles de groupes d'hôtes. Ces derniers reprennent en partie le code couleur déjà expliqué précédemment.

Royaume

• Clé d'import : realm
  
  Cette propriété permet de définir le royaume où l'hôte se trouvera.
  En plaçant l'hôte dans un royaume particulier, un des Schedulers de ce royaume le gérera.

Impact métier

• Clé d'import: business_impact
  
  Cette propriété permet de définir l'importance que l'on donne à un hôte. ( valeur numérique entre 0 et 5 dans les fichiers d'import, 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 => $$$$$$ )

Dépendances réseaux

• Clé d'import : parents
  
  Cette propriété permet de définir une liste d'hôtes ou de Clusters de laquelle l'hôte est dépendant.
  Ceci signifie que si toutes les dépendances réseau sont en état CRITICAL, alors les notifications ne seront pas lancées pour cet hôte et ses checks.
  Note : les dépendances réseau doivent être dans le même royaume que l'hôte.
  
  L'ordre de définition n'a pas d'impact sur la supervision de cet élément.
  Cette propriété gère l'héritage additif ( voir la page Héritage additif (le +) ).

Tout comme les modèles d’hôte, et les modèles de groupes d'hôtes, il existe un code couleur, correspondant aux différents états des dépendances réseau :

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 cet hôte.
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 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.

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.

(1) Nom de l'URL ( label pour l'interface de visualisation ), le nom à afficher est optionnel.

(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.

Ces URL seront disponibles dans l'Interface de Visualisation.

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.

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. Il sera ainsi possible de filtrer par ce nom commun dans les listes des éléments pour retrouver l'ensemble des éléments.

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

Propriétés spécifiques aux modèles d'hôte

Modèle applicable par les administrateurs de SI ?

• Clé d'import : template_can_be_applied_by_si_admin
  

  Cette propriété permet d'autoriser les administrateurs SI à appliquer le modèle sur un hôte.

  Un modèle non applicable par les administrateurs SI reste visible sur l’hôte s’il a déjà été appliqué par un administrateur Shinken.

Onglet : Données

Cet onglet défini des données qui pourront être utilisées en tant que variables ( voir la page  Les Variables ( Remplacement dynamique de contenu - Anciennement les Macros ) ), notamment à l'utilisation de la commande ( voir la page Les commandes ) des checks attachés à cet hôte. Consulter ces pages pour plus d'information.

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

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

Onglet : Droits de l'utilisateur

Il est possible pour chaque hôte de définir qui peut le voir, l'éditer, ou encore recevoir ces notifications. Ces propriétés gèrent l'héritage additif ( voir la page Héritage additif (le +) ).

Lors de la création d'un hôte, l'héritage additif est activé par défaut et l'utilisateur ( Administrateur Shinken ou Administrateur de SI ) créant le cluster est automatiquement ajouté aux droits utilisateurs suivants :

• Les utilisateurs qui voient l'hôte,

• Les utilisateurs à notifier,

• Les utilisateurs qui peuvent modifier la configuration de l'hôte.

Ces propriétés se synchronisent les unes avec les autres, pour éviter d'avoir une incohérence.
Par exemple : un utilisateur qui aurait le droit d'éditer un hôte sans le droit de le voir.

Les accès sont séparés en 3 sections :

• L'accès en visualisation de l'hôte
  
  • Ce paramètre permet d'autoriser certains utilisateurs ou groupes d'utilisateurs à voir l'hôte concerné ( dans l'Interface de Visualisation et dans l'Interface de Configuration ).
  • Il est possible de lister des utilisateurs individuellement, ainsi que des groupes d'utilisateurs.
  • Il est aussi possible, dans cette section, de choisir si l'hôte peut être affiché sur les vues ne nécessitant pas une authentification à Shinken.
• L'accès aux notifications d'un hôte
  
  • Cette section permet de lister les utilisateurs ou les groupes d'utilisateurs qui recevront les notifications de l'hôte.

• L'accès en édition de l'hôte

  • Ce paramètre permet de lister les utilisateurs et les groupes pouvant éditer l'hôte.
  • Pour accéder à l'Interface de Configuration et éditer un hôte l'utilisateur doit au moins être Admin SI ( voir la page Édition d'un utilisateur ).

Code couleur

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 durant laquelle l'hôte sera en maintenance, et en sortira dès que la période de temps sera fini.
  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ènements ne seront pas lancées.

Vérification du statut de l'élément ( ACTIF et PASSIF peuvent être combiné )

Actif ( Les commandes de vérifications sont ordonnancées et lancées par Shinken )

Actif activé

• Clé d'import : active_checks_enabled
  
  Cette propriété permet de définir si Shinken ordonnance et lance les commandes de vérifications pour déterminer l'état de cet hôte.
  Sa valeur peut être :

• Vrai: Shinken va ordonnancer et lancer des commandes de vérifications
• Faux: Shinken ne va pas ordonnancer ni lancer les commandes de vérifications

Vivant ( 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 l'hôte 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.

Affichage des seuils

• Clé d'import : thresholds_display
  
  Cette propriété a pour but de décrire et d'afficher les seuils utilisés sur lesquels la commande de supervision se base afin de déterminer le Statut de l'hôte ( OK, CRITIQUE, ... ).
  Le contenu est libre, donc vous pouvez définir le texte comme bon vous semble.
  
  À savoir :

• • Les données seront interprétées dans le "Rendu final" pour avoir la dynamique de configuration de vos seuils. ( voir la page Les Variables ( Remplacement dynamique de contenu - Anciennement les Macros ) )
  • Le HTML sera interprété.
  • Le rendu sera calculé au chargement de la page, mais il nécessitera l'appui sur le bouton "Mettre à jour" lors d'une édition de l'élément.
  • Dès qu'une propriété ou une donnée influant sur le rendu final sera modifiée, ce dernier sera effacé et devra être mis à jour manuellement.

Tag de Poller

• Clé d'import : poller_tag
  
  Cette propriété permet de définir le poller_tag de l'hôte.
  Si une valeur est définie :
  • La commande de vérification de l'hôte (Vivant) sera exécutée sur les Pollers ayant cette valeur dans la liste des Tags définie dans leur paramètre poller_tags
  • Les checks de l'hôte pourront hériter de ce tag, suivant leur configuration
  
  Par défaut, la valeur de Tag de Poller est "non tagué".
  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 en charge les checks non tagués

Nombre maximum de tentatives de confirmation du statut de l'hôte

• Clé d'import : max_check_attempts
  
  Cette propriété permet de définir le nombre de tentative(s) où Shinken recommencera la commande de vérification d'un hôte 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 vérifie le statut de cet hôte, laissez cette propriété à 1, et renseignez une commande de vérification qui ne fait rien.

Intervalle entre les vérifications ( minutes )

• Clé d'import : check_interval
  
  Cette propriété permet de définir le temps entre 2 vérifications de l'état de l'hôte.
  

Intervalle de nouvelles tentatives de confirmation 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 de l'hôte après un premier état différent de OK.
  
  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 de Check

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.
  
  Aucune valeur ou une valeur a -1, n’indiquent 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.

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 par la valeur par défaut (  via le fichier shinken.cfg et le paramètre warning_threshold_cpu_usage )
  
  

Passif ( Shinken accepte les états reçus depuis des outils externes pour cet élément )

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.
  Les résultats externes seront reçus via le démon Receiver de Shinken.
  Les valeurs possibles sont :

• Vrai : accepte les résultats de commandes de checks externes
• Faux : n'accepte pas ces résultats

Vérifier 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 âgée que le seuil d'expiration, alors Shinken va forcer l'exécution d'une commande de check pour cet élément.
  Sa valeur peut ê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 une commande de vérification pour cet hôte si le dernier état reçu des outils externes est plus âgé que ce seuil.
  
  Cette valeur est en secondes.

Données Collectées

Métrologie

Lire et stocker les métriques

• Clé d'import : process_perf_data
  
  Cette propriété permet de définir si Shinken doit lire et stocker les métriques issues de la commande de vérification de l'hôte.
  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

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 : Checks

Cet onglet détaille la liste des checks qui seront appliqués à l'hôte, et leur provenance ( venant de quel modèle d'hôte, ou directement appliqué à l'hôte ) :

• Tout d'abord, les checks accrochés directement sur l'hôte sont listés.
• Ensuite sont listés les modèles dans l'ordre de leur apparition dans la liste des modèles hérités.
  
  • Et pour chacun leurs checks.
  • Seront aussi listés les checks duplication par la fonctionnalité permettant de dupliquer pour chaque valeur de la donnée de l'hôte ( voir la page Dupliquer des checks en fonction d'une liste de valeurs présentes dans la Donnée d'un hôte (duplicate_foreach) ).
    Ici, dans l'image, un seul check utilise des Duplicate Foreach ( la colonne Duplicate Foreach a une valeur pour ce check ).
    
    
• Sur cet onglet, vous pouvez surcharger les valeurs des checks ( voir la page La surcharge des propriétés pour un check ) et exclure les checks que vous ne voulez pas appliquer sur cet hôte ( voir la page L'exclusion des checks )

Pour chaque check, vous pourrez essayer le check depuis sa configuration actuelle afin de vérifier son résultat.

Filtre rapide pour trouver un check

Filtre actif

Replacer une ligne dans son contexte

Le clic sur l'icône , permet de replacer ce check au milieu des autres check de l'hôte ( les checks qui ne correspondent pas aux filtres réapparaissent avec un fond blanc ).

La ligne qui a été cliqué, sera isolée et le fond bleu permettra de la repérer directement.

Si le filtre retournait plusieurs lignes, elles garderont toutes leur fond bleu, mais seule celle cliqué gardera l'icône œil .

Essayer les checks

Les boutons dans la colonne [ Essayer ce check ] permettent d'évaluer ou d'essayer directement l'exécution d'un check, avec la résolution de ses données.

• Le premier bouton ( roue crantée ) permet de simuler la résolution des arguments, sans l'exécution du check. Cette évaluation vous permettra d'afficher la commande avec les données interprétées.

• Le second bouton ( roue crantée + icône play ) permet d'évaluer et de simuler son exécution depuis la plateforme de configuration ( Synchronizer ). Cette exécution n'utilisera pas vos pollers. Vous pouvez donc utiliser ce bouton pour tester votre commande sans affecter vos serveurs pollers en production.
  Le tableau récapitulatif présente les données récupérées et le résultat de la commande en prenant en compte les éventuelles modulations.

• Le troisième bouton ( icône play ) permet d'évaluer et de simuler son exécution directement sur les Pollers, comme lors de l'exécution normale sur votre architecture Shinken. Vous pouvez donc utiliser ce bouton pour tester votre commande sur votre environnement de production.
  Le tableau récapitulatif présente les données récupérées et le résultat de la commande en prenant en compte les éventuelles modulations.
  
  

  Si votre check utilise des tags de Poller, l'exécution ne peut avoir lieu que si l'un des Pollers définis dans votre architecture dispose d'un tag de Poller correspondant à celui du check que vous essayez. Si le check est dans un sous royaume, il faut que l'un des Pollers du sous-royaume ait le tag recherché ( voir la page Le Poller ).

• Le dernier bouton ( croix ) permet de cacher le bloc d'essai du check.

Exemple de retour :

Les modulations

Lorsqu'une ou plusieurs modulations de résultat ou de données sont associées à l'hôte, au check ou à une surcharge de check, un tag MODULATION est affiché à côté du nom du check sur lequel vont être appliquées la ou les modulations. 

• Si le tag est affiché avec la couleur orange, cela signifie qu'au moins une modulation est désactivée ou en statut Nouveau.
• Dans ce cas, cette ou ces modulations seront ignorées et n'affecteront pas l'exécution du check.

Les modes

Le menu des modes se situe au-dessus de la liste des checks. Il y a trois modes possibles :

Mode normal

Le mode normal est l'affichage basique de la liste des checks, c'est-à-dire sans les fonctionnalités des autres modes.

Mode surcharge

Le mode surcharge fait apparaître des boutons Activer la surcharge ou Surchargé sur chaque ligne de check.

Ce mode permet l'édition ou la suppression de la surcharge des propriétés pour un check ( voir la page La surcharge des propriétés pour un check ).

Mode exclusion

Le mode Exclusion fait apparaître des boutons Exclure spécifiquement ou Exclus spécifiquement sur chaque ligne de check.

Il fait également apparaître la propriété Checks à exclure (par chaîne de caractères).

Lorsqu'un check a été exclu en utilisant cette propriété, il porte le libellé Exclu par nom.

( voir la page L'exclusion des checks )

Affichage particulier

Checks ayant le même nom sur des modèles différent - Caché

Le nom des checks n’étant pas unique, il est possible, selon les modèles utilisés, d’avoir deux checks portant le même nom sur un même élément.

• Dans ce cas, l’ordre d’attachement des modèles détermine quel check sera actif, et lesquels autres seront cachés.

Checks ayant le même nom sur le même modèle - Erreur et caché

Deux checks peuvent avoir le même nom sur un même modèle :

• Dans ce cas particulier, Shinken n’est pas capable de trancher et les deux checks passent en erreur.

Checks dupliqués avec des clés en double dans la donnée Duplicate Foreach - Erreur et caché

Les valeurs dans une donnée doivent toutes être différentes entre elles ( Un, Deux, Trois ), en cas de doublons ( Un, Deux, Un ) une erreur sera présente.

• Dans l'exemple suivant, la donnée DATA contient : Un, Deux, Un. la liste des checks affichera donc une erreur indiquant la valeur en erreur .
• Cliquer dessus, bascule directement vers la donnée pour la corriger.

Checks dupliqués avec un caractère interdit dans le nom - Erreur

Les valeurs dans les données "Duplicate ForEach" seront présents dans le nom du check, il faut donc que ces valeurs respecte les mêmes contraintes que celle que possède le nom d'un check.

• Si une valeur contient un caractère interdit, alors le check apparaitra en erreur,
• et ne pourra pas être sauvegardé.
• le clic sur  conduit à la valeur problématique.

Checks dupliqués utilisant des données chiffrées - Erreur

Les données protégées ( voir la page Chiffrement des données sensibles ) sont interdites dans les données Duplicate Foreach. 

Le check qui utilise de telles données :

• apparaitra en erreur,
• le clic sur  conduit à la donnée problématique.

Checks dupliqués avec une donnée Duplicate Foreach vide - Avertissement et caché

Un check ( non fonctionnel ) utilisant cette donnée est néanmoins créé :

• Il apparaitra en avertissement.
• Le clic sur conduit à la donnée problématique.

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 destinataires ( Utilisateurs ou Groupes d'utilisateurs ) sur cet hôte.
    
    Les notifications sont envoyées :
    • Premièrement lorsqu'un statut non-OK est confirmé.
    • ensuite après chaque intervalle de notification, exprimé en minutes
    • quand le statut de l'hôte redevient OK
    • ( voir la page Logique de notification )
    
    Les valeurs possibles sont :
    • Vrai : Shinken va envoyer les notifications
    • Faux : Shinken n'enverra pas les notifications

Intervalle de temps entre les notifications ( minutes )

• Clé d'import : notification_interval
  
  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.

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.
  
  S'il n'y a pas de période de temps définit ( comportement par défaut ) l'envoi de notification n'est pas impacté par ce paramètre.

Options de notification

• Clé d'import : notification_options
  
  Cette propriété permet de définir quels états et contextes de l'hôte 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 utilisé :
  • pour prendre en compte l'hôte en compte depuis l'interface de visualisation avant que la notification ne soit envoyée.

Par défaut, la valeur est 0, ce qui signifie que la première notification sera envoyée sans délai.

Escalades

• Clé d'import : escalations
  
  Cette propriété permet de lier cet hôte à une ou plusieurs définitions d'escalade.
  Si, au bout d'un certain temps, le statut de l'hôte n'est toujours pas revenu OK ou pas pris en compte ( Contexte ACKNOWLEDGE ou DOWNTIME ), la règle d'escalade sera appliquée.
  
  Cette propriété gère l'héritage additif (le +) ( voir la page Héritage additif (le +) ).

Onglet : Expert

Paramétrage du Flapping

Détection du FLAPPING activé

• Clé d'import : flap_detection_enabled
  
  Cette propriété permet de définir si la détection du Contexte FLAPPING est active sur cet hôte.
  Sa valeur peut être :
  
  • Vrai : active la détection du contexte FLAPPING.
  • Faux : désactive la détection du contexte FLAPPING.

Options de détection du FLAPPING

• Clé d'import : flap_detection_options
  
  Cette propriété permet de définir quels statuts d'un hôte sont pris en compte pour le calcul du pourcentage de FLAPPING.
  C'est une combinaison de l'une ou de plusieurs des valeurs suivantes :
  • o : statut OK
  • d : statuts CRITICAL
  • u : statuts UNREACHABLE
  Le séparateur est la virgule.
  La valeur o est obligatoire.
  
  Exemple : o,d,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 pourcentage de FLAPPING augmente. Donc 10 changements représenteront un pourcentage de FLAPPING de 50% et 20 représenteront 100%.
  Si ce pourcentage calculé est  inférieur  au  pourcentage de sortie du Contexte FLAPPING , alors le Contexte de l'hôte ne sera plus FLAPPING.

Entrée du contexte FLAPPING

• Clé d'import : high_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 pourcentage de FLAPPING augmente. Donc 10 changements représenteront un pourcentage de FLAPPING de 50% et 20 représenteront 100%
  Si ce pourcentage calculé est  supérieur  au  pourcentage d'entrée dans le Contexte FLAPPING , alors le Contexte de l'hôte deviendra FLAPPING.
  Il sortira de ce Contexte quand le pourcentage calculé sera  inférieur au pourcentage 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 temps durant laquelle elles sont actives.
  Pendant cette période, la valeur d'impact métier de l'hôte sera changée par celle de la modulation.
  
  Cette propriété gère l'héritage additif (le +) ( voir la page Héritage additif (le +) ).

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 temps durant laquelle elles sont actives.
  Pendant cette période, les données de l'hôte seront changées par celle de la modulation.
  
  Cette propriété gère l'héritage additif (le +) ( voir la page Héritage additif (le +) ).

Modulations de résultats

• Clé d'import : resultmodulations
  
  Cette propriété permet de définir une ou plusieurs modulations de résultats ( quatre au maximum ). 
  Les modulations de résultats redéfinissent le statut de sortie de l'hote, en fonction de son statut initial, d'une période de temps, ou de sa sortie.
  
  Cette propriété gère l'héritage additif (le +) ( voir la page Héritage additif (le +) ).

Gestionnaire d'événements

Gestionnaire d'événements activé

• Clé d'import : event_handler_enabled
  
  Cette propriété permet de définir si Shinken va lancer une commande ( définie par le paramètre commande de gestionnaire d'événements  ) à des étapes spécifiques lors des changements du statut de l'hôte :
  
  • quand l'hôte passe d'un statut OK à un statut à problème ( CRITICAL ou UNKNOWN )
  • à chaque vérification additionnelle, tant que le statut n'est pas confirmé, donc un nombre maximum de confirmations du statut
  • quand le statut de l'hôte passe d'un statut à problème vers le statut OK 
  • ( voir la page Gestionnaire d'événements )
  Si la propriété est :
  • Vrai : va lancer la commande quand nécessaire
  • Faux : ne va pas lancer cette commande

Tag de Reactionner

• Clé d'import : reactionner_tag
  
  Cette propriété permet de définir le reactionner_tag de l'hôte.
  La commande lancée par le gestionnaire d'événements définie sur cet hôte 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éreront les événements des checks d'un hôte 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 pour cet hôte.