.. _serviceconfiguration:

============
Les services
============

Un service est un point de contrôle lié/rattaché à un hôte.
Par exemple : Pourcentage d'utilisation partition sur un serveur, niveau d'encre sur une imprimante.

Tous les ajouts de services se font dans le menu **Configuration** ==> **Services** ==> **Ajouter**.

.. image :: /images/guide_utilisateur/configuration/03addservice.png
   :align: center 

************************
Configuration du service
************************

Informations générales
======================

*	Le champ **Description** définit le nom du service.
*	Le champ **Modèle de service** indique le modèle de service auquel le service est lié.

Etat du service
===============

*	Le champ **Est volatile** indique si le service est volatile ou non (d'une manière générale uniquement les services passifs sont volatiles).
*	Le champ **Période de contrôle** définit la période temporelle durant laquelle l'ordonnanceur vérifie le statut du service.
*	Le champ **Commande de vérification** indique la commande utilisée pour vérifier la disponibilité du service.
*	Le tableau **Arguments** définit les arguments donnés à la commande de vérification (le nombre d'arguments varie en fonction de la commande de vérification choisie).
*	Le champ **Nombre de contrôles avant validation de l'état** définit le nombre de contrôles à effectuer avant de valider le statut du service. Lorsque le statut est validé, le processus de notification est enclenché.
*	Le champ **Intervalle normal de contrôle** est exprimé en minutes. Il définit l'intervalle entre chaque vérification lorsque le statut du service est OK.
*	Le champ **Intervalle non-régulier de contrôle** est exprimé en minutes. Il définit l'intervalle de validation du statut non-OK du service.
*	Les champs **Contrôle actif activé** et **Contrôle passif activé** activent/désactivent le type de contrôle du service.

Macros
======

La partie **Macros** permet d'ajouter des macros personnalisées.
Les champs **Nom de la macro** et **Valeur de la macro** permettent respectivement de définir le nom et la valeur de la macro.
La case **Mot de passe** permet de cacher la valeur de la macro.

Pour réinitialiser la valeur de la macro (issue du template), cliquez sur |undo|.

Pour ajouter une description à votre macro, cliquez sur |description|.

Pour supprimer la macro, cliquez sur |delete|.

Pour déplacer l'ordre des macros, cliquez sur |move|.

Notification
============

*	Le champ **Notification activée** permet d'activer ou de désactiver les notifications pour l'objet.
*	Le champ **Utiliser les contacts définis sur l'hôte** : permet de faire hériter les contacts depuis la configuration de l'hôte.
*	Si la case **Contacts en complément de ceux hérités** est cochée, alors Centreon n'écrase pas la configuration du modèle de service parent mais ajoute les contacts en complément des contacts définis au niveau du modèle parent.
*	La liste **Contacts liés** indique les contacts qui recevront les notifications.
*	Si la case **Groupes de contacts en complément de ceux hérités** est cochée, alors Centreon n'écrase pas la configuration du modèle de service parent mais ajoute les groupes de contacts en complément des groupes de contacts définis au niveau du modèle parent.
*       Si la case **Inherit only contacts/contacts group from host** est cochée, alors lors de la génération de la configuration, les contacts et/ou groupes de contacts de l’hôte (ou de ses templates suivant l’héritage) viendront écraser ceux du service ou de ses modèles de service. Cette fonction désactive la saisie de contacts et groupes de contacts pour ce service.
*	Au sein de la liste **Groupe de contacts liés** tous les contacts appartenant aux groupes de contacts définis recevront les notifications.
*	Le champ **Intervalle de notification** est exprimé en minutes. Il indique la durée entre chaque envoi de notification lorsque le statut est non-OK. Si la valeur est définie à 0 alors l'ordonnanceur envoie une seule notification par changement de statut.
*	Les **Options de notifications** définissent les statuts pour lesquels une notification sera envoyée.
*	Le **Délai de première notification** est exprimé en minutes. Il fait référence au délai à respecter avant l'envoi d'une première notification lorsqu'un statut non-OK est validé.

****************
Onglet Relations
****************

Relations
=========

*	La liste **Lié aux hôtes** permet de définir le ou les hôtes auxquels lier ce service.
*	La liste **Lié aux groupes de services** permet de lier le service à un ou plusieurs groupes de services.

Traps SNMP
==========

Le champ **Traps SNMP reliés au service** permet de définir les traps SNMP qui pourront modifier le comportement du service.

**********************
Traitement des données
**********************

*   Si le champ **Exécuter une commande post contrôle**  est activé, alors la commande de remontée des contrôles de l'hôte sera activée.
*	Le champ **Contrôler la fraîcheur du résultat** permet d'activer ou de désactiver le contrôle de fraîcheur du résultat.
*	Le champ **Seuil de fraîcheur du résultat** est exprimé en secondes. Si durant cette période aucune demande de changement de statut du service (commande passive) n'a été reçue alors la commande de vérification est exécutée.
*   Le champ **Détection de bagotage des statuts** permet d'activer ou de désactiver la détection du bagotage des statuts (statut changeant trop fréquemment de valeur sur une période donnée).
*   Les champs **Seuil bas de détection de bagotage des statuts** et **Seuil haut de détection de bagotage des statuts** définissent les seuils hauts et bas pour la détection du bagotage en pourcentage de changement.
*	Le champ **Traitement des données de performances** permet d'activer ou de désactiver le traitement des données de performances (et donc la génération des graphiques de performances).
*	Les champs **Rétention des informations de statut** et **Rétention et des informations concernant pas le statut** indiquent si les informations concernant ou ne concernant pas le statut sont sauvegardées après chaque relance de la commande de vérification.
*	Le champ **Options à enregistrer** définit les options à enregistrer si la rétention est activée
*	Le champ **Gestionnaire d'évènements activé** permet d'activer ou de désactiver le gestionnaire d'évènements.
*	Le champ **Gestionnaire d'évènements** définit la commande à exécuter si le gestionnaire d'évènements est activé.
*	Le champ **Arguments** définit les arguments de la commande du gestionnaire d'évènements.

***************************************
Informations supplémentaires du service
***************************************

Centreon
========

*	**Modèle de graphique** : Définit le modèle de graphique à utiliser pour présenter les données de performances liées au service.
*	**Catégories** : Définit la(les) catégorie(s) à laquelle (auxquelles) le service appartient.

Moteur de supervision
=====================

*	Le champ **URL** définit une URL qui peut être utilisée pour donner davantage d'informations sur le service.
*	Le champ **Notes** permet d'ajouter des notes optionnelles concernant le service.
*	Le champ **URL d'action** définit une URL habituellement utilisée pour donner des informations d'actions sur le service (maintenance...).
*	Le champ **Icône** indique l'icône à utiliser pour le service.
*	Le champ **Icône alternative** est le texte utilisé si l'icône ne peut être affichée.
*	Le champ **Niveau de criticité** indique le niveau de criticité du service.

Informations supplémentaires
============================ 

*	Le champ **Statut** permet d'activer ou de désactiver le service.
*	Le champ **Commentaires** permet d'ajouter un commentaire concernant le service.

************************
Détachement d'un service
************************

Si un service est lié à plusieurs hôtes, alors il sera identique pour chacun d'eux. Il ne sera donc pas possible de modifier unitairement le service d'un hôte pour modifier une propriété.
C'est pourquoi il est possible de transformer ce service lié à plusieurs hôtes en un service unique pour chaque hôte :

#.	Dans la liste des services, sélectionnez le service lié à plusieurs hôtes (habituellement ce service est surligné en orange)
#.	Dans le menu **More actions...** cliquez sur **Détacher** puis validez

Il existe maintenant un service unique par hôte.

.. |delete|    image:: /images/delete.png
.. |move|    image:: /images/move.png
.. |description| image:: /images/description.png
.. |undo| image:: /images/undo.png
