Page History

Scroll Ignore

scroll-pdf	true
scroll-office	true
scroll-chm	true
scroll-docbook	true
scroll-eclipsehelp	true
scroll-epub	true
scroll-html	false

Panel

title	Sommaire

Table of Contents

style	none

Contexte

Le check Files Matching [$KEY$] by WinRM permet de superviser simultanément plusieurs propriétés des fichiers présents dans un répertoire : taille, nombre, date de dernière modification et date de dernier accès. Chaque dimension est indépendante et peut être activée ou désactivée individuellement via ses seuils.

Panel

Paramétrage

Le check utilise la ligne de commande suivante :

Code Block

language	bash
theme	Emacs

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

            --size-warn "$ARG3$"
            --size-crit "$ARG4$"
            --size-unit "$ARG5$"

            --count-warn "$ARG6$"
            --count-crit "$ARG7$"

            --last-update-warn "$ARG8$"
            --last-update-crit "$ARG9$"

            --last-access-warn "$ARG10$"
            --last-access-crit "$ARG11$"

            --recursive "$ARG12$"
            --include_hidden "$ARG13$"

            --kind "multi"

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

Données spécifiques pour ce check

Les variables suivantes sont à définir sur le modèle d'hôtes. Chaque dimension peut être désactivée individuellement en positionnant ses deux seuils à NONE. Au moins une dimension doit rester active.

Nom

Modifiable sur

Valeur par défaut

Description

No Format
WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-WARN

l'Hôte

( Onglet Données )

100

Taille d'un fichier à partir de laquelle le check passe en statut ATTENTION

L'unité utilisée est définie par WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__UNIT.

No Format
WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-CRIT

l'Hôte

( Onglet Données )

200

Taille d'un fichier à partir de laquelle le check passe en statut CRITIQUE

L'unité utilisée est définie par WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__UNIT.

No Format
WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__UNIT

l'Hôte

( Onglet Données )

MB

Unité utilisée pour l'affichage des tailles de fichiers ainsi que pour l'évaluation des seuils (SIZE-WARN et SIZE-CRIT).

Valeurs supportées : B , KB , MB , GB ou TB .

No Format
WINDOWS_BY_WINRM__FILES-MATCHING-COUNT__COUNT-WARN

l'Hôte

( Onglet Données )

50

Nombre de fichiers à partir duquel le check passe en statut ATTENTION. Mettre à NONE pour désactiver. Incompatible avec le mode liste.

No Format
WINDOWS_BY_WINRM__FILES-MATCHING-COUNT__COUNT-CRIT

l'Hôte

( Onglet Données )

100

Nombre de fichiers à partir duquel le check passe en statut CRITIQUE. Mettre à NONE pour désactiver. Incompatible avec le mode liste.

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 depuis la dernière modification à partir duquel le check passe en statut ATTENTION. Mettre à NONE pour désactiver.

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 depuis la dernière modification à partir duquel le check passe en statut CRITIQUE. Mettre à NONE pour désactiver.

No Format
WINDOWS_BY_WINRM__FILES-MATCHING-LAST-ACCESS__NO-ACCESS-SINCE-HOURS-WARN

l'Hôte

( Onglet Données )

24

Délai en heures depuis le dernier accès à partir duquel le check passe en statut ATTENTION. Mettre à NONE pour désactiver.

No Format
WINDOWS_BY_WINRM__FILES-MATCHING-LAST-ACCESS__NO-ACCESS-SINCE-HOURS-CRIT

l'Hôte

( Onglet Données )

48

Délai en heures depuis le dernier accès à partir duquel le check passe en statut CRITIQUE. Mettre à NONE pour désactiver.

Les données DFE ( Duplicate Foreach )

Nom

Modifiable sur

Valeur par défaut

Description

Exemple

No Format
WINDOWS_BY_WINRM__FILES-MATCHING

l'Hôte

( Onglet Données )

--

KEY$(VALUE1)$$(VALUE2)$$(VALUE3)$$(VALUE4)$$(VALUE5)$$(VALUE6)$$(VALUE7)$$(VALUE8)$$(VALUE9)$$(VALUE10)$$(VALUE11)$$(VALUE12)$$(VALUE13)$.

KEY correspond à une description des fichiers à superviser.

VALUE1 correspond au répertoire principal dans lequel regarder.

Valeur	Explication	Exemple
$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

à appliquer sur ce répertoire. Il peut

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

prendre deux formes différentes :

un pattern
une liste de noms de fichiers

(ex :

*.log
[fichier1.log,fichier2.log]

).

ou fichier1.log;fichier2.log

$ARG3$

Seuil de taille à partir duquel le check passe en statut ATTENTION .

Hérite

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

.

Mettre à NONE pour désactiver la dimension size.

