Page History

Contexte

Configuration du calcul

du taux de disponibilité

On peut définit le taux de disponibilité dans Shinken Entreprise par le pourcentage de temps sur une période donnée pendant lequel l'élément est en statut OK. Tout statut différent de OK va donc faire baisser .Les paramètre ont 3 type d'impacte sur le taux de disponibilité : .

Il est possible de choisir si certains statuts sont interprétés comme OK dans le cadre du calcul de taux de disponibilité. Par exemple, un statut Warning peut être interprété comme un OK, car le service est rendu mais de manière dégradée, ou comme un Critique car le service n'est pas rendu de manière optimale. On veut donc pouvoir configurer, pour les différents statuts et contextes, comment ils vont être interprétés dans le calcul du taux de disponibilité. 

La configuration du calcul du taux de disponibilité s'effectue directement par fichier de configuration. La modification des paramètres de calcul s'effectue dans le module sla, qui est chargé par le Broker.

Le fichier de configuration correspondant est le suivant: /etc/shinken/modules/sla.cfg.

Dans ce fichier, un grand nombre de commentaires indiquent brièvement les différentes options disponibles. Ces options de configuration sont décrites de manière détaillée dans les section suivantes de ce document.

Description des paramètres de configuration du calcul

Ici nous décrirons les différents paramètres de la configuration du calcul du taux de disponibilité.

Chaque paramètre permet de modifier le comportement du calcul du taux de disponibilité en fonction du statut ou contexte rencontré. Aussi, chaque paramètre est indépendant.

Paramétrage des états Warning

L'état Warning peut avoir plusieurs significations, selon comment il est interprété.

•  Le taux de disponibilité augmente
•  Le taux de disponibilité baisse
•  Le taux de disponibilité n'est pas impacté : La période est exclut du calcul du SLA
  Exemple : Pour une période de 2 heures, le calcul du SLA du jour sera en réalité effectué sur 22 heures.

Paramétrage des états Unknown

L'état Unknown peut être configuré de 3 manières différentes:

Paramétrage des états Missing data & Shinken inactive

Les états Missing data & Shinken inactive ont été regroupés dans un paramètre. Ce paramètre correspond à la période durant durant laquelle Shinken n'a pas effectué les vérifications pour un check (plateforme Shinken éteinte, ou vérification du check désactivée grâce aux Périodes de temps). Le statut de ces checks est donc "Missing data" ou "Shinken inactive".

L'état sans donné données peut être configuré de 3 manières différentes:

Paramètre du contexte Downtime : downtime_period

Paramétrage du contexte Downtime

Le context Downtime peut être configuré Les périodes de Downtime sont problématiques dans le calcul puisqu'elles peuvent être interprétées de 4 manières différentes:

Les périodes de maintenance peuvent:

Calcul du SLA du jour

Le SLA d'un élément est calculé de manière journalière. Les SLA des jours précedents sont sauvegardés et ne sont par défaut pas recalculés.

Après un changement dans les paramètres de calcul du SLA, on pourrait vouloir voir les anciens SLA calculés avec les paramètres nouvellement définis.

Dans Shinken Entreprise, il est possible de dire au système de recalculer les anciens SLA avec l'option recompute_old_sla.

Paramétrage de recalcul des taux de disponibilité archivés

Le taux de disponibilité des éléments est archivé quotidiennement.
Par défaut un changement de paramétrage du calcul n'impactera pas les taux de disponibilité des jours précédant la modification.
L'option recompute_old_sla permet de mettre à jour les taux de disponibilité archivés à jour à chaque changement de configuration. 

Exemple d'un paramétrage du calcul du taux de disponibilité

Le réglage de ces paramètres s'effectue au niveau du module SLA du Broker.

Le fichier de configuration concerné est /etc/shinken/modules/sla.cfg.Les paramètres du fichier suivant correspondent dans l'ordre aux cas énumérés dans la partie précédente:

Voici ci-dessous un exemple de configuration pour le calcul du taux de disponibilité. Dans cette configuration:

• L'option de recalcul des anciennes données est commentée. La valeur par défaut sera donc prise, en l’occurrence, les taux de disponibilités déjà archivés ne seront pas recalculés.
• Un statut "Warning" est compté positivement dans le calcul
• Un statut "Unknown" est aussi compté positivement dans le calcul
• Les statuts "Missing data" et "Shinken Inactive" sont exclus du calcul. Si on a une période de 2 heures avec un statut "Missing data" ou "Shinken Inactive", le taux de disponibilité de la journée ne sera calculé que sur 22 heures.
• Les périodes de maintenances sont comptées négativement dans le calcul.

warning_counts_as_ok     	0  ; Si 1, les Warning sont comptés comme OK, si 0 ils sont comptés comme Critique [par défaut 0]
exclude_unknown    			0  ; Si 1, Les Unknown ne sont pas pris en compte dans le calcul du SLA, si 0, ils sont comptés comme Critique [par défaut 0]
exclude_no_data    			0  ; Si 1, les périodes de données manquante ou Shinken inactif ne sont pas prises en compte dans le calcul du SLA. Si 0, ces périodes sont comptées comme Critique [par défaut 0]
recompute_old_sla 			0  ; Si 1, les anciens SLA seront recalculés avec les paramètres de calcul actuels. Si 0, les anciens SLA ne seront pas recalculés [par défaut 0] 
 
#  == Downtime periods # SLA are computed on a daily basis. SLA of the current day are always recomputed after a configuration change. SLA from days before are by default not recomputed.
# If 1, old SLA will be recomputed with current settings.
# If 0, old SLA will not be recalculated [default]
# recompute_old_sla      0

#======== SLA calculation ========
# Some status can impact positively (counted as OK/UP), negatively (counted as CRITICAL/DOWN) or not impact the SLA
# (is not counted, meaning the period of study is reduced by the period that is not counted).
# This configuration aims at giving Shinken administrators a way to configure how the SLA are calculated.

# If 1, Warning counts as UP
# If 0, Warning counts as DOWN [default]
warning_counts_as_ok   1

#  == Unknown periods ==
#    - include:  Only status is considered. Unknown status is counted negatively in the SLA. [default]
#    - exclude:  Unknown are not counted from SLA considered period
#    - ok:       Unknown are considered as UP periods
unknown_period        ok

#  == No_data periods ("Missing data" and "Shinken inactive" status) ==
#    - include:   Le statut est pris en compte sans tenir compte du contexte Downtime [par défautOnly status is considered. "Missing data" and "Shinken inactive" status are counted negatively in the SLA. [default]
#    - exclude:  No_data are not counted from SLA considered period
#    - ok:       No_data are considered Lesas statuts pendant les périodes de Downtime ne sont pas pris en compte pour le calculUP periods
no_data_period        exclude

#  == Downtime periods ==
#    - okinclude:  Only status is considered.  Le statut pendant les périodes de Downtime est OK[default]
#    - exclude:  Downtimes are not counted from SLA considered period
#    - criticalok: Le statut pendant les périodes de Downtime est Critique       Downtimes are considered as UP periods
#    - critical: Downtimes are considered as DOWN periods
downtime_period    includecritical

Pour appliquer un changement de cette configuration, un redémarrage de l'Arbiter et du Broker sont nécessaires:

service shinken-arbiter restart
service shinken-broker restart