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$] LAST UPDATE by WinRM permet de vérifier la date de dernière modification des fichiers présents dans un répertoire, en fonction d'un filtre spécifique ou spécifique ou d'une liste de noms 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$"

        --last-update-warn "$ARG3$"
        --last-update-crit "$ARG4$"

        --recursive "$ARG5$"
        --include_hidden "$ARG6$"

        --kind "last_update"

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

NomModifiable surValeur par défautDescription
No Format
WINDOWS_BY_WINRM__FILES-MATCHING-LAST-UPDATE__NO-UPDATE-SINCE-HOURS-WARN

l'Hôte

( Onglet Données )

24

Délai en heures écoulées depuis la dernière modification d'un fichier avant de passer le check en statut ATTENTION

Utilisé par $ARG3$ de laDFE  WINDOWS_BY_WINRM__FILES-MATCHING-LAST-UPDATE.

No Format
WINDOWS_BY_WINRM__FILES-MATCHING-LAST-UPDATE__NO-UPDATE-SINCE-HOURS-CRIT

l'Hôte

( Onglet Données )

48

Délai en heures écoulées depuis la dernière modification d'un fichier avant de passer le check en statut CRITIQUE

Utilisé par $ARG4$ de laDFE  WINDOWS_BY_WINRM__FILES-MATCHING-LAST-UPDATE.

Les données DFE ( Duplicate Foreach )

NomModifiable surValeur par défautDescriptionExemple
No Format
WINDOWS_BY_WINRM__FILES-MATCHING-LAST-UPDATE

l'Hôte

( Onglet Données )

--

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

  • 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

    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 :

    •  ou fichier1.log;fichier2.log
    $ARG3$

    Seuil à partir duquel le check passe en status ATTENTION .

    Hérite

    VALUE3 hérite

    de WINDOWS_BY_WINRM__FILES-MATCHING-LAST-UPDATE__NO-UPDATE-SINCE-HOURS-WARN

    .

    • 24
    $ARG4$

    Seuil à partir duquel le check passe en status CRITIQUE

    Hérite

    VALUE4 hérite

    de WINDOWS_BY_WINRM__FILES-MATCHING-LAST-UPDATE__NO-UPDATE-SINCE-HOURS-CRIT

  • VALUE5 hérite de WINDOWS_BY_WINRM__FILES-MATCHING__RECURSIVE
  • VALUE6 hérite de WINDOWS_BY_WINRM__FILES-MATCHING__INCLUDE-HIDDEN
  • .

    • 48
    $ARG5$

    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).
    $ARG6$Active ou désactive la prise en compte des fichiers cachés.
    • true/false
    • Mode pattern :  
    Ces valeurs par défaut peuvent être écrasées pour chaque check généré en remplissant les VALUEs associées.
    No Format
    LOGS$(C:\
    LOGS\)$(*.log
    shinken)$(*.log)$$(24)$$(48)$$(true)$$(true)$
    • Mode liste:
    No Format
    LOGS$(C:\shinken)$([fichier1.log,fichier2.log])$$(24)$$(48)$$(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

    Interprétation

    Statut

    • Il peut prendre quatre valeurs OK / CRITIQUE / ATTENTION / INCONNU.

      • Le statut dépend du retour de sonde et de la configuration spécifique du check pour les données suivantes :

        • WINDOWS_BY_WINRM__FILES-MATCHING-LAST-UPDATE__NO-UPDATE-SINCE-HOURS-WARN ou DFE position $ARG3$
        • WINDOWS_BY_WINRM__FILES-MATCHING-LAST-UPDATE__NO-UPDATE-SINCE-HOURS-CRIT ou DFE position $ARG4$
      • Voici un tableau récapitulatif du statut attendu suivant le retour de sonde :
    Info

    Le texte de la colonne "Affichage des seuils" montre les paramètres utilisés et leur valeur définie sur l'équipement supervisé.

    Panel

    Image RemovedImage Added

    SituationStatutExemple
    • Au moins un fichier n'a pas été modifié depuis un délai dépassant la valeur de WINDOWS_BY_WINRM__FILES-MATCHING-LAST-UPDATE__NO-UPDATE-SINCE-HOURS-WARN (ou DFE $ARG3$)

    ATTENTION

    Panel

    • Au moins un fichier n'a pas été modifié depuis un délai dépassant la valeur de WINDOWS_BY_WINRM__FILES-MATCHING-LAST-UPDATE__NO-UPDATE-SINCE-HOURS-CRIT ou DFE $ARG4$)

    CRITIQUE

    Panel

    • Aucun Mode pattern — aucun fichier ne correspond au filtre dans le répertoire ciblé

    CRITIQUE

    Panel

    Image RemovedImage Added

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

    CRITIQUE

    Panel

    Résultat

    Selon le statut, une ou plusieurs lignes :

    • CRITIQUE : N fichier(s) non modifié(s) depuis la durée critique (≥ V heures).
    • ATTENTION : N fichier(s) non modifié(s) depuis la durée d'avertissement (≥ V heures).
    • OK : Tous les fichiers ont été modifiés récemment.
    • Mode liste, si au moins un fichier manquant : ligne supplémentaire en tête N fichier(s) manquant(s).
    • CRITIQUE : 0 fichier trouvé (mode pattern) : Aucun fichier trouvé correspondant à '<filtre>' dans '<chemin>'.

    Le détail fichier par fichier est dans le résultat longRenvoie pour chaque fichier en dépassement de seuil le temps écoulé depuis sa dernière modification, ainsi que le répertoire ciblé et le filtre utilisé.

    Résultat Long

    Affiche un tableau arborescent des fichiers dont la durée écoulée depuis la dernière modification dépasse un seuil configuré, en affichant par sévérité (Critical puis Warning) avec pour chaque fichier le temps écoulé ainsi que sa date de dernière modification.dépassant un seuil le nombre d'heures écoulées depuis sa dernière modification (ex : 72.5 H, accompagné de la date au format MM-dd HH:mm).

     En mode liste (VALUE2 $ARG2$ sous la forme [fichier1.log, fichier2.log, . ...]), le résultat long est toujours émis . Il présente en tête les fichiers manquants s'il y en a, puis les fichiers présents avec leur durée depuis la dernière modification:

    • Une table MISSING en tête si au moins un nom de la liste est absent du répertoire.
    • Puis, pour les fichiers présents, les tables critique/attention si des seuils sont dépassés.

    Métriques

    Définition

    NomUnitéDescriptionSeuil d'avertissementSeuil critique

    file_updated_elapsed_h_(NOM_FICHIER)

    HRetourne le nombre d'heures écoulées depuis la dernière modification du fichier.WINDOWS_BY_WINRM__FILES-MATCHING-LAST-UPDATE__NO-UPDATE-SINCE-HOURS-WARN(ou DFE $ARG3$)WINDOWS_BY_WINRM__FILES-MATCHING-LAST-UPDATE__NO-UPDATE-SINCE-HOURS-CRIT (ou DFE $ARG4$)

    Exemple

    Panel

    Erreurs et pré-requis

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

    ...