10
NONE

$ARG4$

Seuil de taille à partir duquel le check passe en statut CRITIQUE .

Hérite

VALUE4 hérite

de WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-CRIT

VALUE5 hérite

.

Mettre à NONE pour désactiver la dimension size.

100
NONE

$ARG5$

Unité utilisée pour l'affichage ainsi que pour l'évaluation des seuils de taille.

Hérite de WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__UNIT

.

B, KB, MB, GB ou TB.

$ARG6$

Seuil de nombre de fichiers à partir duquel le check passe en statut ATTENTION.

Hérite

VALUE6 hérite

de WINDOWS_BY_WINRM__FILES-MATCHING-COUNT__COUNT-WARN

.

Mettre à NONE pour désactiver la dimension count. Incompatible avec le mode liste.

50
NONE

$ARG7$

Seuil de nombre de fichiers à partir duquel le check passe en statut CRITIQUE.

Hérite

VALUE7 hérite

de WINDOWS_BY_WINRM__FILES-MATCHING-COUNT__COUNT-CRIT

VALUE8 hérite

.

Mettre à NONE pour désactiver la dimension count. Incompatible avec le mode liste.

100
NONE

$ARG8$

Délai en heures depuis la dernière modification à partir duquel le check passe en statut ATTENTION.

Hérite de WINDOWS_BY_WINRM__FILES-MATCHING-LAST-UPDATE__NO-UPDATE-SINCE-HOURS-WARN

.

Mettre à NONE pour désactiver la dimension last_update.

24
NONE

$ARG9$

Délai en heures depuis la dernière modification à partir duquel le check passe en statut CRITIQUE.

Hérite

VALUE9 hérite

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

.

Mettre à NONE pour désactiver la dimension last_update.

48
NONE

$ARG10$

Délai en heures depuis le dernier accès à partir duquel le check passe en statut ATTENTION.

Hérite

VALUE10 hérite

de WINDOWS_BY_WINRM__FILES-MATCHING-LAST-ACCESS__NO-ACCESS-SINCE-HOURS-WARN

.

Mettre à NONE pour désactiver la dimension last_access.

24
NONE

$ARG11$

Délai en heures depuis le dernier accès à partir duquel le check passe en statut CRITIQUE.

Hérite

VALUE11 hérite

de WINDOWS_BY_WINRM__FILES-MATCHING-LAST-ACCESS__NO-ACCESS-SINCE-HOURS-CRIT

.

Mettre à NONE pour désactiver la dimension last_access.

48
NONE

$ARG12$

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

Hérite

VALUE12 hérite

de WINDOWS_BY_WINRM__FILES-MATCHING__RECURSIVE

.

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

$ARG13$

Active ou désactive la prise en compte des fichiers cachés.

Hérite

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

.	true/ false

Mode pattern :

No Format
LOGS$(C:\shinken)$$(*.log)$$(10)$$(100)$$(MB)$$(50)$$(100)$$(24)$$(48)$$(24)$$(48)$$(true)$$(true)$

Mode list :

No Format
LOGS$(C:\shinken)$$(

*

[fichier1.log,fichier2.log])$$(10)$$(100)$$(MB)$$(NONE)$$(NONE)$$(24)$$(48)$$(24)$$(48)$$(true)$$(true)$

Info

Si aucune valeur n'est renseignée pour un $ARGn$ sur un check, la valeur définie sur la donnée associée dont il hérite est utilisée à la place. Cette donnée peut à son tour avoir sa propre valeur par défaut.

Warning

Tous les checks DFE générés à partir du modèle NEW_PAGE - SPAC-27 - windows-by-WinRM__files-one-property-per-check héritent de ses valeurs par défaut. Cela implique que :

Effet global : tant que $ARGn$ n'est pas renseigné sur une instance, celle-ci lit la variable hôte définie par le modèle. Si plusieurs instances laissent $ARGn$ vide, elles partagent toutes la même valeur. Modifier la variable hôte (ou la valeur par défaut du modèle) se répercute donc sur toutes les instances qui n'ont pas renseigné $ARGn$.
Comportement spécifique à une instance : la seule façon de donner à une instance un comportement différent est de renseigner explicitement le $ARGn$ concerné sur cette instance. Toucher au modèle ou à la variable host ne permet pas de différencier une instance des autres — ça déplace seulement la valeur partagée.

Note

Exemple — $ARG5$ (unité) du check Files Matching [$KEY$] by WinRM :

Si $ARG5$ n'est pas renseigné sur l'instance, le modèle utilise la variable host WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__UNIT.
Si cette variable n'est pas définie, elle prend sa propre valeur par défaut, MB.
Conséquence : plusieurs instances générées sans $ARG5$ utiliseront toutes MB. Pour qu'une instance particulière utilise GB, il faut renseigner $ARG5$ = GB sur cette instance ; modifier WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__UNIT à GB ferait basculer toutes les instances sans surcharge à GB.

