Versions Compared

Old Version 17

changes.mady.by.user Shinken Trainee

Saved on

compared with

New Version Current

changes.mady.by.user Soubrié Grégoire

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Make by tools (01.00.01) - action=clean_corrupted_html
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 Network Interfaces by WinRM  permet d'obtenir l'état des interfaces réseau de la machine via le protocole SNMP sur une machine Linux.

  • Chaque interface est présentée avec son état ainsi que ses statistiques de bande passante.

Panel

Image RemovedImage Added

Paramétrage

Le check utilise la ligne de commande suivante :

Code Block
languagebash
themeEmacs
$WINDOWS-BY-WINRM__SHINKEN__PLUGINSDIR$/check_windows_health_by_winrm_rust --check check_network_interfaces
    --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$"
    --regex "$_HOSTWINDOWS_BY_WINRM__NETWORK-INTERFACES__NET-INTERFACES$"
    --in_warning "$_HOSTWINDOWS_BY_WINRM__NETWORK-INTERFACES__IN-WARN$"
    --in_critical "$_HOSTWINDOWS_BY_WINRM__NETWORK-INTERFACES__IN-CRIT$"
    --out_warning "$_HOSTWINDOWS_BY_WINRM__NETWORK-INTERFACES__OUT-WARN$"
    --out_critical "$_HOSTWINDOWS_BY_WINRM__NETWORK-INTERFACES__OUT-CRIT$"
    --extend "$_HOSTWINDOWS_BY_WINRM__NETWORK-INTERFACES__EXTEND$"
    --local_winrm_tmp_wf "$_HOSTWINDOWS_BY_WINRM__POLLER-LOCAL-WORKING-FOLDER$"
    --shared_winrm_tmp_wf "$_HOSTWINDOWS_BY_WINRM__POLLER-SHARED-WORKING-FOLDER$"

Données utilisées provenant des modèles

Données communes pour les checks des modèles

Excerpt Include
NEW-PAGE - SPAC-27 - Modèle windows-by-WinRM__baseNEW-PAGE - SPAC-27 -
Modèle windows-by-WinRM__base
nopaneltrue

Excerpt
Section

Les données communes pour certain checks

Section

Pour les checks suivants :

  • Network Interfaces by WinRM
  • Stats
Kernel
  • Disks by WinRM
( en developpement )
  • Stats
NFS
  • Kernel by WinRM
( en developpement )
Section
Stats Disks by WinRM ( en developpement )
NomModifiable surUnitéDéfautDescription
No Format
WINDOWS_BY_WINRM__WORKING-FOLDER-BASE-PATH

l'Hôte

( Onglet Données )

--/tmpChemin absolu où sera créé le dossier WINDOWS_BY_WINRM__WORKING-FOLDER-TMP-DIRNAME.
No Format
WINDOWS_BY_WINRM__WORKING-FOLDER-TMP-DIRNAME


l'Hôte

( Onglet Données )

--shinkenNom de dossier temporaire où seront stockés les fichiers temporaires générés par les sondes.
Ne peut contenir uniquement des caractères alphanumériques, slash, antislash, espace, guillemet simple et double, tiret et tiret du bas.

Données spécifiques pour ce check

NomModifiable surUnitéDéfautDescription
No Format
WINDOWS_BY_WINRM__NETWORK-INTERFACES__NET-INTERFACES

l'Hôte

( Onglet Données )

--
.*
Filtre sur les interfaces présenté sous forme d'expression régulière. Prend toutes les interfaces par défaut.
No Format
WINDOWS_BY_WINRM__NETWORK-INTERFACES__IN-WARN

l'Hôte

( Onglet Données )

--
0

Seuil d'AVERTISSEMENTde transfert entrants sur les interfaces (en Kbps).
Utilisez la valeur par défaut 0 pour ignorer le seuil.

No Format
WINDOWS_BY_WINRM__NETWORK-INTERFACES__IN-CRIT

l'Hôte

( Onglet Données )

--
0

Seuil CRITIQUE de transfert entrants sur les interfaces (en Kbps).
Utilisez la valeur par défaut 0 pour ignorer le seuil.

No Format
WINDOWS_BY_WINRM__NETWORK-INTERFACES__OUT-WARN

l'Hôte

( Onglet Données )

--
0

Seuil d'AVERTISSEMENT de transfert sortant sur les interfaces (en Kbps).
Utilisez la valeur par défaut 0 pour ignorer le seuil.

