View Source

Contexte

Le check File Matching [$KEY$] COUNT by WinRM permet de compter le nombre de fichiers présents dans un répertoire, en fonction d'un filtre spécifique.

Shinken Entreprise V02.08.02 > Files Matching $KEY$ COUNT by WinRM > 192.168.1.143_7766_elements_hosts_e13fde66341811f1aab1080027a9c43d_tab=checks&shinken_documentation=1 (2).png

Paramétrage

Le check utilise la ligne de commande suivante :

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

      --count-warn "$ARG3$"
      --count-crit "$ARG4$"

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

      --kind "count"

Données utilisées provenant du modèle

Données communes pour les checks du modèle

Données spécifiques pour ce check

Nom

Modifiable sur

Valeur par défaut

Description

WINDOWS_BY_WINRM__FILES-MATCHING-COUNT__COUNT-WARN

l'Hôte

( Onglet Données )

50

Nombre de fichiers à détecter dans un répertoire avant de passer le check en statut ATTENTION

Utilisé par $ARG3$ de la DFE WINDOWS_BY_WINRM__FILES-MATCHING-COUNT.

WINDOWS_BY_WINRM__FILES-MATCHING-COUNT__COUNT-CRIT

l'Hôte

( Onglet Données )

100

Nombre de fichiers à détecter dans un répertoire avant de passer le check en statut CRITIQUE

Utilisé par $ARG4$ de la DFE WINDOWS_BY_WINRM__FILES-MATCHING-COUNT.

Les données DFE ( Duplicate Foreach )

Nom

Modifiable sur

Valeur par défaut

Description

Exemple

WINDOWS_BY_WINRM__FILES-MATCHING-COUNT

l'Hôte

( Onglet Données )

--

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 à appliquer sur ce répertoire.

*.log

$ARG3$

Seuil à partir duquel le check passe en status ATTENTION

Hérite de WINDOWS_BY_WINRM__FILES-MATCHING-COUNT__COUNT-WARN.

10

$ARG4$

Seuil à partir duquel le check passe en status CRITIQUE

Hérite de WINDOWS_BY_WINRM__FILES-MATCHING-COUNT__COUNT-CRIT.

20

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

$ARG6$

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

true/false

LOGS$(C:\shinken)$(*.log)$$(10)$$(20)$$(true)$$(true)$

Données utilisées provenant du check

Pas de données provenant du check

Résultat

Exemple

Shinken Entreprise V02.08.02 > Files Matching $KEY$ COUNT by WinRM > 192.168.1.143_7766_elements_hosts_e13fde66341811f1aab1080027a9c43d_tab=checks&shinken_documentation=1 (2).png

Interprétation

Statut

Il peut prendre quatre valeurs OK / CRITIQUE / ATTENTION / INCONNU .
- Le statut va dépendre du retour de sonde et de la configuration spécifique du check pour les données suivantes :
  - WINDOWS_BY_WINRM__FILES-COUNT__COUNT-WARN ou DFE position $ARG3$
  - WINDOWS_BY_WINRM__FILES-COUNT__COUNT-CRIT ou DFE position $ARG4$
- Voici un tableau récapitulatif du statut attendu suivant le retour de sonde :

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

Shinken Entreprise V02.08.02 > Files Matching $KEY$ COUNT by WinRM > 192.168.1.143_7766_elements_hosts_ef5baa62341c11f1a0db080027a9c43d_tab=checks.png

Situation

Statut

Exemple

Le nombre de fichiers trouvé dépasse la valeur de WINDOWS_BY_WINRM__FILES-COUNT__COUNT-WARN (ou DFE $ARG3$)

ATTENTION

Shinken Entreprise V02.08.02 > Files Matching $KEY$ COUNT by WinRM > 192.168.1.143_7766_elements_hosts_e13fde66341811f1aab1080027a9c43d_tab=checks&shinken_documentation=1 (3).png

Le nombre de fichiers trouvé dépasse la valeur de WINDOWS_BY_WINRM__FILES-COUNT__COUNT-CRIT (ou DFE $ARG4$)

CRITIQUE

Shinken Entreprise V02.08.02 > Files Matching $KEY$ COUNT by WinRM > 192.168.1.143_7766_elements_hosts_e13fde66341811f1aab1080027a9c43d_tab=checks&shinken_documentation=1.png

Une liste de fichier a était utilisé en $ARG2$.

INCONNU

Shinken Entreprise V02.08.02 > Files Matching $KEY$ COUNT by WinRM > 192.168.1.143_7766_elements_hosts_e13fde66341811f1aab1080027a9c43d_tab=checks&shinken_documentation=1 (1).png

Résultat

Une seule ligne :

CRITIQUE (seuil dépassé) : N fichier(s) trouvé(s) (≥ C critique).
CRITIQUE 0 fichier trouvé : Aucun fichier trouvé correspondant à '<filtre>' dans '<chemin>'..
ATTENTION (seuil dépassé) : N fichier(s) trouvé(s) (≥ W avertissement).
OK : N fichier(s) trouvé(s).
UNKNOWN (paramètre invalide) si le filtre est une liste : Count cannot be used with a list of file names (the count would always equal the list size). (le count vaudrait toujours la taille de la liste).

Résultat Long

Pas de résultat long pour ce check.

Métriques

Définition

Nom	Unité	Description	Seuil d'avertissement	Seuil critique
files_count_( NOM_DOSSIER )( VALEUR_FILTRE )	--	Retourne le nombre de fichiers détectés dans le répertoire qui correspondent au filtre indiqué.	WINDOWS_BY_WINRM__FILES-COUNT__COUNT-WARN (ou DFE position $ARG3$)	WINDOWS_BY_WINRM__FILES-COUNT__COUNT-CRIT (ou DFE position $ARG4$)

Exemple

Shinken Entreprise V02.08.02 > Files Matching $KEY$ COUNT by WinRM > 192.168.1.143_7766_elements_hosts_e13fde66341811f1aab1080027a9c43d_tab=checks&shinken_documentation=1 (4).png

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