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-htmltrue
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_snmp_int.plhealth_by_snmp_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
V020802:NEW_PAGE - 02.00.00 - SPAC-25 - Modèle linux-by-SNMPv1v2V020802:
NEW_PAGE - 02.00.00 - SPAC-25 - Modèle linux-by-SNMPv1v2
nopaneltrue

Données communes
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 Modified

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 

Situation

Statut

Exemple

  • Aucun des seuils ne sont dépassés

OK

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


Image RemovedImage 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

Image Added

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

Image Added

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

Image AddedImage 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

Nom de la métriqueDescription
( NOM_INTERFACE )_in_octetTotal d'octets émis par l'interface
( NOM_INTERFACE )_out_octetTotal d'octets reçus par l'interface

Pré-requis pour ce check

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.

    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

    Résolution :
    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 :

     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