Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Scroll Ignore
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmltruefalse
Panel
titleSommaire

Table of Contents
stylenone

Contexte

Le check File Count by WinRM [$KEY$] va by WinRM permet de 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. Image Removed


Panel

Image Added

Paramétrage

Le check utilise la ligne de commande suivante :

Code Block
languagetextbash
themeEmacs
$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_wftimeout "$_HOSTWINDOWS_BY_WINRM__LINUX-WORKING-FOLDER$TIMEOUT$"
      --path "$ARG1$" 
      --filter "$ARG2$" 
      --warning "$_SERVICEWINDOWS_BY_WINRM__FILES-COUNT__FILES_WARN$WARNING$" 
      --critical "$_SERVICEWINDOWS_BY_WINRM__FILES-COUNT__FILES_CRIT$CRITICAL$"

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
No Format
WINDOWS_BY_WINRM__DOMAINUSERSHORT

l'Hôte

( Onglet Données )

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

l'Hôte

( Onglet Données )

$DOMAINPASSWORD$ superpassword Mot de passe de l'utilisateur
No Format
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.

No Format
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.
No Format
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

Excerpt Include
Modèle windows-by-WinRM__base
Modèle windows-by-WinRM__base
nopaneltrue

Données spécifiques pour ce check

NomModifiable sur
Défaut
Valeur par défaut
à l'installation de Shinken
Description
No Format
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
No Format
WINDOWS_BY_WINRM__FILES-COUNT__FILES_CRITICAL

l'Hôte

( Onglet Données )

10

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

Les données DFE ( Duplicate Foreach )

NomModifiable sur
Défaut
Valeur par
défaut à l'installation de Shinken
défaultDescription
No Format
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

Excerpt
Section

Données globales

SectionNomModifiable surUnitéDéfautValeur par défaut à l'installation de ShinkenDescription
No Format
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 )

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

-include
Uptime by WinRM
Uptime by WinRM
nopaneltrue

Résultat

Exemple

Panel

Image Added

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

Image Removed

Interprétation

Statut

  • Il peut prendre quatre valeurs  OK / CRITIQUE / ATTENTION /

CRITIQUE /
  • INCONNU .

    • Le statut va dépendre du

nombre de fichiers détectés dans le répertoire ciblé.
    • retour de sonde et de la configuration spécifique du check pour les données suivantes :

      • WINDOWS_BY_WINRM__FILES-COUNT__FILES_WARNING
      • WINDOWS_BY_WINRM__FILES-COUNT__FILES_CRITICAL
    • 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é.

Panel

Image Added

Situation Statut Exemple
  • Le nombre de fichiers trouvé dépasse la valeur de WINDOWS_BY_WINRM__FILES-COUNT__FILES_WARNING

ATTENTION

Panel

Image Added


  • Le nombre de fichiers trouvé dépasse la valeur de WINDOWS_BY_WINRM__FILES-COUNT__FILES_CRITICAL

CRITIQUE

Panel

Image Added

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

Définition

Nom

UnitésUnité

Description

Seuil d'avertissement

Seuil critique

files_count

_"nom_du répertoire""nom du filtre"

_( NOM_DOSSIER )( VALEUR_FILTRE )

--NombreRetourne le nombre de fichiers détectés dans le répertoire qui correspondent au filtre indiqué.WINDOWS_BY_WINRM__FILES-COUNT__FILES_WARNINGWINDOWS_BY_WINRM__FILES-COUNT__FILES_CRITICAL

Exemple

Panel

Image Added

Erreurs et pré-requis

Excerpt Include
Erreurs du pack windows-by-WinRM__shinken
Erreurs du pack windows-by-WinRM__shinken
nopaneltrue