Contexte

Le check Stats Disks by WinRM va récupérer les statistiques de vos disques pour vous les renvoyer sous forme de métriques visibles dans l'interface de visualisation.

Paramétrage

Le check utilise la ligne de commande suivante :


$WINDOWS-BY-WINRM__SHINKEN__PLUGINSDIR$/check_windows_health_by_winrm_rust --check check_stats_disks
    --hostname "$HOSTADDRESS$"
    --port "$_HOSTWINDOWS_BY_WINRM__PORT$"
    --username "$_HOSTWINDOWS_BY_WINRM__DOMAINUSER$"
    --password "$_HOSTWINDOWS_BY_WINRM__DOMAINPASSWORD$"
    --auth_method "$_HOSTWINDOWS_BY_WINRM__AUTHMETHOD$"
    --timeout "$_HOSTWINDOWS_BY_WINRM__TIMEOUT$"
    --shared_winrm_tmp_wf "$_HOSTWINDOWS_BY_WINRM__POLLER-SHARED-WORKING-FOLDER$"

Données utilisées provenant des modèles

Données communes pour les checks des modèles

Données spécifiques pour ce check

Pour les checks suivants :

  • Network Interfaces by WinRM
  • Stats Disks by WinRM


Et les futurs checks en cours de développement :

  • Stats Kernel by WinRM
  • Stats NFS by WinRM


NomModifiable surUnitéDéfautValeur par défaut à l'installationDescription
WINDOWS_BY_WINRM__POLLER-SHARED-WORKING-FOLDER-BASE-PATH

l'Hôte

( Onglet Données )

--/tmp /tmp Chemin absolu où sera créé le dossier WINDOWS_BY_WINRM__POLLER-SHARED-WORKING-FOLDER-TMP-DIRNAME.
WINDOWS_BY_WINRM__POLLER-SHARED-WORKING-FOLDER-TMP-DIRNAME


l'Hôte

( Onglet Données )

--shinken shinken Nom de dossier temporaire où seront stockés les fichiers temporaires générés par les sondes.
Ne peut contenir uniquement des caractères alphanumériques, slash, antislash, espace, guillemet simple et double, tiret et tiret du bas.
WINDOWS_BY_WINRM__POLLER-SHARED-WORKING-FOLDER

l'Hôte

( Onglet Données )

--shinken/tmp/shinkenChemin complet où seront stockés les fichiers temporaires générés par les sondes.

  1. Le chemin de base (BASE-PATH, par défaut /tmp)

  2. Le nom du dossier temporaire (TMP-DIRNAME, par défaut shinken)

Données spécifiques pour ce check

Pas de données spécifiques pour ce check

Données DFE ( Duplicate Foreach )

Pas de données DFE pour ce check

Données utilisées provenant du check

Pas de données provenant du check pour ce modèle

Résultat

Exemple

Interprétation des données

Statut

  • Il peut prendre 3 valeurs  OK / CRITIQUE / INCONNU 

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


Le check calcule des moyennes par rapports aux mesures de ses dernières exécutions. Alors, l'intervalle d'exécution du check va affecter la période sur laquelle ces moyennes sont calculées.

  • Un intervalle d'exécution rapide donnera des moyennes plus volatiles, où il sera plus facile d'observer des pics.
  • Un intervalle d'exécution lent donnera des moyennes plus lissées.

Afin d'assurer la cohérence des données remontée entre chaque exécution, le check détermine l'intervalle d'exécution et va retourner un statut INCONNU lorsque les dernières mesurent sont trop récentes ou trop anciennes.

  • Si le check est configuré pour s'exécuter toutes les cinq minutes de 8h à 00h, la première exécution à 8h aura des dernières mesures anciennes de 8h, et retournera un statut INCONNU.
  • Si le check est configuré pour s'exécuter une fois par jour à midi, et qu'à 12h10 le check est exécuté de force, il aura des mesures trop récentes et retournera un statut INCONNU.



Situation Statut Exemple
  • Les mesures des disques ont bien été stockés dans les métriques.
OK

  • Les moyenne n'a pas pu être calculé. Les mesures sont trop récentes.
 INCONNU 

  • Les moyenne n'a pas pu être calculé. Les mesures sont dépassées.
 INCONNU 

  • Les moyenne n'a pas pu être calculé. Aucune mesure n'a été trouvée.
 INCONNU 

Résultat

Le résultat contient un message indiquant le statut du check.

Résultat Long

Pas de résultat long.

Métriques

Définition

Nom de la métriqueUnitéDescriptionSeuil d'avertissementSeuil critique
( NOM_DU_DISQUE )_r_by_sec--Nombre de lectures par seconde.----
( NOM_DU_DISQUE )_w_by_sec--Nombre d'écritures par seconde.----
( NOM_DU_DISQUE )_rKB_by_secKB/sQuantité de données ( en kB ) lue par seconde.----
( NOM_DU_DISQUE )_wKB_by_secKB/sQuantité de données ( en KB ) écrite par seconde.----
( NOM_DU_DISQUE )_util%Pourcentage d'occupation du disque.----

Exemple

Erreurs et pré-requis

Erreurs de configuration du poller shinken ( spécifique à certains checks )

Permission denied

Le poller qui exécutera les checks nécessite un droit d'écriture et de lecture dans le répertoire décrit par WINDOWS_BY_WINRM__POLLER-SHARED-WORKING-FOLDER-BASE-PATH/WINDOWS_BY_WINRM__POLLER-SHARED-WORKING-FOLDER-TMP-DIRNAME, par défaut /tmp/shinken.


Vous pouvez obtenir les erreurs suivantes :

Résolution

Cette série de commandes ne peut être effectuée qu'en ayant les droits root.

Donc en étant connecté au compte root ou en ayant fait la commande "su" au préalable.

Les instructions suivantes sont à exécuter sur le ou les pollers shinken.

shinken_tmp_dirname="shinken"
mkdir --parents /tmp/$shinken_tmp_dirname
chown -R root:shinken /tmp/$shinken_tmp_dirname
chmod -R g+rwx /tmp/$shinken_tmp_dirname
Explication

1.  La commande mkdir --parents /tmp/$shinken_tmp_dirname crée un récursivement un répertoire.

2. La commande chown -R root:shinken /tmp/$shinken_tmp_dirname modifie le groupe du dossier /tmp/shinken.

  • Cela garantit que des droits peuvent être appliqués au groupe shinken sur ce dossier.

3. La commande chmod -R g+rwx /tmp/$shinken_tmp_dirname applique immédiatement les droits nécessaires au dossier /tmp/shinken pour le groupe shinken.

  • Les droits de lecture, d'écriture et d'exécution sont ajoutés au dossier. Cela permet aux sondes de créer et lire des fichiers dans le dossier /tmp/shinken.


Il est nécessaire d'adapter la variable shinken_tmp_dirname si vous avez modifié l'un des deux variables suivantes :

  • WINDOWS_BY_WINRM__POLLER-SHARED-WORKING-FOLDER-BASE-PATH
  • WINDOWS_BY_WINRM__POLLER-SHARED-WORKING-FOLDER-TMP-DIRNAME