Données utilisées provenant du check

Pas de données provenant du check

Excerpt Include

	Uptime by WinRM
	Uptime by WinRM
nopanel	true

Résultat

Exemple

Panel

Interprétation

Statut

Il peut prendre quatre valeurs OK / CRITIQUE / ATTENTION / INCONNU .
- Le statut global est le plus sévère parmi toutes les dimensions actives. Les données concernées sont :
  - WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-WARN / ...-CRIT
  - WINDOWS_BY_WINRM__FILES-MATCHING-COUNT__COUNT-WARN / ...-CRIT
  - WINDOWS_BY_WINRM__FILES-MATCHING-LAST-UPDATE__NO-UPDATE-SINCE-HOURS-WARN / ...-CRIT
  - WINDOWS_BY_WINRM__FILES-MATCHING-LAST-ACCESS__NO-ACCESS-SINCE-HOURS-WARN / ...-CRIT
- 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

Situation

Statut

Exemple

2 dimensions actives (size + count) — au moins un fichier dépasse le seuil d'avertissement d'une dimension

ATTENTION

Panel

2 dimensions actives (size + count) — au moins un fichier dépasse le seuil critique d'une dimension

CRITIQUE

Panel

Toutes les dimensions actives (size + count + last_update + last_access) — au moins un fichier dépasse le seuil d'avertissement d'une dimension

ATTENTION

Panel

Toutes les dimensions actives (size + count + last_update + last_access) — au moins un fichier dépasse le seuil critique d'une dimension

CRITIQUE

Panel

Mode liste — au moins un fichier attendu est absent du répertoire ciblé (les fichiers présents sont évalués normalement sur les dimensions actives)

CRITIQUE

Panel

Mode liste — tous les fichiers attendus sont absents du répertoire ciblé

CRITIQUE

Panel

Mode pattern — Aucun fichier correspondant au filtre n'est trouvé.

CRITIQUE

Panel

Résultat

Renvoie pour chaque dimension active le nombre de fichiers en dépassement de seuil et la valeur de ce seuil. En mode liste, indique également le nombre de fichiers manquants.

Résultat Long

Affiche un tableau arborescent des fichiers en dépassement de seuil sur au moins une dimension active. Chaque colonne correspond à une dimension (taille, dernière modification, dernier accès) avec la valeur mesurée pour chaque fichier.

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 leurs valeurs pour chaque dimension active. La dimension count est incompatible avec le mode liste.

Métriques

Définition

Les métriques émises dépendent des dimensions actives (seuils non NONE) :

Nom	Unité	Description	Seuil d'avertissement	Seuil critique
files_size_(NOM_FICHIER)	B	Taille en octets de chaque fichier. Émise uniquement si la dimension size est active.	WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-WARN	WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-CRIT
files_total_size_(CONTEXTE)	B	Taille totale en octets de l'ensemble des fichiers détectés. CONTEXTE est composé du répertoire supervisé et du filtre utilisé. Émise uniquement si la dimension size est active.	—	—
files_updated_elapsed_h_(NOM_FICHIER)	H	Heures écoulées depuis la dernière modification. Émise uniquement si la dimension last update est active.	WINDOWS_BY_WINRM__FILES-MATCHING-LAST-UPDATE__NO-UPDATE-SINCE-HOURS-WARN	WINDOWS_BY_WINRM__FILES-MATCHING-LAST-UPDATE__NO-UPDATE-SINCE-HOURS-CRIT
files_accessed_elapsed_h_(NOM_FICHIER)	H	Heures écoulées depuis le dernier accès. Émise uniquement si la dimension last access est active.	WINDOWS_BY_WINRM__FILES-MATCHING-LAST-ACCESS__NO-ACCESS-SINCE-HOURS-WARN	WINDOWS_BY_WINRM__FILES-MATCHING-LAST-ACCESS__NO-ACCESS-SINCE-HOURS-CRIT

Exemple

Panel

Erreurs et pré-requis

Excerpt Include

	Uptime Erreurs du pack windows-by-WinRMUptime by WinRM__shinken
	Erreurs du pack windows-by-WinRM__shinken
nopanel	true

Page tree

Versions Compared

Old Version 6

New Version 7

Key

Contexte

Paramétrage

Données utilisées provenant du modèle

Données communes pour les checks du modèle

Données spécifiques pour ce check

Les données DFE ( Duplicate Foreach )

Données utilisées provenant du check

Résultat

Exemple

Interprétation

Statut

Résultat

Résultat Long

Métriques

Définition

Exemple

Erreurs et pré-requis