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 No Files Matching by WinRM [$KEY$] by WinRM 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.


Panel
Image Removed

Image Added

Paramétrage

Le check utilise la ligne de commande suivante :

Code Block
languagetextbash
themeEmacs
$PLUGINSDIR$$WINDOWS-BY-WINRM__SHINKEN__PLUGINSDIR$/check_windows_files.py_health_by_winrm_rust --check check_files
      --hostname "$HOSTADDRESS$"
      --port "$_HOSTWINDOWS_BY_WINRM__PORT$"
      --username "$_HOSTDOMAINUSER$" _HOSTWINDOWS_BY_WINRM__DOMAINUSER$" 
      --password "$_HOSTDOMAINPASSWORD$" --hostname "$HOSTADDRESS$" --method "$_HOSTAUTHMETHOD$" HOSTWINDOWS_BY_WINRM__DOMAINPASSWORD$"
      --auth_method "$_HOSTWINDOWS_BY_WINRM__AUTHMETHOD$"
      --timeout "$_HOSTWINDOWS_BY_WINRM__TIMEOUT$"
      --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
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 :

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

  • 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 sur
    Défaut
    Valeur par défaut
    à l'installation de Shinken
    Description

      

    No Format
    WINDOWS_BY_WINRM__EMPTY_FOLDER

    l'Hôte

    ( Onglet Données )

    ----

    exemple1$(D:\Users\old-user)$$(*)$

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

    • .
    exe$
    • txt$(C:\Windows)$$(*.
    exe
    • txt)$ : Vérifie
    l'absence
    • la présence de fichiers possédant l'extension ''
    exe
    • txt "  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

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

    Image Removed

    Interprétation

    Statut

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

      Il peut prendre trois valeurs  OK / CRITIQUE  / INCONNU

    .
    • .

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


    Situation Statut

    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
    Exemple
    • Le dossier configuré contient des fichiers

    CRITIQUE

    Panel

    Image Added


    • Le dossier configuré n'existe pas

    CRITIQUE

    Panel

    Image Added

    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

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

    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