Contexte

Le check No Files Matching by WinRM [$KEY$] va vérifier qu'aucun fichier ne soit présent 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 :

$PLUGINSDIR$/check_windows_files.py --username "$_HOSTDOMAINUSER$" --password "$_HOSTDOMAINPASSWORD$" --hostname "$HOSTADDRESS$" --method "$_HOSTAUTHMETHOD$" --path "$ARG1$" --filter "$ARG2$" -n

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

Pas de données spécifiques pour ce check

Les données DFE ( Duplicate Foreach )



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

  

WINDOWS_BY_WINRM__EMPTY-FOLDER

l'Hôte

( Onglet Données )

----

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

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

Check(s) impacté(s) :

  •  No file matching [$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ôteAdresse 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 "No Files Matching by WinRM [$KEY$]" :



Interprétation

Statut

Il peut prendre trois valeurs OK/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 :

SituationStatut

Si aucun fichier n'est détecté dans le répertoire en fonction du filtre

OK

Si des fichiers sont détectés dans le répertoire en fonction du filtre

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 :

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

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é, depuis le dernier check.