View Source

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.

Shinken Entreprise V02.08.02 > Files Matching $KEY$ by WinRM > 192.168.1.143_7766_elements_hosts_ef5baa62341c11f1a0db080027a9c43d_tab=datas&shinken_documentation=1 (6).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$"

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

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

WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-WARN

l'Hôte

( Onglet Données )

100

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

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

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.

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 .

WINDOWS_BY_WINRM__FILES-MATCHING-COUNT__COUNT-WARN

l'Hôte

( Onglet Données )

50

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

WINDOWS_BY_WINRM__FILES-MATCHING-COUNT__COUNT-CRIT

l'Hôte

( Onglet Données )

100

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

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 passer en ATTENTION . Mettre à NONE pour désactiver.

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 passer en CRITIQUE . Mettre à NONE pour désactiver.

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 passer en ATTENTION . Mettre à NONE pour désactiver.

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 passer en CRITIQUE . Mettre à NONE pour désactiver.

Les données DFE ( Duplicate Foreach )

Nom

Modifiable sur

Valeur par défaut

Description

Exemple

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.
VALUE2 correspond au filtre à appliquer sur ce répertoire. Il peut s'agir d'un pattern (ex : *.log ) ou d'une liste de noms de fichiers (ex: [fichier1.log,fichier2.log]).

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
VALUE4 hérite de WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__SIZE-CRIT
VALUE5 hérite de WINDOWS_BY_WINRM__FILES-MATCHING-SIZE__UNIT
VALUE6 hérite de WINDOWS_BY_WINRM__FILES-MATCHING-COUNT__COUNT-WARN
VALUE7 hérite de WINDOWS_BY_WINRM__FILES-MATCHING-COUNT__COUNT-CRIT
VALUE8 hérite de WINDOWS_BY_WINRM__FILES-MATCHING-LAST-UPDATE__NO-UPDATE-SINCE-HOURS-WARN
VALUE9 hérite de WINDOWS_BY_WINRM__FILES-MATCHING-LAST-UPDATE__NO-UPDATE-SINCE-HOURS-CRIT
VALUE10 hérite de WINDOWS_BY_WINRM__FILES-MATCHING-LAST-ACCESS__NO-ACCESS-SINCE-HOURS-WARN
VALUE11 hérite de WINDOWS_BY_WINRM__FILES-MATCHING-LAST-ACCESS__NO-ACCESS-SINCE-HOURS-CRIT
VALUE12 hérite de WINDOWS_BY_WINRM__FILES-MATCHING__RECURSIVE
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.

exemple$(C:\logs)$(*.log)$

Données utilisées provenant du check

Pas de données provenant du check

Résultat

Exemple

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 :

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

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

ATTENTION

Shinken Entreprise V02.08.02 > Files Matching $KEY$ by WinRM > 192.168.1.143_7766_elements_hosts_ef5baa62341c11f1a0db080027a9c43d_tab=datas&shinken_documentation=1 (9).png

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

CRITIQUE

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

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

ATTENTION

Shinken Entreprise V02.08.02 > Files Matching $KEY$ by WinRM > 192.168.1.143_7766_elements_hosts_ef5baa62341c11f1a0db080027a9c43d_tab=datas&shinken_documentation=1 (8).png

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

CRITIQUE

Shinken Entreprise V02.08.02 > Files Matching $KEY$ by WinRM > 192.168.1.143_7766_elements_hosts_ef5baa62341c11f1a0db080027a9c43d_tab=datas&shinken_documentation=1 (5).png

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

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

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

CRITIQUE

Shinken Entreprise V02.08.02 > Files Matching $KEY$ by WinRM > 192.168.1.143_7766_elements_hosts_ef5baa62341c11f1a0db080027a9c43d_tab=datas&shinken_documentation=1 (10).png

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

CRITIQUE

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

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 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_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

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