Versions Compared

Old Version 2

changes.mady.by.user Shinken Trainee

Saved on

compared with

New Version Current

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

Image RemovedImage Added

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 liste :
    No Format
    LOGS$(C:\shinken
    No FormatCONF$(C:\config
    )$([fichier1.
    cfg
    log,fichier2.
    cfg
    log])$$(10)$$(20)$$(MB)$$(true)
    $
    $$(true)$


    Excerpt Include
    Files Matching $KEY$ by WinRM
    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

    Image RemovedImage Added

    Interprétation

    Statut

    • Il peut prendre quatre trois valeurs OK / CRITIQUE  / ATTENTION / 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
    Image Removed

    Image Added

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

    CRITIQUE

    Panel
    Image Removed

    Image Added

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

    OK

    Panel
    Image Removed

    Image Added

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

    CRITIQUE

    Panel
    Image Removed

    Image Added

    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

    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 (VALUE2 $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

    ...