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


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

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

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

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

    Panel

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

    CRITIQUE

    Panel

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

    OK

    Panel

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

    CRITIQUE

    Panel

    Résultat

    Renvoie

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

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

    Mode liste ($ARG3$

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

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

    ...