Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Scroll Ignore
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmltruefalse
Panel
titleSommaire

Table of Contents
stylenone

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.

Panel

Image RemovedImage Added


Paramétrage

Le check utilise la ligne de commande suivante :

Code Block
languagebash
themeEmacs
$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

Excerpt Include
Modèle linux-by-SNMPv1v2
Modèle linux-by-SNMPv1v2
nopaneltrue

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

NomModifiable surUnitéDéfautValeur par défaut à l'installationDescription
No Format
LINUX-BY-SNMP__WORKING-FOLDER-BASE-PATH

l'Hôte

( Onglet Données )

--/tmp /tmp Chemin absolu où sera créé le dossier LINUX-BY-SNMP__WORKING-FOLDER-TMP-DIRNAME.
No Format
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

NomModifiable surUnitéDéfautValeur par défaut à l'installation de ShinkenDescription
No Format
LINUX-BY-SNMP__NET-INTERFACES__NET-INTERFACES

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.
No Format
LINUX-BY-SNMP__NET-INTERFACES__IN-WARN

l'Hôte

( Onglet Données )

--
0
0

Seuil d' ATTENTION de transfert entrants sur les interfaces (en Kbps).
Utilisez la valeur par défaut 0 pour ignorer le seuil.

No Format
LINUX-BY-SNMP__NET-INTERFACES__IN-CRIT

l'Hôte

( Onglet Données )

--
0
0

Seuil CRITIQUE de transfert entrants sur les interfaces (en Kbps).
Utilisez la valeur par défaut 0 pour ignorer le seuil.

No Format
LINUX-BY-SNMP__NET-INTERFACES__OUT-WARN

l'Hôte

( Onglet Données )

--
0
0

Seuil d' ATTENTION de transfert sortant sur les interfaces (en Kbps).
Utilisez la valeur par défaut 0 pour ignorer le seuil.

No Format
LINUX-BY-SNMP__NET-INTERFACES__OUT-CRIT

l'Hôte

( Onglet Données )

--
0
0

Seuil CRITIQUE de transfert sortant sur les interfaces (en Kbps).
Utilisez la valeur par défaut 0 pour ignorer le seuil.

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

Excerpt Include
Disks Usage by SNMPv3 ( pour les modèles linux-by-SNMPv3_( noAuthNoPriv / authNoPriv / authPriv ))
Disks Usage by SNMPv3 ( pour les modèles linux-by-SNMPv3_( noAuthNoPriv / authNoPriv / authPriv ))
nopaneltrue

Excerpt Include
Memory by SNMPv3 ( pour les modèles linux-by-SNMPv3_( noAuthNoPriv / authNoPriv / authPriv ))
Memory by SNMPv3 ( pour les modèles linux-by-SNMPv3_( noAuthNoPriv / authNoPriv / authPriv ))
nopaneltrue

Résultat

Exemple

Panel

Image RemovedImage Added

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 :


Info

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 .

Info

Le texte de la colonne  "Affichage des seuils" montre les paramètres utilisés et leur valeur définie sur l'équipement supervisé.

Panel

Image RemovedImage Added 

CRITIQUE

Situation

Statut

Exemple

  • Un ou plusieurs des seuils suivants sont dépassés :
    • LINUX-BY-SNMP__NET-INTERFACES__IN-CRIT
    • LINUX-BY-SNMP__NET-INTERFACES__OUT-CRIT

CRITIQUE

Panel
Image Removed

Image Added


  • Un ou plusieurs des seuils suivants sont dépassés :
    • LINUX-BY-SNMP__NET-INTERFACES__IN-WARN
    • LINUX-BY-SNMP__NET-INTERFACES__OUT-WARN
ATTENTION
Panel

Image Added

Image Removed

  • Aucune interface réseau ne correspond à LINUX-BY-SNMP__NET-INTERFACES__NET-INTERFACES
INCONNU
Panel
Image Removed

Image Added

  • Les calculs de moyenne des débits ne sont pas disponibles pour le moment.
INCONNU
Panel
Image Removed

Image Added

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étriqueUnitéDescriptionSeuil d'avertissementSeuil 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 moyenLINUX-BY-SNMP__NET-INTERFACES__IN-WARN si != 0LINUX-BY-SNMP__NET-INTERFACES__IN-CRIT si != 0
( NOM_INTERFACE )_out_bit_per_second
Débit sortant moyenLINUX-BY-SNMP__NET-INTERFACES__OUT-WARN si != 0LINUX-BY-SNMP__NET-INTERFACES__OUT-CRIT si != 0

Exemple

Panel
Image Added

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 :

Panel

Image Added

Panel

Image AddedImage Removed

RESOLUTION :

Info
titleRemarque

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.

Info
titleRemarque

Les instructions suivantes sont à exécuter sur le ou les pollers shinken.

Code Block
languagebash
themeEmacs
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.


Warning

Il est nécessaire d'adapter la variable shinken_tmp_dirname si vous avez modifié l'un des deux variables suivantes :

  • LINUX-BY-SNMP__WORKING-FOLDER-BASE-PATH
  • LINUX-BY-SNMP__WORKING-FOLDER-TMP-DIRNAME

Excerpt Include
Erreurs communes du pack linux-by-SNMP__shinken
Erreurs communes du pack linux-by-SNMP__shinken
nopaneltrue