Contexte

Le check File Matching [$KEY$] SIZE by WinRM permet de vérifier la taille des fichiers présents dans un répertoire, en fonction d'un filtre spécifique.


Paramétrage

Le check utilise la ligne de commande suivante :

$WINDOWS-BY-WINRM__SHINKEN__PLUGINSDIR$/check_windows_health_by_winrm_rust --check check_files_matching
          --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$"

          --path "$ARG1$"
          --filter "$ARG2$"

          --size-warn "$ARG3$"
          --size-crit "$ARG4$"
          --size-unit "$ARG5$"

          --recursive "$ARG6$"
          --include_hidden "$ARG7$"

          --kind "size"

Données utilisées provenant du modèle

Données communes pour les checks du modèle

Données spécifiques pour ce check

NomModifiable surValeur par défautDescription
WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-WARN

l'Hôte

( Onglet Données )

100

Taille d'un fichier à partir de laquelle le check en passe statut ATTENTION

L’unité utilisée est définie par WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__UNIT.

WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-CRIT

l'Hôte

( Onglet Données )

200

Taille d'un fichier à partir de laquelle le check passe en statut CRITIQUE.
L’unité utilisée est définie par WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__UNIT.

WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__UNIT

l'Hôte

( Onglet Données )

MB

Unité utilisée pour l’affichage des tailles de fichiers ainsi que pour l’évaluation des seuils (SIZE-WARN et SIZE-CRIT).

Valeurs supportées : B, KB, MB, GB ou TB.

Les données DFE ( Duplicate Foreach )

NomModifiable surValeur par défautDescriptionExemple
WINDOWS_BY_WINRM__FILES-MATCHING-SIZE

l'Hôte

( Onglet Données )

--

KEY$(VALUE1)$$(VALUE2)$$(VALUE3)$$(VALUE4)$$(VALUE5)$$(VALUE6)$$(VALUE7)$.

  • KEY correspond à une description des fichiers à superviser.
  • VALUE1 correspond au répertoire principal dans lequel regarder.
  • VALUE2 correspond au filtre à appliquer sur ce répertoire. Il peut s'agir d'un pattern (ex : *.log) ou d'une liste de noms de fichiers (ex: [fichier1.log,fichier2.log]).

Cette donnée utilise des valeurs par défaut héritées du modèle d'hôtes :

  • VALUE3 hérite de WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-WARN
  • VALUE4 hérite de WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-CRIT
  • VALUE5 hérite de WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__UNIT
  • VALUE6 hérite de WINDOWS_BY_WINRM__FILES-MATCHING__RECURSIVE
  • VALUE7 hérite de WINDOWS_BY_WINRM__FILES-MATCHING__INCLUDE-HIDDEN

Ces valeurs par défaut peuvent être écrasées pour chaque check généré en remplissant les VALUEs associées.

LOGS$(C:\LOGS\)$(*.log)$$(100)$(200)$(MB)$(true)$(true)$

Données utilisées provenant du check

Pas de données provenant du check

Résultat

Exemple

Interprétation

Statut

  • Il peut prendre quatre valeurs OK / CRITIQUE / ATTENTION / INCONNU .

    • Le statut dépend du retour de sonde et de la configuration spécifique du check pour les données suivantes :

      • WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-WARN
      • WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-CRIT
    • Voici un tableau récapitulatif du statut attendu suivant le retour de sonde :

Le texte de la colonne "Affichage des seuils" montre les paramètres utilisés et leur valeur définie sur l'équipement supervisé.

Situation Statut Exemple
  • Au moins un fichier dépasse la taille définie par WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-WARN

ATTENTION

  • Au moins un fichier dépasse la taille définie par WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-CRIT

CRITIQUE

  • Aucun fichier ne correspond au filtre dans le répertoire ciblé

CRITIQUE

  • Mode liste — au moins un fichier attendu est absent du répertoire ciblé

CRITIQUE

Résultat

Renvoie pour chaque fichier en dépassement de seuil sa taille, ainsi que le répertoire ciblé et le filtre utilisé.

Résultat Long

Affiche un tableau arborescent des fichiers dont la taille dépasse un seuil configuré, en affichant pour chaque fichier sa taille dans l'unité définie (ex : 150.25 MB).

En mode liste (VALUE2 sous la forme [fichier1.log, fichier2.log, ....]),, le résultat long est toujours émis. Il présente en tête les fichiers manquants s'il y en a, puis les fichiers présents avec leur taille.

Métriques

Définition

NomUnitéDescriptionSeuil d'avertissementSeuil critique

files_size_(NOM_FICHIER)

BRetourne la taille en octets de chaque fichier détecté.WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-WARNWINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-CRIT

files_total_size_(CONTEXTE)

BRetourne la taille totale en octets de l'ensemble des fichiers détectés. CONTEXTE est composé du répertoire supervisé et du filtre utilisé.——

Exemple

Erreurs et pré-requis