Versions Compared

Old Version 52

changes.mady.by.user Jroy

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 shinkenmodèle shinken-broker-module-metrology-writer vous permet de superviser un hôte hébergeant le module Graphite-Perfdata d'un démon broker .

Description du modèle

Modèle d'hôte correspondant : shinken-broker-module-metrology-writer( voir la page Le Broker ).

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é.

Paramétrage du modèle

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 broker7772LocaleMODULE_METROLOGY_LISTListe de Broker (Multi-démon)broker-master$($_HOSTBROKER_PORT$)$Locale - Duplicate For EachCHECK_SHINKEN_TIMEOUTTimeout utilisé pour établir la connexion avec le broker3shinkenSHINKEN_PROTOCOLProtocole utilisé pour se connecter au serveur graphitehttpshinkenSSH_KEYClé SSH utilisée pour se connecter au serveur graphite$SSH_KEY$LocaleSSH_KEY_PASSPHRASEPassphrase 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.

Description des checks

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 un un carbon-cache.

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

  • Vérifie que le 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.

Panel

|Image 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 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 Visualiser l'architecture de son installation Shinken - Présentation détaillée, où cette fonctionnalité est décrite en bas de page ).

Panel

Image 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ésultats 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

Check Shinken Graphite Status

Une fois les hôtes ajoutés par l'export de l'architecture, les checks Shinken Graphite Status donnent les informations suivantes sur les hôtes :

  • File permission : Si le carbon-cache dispose de droits suffisants pour écrire sur le disque.
  • Metric reception : Des informations sur le service carbon-cache.
  • Storate I/O statistics : Des informations sur l'utilisation du disque (espace disponible, lecture et écriture) par le service carbon-cache.

Remarque: Il est possible de changer le type de cache utilisé, pensez à changer les variables GRAPHITE_CACHE_NAME par le nom du service de votre cache ( ou relay ) dans les hôtes concernés.

Dans le cas du relay, c'est la variable GRAPHITE_RELAY_NAME qu'il faut changer (valeurs par défaut respectives : carbon-cache et carbon-relay).

Panel

Image Removed

Sommaire des checks

Nom

Description

Broker - $KEY$ - Module Metrology Writer

Vérifie que le bon fonctionnement du module Graphite-Perfdata d'un démon broker ( voir la page 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

Erreur dans un check Shinken Graphite Status

Le check Shinken Graphite Status fait appel à deux services pour récupérer les données à afficher :

  1. carbon-cache : On a besoin de savoir si il peut recevoir les métriques.
  2. shinken-gatherer : Utilisé pour avoir des informations sur l'utilisation ( lecture & écriture ) du disque de l'hôte.

Pour vérifier l'état de ces services

Si un service n'est pas trouvé, une solution peut être de tenter de le relancer sur l'hôte en question à l'aide des commandes suivante :

Relancer le shinken-gatherer :

service shinken-gatherer restart

Relancer le carbon-cache :

service carbon-cache restart

Remarque: Le check utilise le nom des services pour vérifier leurs états. Si un service n'est pas trouvé, il est possible que les noms indiqués dans les variables GRAPHITE_CACHE_NAME et GRAPHITE_RELAY_NAME des hôtes ne soient pas ceux des services (en fonction des implémentations utilisées).

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 localeADDRESSAdresse de l'hôtelocalhostHérité du modèle d'hôteSSH_USERUtilisateur utilisé pour la connexion SSH pour la vérification des servicesshinkenDonnée globaleSSH_PORTPort SSH de l'hôte22Donnée globaleSSH_KEYChemin ( relatif ou absolu ) vers la clé privée à utiliser pour la connexion SSH~/.ssh/id_rsaDonnée globaleSSH_KEY_PASSPHRASEMot de passe de la clé privée SSH.''Donnée globaleGRAPHITE_PORTPort utilisé pour la connexion au Graphite.2003Hérité du modèle d'hôteGRAPHITE_DATA_LOCATIONEmplacement des données sur les serveurs graphite/opt/graphite/storage/whisperLocaleGRAPHITE_CACHE_NAMENom du démon du cache ( Service )carbon-cacheLocaleGRAPHITE_RELAY_NAMENom du démon du relay ( Service )carbon-relayLocaleGRAPHITE_STORAGE_CRITICALLimite en % pour passer le statut du check en critique lorsque l'espace de stockage atteint cette limite95LocaleGRAPHITE_STORAGE_WARNINGLimite en % pour passer le statut du check en avertissement lorsque l'espace de stockage atteint cette limite85LocaleGRAPHITE_USERUtilisateur de graphite pour vérifier que les droits sont correctsapacheLocaleGRAPHITE_DISKS_LOCATIONFiltre sur le nom du disque. Si une valeur est indiquée, seul ce disque sera pris en compte pour la vérification des I/O disques.Absente, car c'est une donnée sans valeur par défaut.
Il faut la rajouter dans les données locales pour l'utiliser
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).

Détail des commandes

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$"Shinken Graphite Statuscheck_shinken_graphite$PLUGINSDIR$/check_shinken_graphite.py -H "$HOSTADDRESS$" -u "$_HOSTSSH_USER$" -p "$_HOSTSSH_PORT$" -i "$_HOSTSSH_KEY$" -P "$_HOSTSSH_KEY_PASSPHRASE$" -s "$_HOSTGRAPHITE_PORT$" -d "$_HOSTGRAPHITE_DATA_LOCATION$" -U "$_HOSTGRAPHITE_USER$" -w "$_HOSTGRAPHITE_STORAGE_WARNING$" -c "$_HOSTGRAPHITE_STORAGE_CRITICAL$" -n "$_HOSTGRAPHITE_CACHE_NAME$" -R "$_HOSTGRAPHITE_RELAY_NAME$"

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

Vérification des droits du répertoire "/opt/graphite/storage/whisper/"

Le check vérifie aussi que l'utilisateur "apache" possède les droits de lecture sur les métriques.

PanelImage Removed