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_int.pl_rust --check check_network_interfaces
    -H "$HOSTADDRESS$"
    -p "$_HOSTLINUX-BY-SNMP__PORT$"
    -nt "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__NET-INTERFACES$TIMEOUT$"
    -f
    -B
    -a
    -k
    -g-regex "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__USE-HIGH-PERF-TABLE$NET-INTERFACES$"
    -w-in_warning "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__IN-WARN$,"
    --in_critical "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__OUTIN-WARN$CRIT$"
    --cout_warning "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__IN-CRIT$,OUT-WARN$"
    --out_critical "$_HOSTLINUX-BY-SNMP__NET-INTERFACES__OUT-CRIT$"
    -CF "$_HOSTLINUX-BY-SNMP__V1V2-COMMUNITY$"
    -2
    -t "WORKING-FOLDER-BASE-PATH$/$_HOSTLINUX-BY-SNMP__TIMEOUT$WORKING-FOLDER-TMP-DIRNAME$"
    -Fd "$_HOSTLINUX-BY-SNMP__WORKING-FOLDER-BASE-PATH$/NET-INTERFACES__MEASURE-PERIOD$"
    --snmp_version "2"
    --community "$_HOSTLINUX-BY-SNMP__WORKING-FOLDER-TMP-DIRNAME$V1V2-COMMUNITY$"

Données utilisées provenant des modèles

Données communes pour les checks des modèles

Excerpt Include
true
Modèle linux-by-SNMPv1v2
V020802:NEW_PAGE - 02.00.00 - SPAC-25 - Modèle linux-by-SNMPv1v2V020802:NEW_PAGE - 02.00.00 - SPAC-25 - Modèle linux-by-SNMPv1v2nopanel
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'

avertissement

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

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'

avertissement

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

CRITIQUE de transfert sortant sur les interfaces (en Kbps).

No Format
LINUX-BY-SNMP__NET-INTERFACES__USE-HIGH-PERF-TABLE

l'Hôte

( Onglet Données )

--
false
false Utilise des données plus précises, nécessaires pour certaines interfaces réseaux, mais a un impact modéré sur le temps d'exécution de la sonde

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
V020802:NEW_PAGE - 02.00.00 - SPAC-25 - Disks Usage by SNMPv3 ( pour les modèles linux-by-SNMPv3_( noAuthNoPriv / authNoPriv / authPriv ))V020802:NEW_PAGE - 02.00.00 - SPAC-25 -
Disks Usage by SNMPv3 ( pour les modèles linux-by-SNMPv3_( noAuthNoPriv / authNoPriv / authPriv ))
nopaneltrue

Excerpt Include
V020802:NEW_PAGE - 02.00.00 - SPAC-25 - Memory by SNMPv3 ( pour les modèles linux-by-SNMPv3_( noAuthNoPriv / authNoPriv / authPriv ))V020802:NEW_PAGE - 02.00.00 - SPAC-25 -
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 

OK

Situation

Statut

Exemple

  • Aucun des seuils ne sont dépassés

Image Removed

  • 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 Added

Image Removed


  • 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

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

Image Added

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

Image Added

Image Removed

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 ([OK] ou autre) 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

Pré-requis pour ce check

----
( 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 Added

RESOLUTION :

Certains checks requièrent un accès spécifique à des fichiers.

  • Pour ce faire, nous vous mettons à disposition une série de commandes.
    • Ces commandes permettront au groupe de l'utilisateur choisi pour votre supervision Shinken d'avoir un accès ( en lecture, écriture et execution ) au dossier /tmp/shinken.
  • Sans cet accès, la sonde ne fonctionnera pas et vous renverra le statut INCONNU .

  • Cette série de commandes ne peut être effectuée qu'en ayant les droits root.

    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.

    Commande à exécuter

    Code Block
    languagebash
    titlethemeUtilisationEmacs
    shinken_tmp_dirname="shinken"
    mkdir --parents /tmp/$shinken_tmp_dirname
    chown -R root:user-service-shinken /tmp/$shinken_tmp_dirname
    chmod -R g+rwx /tmp/$shinken_tmp_dirname
    Explication

    EXPLICATION :

     11.  La commande mkdir --parents /tmp/$shinken_tmp_dirname crée un récursivement un répertoire.

    2. La commande chown -R root:user-service-shinken /tmp/shinken$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$shinken_tmp_dirname applique immédiatement les droits nécessaires au dossier /tmp/shinken pour le groupe user-service-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 du pack linux-by-SNMP__shinken
    Erreurs du pack linux-by-SNMP__shinken
    nopaneltrue