e

Sommaire

Contexte

Le modèle de check "Network Interface" renvoie le statut et utilisation des différentes interfaces réseaux du système d'exploitation.

Paramétrage

Le check utilise la ligne de commande suivante :


$PLUGINSDIR$/check_wmi_plus.pl -H "$HOSTADDRESS$" -u "$_HOSTDOMAINUSER$" -p "$_HOSTDOMAINPASSWORD$" 
-m checknetwork -a "$_HOSTWINDOWS_NETWORK_INTERFACE$" --inidir=$PLUGINSDIR$ --security-mechanisms=$_HOSTWINDOWS_SECURITY_MECANISMS$ 
--nokeepstate -y "$_HOSTWINDOWS_NETWORK_INTERFACE_DELAY$" -t "$_HOSTWINDOWS_NETWORK_INTERFACE_TIMEOUT$"

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
DOMAINUSERSHORT

l'Hôte

( Onglet Données )

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

l'Hôte

( Onglet Données )

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

DOMAINUSER

l'Hôte

( Onglet Données )

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

Nom complet utilisé pour se connecter, il faut 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_SECURITY
_MECANISMS

l'Hôte

( Onglet Données )

integrityintegrity

Niveau de sécurité utilisé pour se connecter sur le serveur Windows :

  • integrity : ( par défaut ) valeur de sécurité élevée
  • connect: valeur de sécurité faible, qui sera bloquée sur les serveurs Windows à partir de mi-2022 ( voir la page l'article de microsoft sur le sujet ), à partir des serveurs Windows 2008.
    • Cette valeur ne doit être utilisée que sur de vieux serveurs qui ne gèrent pas les connexions au niveau integrity.


Données spécifiques pour ce check

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

l'Hôte

( Onglet Données )

-**Nom de l'interface réseau à superviser.
WINDOWS_NETWORK_INTERFACE_DELAY

l'Hôte

( Onglet Données )

seconde22

Les métriques se terminant par "PerSec" représentent des moyennes calculées sur une période définie. La donnée _WINDOWS_NETWORK_INTERFACE_DELAY détermine la période sur laquelle cette moyenne est calculée. Pour cette raison, plus le délai est long et plus la valeur de la métrique est significative.

WINDOWS_NETWORK_INTERFACE_TIMEOUT

l'Hôte

( Onglet Données )

seconde1515


Cette donnée spécifie le nombre de secondes au-delà duquel la commande est interrompue. Certaines requêtes et un réseau avec une latence élevée peuvent nécessiter une augmentation de la valeur par défaut.

Si le temps dépasse 60 secondes, il faut modifier la propriété "temps maximum d'exécution d'un check" pour qu'elle surpasse cette valeur (  voir la page La surcharge des propriétés pour un check )

La valeur * permet de récupérer toutes les interfaces réseau.

Plus le temps donné à WINDOWS_NETWORK_INTERFACE_DELAY sera élevé, plus la valeur renvoyée sera précise. Mais cela a un coût sur les ressources utilisées par le Poller exécutant la commande.

Si le temps d'exécution de la commande dépasse la valeur de WINDOWS_NETWORK_INTERFACE_TIMEOUT, la commande va s'interrompre avant d'avoir son résultat. Il est recommandé d'affecter une valeur de WINDOWS_NETWORK_INTERFACE_TIMEOUT toujours supérieure à celle de WINDOWS_NETWORK_INTERFACE_DELAY d'au moins six secondes.

Les données DFE ( Duplicate Foreach )

Pas de données DFE pour ce check.

Données utilisées provenant du check

Pas de données spécifiques pour ce check.

Données globales

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

Non modifiable

( Sauf Admin Shinken )

--

/var/lib/shinken/libexec/var/lib/shinken/libexecChemin absolu du dossier contenant la sonde ( non modifiable )

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

l'Hôte

( Onglet Général )

---

Nom de l'hôteNom de l'hôte

Adresse de l'hôte

​



Résultat

Exemple

Interprétation

Statut

Il peut prendre quatre valeurs OK / INCONNU.

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

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

Situation

Statut

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

  • Si supérieur à WINDOWS_NETWORK_INTERFACE_TIMEOUT ( par défaut :  15s )
INCONNU

Résultat

Renvoi au format texte : 

  • les statistiques des interfaces ( nombre, adresse, ... )

Résultat Long

Pas de résultat long pour ce check.

Métriques

NomUnitéDescription
(nom de l'interface)_BytesReceivedPersec
octet

Quantité totale d'octets reçus par seconde.

(nom de l'interface)_BytesSentPersec
octet

Quantité totale d'octets envoyés par seconde.

(nom de l'interface)_OutputQueueLength
-

Longueur de la file d'attente de sortie.

(nom de l'interface)_PacketsReceivedErrors
-

Quantité totale de paquets reçus en erreurs.

(nom de l'interface)_PacketsReceivedPersec
-

Quantité totale de paquets reçus par seconde.

(nom de l'interface)_PacketsSentPersec
-

Quantité totale de paquets envoyés par seconde.

(nom de l'interface)_Receive_Utilisation
%

Pourcentage du débit utilisé en réception.

(nom de l'interface)_Send_Utilisation
%

Pourcentage du débit utilisé en envoi.