Contexte
Le check Network Interfaces by SNMPv1v2 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 :
$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 "2"
--community "$_HOSTLINUX-BY-SNMP__V1V2-COMMUNITY$" |
Données utilisées provenant des modèles
Données communes pour les checks des modèles
Données communes
| 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 entrants 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
| Nom de la métrique | Description |
|---|---|
| ( NOM_INTERFACE )_in_octet | Total d'octets émis par l'interface |
| ( NOM_INTERFACE )_out_octet | Total d'octets reçus par l'interface |
Pré-requis pour 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 :
|
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 :
|
Erreurs communes
Pour toutes autres erreurs, la page Erreurs communes du pack linux-by-SNMP__shinken répertorie l'ensemble des erreurs possibles lors de l'exécution des checks.