Contexte
Le check Network Interfaces by SNMPv3 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 une des lignes de commandes suivantes selon le modèle d'hôte utilisé :
$LINUX-BY-SNMP__SHINKEN__PLUGINSDIR$/check_linux_health_by_snmp_rust --check check_network_interfaces
-H "$HOSTADDRESS$"
-p "$_HOSTLINUX-BY-SNMP__PORT$"
-t "$_HOSTLINUX-BY-SNMP__TIMEOUT$"
--regex "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__NET-INTERFACES$"
--in_warning "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__IN-WARN$"
--in_critical "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__IN-CRIT$"
--out_warning "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__OUT-WARN$"
--out_critical "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__OUT-CRIT$"
-F "$_HOSTLINUX-BY-SNMP__WORKING-FOLDER-BASE-PATH$/$_HOSTLINUX-BY-SNMP__WORKING-FOLDER-TMP-DIRNAME$"
-d "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__MEASURE-PERIOD$"
--snmp_version "3"
--user "$_HOSTLINUX-BY-SNMP__V3-LOGIN$"
--level "noAuthNoPriv" |
$LINUX-BY-SNMP__SHINKEN__PLUGINSDIR$/check_linux_health_by_snmp_rust --check check_network_interfaces
-H "$HOSTADDRESS$"
-p "$_HOSTLINUX-BY-SNMP__PORT$"
-t "$_HOSTLINUX-BY-SNMP__TIMEOUT$"
--regex "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__NET-INTERFACES$"
--in_warning "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__IN-WARN$"
--in_critical "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__IN-CRIT$"
--out_warning "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__OUT-WARN$"
--out_critical "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__OUT-CRIT$"
-F "$_HOSTLINUX-BY-SNMP__WORKING-FOLDER-BASE-PATH$/$_HOSTLINUX-BY-SNMP__WORKING-FOLDER-TMP-DIRNAME$"
-d "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__MEASURE-PERIOD$"
--snmp_version "3"
--user "$_HOSTLINUX-BY-SNMP__V3-LOGIN$"
--auth_password "$_HOSTLINUX-BY-SNMP__V3-PASSPHRASE-AUTH$"
--auth_protocol "$_HOSTLINUX-BY-SNMP__V3-PROTOCOL-AUTH$"
--level "authNoPriv" |
$LINUX-BY-SNMP__SHINKEN__PLUGINSDIR$/check_linux_health_by_snmp_rust --check check_network_interfaces
-H "$HOSTADDRESS$"
-p "$_HOSTLINUX-BY-SNMP__PORT$"
-t "$_HOSTLINUX-BY-SNMP__TIMEOUT$"
--regex "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__NET-INTERFACES$"
--in_warning "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__IN-WARN$"
--in_critical "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__IN-CRIT$"
--out_warning "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__OUT-WARN$"
--out_critical "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__OUT-CRIT$"
-F "$_HOSTLINUX-BY-SNMP__WORKING-FOLDER-BASE-PATH$/$_HOSTLINUX-BY-SNMP__WORKING-FOLDER-TMP-DIRNAME$"
-d "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__MEASURE-PERIOD$"
--snmp_version "3"
--user "$_HOSTLINUX-BY-SNMP__V3-LOGIN$"
--auth_password "$_HOSTLINUX-BY-SNMP__V3-PASSPHRASE-AUTH$"
--priv_passphrase "$_HOSTLINUX-BY-SNMP__V3-PASSPHRASE-PRIV$"
--auth_protocol "$_HOSTLINUX-BY-SNMP__V3-PROTOCOL-AUTH$"
--priv_protocol "$_HOSTLINUX-BY-SNMP__V3-PROTOCOL-PRIV$"
--level "authPriv" |
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 SNMPv1v2
- Network Interfaces by SNMPv3
- Stats Kernel by SNMPv1v2
- Stats Kernel by SNMPv1v3
- Stats NFS by SNMPv1v2
- Stats NFS by SNMPv3
- Stats Disks by SNMPv1v2
- Stats Disks by SNMPv3
| Nom | Modifiable sur | Unité | Défaut | Valeur par défaut à l'installation | Description | |
|---|---|---|---|---|---|---|
| l'Hôte ( Onglet Données ) | -- | /tmp | /tmp | Chemin absolu où sera créé le dossier LINUX-BY-SNMP__WORKING-FOLDER-TMP-DIRNAME. | |
| l'Hôte ( Onglet Données ) | -- | shinken | 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 | Valeur par défaut à l'installation de Shinken | 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 | 0 | Seuil d' ATTENTION de transfert entrants sur les interfaces (en Kbps). | |
| l'Hôte ( Onglet Données ) | -- | 0 | 0 | Seuil CRITIQUE de transfert sortant sur les interfaces (en Kbps). | |
| l'Hôte ( Onglet Données ) | -- | 0 | 0 | Seuil d' ATTENTION de transfert sortant sur les interfaces (en Kbps). | |
| l'Hôte ( Onglet Données ) | -- | 0 | 0 | Seuil CRITIQUE de transfert sortant sur les interfaces (en Kbps). | |
| | |
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 :
- LINUX-BY-SNMP__NET-INTERFACES__IN-WARN
- LINUX-BY-SNMP__NET-INTERFACES__IN-CRIT
- LINUX-BY-SNMP__NET-INTERFACES__OUT-WARN
- LINUX-BY-SNMP__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 . |
Le texte de la colonne "Affichage des seuils" montre les paramètres utilisés et leur valeur définie sur l'équipement supervisé.
|
Situation | Statut | Exemple | |
|---|---|---|---|
| CRITIQUE |
| |
| ATTENTION |
| |
| CRITIQUE |
| |
| INCONNU |
|
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.
Métriques
Définition
| Nom de la métrique | Unité | Description | Seuil d'avertissement | Seuil critique |
|---|---|---|---|---|
| ( NOM_INTERFACE )_in_octet | Total d'octets émis par l'interface | -- | -- | |
| ( NOM_INTERFACE )_out_octet | Total d'octets reçus par l'interface | -- | -- | |
| ( NOM_INTERFACE )_in_bit_per_second | Débit entrant moyen | LINUX-BY-SNMP__NET-INTERFACES__IN-WARN si != 0 | LINUX-BY-SNMP__NET-INTERFACES__IN-CRIT si != 0 | |
| ( NOM_INTERFACE )_out_bit_per_second | Débit sortant moyen | LINUX-BY-SNMP__NET-INTERFACES__OUT-WARN si != 0 | LINUX-BY-SNMP__NET-INTERFACES__OUT-CRIT si != 0 |
Exemple
|
Erreurs et pré-requis
Erreurs de configuration de l'hôte à superviser ( spécifique à ce check )
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 LINUX-BY-SNMP__WORKING-FOLDER-BASE-PATH/LINUX-BY-SNMP__WORKING-FOLDER-TMP-DIRNAME, par défaut /tmp/shinken .
Vous pouvez obtenir l'erreur suivante :
|
|
RESOLUTION :
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. |
Voici les commandes à exécuter sur vos pollers qui exécuterons ce check.
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 :
|