On branch 2.5.x

 Changes to be committed:
   (use "git reset HEAD <file>..." to unstage)

	modified:   doc/fr/guide_utilisateur/configuration/10advanced_configuration/03dependancy.rst
	new file:   doc/fr/guide_utilisateur/configuration/10advanced_configuration/04notifications_escalation.rst
	new file:   doc/fr/guide_utilisateur/configuration/10advanced_configuration/05recurrent_downtimes.rst
	modified:   doc/fr/guide_utilisateur/configuration/10advanced_configuration/index.rst

doc/fr/guide_utilisateur/configuration/10advanced_configuration/03dependancy.rst

@@ -11,31 +11,154 @@ Les dépendances sont utilisées afin de répondre à deux besoins :
 * Limiter l'envoi de notifications
 Exemples :
 
-Si un hôte est indisponible, il est nécessaire d'envoyer une notification pour l'hôte indisponible mais l'envoi de notifications pour les services liés à cette hôte doit être désactivé (étant donné que l'hôte ne peut pas être interrogé).
+Si un hôte est indisponible, il est nécessaire d'envoyer une notification pour l'hôte indisponible mais l'envoi de notifications pour les services liés à cette hôte est automatiquement désactivé (étant donné que l'hôte ne peut pas être interrogé).
 
 Si un service est vérifié via le protocole SNMP, si l'agent SNMP de la machine cible est indisponible alors ce service ne peut pas être joint. Une seule notification doit être envoyée : celle pour l'agent SNMP indisponible.
 
 * Mettre en place une hiérarchie entre les hôtes et les services. Un switch est connecté à un hôte. Par conséquent, l'hôte est dépendant de ce switch. Si le switch devient indisponible, alors l'hôte lié à celui-ci est injoignable.
 
+* Limiter la vérification et l'envoi de notifications nécessaires
+
+Exemple :
+Prenons le cas d'un cluster d'hôtes actif/passif. L'hôte A est actif et l'hôte B est passif.
+Les services sont démarrés sur l'hôte A, si l'hôte A devient indisponible alors les services sont démarrés sur l'hôte B.
+
+Notre outil de supervision doit être capable de raisonner de la mannière suivante : si l'hôte A est disponible alors l'hôte B n'est pas vérifié (il est également possible de laisser la vérification de l'hôte B tout en désactivant les notifications liés à cet hôte). 
+Si l'hôte A devient indisponible alors l'hôte B est vérifié.
+
 ********************************************
 Gestion des dépendances avec Centreon Broker
 ********************************************
 
