e

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

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.

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.