Contexte

Le check File Matching [$KEY$] EXIST by WinRM permet de vérifier la présence de fichiers dans un répertoire, en fonction d'un filtre spécifique ou d'une liste de nom de fichiers.


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$"

          --recursive "$ARG3$"
          --include_hidden "$ARG4$"

          --kind "exist"

Données utilisées provenant du modèle

Données communes pour les checks du modèle

Données spécifiques pour ce check

Aucune donnée spécifique — ce check ne dispose pas de seuils configurables.

Les données DFE ( Duplicate Foreach )

NomModifiable surValeur par défautDescriptionExemple
WINDOWS_BY_WINRM__FILES-MATCHING-EXIST

l'Hôte

( Onglet Données )

--
ValeurExplicationExemple
$KEY$ Nom utilisé pour garantir l'unicité des checks DFE générés. LOGS
$ARG1$Répertoire principal à analyser.
  • C:\shinken
$ARG2$

Filtre à appliquer sur ce répertoire. Il peut prendre deux formes différentes :

  • un pattern
  • une liste de noms de fichiers
  • *.log
  • [fichier1.log,fichier2.log] ou fichier1.log;fichier2.log
$ARG3$

Active ou désactive la recherche récursive dans le répertoire principal. Il peut accepter 2 types de données :

  • un booléen
  • un nombre entier


  • true/false

    Note : À "true", le check analysera le répertoire et tous ses dossiers jusqu'à la profondeur maximale. 

  • 3 (Le check analysera le répertoire et ses dossiers à une profondeur maximale de 3).
$ARG4$Active ou désactive la prise en compte des fichiers cachés.
  • true/false
  • Mode pattern :  
LOGS$(C:\shinken)$(*.log)$$(10)$$(20)$$(MB)$$(true)$$(true)$
  • Mode list :
LOGS$(C:\shinken)$([fichier1.log,fichier2.log])$$(10)$$(20)$$(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  / INCONNU .

    • Ce check ne dispose pas de seuils configurables. Le statut dépend uniquement de la présence ou de l'absence des fichiers attendus.
    • Voici un tableau récapitulatif du statut attendu suivant le retour de sonde :
Situation Statut Exemple
  • Mode pattern — au moins un fichier correspondant au filtre est présent dans le répertoire

OK

  • Mode pattern — aucun fichier correspondant au filtre dans le répertoire ciblé

CRITIQUE

  • Mode liste — tous les fichiers attendus sont présents

OK

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

CRITIQUE

Résultat

Une seule ligne, le format dépend du mode de filtre :

Mode pattern :

  • OK : N fichier(s) trouvé(s) correspondant à '' dans ''.
  • CRITIQUE (0 fichier) : Aucun fichier trouvé correspondant à '<filtre>' dans '<chemin>'.

Mode liste :

  • OK (tous trouvés) : Les N fichier(s) sont tous présent(s).
  • CRITIQUE (≥ 1 manquant) : N fichier(s) manquant(s).

Résultat Long

En mode pattern, aucun résultat long n'est émis.

En mode liste ($ARG2$ sous la forme [fichier1.log, fichier2.log, ...]), le résultat long est toujours émis. Il présente un tableau listant chaque fichier attendu avec son statut : PRESENT ou MISSING.

Métriques

Aucune métrique émise par ce check.

Erreurs et pré-requis