| Scroll Ignore | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
|
Contexte
Le check 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 |
|---|
|
Paramétrage
Le check utilise la ligne de commande suivante :
| Code Block | ||||
|---|---|---|---|---|
| ||||
$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 | ||||||
|---|---|---|---|---|---|---|
|
Données spécifiques pour ce check
| Nom | Modifiable sur | Valeur par défaut | Description | ||
|---|---|---|---|---|---|
| l'Hôte ( Onglet Données ) | 100 | Taille d'un fichier à partir de laquelle le check passe en statut ATTENTION Ce seuil est définie par WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-WARN ou par la position $ARG3$ de laDFE WINDOWS_BY_WINRM__FILES-MATCHING-SIZE. | ||
| l'Hôte ( Onglet Données ) | 200 | Taille d'un fichier à partir de laquelle le check passe en statut CRITIQUE Ce seuil est définie par WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-CRIT ou par la position $ARG4$ de laDFE WINDOWS_BY_WINRM__FILES-MATCHING-SIZE. | ||
| 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. L'unité est définie par WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__UNIT ou par la position $ARG5$ de laDFE WINDOWS_BY_WINRM__FILES-MATCHING-SIZE. |
Les données DFE ( Duplicate Foreach )
| Nom | Modifiable sur | Valeur par défaut | Description | Exemple | ||||
|---|---|---|---|---|---|---|---|---|
| l'Hôte ( Onglet Données ) | -- | $KEY$$(ARG1)$$(ARG2)$$(ARG3)$$(ARG4)$$(ARG5)$$(ARG6)$$(ARG7)$.
Cette donnée utilise des valeurs par défaut héritées du modèle d'hôtes :
Ces valeurs par défaut peuvent être écrasées pour chaque check généré en remplissant les $ARGn$ associées. |
|
Données utilisées provenant du check
Pas de données provenant du check
| Excerpt Include | ||||||
|---|---|---|---|---|---|---|
|
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-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é.
|
| Situation | Statut | Exemple | ||
|---|---|---|---|---|
| ATTENTION |
| ||
| CRITIQUE |
| ||
| CRITIQUE |
| ||
| CRITIQUE |
|
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 Long.
Résultat Long
Affiche un tableau arborescent par sévérité (Critical puis Warning) avec pour chaque fichier dépassant un seuil sa taille dans l'unité définie (ex : 150.25 MB).
En mode liste ($ARG3$ sous la forme [fichier1.log, fichier2.log, ...]), le résultat long est toujours émis :
- 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 Critical/Warning normales 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-WARN | WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-CRIT |
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 |
|---|
|
Erreurs et pré-requis
| Excerpt Include | ||||||
|---|---|---|---|---|---|---|
|
...