No Format
WINDOWS_BY_WINRM__NETWORK-INTERFACES__OUT-CRIT

l'Hôte

( Onglet Données )

--
0

Seuil CRITIQUE de transfert sortant sur les interfaces (en Kbps).
Utilisez la valeur par défaut 0 pour ignorer le seuil.

No Format
WINDOWS_BY_WINRM__NETWORK-INTERFACES__EXTEND

l'Hôte

( Onglet Données )

--falseAffiche un second tableau dans le résultat long qui ajoute des informations supplémentaires sur l'utilisation des interfaces réseaux.

Données DFE ( Duplicate Foreach )

Pas de données DFE pour ce check

Données utilisées provenant du check

Pas de données provenant du check pour ce modèle

Excerpt Include
NEW-PAGE - SPAC-27 - Uptime by WinRM (pour le modèle windows- by - WinRM)NEW-PAGE - SPAC-27 -
Uptime by WinRM (pour le modèle windows- by - WinRM)
nopaneltrue

Résultat

Exemple

Panel

Image RemovedImage Added

Interprétation

Statut

  • Il peut prendre 4 valeurs  OK / CRITIQUE / ATTENTION / INCONNU .

    • Le statut va dépendre du retour de sonde et de la configuration spécifique du check pour les données suivantes :

      • WINDOWS_BY_WINRM__NET-INTERFACES__IN-WARN
      • WINDOWS_BY_WINRM__NET-INTERFACES__IN-CRIT
      • WINDOWS_BY_WINRM__NET-INTERFACES__OUT-WARN
      • WINDOWS_BY_WINRM__NET-INTERFACES__OUT-CRIT
    • Voici un tableau récapitulatif du statut attendu suivant le retour de sonde :


Info

Le check sera automatiquement en INCONNU dès l'installation du pack, il suffit d'attendre que le check récupère les informations suffisantes calcule des moyennes par rapports aux mesures de ses dernières exécutions. Alors, l'intervalle d'exécution du check va affecter la période sur laquelle ces moyennes sont calculées.

  • Un intervalle d'exécution rapide donnera des moyennes plus volatiles, où il sera plus facile d'observer des pics.
  • Un intervalle d'exécution lent donnera des moyennes plus lissées.
Info
Panel

Image Removed

Situation

Statut

Exemple

  • Un ou plusieurs des seuils suivants sont dépassés :
    • WINDOWS_BY_WINRM__NET-INTERFACES__IN-CRIT
    • WINDOWS_BY_WINRM__NET-INTERFACES__OUT-CRIT

CRITIQUE

Panel
Image Removed

Image Added

  • Un ou plusieurs des seuils suivants sont dépassés :
    • WINDOWS_BY_WINRM__NET-INTERFACES__IN-WARN
    • WINDOWS_BY_WINRM__NET-INTERFACES__OUT-WARN
 ATTENTION
Panel
Image Removed

Image Added

  • Aucune interface réseau ne correspond à WINDOWS_BY_WINRM__NET-INTERFACES__NET-INTERFACES
INCONNU CRITIQUE
Panel
Image Removed

Image Added

  • Les calculs de moyenne des débits ne sont pas disponibles pour le moment.
INCONNU
Panel

Image Added

  • Dépassement des seuils de trafic entrant et/ou sortant (warning ou critical),

  • Indisponibilité des données nécessaires au calcul des moyennes de débit (mesures absentes),

  • WINDOWS_BY_WINRM__NET-INTERFACES__EXTEND activée (true).

  • Erreur de permission empêchant l’accès à un fichie temporaire d'une interface réseau.

CRITIQUE
Panel

Image Added

Résultat

Le résultat contient un message indiquant le status ainsi que le nombre d'interfaces réseaux trouvées.

Résultat Long

Le résultat long fournit des détails sur chaque interface réseau détectée, incluant son statut ainsi que son débit en Kbps pour les téléchargements et les envois de données.

La donnée WINDOWS_BY_WINRM__NETWORK-INTERFACES__EXTEND configuré à true permet d'afficher un second tableau pour afficher davantage d'informations sur les interfaces réseaux.

Métriques

Definition

