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 )

--

KEY$(VALUE1)$$(VALUE2)$$(VALUE3)$$(VALUE4)$.

  • 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__RECURSIVE
  • VALUE4 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.

CONF$(C:\config)$([fichier1.cfg,fichier2.cfg])$$(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

Renvoie le nombre de fichiers trouvés correspondant au filtre dans le répertoire ciblé, ou en mode liste le nombre de fichiers trouvés qui ne devraient pas être présents.

Résultat Long

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

En mode liste (VALUE2 sous la forme [fichier1.log, fichier2.log, ....] ), le résultat long n'est émis qu'en cas d'anomalie. Il présente un tableau listant chaque fichier avec son statut : FOUND (en rouge) pour les fichiers détectés à tort, ABSENT pour les fichiers correctement absents.

Métriques

Aucune métrique émise par ce check.

Erreurs et pré-requis