Contexte
Le modèle de check "Network Interface by WMI" 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$" --extrawmicarg "--option=client ntlmv2 auth=Yes"
Données utilisées provenant du modèle
Données communes pour les checks du modèle
| Nom | Modifiable sur | Défaut | Valeur par défaut à l'installation de Shinken | Description |
|---|---|---|---|---|
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.
|
WINDOWS_SECURITY _MECANISMS | l'Hôte ( Onglet Données ) | integrity | integrity | Niveau de sécurité utilisé pour se connecter sur le serveur Windows :
|
Données spécifiques pour ce check
| Nom | Modifiable sur | Unité | Défaut | Valeur par défaut à l'installation de Shinken | Description |
|---|---|---|---|---|---|
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 ) | seconde | 2 | 2 | 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 ) | seconde | 15 | 15 | 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.
Non modifiable ( Sauf Admin Shinken ) --Données globales
Nom Modifiable sur Unité Défaut Valeur par défaut à l'installation de Shinken Description PLUGINSDIR
/var/lib/shinken/libexec /var/lib/shinken/libexec Chemin absolu du dossier contenant la sonde ( non modifiable )
l'Hôte ( Onglet Général ) --- Adresse de l'hôteNom Modifiable sur Unité Défaut Valeur par défaut à l'installation de Shinken Description HOSTADDRESS
Nom de l'hôte Nom 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
- 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
| 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
| Nom | Unité | 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. |