Contexte

Le check File Count by WinRM [$KEY$] va compter le nombre de fichiers présents dans un répertoire en fonction d'un filtre spécifique. Les requêtes s'effectuent via le protocole WinRM.


Paramétrage

Le check utilise la ligne de commande suivante :

$WINDOWS-BY-WINRM__SHINKEN__PLUGINSDIR$/check_windows_health_by_winrm_rust --check check_files 
      --hostname "$HOSTADDRESS$"
      --port "$_HOSTWINDOWS_BY_WINRM__PORT$"
      --username "$_HOSTWINDOWS_BY_WINRM__DOMAINUSER$" 
      --password "$_HOSTWINDOWS_BY_WINRM__DOMAINPASSWORD$"
      --auth_method "$_HOSTWINDOWS_BY_WINRM__AUTHMETHOD$"
      --linux_winrm_tmp_wf "$_HOSTWINDOWS_BY_WINRM__LINUX-WORKING-FOLDER$"
      --path "$ARG1$" 
      --filter "$ARG2$" 
      --warning "$_SERVICEWINDOWS_BY_WINRM__FILES-COUNT__FILES_WARN$" 
      --critical "$_SERVICEWINDOWS_BY_WINRM__FILES-COUNT__FILES_CRIT$"

Données utilisées provenant du modèle

Données communes pour les checks du modèle

NomModifiable surDéfautValeur par défaut à l'installation de ShinkenDescription
WINDOWS_BY_WINRM__DOMAINUSERSHORT

l'Hôte

( Onglet Données )

$DOMAINUSERSHORT$ shinken_user Nom d'utilisateur utilisé, sans le domaine
WINDOWS_BY_WINRM__DOMAINPASSWORD

l'Hôte

( Onglet Données )

$DOMAINPASSWORD$ superpassword Mot de passe de l'utilisateur
WINDOWS_BY_WINRM__DOMAIN

l'Hôte

( Onglet Données )

$DOMAIN$ MYDOMAIN

Nom du domaine Active Directory du compte. Si vide, alors c'est le domaine du serveur qui sera utilisé, ou un compte local s'il n'est pas dans un domaine Active Directory.

WINDOWS_BY_WINRM__DOMAINUSER

l'Hôte

( Onglet Données )

$_HOSTDOMAIN$\\
$_HOSTDOMAINUSERSHORT$		 MYDOMAIN\\shinken_user

Nom complet utilisé pour se connecter, il vaut par défaut DOMAINE\DOMAINUSERSHORT.

  • À n'utiliser que si vous ne souhaitez pas utiliser les variables DOMAINUSERSHORT et DOMAIN, et que votre connexion se fait sur un autre format que Domaine/utilisateur.
WINDOWS_BY_WINRM__AUTHMETHOD

l'Hôte

( Onglet Données )

$_HOSTAUTHMETHOD$ ntlm

Méthode d'authentification utilisée pour accéder aux serveurs Windows. Méthodes disponibles :

  • basic
  • ntlm

Données spécifiques pour ce check

NomModifiable surDéfautValeur par défaut à l'installation de ShinkenDescription
WINDOWS_BY_WINRM__FILES-COUNT__FILES_WARNING

l'Hôte

( Onglet Données )

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

l'Hôte

( Onglet Données )

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

Les données DFE ( Duplicate Foreach )

NomModifiable surDéfautValeur par défaut à l'installation de ShinkenDescription
WINDOWS_BY_WINRM__FILES_COUNT

l'Hôte

( Onglet Données )

-- --

Chemin vers le répertoire à vérifier et filtre à appliquer, exemple :

  • .txt$(C:\Windows)$$(*.txt)$ : Vérifie la présence de fichiers possédant l'extension ''txt "  dans le répertoire " C:\Windows "

Check(s) impacté(s) :

  •  File Count [$KEY$].

Données utilisées provenant du check

Pas de données provenant du check

Données globales

NomModifiable surUnitéDéfautValeur par défaut à l'installation de ShinkenDescription
USERPLUGINSDIR

Non modifiable

( Sauf Admin Shinken )

--/var/lib/shinken/libexec /var/lib/shinken/libexec

Chemin absolu du dossier contenant le répertoire des sondes ( non modifiable )

HOSTADDRESS

Non modifiable

( Sauf Admin Shinken )

--Adresse IP de l'hôte Adresse IP de l'hôte

Adresse IP de l'hôte sur lequel est exécuté le check

Résultat

Exemple

Ci-dessous, le résultat du check " Files Count by WinRM  [$KEY$] " :


Interprétation

Statut

Il peut prendre quatre valeurs OK / ATTENTION / CRITIQUE / INCONNU .

  • Le statut va dépendre du nombre de fichiers détectés dans le répertoire ciblé.


Voici un tableau récapitulatif du statut attendu suivant le retour de sonde :

Situation Statut

Si le nombre de fichiers détectés reste dans la limite des seuils configurés, ou si aucun seuil n'est spécifié.

OK

Si le nombre de fichiers détectés dépasse la limite de seuil d'avertissement configuré.

ATTENTION

Si le nombre de fichiers détectés dépasse la limite de seuil critique configuré, ou si aucun fichier n'est détecté.

CRITIQUE

Si la sonde n'a pas eu de réponse avant le temps maximum

  • par défaut: 60 s


INCONNU

Résultat

Renvoie le nombre de fichiers détectés ainsi que le répertoire ciblé et le filtre utilisé :


Exemple :

4 file(s) detected in the folder : C:\Windows\test with the filter : *.txt

Résultat Long

Pas de résultat long pour ce check.

Métriques

Nom

Unités

Description

files_count_"nom_du répertoire""nom du filtre"
NombreRetourne le nombre de fichiers détectés dans le répertoire qui correspondent au filtre indiqué.