Page History

Contexte

Le check Broker - $KEY$ - Module SLA Writer permet de superviser la partie écriture du module SLA au niveau du démon Broker (  voir la page   Le Broker  ).

Paramétrage

Le check utilise la ligne de commande suivante :

$PLUGINSDIR$/check_shinken_module_sla_writer.py -H "$HOSTADDRESS$" -p "$ARG1$" --shinkenversion "$SHINKENVERSION$" 

-m "$_HOSTMINUTES_OF_STATS$" --workerwarning "$_HOSTWORKER_WARNING$" --workercritical "$_HOSTWORKER_CRITICAL$" 

--storagewarning "$_HOSTSTORAGE_WARNING$" --storagecritical "$_HOSTSTORAGE_CRITICAL$" --timeout "$_HOSTCHECK_SHINKEN_TIMEOUT$"

Données utilisées provenant du modèle

Données communes pour les checks du modèle

Provenant du modèle shinken

Provenant du modèle shinken-broker-module-sla-writer

Données spécifiques pour ce check

MINUTES_

OF_

STATS

Temps maximum durant lequel les checks peuvent s'exécuter (  en secondes  ).

Données spécifiques pour ce check

Les données DFE ( Duplicate Foreach )

Données utilisées provenant du check

Pas de données spécifiques pour ce check.

Paramètre du check

provenant du check pour ce check.

Données globales

Propriétés de l'hôte

Résultat

Exemple

Interprétation

Statut

Il peut prendre deux valeurs  OK / CRITIQUE / ATTENTION / INCONNU .

• Le statut va dépendre du retour de sonde et de la configuration spécifique du check pour les données suivantes :
  • WORKER_CRITICAL
  • WORKER_WARNING
  • STORAGE_CRITICAL
  • STORAGE_WARNING
  • CHECK_SHINKEN_TIMEOUT
    
    

• Voici un tableau récapitulatif du statut attendu suivant le retour de sonde :

Les vérifications spécifiques

Résultat

Renvoi au format texte : 

• Si le module fonctionne correctement

Résultat Long

Le résultat du check de supervision de l'écriture du module SLA se compose en 5 catégories d'informations :

• SLA - Writer  :  Ecriture des SLA,
• SLA - Archive: Archivage des SLA,
• SLA - Migration  : Migration des données SLA,
• SLA - Database cleanup  : Suppression des anciennes données SLA,
• Les métriques du check: Affiche les informations sur les métriques du check.

Écriture des SLA

Cette partie SLA - Writer du résultat du check indique dans la première puce le nombre d'éléments total dans le module.

Puis les autres puces indique pour chaque worker :

• Le nombre géré d'éléments dans le worker
• Les statistiques sur x minutes
  
  • Le temps d'écriture
  • Le nombre d’éléments écrit 
  • La charge sur la dernière minute

Archivage des SLA

La partie SLA - Archive indique les informations sur l'archivage des SLA.

La première puce présente les informations sur la dernière archive avec :

• La date de début de l'archive
• Le temps d’exécution de l'archive
• Le nombre de SLA archivés

La seconde puce indique la date de la plus ancienne archive de

stocker. Cette date est la limite à partir de laquelle on ne peut pas générer un rapport SLA ou visualiser un SLA dans l'onglet Historique/SLA du volet détail de l'interface de visualisation plus ancienne que cette date. 

Migration des données

La partie SLA - Migration indique les informations sur le statut du processus de migration des données de SLA.

Pour rappel, la migration des données SLA permet de migrer toutes les données SLA d'un format de donnée vers un nouveau qui pourrait être mise en place lors d'une mise à jour de Shinken

Lorsque la migration des données est en cours le résultat du check indique :

• Si la base de donnée a été migré
  

  • Avec le nombre de données utilisant l'ancien format de données

    Panel
    title Migration terminée
    Image Added

• Le statut de la migration

  • La progression de la migration avec le pourcentage et le nombre de données migré et sur le nombre total de donnée.

    Panel
    title Migration en cours
    Image Added

Si la base de données est au bon format, le résultat du check indique la durée de la dernière migration effectuée

Rotation des données

La partie SLA - Database cleanup indique les informations sur la rotation des données.

Pour rappel, la rotation des données est un système de suppression des données afin d'éviter que la base de données ne grossisse trop. Cette rotation supprime les données à partir d'un certain nombre de jours. Exemple ci-contre seul les 300 derniers jours de SLA sont conservés.

Le nombre de jours

a conservé

et paramétrable dans le fichier de configuration du Module SLA sur le paramètre nb_stored_days. Si souhaiter ne pas mettre de jours maximaux de conservation, il faut mettre la valeur -1 au paramètre 

