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 File Files Matching [$KEY$] SIZE by WinRM permet de vérifier la taille des fichiers présents dans un répertoire, en fonction d'un filtre spécifique ou d'une liste de fichiers.

Panel
Image RemovedImage Added

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

          --recursive "$ARG6$"
          --include_hidden "$ARG7$"

          --kind "size"

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

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

passe WINDOWS

statut ATTENTION

L’unité utilisée est définie par

Utilisé par $ARG3$ de laDFE 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

Utilisé par $ARG4$ de laDFE 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 .

Utilisé par $ARG5$ de laDFE WINDOWS_BY_WINRM__FILES-MATCHING-SIZE.

Les données DFE ( Duplicate Foreach )

Nom

Modifiable sur

Valeur par défaut

Description

Exemple

No Format
WINDOWS_BY_WINRM__FILES-MATCHING-SIZE

l'Hôte

( Onglet Données )

--

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

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

).

ou fichier1.log;fichier2.log

$ARG3$

Seuil à partir duquel le check passe en status 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

.

10

$ARG4$

Seuil à partir duquel le check passe en status CRITIQUE

Hérite

VALUE4 hérite

de WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-CRIT

VALUE5 hérite

.

20

$ARG5$

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

Hérite de WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__UNIT

VALUE6 hérite de WINDOWS_BY_WINRM__FILES-MATCHING__RECURSIVE

VALUE7 hérite de WINDOWS_BY_WINRM__FILES-MATCHING__INCLUDE-HIDDEN

.

B, KB, MB, GB ou TB.

$ARG6$

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

$ARG7$

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\

shinken)$(*.log)$$(10)$$(20)$$(

100)$(200)$(MB)$(true)$(true)$

MB)$$(true)$$(true)$

Mode liste :

No Format
LOGS$(C:\shinken)$([fichier1.log,fichier2.log])$$(10)$$(20)$$(MB)$$(true)$$(true)$

Excerpt Include

	Files Matching $KEY$ by WinRM
	Files Matching $KEY$ by WinRM
nopanel	true

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
Image RemovedImage Added

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-SIZE__SIZE-WARN ou DFE position $ARG3$
  - WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-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

Situation

Statut

Exemple

Au moins un fichier dépasse la taille définie par WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-WARN (ou DFE $ARG3$)

ATTENTION

Panel

Image Removed

Image Added

Au moins un fichier dépasse la taille définie par WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-CRIT (ou DFE $ARG4$ )

CRITIQUE

Panel

Image Removed

Image Added

Aucun fichier ne correspond au filtre dans le répertoire ciblé

CRITIQUE

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

Selon le statut, une ou plusieurs lignes :

CRITIQUE : N fichier(s) dépasse(nt) la taille critique (≥ V unité).
ATTENTION : N fichier(s) dépasse(nt) la taille d'avertissement (≥ V unité).
OK : Tous les fichiers ont une taille acceptable.
Mode liste, si au moins un fichier manquant : ligne supplémentaire en tête N fichier(s) manquant(s).
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 sa taille, ainsi que le répertoire ciblé et le filtre utilisé.

Résultat Long

Affiche un tableau arborescent des fichiers dont la taille dépasse un seuil configuré, en affichant par sévérité (critique puis attention) avec pour chaque fichier dépassant un seuil sa taille dans l'unité définie (ex : 150.25 MB).

En En mode liste (VALUE2 $ARG3$ 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 taille:

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

Nom	Unité	Description	Seuil d'avertissement	Seuil critique
files_size_(NOM_FICHIER)	B	Retourne la taille en octets de chaque fichier détecté.	WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-WARNWARN (ou DFE position $ARG3$)	WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-CRITCRIT (ou DFE position $ARG4$)
files_total_size_(CONTEXTE)	B	Retourne la taille totale en octets de l'ensemble des fichiers détectés. CONTEXTE est composé du répertoire supervisé et du filtre utilisé.	—-—	-

Exemple

Panel
Image RemovedImage Added

Erreurs et pré-requis

Excerpt Include

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

...

Page tree

Versions Compared

Old Version 2

New Version Current

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