Page History

Contexte

Le check Broker - $KEY$ - Module Report Builder - Performance permet de suivre l'utilisation qui est faite du module broker--module-report-builder ( voir la page Module broker--module-report-builder ) au niveau du démon  Broker ( voir la page Le Broker ).

Paramétrage

Le check utilise la ligne de commande suivante :

$PLUGINSDIR$/check_shinken_broker_module_report_builder.py -H "$HOSTADDRESS$" -p "$ARG1$" -r "$ARG2$" -m "$ARG3$" --timeout "$_HOSTCHECK_SHINKEN_TIMEOUT$" --shinkenversion "$SHINKENVERSION$" -n "$_HOSTNB_LINE_UNAVAILABILITY$"

Données utilisées provenant du modèle

Données communes pour les checks du modèle

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.

Données globales

Propriétés de l'hôte

Résultat

Exemple

Interprétation

Statut

Il peut prendre les 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 :
  • CHECK_SHINKEN_TIMEOUT
    
    

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

Les vérifications spécifiques

Résultat

Charge de travail du module

Le check remonte le taux d'occupation par une génération de rapport sur la dernière minute.

Résumé des rapports en attente de génération

Le check affiche au format texte :

• le nombre de rapports en attente ;
• le temps d'attente moyen pour commencer la génération d'un rapport sur les dernières 24 heures ;

Lorsqu'il y a des rapports en attente de génération, le check affiche également depuis combien de temps patiente le prochain rapport dans la liste ( au moment où le check est exécuté ).

Statistiques des générations de rapports effectuées

Le check affiche au format texte :

• le nombre de rapports générés sur les dernières 24 heures ;
• le temps moyen pour générer un rapport sur les dernières 24 heures ;

Résultat Long

Ce check va afficher deux tableaux :

• un top 5 des demandes de rapports,
• un récapitulatif des durées de génération des rapports sur les dernières 24 heures.

Le top des requêtes va indiquer :

• l'utilisateur à l'initiative de la demande de rapport,
• le format demandé ( WEB ou CSV ),
• le type de rapport demandé ( History, SLA ou History & SLA ),
• la requête de filtrage,
• l'intervalle de recherche,
• le nombre d'éléments trouvés,
• le temps d'attente ( entre l'heure de la demande et le début effectif de la génération ),
• le temps de génération du rapport,
• la date de génération du rapport.

Le récapitulatif des durées de génération des rapports va regrouper les temps mis pour créer les rapports selon les intervalles définis dans la configuration du module ( voir la page Module broker--module-report-builder ) pour les dénombrer.

Description des erreurs

Le module n'a pas été trouvé sur le Broker

Lorsqu'il est impossible de trouver un module de génération de rapport avec le bon nom sur le Broker, le check le remonte comme une erreur :

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

Exemple

Avec la configuration suivante pour le module :

    # ┌─────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    # │ ────────────────────────────────────────    STATISTICS    ───────────────────────────────────────── │ #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────┘ #
 
    # ─── Ranges definition for the performance check                                                       ───
    #                                                                                                       ───
    #           Default : 5,10,20,30,60,120,300,600 ( seconds )                                             ───
    # ───                                                                                                   ───
    broker__module_report_builder__exec_stats_ranges    90, 180, 240

Les métriques suivantes seront générées :

reports_per_generation_time_0_90_s

reports_per_generation_time_90_180_s

reports_per_generation_time_180_240_s

reports_per_generation_time_240_s_and_more