Nom de la métriqueUnitéDescriptionSeuil d'avertissementSeuil critique
( NOM_INTERFACE )_in_octetoTotal d'octets émis par l'interface----
( NOM_INTERFACE )_out_octetoTotal d'octets reçus par l'interface----
( NOM_INTERFACE )_in_bit_per_secondb/sDébit entrant moyenWINDOWS_BY_WINRM__NETWORK-INTERFACES__IN-WARN si != 0WINDOWS_BY_WINRM__NETWORK-INTERFACES__IN-CRIT si != 0
( NOM_INTERFACE )_out_bit_per_secondb/sDébit sortant moyenWINDOWS_BY_WINRM__NETWORK-INTERFACES__OUT-WARN si != 0WINDOWS_BY_WINRM__NETWORK-INTERFACES__OUT-CRIT si != 0
( NOM_INTERFACE )_total_in_packetsPaquetTotal des paquets entrants.
Généré uniquement lorsque WINDOWS_BY_WINRM__NETWORK-INTERFACES__EXTEND vaut "true".		----
( NOM_INTERFACE )_total_out_packetsPaquetTotal des paquets sortants.
Généré uniquement lorsque WINDOWS_BY_WINRM__NETWORK-INTERFACES__EXTEND vaut "true".		----
( NOM_INTERFACE )_in_packets_per_secondPaquet/sNombre moyen de paquets entrants par second.
Généré uniquement lorsque WINDOWS_BY_WINRM__NETWORK-INTERFACES__EXTEND vaut "true".		----
( NOM_INTERFACE )_out_packets_per_secondPaquet/sNombre moyen de paquets sortants par seconde.
Généré uniquement lorsque WINDOWS_BY_WINRM__NETWORK-INTERFACES__EXTEND vaut "true".		----
( NOM_INTERFACE )_total_in_packets_errorsPaquetNombre total d’erreurs de paquets entrants.
Généré uniquement lorsque WINDOWS_BY_WINRM__NETWORK-INTERFACES__EXTEND vaut "true".		----
( NOM_INTERFACE )_in_errors_per_secondPaquet/sTaux d’erreur de paquets entrants par seconde.
Généré uniquement lorsque WINDOWS_BY_WINRM__NETWORK-INTERFACES__EXTEND vaut "true".		----

Exemple

Panel

Image Modified

Erreurs et pré-requis

Erreurs de configuration du poller shinken ( spécifique à certains checks )

POLLER - BAD STATE – Permission denied

Le poller qui exécutera les checks nécessite un droit d'écriture et de lecture dans le répertoire décrit par WINDOWS_BY_WINRM__POLLER-SHARED-WORKING-FOLDER-BASE-PATH/WINDOWS_BY_WINRM__POLLER-SHARED-WORKING-FOLDER-TMP-DIRNAME, par défaut /tmp/shinken.


Vous pouvez obtenir les erreurs suivante :

Panel

Image Added

Panel

Image Added

Résolution

Info
titleRemarque

Cette série de commandes ne peut être effectuée qu'en ayant les droits root.

Donc en étant connecté au compte root ou en ayant fait la commande "su" au préalable.

Info
titleRemarque

Les instructions suivantes sont à exécuter sur le ou les pollers shinken.

Code Block
themeEmacs
titleUtilisation
shinken_tmp_dirname="shinken"
mkdir --parents /tmp/$shinken_tmp_dirname
chown -R root:shinken /tmp/$shinken_tmp_dirname
chmod -R g+rwx /tmp/$shinken_tmp_dirname

Explication

1.  La commande mkdir --parents /tmp/$shinken_tmp_dirname crée un récursivement un répertoire.

2. La commande chown -R root:shinken /tmp/$shinken_tmp_dirname modifie le groupe du dossier /tmp/shinken.

  • Cela garantit que des droits peuvent être appliqués au groupe shinken sur ce dossier.

3. La commande chmod -R g+rwx /tmp/$shinken_tmp_dirname applique immédiatement les droits nécessaires au dossier /tmp/shinken pour le groupe shinken.

  • Les droits de lecture, d'écriture et d'exécution sont ajoutés au dossier. Cela permet aux sondes de créer et lire des fichiers dans le dossier /tmp/shinken.


Warning

Il est nécessaire d'adapter la variable shinken_tmp_dirname si vous avez modifié l'un des deux variables suivantes :

  • WINDOWS_BY_WINRM__POLLER-SHARED-WORKING-FOLDER-BASE-PATH
  • WINDOWS_BY_WINRM__POLLER-SHARED-WORKING-FOLDER-TMP-DIRNAME

Excerpt Include
Excerpt Include
NEW_PAGE - SPAC-27 - Erreurs du pack windows-by-WinRM__shinkenNEW_PAGE - SPAC-27 -
Erreurs du pack windows-by-WinRM__shinken
nopaneltrue