-[ TODO Besoin d'informations]
-
-************************
-Les liens de dépendances
-************************
+[ TODO Besoin d'informations : Ou bien voir en dessous j'ai parlé de Centreon Broker pour les champs spécifiques]
 
+*********
 Les hôtes
----------
+*********
+
+La gestion simple
+-----------------
+
+Au sein de l'onglet **Relations** d'une fiche de configuration d'hôte (**Configuration** ==> **Hôtes** ==> **Ajouter**) il est possible de définir deux paramètres :
+
+* Les hôtes parents : signifie que les hôtes sélectionnés sont parents de l'hôte. Si tous les hôtes parents sélectionnés deviennent indisponible ou injoignable alors l'hôte sera injoignable.
+Exemple : Un hôte est connecté à un switch. Si ce switch tombe en panne, l'hôte n'est plus joignable.
+
+* Les hôtes enfants : signifie que l'hôte devient parent de tous les hôtes enfants sélectionnés
+
+Le principal défaut de cette méthode de configuration est que les hôtes parents et les hôtes enfants doivent être supervisés par le même collecteur de supervision.
 
+La gestion avancée
+------------------
 
+Il est possible de gérer la dépendance entre les hôtes d'une manière plus intelligente. Pour cela :
 
+#. Rendez-vous dans **Configuration** ==> **Notifications**
+#. Dans le menu de gauche, sous le titre **Dépendances**, cliquez sur **Hôtes**
+#. Cliquez sur **Ajouter**
+
+[ TODO Mettre une capture d'écran]
+
+Dans ce cas, nous avons deux types d'hôtes qui entrent en jeu : un ou des hôtes (appelé hôtes maitres) dont le statut contrôle l'exécution et les notifications d'autres hôtes (appelés hôtes dépendants).
+Si vous utilisez Centreon Broker, il est également possible à partir des hôtes maitres de contrôler l'exécution et les notifications de services (appelés services dépendants)
+
+* Les champs **Nom** et **Description** indiquent le nom et la description de la dépendance
+* Le champ **Relation de parenté** est à ignorer si vous utilisez Centreon Engine. Si il est activé, alors si les liens de dépendances de l'hôte maitre deviennent indisponible la dépendance en cours de création n'est plus pris en compte.
+* Le champ **Critères d'échec d'exécution** indique quels sont les statuts du ou des hôtes maitres qui empecheront la vérification des hôtes ou des services dépendants
+* Le champ **Critères d'échec de notification** indique quels sont les statuts du ou des hôtes maitres qui empecheront l'envoi de notifications pour les hôtes ou les services dépendants
+* La liste **Nom d'hôtes** définie le ou les hôtes maitres
+* La liste **Nom d'hôtes liés** définie les hôtes dépendants
+* La liste **Services dépendants** définie les services dépendants
+* Le champ **Commentaire** permet de commenter la dépendance
+
+************
 Les services
-------------
+************
 
+Pour ajouter une dépendance au niveau des services :
 
+#. Rendez-vous dans **Configuration** ==> **Notifications**
+#. Dans le menu de gauche, sous le titre **Dépendances**, cliquez sur **Services**
+#. Cliquez sur **Ajouter**
 
+[ TODO Mettre une capture d'écran]
+
+Dans ce cas, nous avons deux entités qui entrent en jeu : les services (dits maitres) qui contrôlent l'exécution et les notifications d'autres services (dits dépendants).
+Si vous utilisez Centreon Broker, il est également possible de contrôler l'exécution et les notifications d'autres hôtes.
+
+* Les champs **Nom** et **Description** indiquent le nom et la description de la dépendance
+* Le champ **Relation de parenté** est à ignorer si vous utilisez Centreon Engine. Si il est activé, alors si les liens de dépendances du service maitre deviennent indisponible la dépendance en cours de création n'est plus pris en compte.
+* Le champ **Critères d'échec d'exécution** indique quels sont les statuts du ou des services maitres qui empecheront la vérification des hôtes ou des services dépendants
+* Le champ **Critères d'échec de notification** indique quels sont les statuts du ou des services maitres qui empecheront l'envoi de notifications pour les hôtes ou les services dépendants
+* La liste **Services** définie le ou les services maitres
+* La liste **Services dépendants** définie les services dépendants
+* La liste **Hôtes dépendants** définie les hôtes dépendants
+* Le champ **Commentaire** permet de commenter la dépendance
+
+***********
 Les groupes
------------
+***********
\ No newline at end of file
+
+Les groupes d'hôtes
+-------------------
+
+Pour ajouter une dépendance au niveau des groupes d'hôtes :
+
+#. Rendez-vous dans **Configuration** ==> **Notifications**
+#. Dans le menu de gauche, sous le titre **Dépendances**, cliquez sur **Groupes d'hôtes**
+#. Cliquez sur **Ajouter**
+
+[ TODO Mettre une capture d'écran]
+
+Deux types de groupes d'hôtes : Un groupe d'hôtes est dit maitre s'il contrôle l'exécution et la notification d'autres groupes d'hôtes (dit dépendants).
+
+* Les champs **Nom** et **Description** indiquent le nom et la description de la dépendance
+* Le champ **Relation de parenté** est à ignorer si vous utilisez Centreon Engine. Si il est activé, alors si les liens de dépendances du groupe d'hôte maitre deviennent indisponible la dépendance en cours de création n'est plus pris en compte.
+* Le champ **Critères d'échec d'exécution** indique quels sont les statuts du ou des groupes d'hôtes maitres qui empecheront la vérification des groupes d'hôtes dépendants
+* Le champ **Critères d'échec de notification** indique quels sont les statuts du ou des hôtes maitres qui empecheront l'envoi de notifications pour des groupes d'hôtes dépendants
+* La liste **Nom du groupe d'hôte** définie le ou les groupes d'hôtes maitres
+* La liste **Nom des groupes d'hôtes liés** définie le ou les groupes d'hôtes dépendants
+* Le champ **Commentaire** permet de commenter la dépendance
+
+Les groupes de services
+-----------------------
+
+Pour ajouter une dépendance au niveau des groupes de services :
+
+#. Rendez-vous dans **Configuration** ==> **Notifications**
+#. Dans le menu de gauche, sous le titre **Dépendances**, cliquez sur **Groupes de services**
+#. Cliquez sur **Ajouter**
+
+[ TODO Mettre une capture d'écran]
+
+Deux types de groupes de services : Un groupe de services est dit maitre s'il contrôle l'exécution et la notification d'autres groupes de services (dit dépendants).
+
+* Les champs **Nom** et **Description** indiquent le nom et la description de la dépendance
+* Le champ **Relation de parenté** est à ignorer si vous utilisez Centreon Engine. Si il est activé, alors si les liens de dépendances du groupe de service maitre deviennent indisponible la dépendance en cours de création n'est plus pris en compte.
+* Le champ **Critères d'échec d'exécution** indique quels sont les statuts du ou des groupes de services maitres qui empecheront la vérification des groupes de services dépendants
+* Le champ **Critères d'échec de notification** indique quels sont les statuts du ou des hôtes maitres qui empecheront l'envoi de notifications pour des groupes de services dépendants
+* La liste **Nom des groupes de services** définie le ou les groupes de services maitres
+* La liste **Nom des groupes de services liés** définie le ou les groupes de services dépendants
+* Le champ **Commentaire** permet de commenter la dépendance
+
+*****************
+Les méta-services
+*****************
+
+Pour ajouter une dépendance au niveau des méta-services :
+
+#. Rendez-vous dans **Configuration** ==> **Notifications**
+#. Dans le menu de gauche, sous le titre **Dépendances**, cliquez sur **Méta-services**
+#. Cliquez sur **Ajouter**
+
+[ TODO Mettre une capture d'écran]
+
+Deux types de méta-services : Un méta-service est dit maitre s'il contrôle l'exécution et la notification d'autres méta-services (dit dépendants).
+
+* Les champs **Nom** et **Description** indiquent le nom et la description de la dépendance
+* Le champ **Relation de parenté** est à ignorer si vous utilisez Centreon Engine. Si il est activé, alors si les liens de dépendances du méta-service maitre deviennent indisponible la dépendance en cours de création n'est plus pris en compte.
+* Le champ **Critères d'échec d'exécution** indique quels sont les statuts du ou des méta-services maitres qui empecheront la vérification des méta-services dépendants
+* Le champ **Critères d'échec de notification** indique quels sont les statuts du ou des méta-services qui empecheront l'envoi de notifications pour des méta-services dépendants
+* La liste **Nom du méta-service** définie le ou les méta-services maitres
+* La liste **Nom des méta-services liés** définie le ou les méta-services dépendants
+* Le champ **Commentaire** permet de commenter la dépendance
\ No newline at end of file

doc/fr/guide_utilisateur/configuration/10advanced_configuration/04notifications_escalation.rst

+==============================
+Les escalades de notifications
+==============================
+
+**********
+Définition
+**********
+
+Par défaut, une notification permet de contacter un ou plusieurs contacts (ou groupes de contacts) en cas de déclenchement d'une alerte. 
+De même, il est possible d'envoyer plusieurs notifications suivant un intervalle de temps régulier.
+
+Une escalade de notifications permet de contacter différents groupes de contacts au fil des notifications envoyées.
+La définitin d'une escalade de notification pour un hôte, un groupe d'hôte, un service, un groupe de services ou un méta-service écrase la configuration classique des notifications pour cet objet.
+
+Exemple : Un service A est paramétré pour envoyer des notifications à un groupe de contact "A" en cas de statut non-OK. Ces notifications sont envoyées toutes les 5 minutes.
+Si pendant un certain nombre de notifications envoyées le statut du service est toujours en non-OK, il est possible de contacter les individus du groupe de contact "B" etc...
+
+Les escalades de notifications sont pratiques dans les cas où il existe dans une société une équipe de support de niveau 1, niveau 2, niveau 3...
+Lorsqu'un problème survient l'équipe de support niveau 1 est contactée. Si pendant un certain temps l'équipe niveau 1 n'a pas réussit à résoudre le problème, l'équipe niveau 2 est
+avertie etc...
+
+*************
+Configuration
+*************
+
+Pour ajouter une escalade de notification :
+
+#. Rendez-vous dans **Configuration** ==> **Notifications**
+#. Cliquez sur **Ajouter**
+
+[ TODO Mettre une capture d'écran]
+
+* Les champs **Nom d'escalade** et **Alias** permettent de définir un nom et un alias à l'escalade de notifications
+* Le champ **Première notification** permet de choisir le numéro de la notification à partir de laquelle le groupe de contact sera averti
+* Le champ **Dernière notification** permet de choisir le dernier numéro de la notification pour lequel ce groupe de contact sera averti. Si le groupe de contact est le dernier niveau de l'escalade. La valeur de ce champ est **0**.
+* Le champ **Intervalle de notification** définit l'intervalle de notifications entre chaque alerte
+* Le champ **Période d'escalade** définit la période temporelle de notifications
+* Les champs **Options d'escalade des hôtes** et **Options d'escalade des services** définissent les statuts d'hôte et de service pour laquelle l'escalade est utilisée
+* La liste **Groupes de contacts liés** définit le groupe de contact à contacter lors du déclenchement de l'escalade
+* Le champ **Commentaire** permet de commenter l'escalade
+
+Application de l'escalade
+-------------------------
+
+Pour sélectionner les différents objets qui seront concernés par cette escalade, les onglets
+**Escalade des hôtes**, **Escalade des services**, **Escalade des groupes d'hôtes**, **Escalade des méta-services**, **Escalade des groupes de services**
+permettent de choisir les objets sur lesquels les escalades sont appliquées.
\ No newline at end of file

doc/fr/guide_utilisateur/configuration/10advanced_configuration/05recurrent_downtimes.rst

+=============================
+Les temps d'arrêts récurrents
+=============================
+
+**********
+Définition
+**********
+
+Un temps d'arrêt est une période de temps durant laquelle les notifications sont désactivées pour un hôte ou un service.
+Les temps d'arrêts sont pratiques lors d'opérations de maintenance sur un hôte ou un service : ils permettent d'éviter de recevoir des alertes de type faux-positif.
+
+Les temps d'arrêts récurrents sont des temps d'arrêts qui reviennent de manière répétitive. 
+
+Exemple : Une sauvegarde des machines virtuelles est effectuée tous les jours de 20h00 à minuit. Ce type de sauvegarde a tendance à saturer l'utilisation CPU de toutes les machines virtuelles.
+Il est nécessaire de programmer des temps d'arrêts récurrents sur les services concernés afin d'éviter de recevoir des notifications de 20h00 à minuit.
+
+Les types de temps d'arrêts
+---------------------------
+
+Il existe deux types de temps d'arrêts :
+
+* Les temps d'arrêts fixe : C'est à dire que le temps d'arrêt a lieu exactement pendant la période de temps définie
+* Les temps d'arrêts flexible : C'est à dire que si pendant la période de temps définie le service ou l'hôte retourne un statut non-OK alors le temps d'arrêt dure un 
+certain nombre de secondes (à définir dans le formulaire) à partir du moment où l'hôte ou le statut a retourné un statut non-OK.
+
+*************
+Configuration
+*************
+
+Pour ajouter un temps d'arrêt récurrent :
+
+#. Rendez-vous dans **Configuration** ==> **Hôtes** (ou **Services**)
+#. Dans le menu de gauche, cliquez sur **Temps d'arrêt**
+#. Cliquez sur **Ajouter**
+
+Configuration des temps d'arrêt
+-------------------------------
+
+* Les champs **Nom** et **Description** permet de donner un nom et de décrire le temps d'arrêt récurrent
+* Le champ **Activer** permet d'activer ou de désactiver le temps d'arrêt
+* Le champ **Période** permet de définir une ou plusieurs période de temps d'arrêts récurrents. Pour ajouter une période, cliquez sur [ TODO Mettre l'image]
+
+Il est possible de choisir trois types de périodes :
+
+* Hebdomadaire : Permet de choisir les jours de semaines
+* Mensuel : Permet de choisir les jours dans un mois
+* Date spécifique : Permet de choisir des dates spécifiques
+
+* Le champ **Jours** permet de définir le ou les jours concernés.
+* Le champ **Période de temps** permet de définir la période de temps concernée (exprimée en HH:MM - HH:MM).
+* Le champ **Type de temps d'arrêt** définit le type de temps d'arrêt souhaité.
+
+Relations
+---------
+
+* La liste **Lié aux hôtes** permet de choisir le ou les hôtes concernés par le temps d'arrêt récurrent
+* Si un groupe d'hôte est choisit avec la liste **Lié avec le groupe d'hôtes** tous les hôtes appartenant à ce groupe sont concernés par le temps d'arrêt récurrent
+* La liste **Lié avec les services** permet de choisir le ou les services concernés par le temps d'arrêt récurrent
+* Si un groupe de service est choisit avec la liste **Linked with Service Groups** [ TODO Pas de traduction disponible : Traduction proposée] tous les services appartenant à ce groupe sont concernés par le temps d'arrêt récurrent
\ No newline at end of file

doc/fr/guide_utilisateur/configuration/10advanced_configuration/index.rst

@@ -7,3 +7,5 @@ Configuration avancée
    01macros
    02metaservices
    03dependancy
+   04notifications_escalation
+   05recurrent_downtimes
\ No newline at end of file