Versions Compared

Old Version 9

changes.mady.by.user Shinken Trainee

Saved on

compared with

New Version 10

changes.mady.by.user Shinken Trainee

Saved on

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 )

--

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

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

  • KEY correspond à une description des fichiers à superviser.
  • VALUE1 correspond au répertoire principal dans lequel regarder.
    • VALUE2 correspond au filtre ) ou d'

    à appliquer sur ce répertoire. Il peut

    s'agir d'un pattern (ex : *.log

    prendre deux formes différentes :

    • un pattern
    • une liste de noms de fichiers
    (ex:
    • *.log
    • [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.

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

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

    Renvoie le nombre de fichiers trouvés correspondant au filtre dans le répertoire ciblé, ou la liste des fichiers manquants en mode liste.

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

    ...