Versions Compared

Old Version 76

changes.mady.by.user Soubrié Grégoire

Saved on

compared with

New Version Current

changes.mady.by.user Soubrié Grégoire

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Make by tools (01.00.01) - action=same_as_next_version
Scroll Ignore
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmltrue
Panel
titleSommaire

Table of Contents
stylenone

Contexte

Le modèle shinken-broker-module-metrology-writer vous permet de superviser un hôte hébergeant le module Graphite-Perfdata d'un démon broker ( voir la page Le Broker Le Broker

Description du modèle

Modèle d'hôte correspondant :  shinken-broker-module-metrology-writer ).

Afin de superviser le module Graphite-Perfdata d'un démon Broker, le modèle shinken-broker-module-metrology-writer  appliqué à

votre

l'hôte, attachera un check qui vérifiera la santé et la performance de ce module.

Un check shinken-broker-module-metrology-writer  est créé pour chaque module webui présent sur le démon broker de l'élément supervisé.

Données du modèle

Sommaire des checks

Le modèle est paramétrable via des données fournies par le modèle.

Les données sont les suivantes : 

Nom de la donnéeDescriptionValeur par défautHérité d'un autre modèle ou localeBROKER_PORTPort utilisé pour établir la connexion avec le broker.7772LocaleGRAPHITE_DATA_LOCATIONL'endroit où sont stockées les métriques reçues./opt/graphite/storage/whisperLocaleGRAPHITE_PROCESS_NAMELe nom du service utilisé pour le cache de Graphite.carbon-cacheLocaleGRAPHITE_STORAGE_CRITICALLe seuil ( en pourcentage ) d'espace disque utilisé pour lequel on veut lever une alerte critique . 95LocaleGRAPHITE_STORAGE_WARNINGLe seuil ( en pourcentage ) d'espace disque utilisé pour lequel on veut lever un avertissement .85LocaleGRAPHITE_USERLe nom d'utilisateur utilisé pour se connecter à la base Graphite.
apacheLocaleCHECK_SHINKEN_TIMEOUTLe temps en secondes pendant lequel le check essaye de se connecter à l'hôte.3shinkenSHINKEN_PROTOCOLProtocole utilisé pour se connecter au serveur Graphite.httpshinkenMODULE_METROLOGY_LISTListe des modules de métrologie sur lesquels lancer un check.broker-master$($_HOSTBROKER_PORT$)$Locale - Duplicate For Each ( voir la page  Dupliquer des checks en fonction d'une liste de valeurs présentes dans la Donnée d'un hôte (duplicate_foreach) )SSH_KEYClé SSH utilisée pour se connecter au serveur Graphite.$SSH_KEY$LocaleSSH_KEY_PASSPHRASELe mot de passe de la clé SSH.$SSH_KEY_PASSPHRASE$LocaleSSH_PORTPort SSH des serveurs Graphite.$SSH_PORT$LocaleSSH_USERUtilisateur SSH des serveurs Graphite.$SSH_USER$Locale
Info

Le SSH est utilisé pour se connecter au serveur Graphite afin de vérifier que le processus indiqué est bien en cours d'exécution et que le serveur dispose d'assez d'espace de stockage.

Anchorcheckcheck Description des checks

Nom

Description

Broker - $KEY$ - Module Metrology Writer

Mode de fonctionnement du graphite installé

Graphite configuré en mode "Cache"
Les données de métrologie sont stockées seulement dans un carbon-cache.

Il s'agit de la configuration avec laquelle Shinken est livrée.

Vérifie que le bon fonctionnement du module Graphite-Perfdata

