Contexte

Le check No Files Matching [$KEY$] EXIST by WinRM permet de vérifier l'absence de fichiers dans un répertoire, en fonction d'un filtre spécifique. Il est complémentaire du check EXIST : il passe en CRITIQUE si des fichiers correspondant au filtre sont trouvés.


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

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__NO-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 supervisés.
    • Voici un tableau récapitulatif du statut attendu suivant le retour de sonde :
Situation Statut Exemple
  • Mode pattern — aucun fichier correspondant au filtre dans le répertoire ciblé

OK

  • Mode pattern — des fichiers correspondant au filtre ont été trouvés alors qu'aucun n'est attendu

CRITIQUE

  • Mode liste — aucun des fichiers listés n'est présent dans le répertoire ciblé

OK

  • Mode liste — au moins un des fichiers listés a été trouvé alors qu'il ne devrait pas exister

CRITIQUE

Résultat

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

Mode pattern :

  • OK (0 fichier) : Aucun fichier trouvé correspondant à '<filtre>' dans '<chemin>'.
  • CRITIQUE (≥ 1 fichier) : N fichier(s) trouvé(s) — aucun n'était attendu.

Mode liste :

  • OK (aucun de la liste trouvé) : Aucun fichier de la liste trouvé.
  • CRITIQUE (≥ 1 de la liste trouvé) : N fichier(s) trouvé(s) qui ne devrai(en)t pas exister.

Résultat Long

Mode pattern ($ARG3$ = *.log, *,…) : pas de résultat long.

Mode liste ($ARG3$ sous la forme [fichier1.log, fichier2.log, ...]) : résultat long émis uniquement si CRITIQUE (au moins un fichier de la liste est présent).

Ligne d'intro en gras : N file(s) checked:

  • Table à deux colonnes (Name | Status) mélangeant les fichiers de la liste :
    • PRESENT — pour les fichiers trouvés
    • MISSING — pour les fichiers absents

Si OK en mode liste (aucun fichier de la liste trouvé), pas de résultat long.

Métriques

Aucune métrique émise par ce check.

Erreurs et pré-requis