Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Scroll Ignore
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmlfalse
Panel
titleSommaire

Table of Contents
stylenone

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.


Panel

Paramétrage

Le check utilise la ligne de commande suivante :

Code Block
languagebash
themeEmacs
$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

Excerpt Include
Modèle windows-by-WinRM__base
Modèle windows-by-WinRM__base
nopaneltrue

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
No Format
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

    Info

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

  • (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 :  
No Format
LOGS$(C:\shinken)$(*.log)$$(10)$$(20)$$(MB)$$(true)$$(true)$
  • Mode list :
No Format
LOGS$(C:\shinken)$([fichier1.log,fichier2.log])$$(10)$$(20)$$(MB)$$(true)$$(true)$


Excerpt Include
NEW_PAGE - SPAC-27 - Files Matching $KEY$ by WinRM
NEW_PAGE - SPAC-27 - Files Matching $KEY$ by WinRM
nopaneltrue

Données utilisées provenant du check

Pas de données provenant du check

Excerpt Include
Uptime by WinRM
Uptime by WinRM
nopaneltrue

Résultat

Exemple

Panel

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

Panel

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

CRITIQUE

Panel

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

OK

Panel

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

CRITIQUE

Panel

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

Excerpt Include
Erreurs du pack windows-by-WinRM__shinken
Erreurs du pack windows-by-WinRM__shinken
nopaneltrue

Votre essai Premium est terminé