peut contacter le serveur hébergeant le service graphite.
  • Vérifie que le service est disponible :
    • port réseau ouvert,
    • processus en cours d’exécution,
    • suffisamment d'espace disque,
    • permissions,
    • statistiques d'entrées/sorties disque pour écrire les données de métrologie.
  • Renvoie également les statistiques globales et pour chaque worker :
    • Nombre de données reçues,
    • volume et charge du module.
    • Info

    La charge du module est calculée à partir du temps de traitement utilisé par rapport au temps d’exécution que le module dispose pour traiter les données.

    PanelImage Removed
    Graphite configuré en mode "relais"
    Lorsque le service Graphite est configuré comme un relais vers

    d'

    autres nœuds de stockage, le check vérifie l'état du relais vers lequel le module Graphite-Perfdata envoie les métriques ; il se connecte également sur les nœuds vers lesquels le relais Graphite relaie les métriques.

    Veuillez vous référer à la page Haute disponibilité de la base de métrologie (Graphite) pour la mise en place de cette architecture.

    Le check donne :

  • du détail sur le relai
    • et un aperçu des nœuds carbon-cache.
    Vous devez consulter les checks Shinken Graphite Status

    un démon broker ( voir la page 

    shinken-graphite ( Modèle d'hôte ) ) de ces nœuds pour obtenir les détails.

    Dans l'exemple ci-contre, le module envoie ses données à un relais ( 192.168.1.58:2013 ), qui transmet les données à deux nœuds "cache" :

    • 192.168.1.46:2004
    • 192.168.1.49:2004
    Info

    Les hôtes composant l'architecture Graphite sont automatiquement ajoutés à votre configuration par le listener Shinken ( voir la page Présentation détaillée où cette fonctionnalité est décrite en bas de page ).

    PanelImage Removed
    Vérifier le détail des carbon-caches

    Pour chaque nœud d'un carbon-relay , il est possible d'avoir plus de détails sur son état en allant vérifier le résultat des checks Shinken Graphite Status  pour chaque nœud correspondant. Ces checks sont présents sur des hôtes possédant le modèle d'hôte  shinken-graphite .

    • Si le module Module architecture-export de l'Arbiter est activé, les hôtes hébergeant les carbon-cache devraient être automatiquement ajoutés avec le modèle d'hôte shinken-graphite dans le Shinken Entreprise cible de l'architecture-export.
    • Sinon vous devrez les créer manuellement en y accrochant le modèle d'hôte shinken-graphite.
    Panel

    Image Removed

    Info
    Pour plus d'informations sur ce check, veuillez vous référer à la page du modèle correspondant shinken-graphite ( Modèle d'hôte ).
    Envoi des données d'inventaire
    Données spécifiques au serveur d'inventaire de métrologie
    Nom de la donnéeDescriptionValeur par défautHérité d'un autre modèle ou localeNB_METROLOGY_INVENTORY_SERVER_REQUESTS_DISPLAYEDNombre de requêtes affiché
    10LocaleNB_METROLOGY_INVENTORY_SERVER_ERRORS_DISPLAYED Nombre de requêtes en erreur affiché 5Locale
    Exemple d'affichage du check lorsque tout est OK pour les serveurs d'inventaire de métrologie
    Panel

    Image Removed

    Différents cas d'erreur

    Le serveur d'inventaire de métrologie a reçu des requêtes avec une mauvaise clé d'authentification :

    Panel

    Image Removed

    Le serveur d'inventaire de métrologie n'est pas à jour par rapport à la configuration de l'Arbiter :

    Panel

    Image Removed

    Paramètres du check

    Les checks du module Graphite-Perfdata peuvent être configurés via des données fournies par le modèle.

    Les données suivantes sont disponibles :

    Nom de la donnéeDecriptionValeur par défautHérité du modèle d'hôte ou localePLUGINSDIRChemin vers les plugins du module./var/lib/shinken/libexecDonnée globaleADDRESSAdresse de l'hôte.localhostLocale à l'hôteSSH_USERUtilisateur utilisé pour la connexion SSH pour la vérification des servicesshinkenHérité du modèle d'hôte ( shinken-broker-module-metrology )SSH_PORTPort SSH de l'hôte22Hérité du modèle d'hôte ( shinken-broker-module-metrology )SSH_KEYChemin ( relatif ou absolu ) vers la clé privée à utiliser pour la connexion SSH~/.ssh/id_rsaHérité du modèle d'hôte ( shinken-broker-module-metrology )SSH_KEY_PASSPHRASEMot de passe de la clé privée SSH.''Hérité du modèle d'hôte ( shinken-broker-module-metrology )GRAPHITE_DATA_LOCATIONEmplacement des données sur les serveurs Graphite/opt/graphite/storage/whisperHérité du modèle d'hôte ( shinken-broker-module-metrology )GRAPHITE_PROCESS_NAMENom du démon du cache ( Service )carbon-cacheHérité du modèle d'hôte ( shinken-broker-module-metrology )GRAPHITE_STORAGE_CRITICALLimite en % pour passer le statut du check en critique lorsque l'espace de stockage atteint cette limite95Hérité du modèle d'hôte ( shinken-broker-module-metrology )GRAPHITE_STORAGE_WARNINGLimite en % pour passer le statut du check en avertissement lorsque l'espace de stockage atteint cette limite85Hérité du modèle d'hôte ( shinken-broker-module-metrology )GRAPHITE_USERUtilisateur de graphite pour vérifier que les droits sont correctsapacheHérité du modèle d'hôte ( shinken-broker-module-metrology )CHECK_SHINKEN_TIMEOUTLe temps en secondes pendant lequel on va tenter de contacter d'hôte.3Hérité du modèle d'hôte ( shinken-arbiter )
    Info

    Les ports et adresses des serveurs hébergeant le broker sont utilisés pour connaître l'état des modules Graphite-Perfdata ( écriture ) et WebUI ( lecture ).

    Commande

    Nom du checkCommande du checkLigne de commandeBroker - $KEY$ - Module Metrology Writercheck_shinken_broker_module_metrology_writer!$VALUE1$$PLUGINSDIR$/check_shinken_module_metrology_writer.py -H "$HOSTADDRESS$" -p "$ARG1$" --shinkenversion "$SHINKENVERSION$" -P "$_HOSTSSH_PORT$" -i "$_HOSTSSH_KEY$" -u "$_HOSTSSH_USER$" -r "$_HOSTSSH_KEY_PASSPHRASE$" -d "$_HOSTGRAPHITE_DATA_LOCATION$" -U "$_HOSTGRAPHITE_USER$" -D "$_HOSTGRAPHITE_DISKS_LOCATION$" -n "$_HOSTGRAPHITE_PROCESS_NAME$" -w "$_HOSTGRAPHITE_STORAGE_WARNING$" -c "$_HOSTGRAPHITE_STORAGE_CRITICAL$" --timeout "$_HOSTCHECK_SHINKEN_TIMEOUT$"

    Métriques

    Le module Metrology - Writer donne plusieurs métriques :

    Nom de la métriqueDescription

    IP_HOST_graphite_disk_sda_IO 

    Taille en pourcentage des entrées/sorties utilisé sur le disque de la machine ou graphite est installé. HOST_ADRESS correspond à l'adresse IP ou au DNS de l'hôte.

    IP_HOST_graphite_storage_size

    Taille en pourcentage de l'espace disque utilisé sur la machine ou graphite est installé. HOST_ADRESS correspond à l'adresse IP ou au DNS de l'hôte.

    worker_X_last_minute_metrics_sent_nb

    Nombre de métrique écrit sur la dernière minute sur la worker X

    worker_X_last_minute_work_time

    Temps passé sur la dernière minute à écrire les métriques ( en seconde ) sur le worker X

    Erreurs Remontés

    Echec de la connexion aux nœuds

    Cette erreur arrive lorsque la configuration n'est pas correcte. Il peut y avoir plusieurs sources à ce problème :

    • Une erreur dans la configuration du relai et d'un ( ou plusieurs ) cache. Pensez à bien vérifier les adresses saisies dans les fichiers de configuration de ces éléments ( voir la page Haute disponibilité de la base de métrologie (Graphite) )
    • Une erreur dans les paramètres du check Broker - $KEY$ - Module Metrology Writer. Avec une installation par défaut du relai et des caches, cela ne devrait pas arriver, mais dans le cas où vous avez modifié certains paramètres sur l'hôte ( comme les ports SSH et/ou Graphite ), pensez à répercuter ces changements dans le modèle d'hôte shinken-broker-module-metrology-writer et le check Broker - $KEY$ - Module Metrology Writer.

    Module Graphite-Perfdata )

    Les données

    Les données communes pour tous les checks

    Provenant du modèle shinken

    Excerpt Include
    Modèle shinken
    Modèle shinken
    nopaneltrue

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

    Excerpt Include
    Mode actif et mode passif
    Mode actif et mode passif
    nopaneltrue


    Excerpt Include
    Le Broker
    Le Broker
    nopaneltrue

    Les données spécifiques

    Pour le check "Broker - $KEY$ - Module Metrology Writer"

    Excerpt Include
    Broker - $KEY$ - Module Metrology Writer
    Broker - $KEY$ - Module Metrology Writer
    nopaneltrue

    Les données DFE ( Duplicate Foreach )

    Excerpt
    NomModifiable sur UnitésDéfautValeur par défaut à l'installation de ShinkenDescription
    No Format
    MODULE_METROLOGY_LIST

    l'Hôte

    ( Onglet Données )

    		---broker-master$($_HOSTBROKER_PORT$)$ broker-master$($_HOSTBROKER_PORT$)$

    Liste de Broker (  Multi-démon   )

    Check(s) impacté(s) :

    Comment appliquer un modèle d'hôte à un hôte

    Excerpt Include
    Comment appliquer un modèle d'hôte à un hôte - Pack shinken
    Comment appliquer un modèle d'hôte à un hôte - Pack shinken
    nopaneltrue

    PanelImage Removed
    Avertissement ou erreur dans un noeud

    Lorsqu'un ou plusieurs nœuds remontent un dysfonctionnement, celui-ci apparaît dans le check Broker - $KEY$ - Module Metrology Writer. Un avertissement signifie qu'il y a une erreur non bloquante au fonctionnement normal du cache. Il est tout même conseiller d'essayer de résoudre ce problème.

    Pour avoir plus d'informations sur le problème remonté par le nœud, veuillez vous référer au check Shinken Graphite Status du nœud correspondant ( voir la page shinken-graphite ( Modèle d'hôte ) ).

    Remarque : Lorsque plusieurs erreurs ( par exemple un avertissement et une erreur critique ) surgissent sur un même nœud, seule la plus importante ( ici l'erreur critique ) sera affichée dans le retour du check Broker - $KEY$ - Module Metrology Writer ( comme sur l'image suivante ).

    PanelImage Removed

    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

    PanelImage Removed