Lorsque la rotation est en cours, le résultat du check indique :

• La date limite de conservation des SLA
  • Avec le nombre de SLA à supprimer
• La progression de la rotation
  • Avec le pourcentage d'avancement
• La taille totale de la base de données SLA
  • Avec le nombre d'éléments supervisé qui correspond au total d'élément affiché dans la partie "écriture"

  • Le nombre d'éléments qui ne sont plus

• • supervisés, mais toujours stocké ( calculé grâce au nombre total d'éléments dans la base archive par le module SLA que l'on peut suivre via le chapitre [ UNIQUE ELEMENTS IN ARCHIVE ] des logs du broker :  Broker - Les logs du module SLA

• •  

    Panel
    title Rotation en cours
    Image Added

Lorsque la rotation est désactivée, voici les informations affichées  :

• Affiche que les SLA sont

• conservés pour toujours
• La taille totale de la base de données SLA

  • Avec le nombre d'éléments supervisé qui correspond au total d'élément affiché dans la partie "écriture"

  • Le nombre d'éléments qui ne sont plus

• • supervisés, mais toujours stocké

    Panel
    title Rotation

• • désactivé

    Image Modified

Description des erreurs

Le

Broker est en cours d'

Si dans le graphite_backends d'une WebUI, une adresse utilise un port HTTP non valide, alors une erreur est remontée dans le check.

Par exemple, le graphite_backends suivant va remonter une erreur :

graphite_backends    *:127.0.0.1:80, Italie:192.168.1.26:80, Japon:127.0.0.1:invalid_port

Les métriques ne seront alors pas disponibles pour ce royaume.

Panel
Image Removed

Le Graphite backend d'un royaume utilise n'a pas d'adresse

Si dans la définition d'un Graphite backend d'un royaume, l'adresse (  ou l'IP   ) est manquante, alors une erreur est remontée.

Par exemple, le graphite_backends suivant va remonter une erreur :

graphite_backends    *:127.0.0.1:80, Italie::80, Japon:127.0.0.1:80

Les métriques ne seront alors pas disponibles pour ce royaume.

Un ou plusieurs royaumes n'ont pas de Graphite backend

Si dans la définition d'un graphite_backends, un ou plusieurs royaumes n'ont pas d'adresse définie, mais qu'il sont quand même gérés par le Broker, alors une erreur sera remontée dans le check.

Par exemple, un Broker gère les royaumes suivants :  All, France, Italie, Japon

Maintenant, une des WebUI du Broker a le graphite_backends suivant :

graphite_backends    France:192.168.1.23:80

Alors, les royaumes "All, Italie et Japon" n'ont pas de Graphite backend défini par la WebUI, ce qui aura pour conséquence que les éléments de ces royaumes n'auront pas accès à leurs métriques.

Le Graphite backend d'un royaume n'utilise pas un protocole valide

Si la définition d'un Graphite backend utilise un protocole qui n'est pas valide, le check remonte une erreur pour le backend concerné.

Par exemple, le graphite_backends suivant va remonter une erreur :

graphite_backends    *:192.168.1.23:80, France:htt://192.168.1.23:80

Les métriques ne seront alors pas disponibles pour ce royaume.

Un ou plusieurs royaumes n'est pas géré par le Broker

arrêt

Lorsque le Broker est en cours d'arrêt, le check le signale, et les informations relatives au module ne sont plus disponibles

L'archivage journalier des SLA n'a jamais eu lieu

Lorsque l'archivage journalier des SLA n'a pas eu lieu depuis le démarrage du module, la partie SLA - Archive passe en Warning et le check aussi.

L'archivage journalier des SLA n'a pas eu lieu

Lorsque l'archivage journalier des SLA n'a pas eu lieu ( vérification depuis les deux derniers jours ), la partie SLA - Archive passe en Warning et le check aussi.

Le processus d'archivage ne fonctionne plus

En cas d'erreur, le processus d'Archivage peut subir un arrêt inopiné.

Dans ce cas, le module continue de fonctionner pour poursuivre l'écriture des SLA, et le processus n'est pas relancé.

Une erreur est remontée dans le check de supervision pour informer de cette panne. Il est alors recommandé de prendre contact avec le support Shinken.

Métriques

Le Broker est en cours d'arrêt

Lorsque le Broker est en cours d'arrêt, le check le signale, et les informations relatives au module ne sont plus disponibles

Métriques

worker_X_worker_load

worker_X_sla_last_minute_write_nb

nb_contacts

Nombre de contacts géré par la WebUI

nb_hosts

worker_X_sla_last_minute_write_time

worker_X_last_minute_work_time

storage_size