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.
|
Paramétrage
Le check utilise la ligne de commande suivante :
$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$"
--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
Les données communes pour certain checks
Pour les checks suivants :
- Network Interfaces by WinRM
- Stats Disks by WinRM
- Stats Kernel by WinRM ( en developpement )
- Stats NFS by WinRM ( en developpement )
| Nom | Modifiable sur | Unité | Défaut | Description | |
|---|---|---|---|---|---|
| l'Hôte ( Onglet Données ) | -- | /tmp | Chemin absolu où sera créé le dossier WINDOWS_BY_WINRM__WORKING-FOLDER-TMP-DIRNAME. | |
| l'Hôte ( Onglet Données ) | -- | shinken | Nom 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
| Nom | Modifiable sur | Unité | Défaut | Description | |
|---|---|---|---|---|---|
| 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. | |
| l'Hôte ( Onglet Données ) | -- | 0 | Seuil d'AVERTISSEMENT de transfert entrants sur les interfaces (en Kbps). | |
| l'Hôte ( Onglet Données ) | -- | 0 | Seuil CRITIQUE de transfert entrants sur les interfaces (en Kbps). | |
| l'Hôte ( Onglet Données ) | -- | 0 | Seuil d'AVERTISSEMENT de transfert sortant sur les interfaces (en Kbps). | |
| l'Hôte ( Onglet Données ) | -- | 0 | Seuil CRITIQUE de transfert sortant sur les interfaces (en Kbps). | |
| l'Hôte ( Onglet Données ) | -- | false | Affiche un 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
Résultat
Exemple
|
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 :
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 . |
|
Situation | Statut | Exemple |
|---|---|---|
| CRITIQUE |
|
| ATTENTION |
|
| INCONNU |
|
| INCONNU |
|
| INCONNU |
|
| INCONNU |
|
| CRITIQUE |
|
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étrique | Unité | Description | Seuil d'avertissement | Seuil critique | |
|---|---|---|---|---|---|
| ( NOM_INTERFACE )_in_octet | o | Total d'octets émis par l'interface | -- | -- | |
| ( NOM_INTERFACE )_out_octet | o | Total d'octets reçus par l'interface | -- | -- | |
| ( NOM_INTERFACE )_in_bit_per_second | b/s | Débit entrant moyen | WINDOWS_BY_WINRM__NETWORK-INTERFACES__IN-WARN si != 0 | WINDOWS_BY_WINRM__NETWORK-INTERFACES__IN-CRIT si != 0 | |
| ( NOM_INTERFACE )_out_bit_per_second | b/s | Débit sortant moyen | WINDOWS_BY_WINRM__NETWORK-INTERFACES__OUT-WARN si != 0 | WINDOWS_BY_WINRM__NETWORK-INTERFACES__OUT-CRIT si != 0 | |
| ( NOM_INTERFACE )_total_in_packets | Paquet | Total des paquets entrants. Généré uniquement lorsque WINDOWS_BY_WINRM__NETWORK-INTERFACES__EXTEND vaut "true". | -- | -- | |
| ( NOM_INTERFACE )_total_out_packets | Paquet | Total des paquets sortants. Généré uniquement lorsque WINDOWS_BY_WINRM__NETWORK-INTERFACES__EXTEND vaut "true". | -- | -- | |
| ( NOM_INTERFACE )_in_packets_per_second | Paquet/s | Nombre moyen de paquets entrants par second. Généré uniquement lorsque WINDOWS_BY_WINRM__NETWORK-INTERFACES__EXTEND vaut "true". | -- | -- | |
| ( NOM_INTERFACE )_out_packets_per_second | Paquet/s | Nombre moyen de paquets sortants par seconde. Généré uniquement lorsque WINDOWS_BY_WINRM__NETWORK-INTERFACES__EXTEND vaut "true". | -- | -- | |
| ( NOM_INTERFACE )_total_in_packets_errors | Paquet | Nombre total d’erreurs de paquets entrants. Généré uniquement lorsque WINDOWS_BY_WINRM__NETWORK-INTERFACES__EXTEND vaut "true". | -- | -- | |
| ( NOM_INTERFACE )_in_errors_per_second | Paquet/s | Taux d’erreur de paquets entrants par seconde. Généré uniquement lorsque WINDOWS_BY_WINRM__NETWORK-INTERFACES__EXTEND vaut "true". | -- | -- |
Exemple
|
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 :
|
|
Résolution
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. |
Les instructions suivantes sont à exécuter sur le ou les pollers shinken. |
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.
Il est nécessaire d'adapter la variable shinken_tmp_dirname si vous avez modifié l'un des deux variables suivantes :
|