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-htmlfalse
Panel
titleSommaire

Table of Contents
stylenone

Contexte

Le check

...

Interfaces Status by

...

SNMPv3 vérifie l'état opérationnel

...

des interfaces réseau

...

d'une baie HPE Nimble, via la MIB standard IF-MIB (ifDescr / ifOperStatus).

Il découvre les interfaces, en retient celles dont le nom correspond au regex, puis compte celles qui sont UP.

Info

Le statut dépend du nombre d'interfaces UP par rapport à deux bornes (règle MIN-UP-WARN ≥ MIN-UP-CRIT) :

  • OK si UP MIN-UP-WARN ;
  • ATTENTION si MIN-UP-CRIT UP < MIN-UP-WARN ;
  • CRITIQUE si UP < MIN-UP-CRIT.

Ce check permet donc :

  • de détecter une perte d'interfaces ( aucune UP = stockage inaccessible aux applications ),

  • de suivre le nombre d'interfaces réseau actives de la baie.

Panel

Image Added

Paramétrage

Le check utilise une des lignes de commandes suivantes selon le modèle d'hôte utilisé

  • Il compte le nombre d'interfaces « Up » parmi celles retenues par un filtre (expression régulière sur le nom d'interface), et compare ce nombre à des seuils.
  • Le tableau de l'ensemble des interfaces retenues (statut, nom, adresse MAC) est affiché dans les métriques.
Panel

[Capture d'écran — exemple de configuration du check dans l'interface]

Paramétrage

...

:


Code Block
languagebash
themeEmacs

...

titleCommande noAuthNoPriv
$GLOBAL__HPE-NIMBLE-BY-SNMP__SHINKEN__PLUGINSDIR$/check_hpe_nimble_health_by_snmp_rust --check check_interfaces_status
    -H "$HOSTADDRESS$"
    -p "$_HOSTHPE-NIMBLE-BY-SNMP__PORT$"
    -t "$_HOSTHPE-NIMBLE-BY-SNMP__TIMEOUT$"
    --snmp_version "3"
    --user "$_HOSTHPE-NIMBLE-BY-SNMP__LOGIN$"
    --context "$_HOSTHPE-NIMBLE-BY-SNMP__CONTEXT$"
    --level "noAuthNoPriv"
    --regex "$_HOSTHPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__REGEX$"
    -

...

-min-up-warn "$_HOSTHPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__MIN-UP-WARN$"
    

...

--min-up-crit "$_HOSTHPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__MIN-UP-CRIT$"
Code Block
languagebash
themeEmacs
titleCommande authNoPriv
$GLOBAL__HPE-NIMBLE-BY-SNMP__SHINKEN__PLUGINSDIR$/check_hpe_nimble_health_by_snmp_rust --check check_interfaces_status
    -H "$HOSTADDRESS$"
    -p "$_HOSTHPE-NIMBLE-BY-SNMP__PORT$"
    -t "$_HOSTHPE-NIMBLE-BY-SNMP__TIMEOUT$"
    --snmp_version "3"
    --user "$_HOSTHPE-NIMBLE-BY-SNMP__LOGIN$"
    --

...

auth_password "$_HOSTHPE-NIMBLE-BY-SNMP__

...

AUTHPASSWORD$"
    --auth_protocol "$_HOSTHPE-NIMBLE-BY-SNMP__AUTHPROTOCOL$"
    --context "$_HOSTHPE-NIMBLE-BY-

...

SNMP__CONTEXT$"
    --level "authNoPriv"
    --regex "$_HOSTHPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__REGEX$"
    --min-up-warn "$_HOSTHPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__MIN-UP-WARN$"
    --min-up-crit "$_HOSTHPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__MIN-UP-CRIT$"
Code Block
languagebash
themeEmacs
titleCommande authPriv
$GLOBAL__HPE-NIMBLE-BY-SNMP__SHINKEN__PLUGINSDIR$/check_hpe_nimble_health_by_snmp_rust --check check_interfaces_status
    -H "$HOSTADDRESS$"
    -p "$_HOSTHPE-NIMBLE-BY-

...

SNMP__PORT$"
    -t "$_HOSTHPE-NIMBLE-BY-SNMP__TIMEOUT$"
    --snmp_

...

version "3"
    --user "$_HOSTHPE-NIMBLE-BY-SNMP__LOGIN$"
    --auth_password "$_HOSTHPE-NIMBLE-BY-SNMP__AUTHPASSWORD$"
    --priv_passphrase "$_HOSTHPE-NIMBLE-BY-SNMP__PRIVPASSWORD$"
    --auth_

...

protocol "$_HOSTHPE-NIMBLE-BY-SNMP__AUTHPROTOCOL$"
    --priv_protocol "$_HOSTHPE-NIMBLE-BY-SNMP_

...

_PRIVPROTOCOL$"
    --context "$_HOSTHPE-NIMBLE-BY-SNMP__CONTEXT$"
    --level "authPriv"
    --regex "$_HOSTHPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__REGEX$"
    --

...

min-up-warn "$_HOSTHPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__MIN-UP-WARN$"
    --min-up-crit "$_HOSTHPE-NIMBLE-BY-SNMP__

...

INTERFACES-STATUS__MIN-UP-CRIT$"

Données utilisées provenant du modèle

Données communes pour les checks du modèle

NomModifiable surUnitéDéfautValeur par défaut à l'installation de ShinkenDescription
No Format
HPE-NIMBLE-BY-SNMP__PORT

l'Hôte

( Onglet Données )

--161 161

Port de connexion SNMP.

No Format
HPE-NIMBLE-BY-SNMP__TIMEOUT

l'Hôte

( Onglet Données )

s5 5

Délai d'attente de la connexion SNMP.

No Format
HPE-NIMBLE-BY-SNMP__LOGIN

l'Hôte

( Onglet Données )

--shinken shinken

L'utilisateur SNMPv3 utilisé pour se connecter à la baie de stockage.

Section
Mode de connexion noAuthNoPriv
Section

Pas de données communes supplémentaires pour ce type de connexion SNMPv3

Section
Mode de connexion authNoPriv
Section
NomModifiable surUnitéDéfautValeur par défaut à l'installation de ShinkenDescription
No Format
HPE-NIMBLE-BY-SNMP__AUTHPROTOCOL

l'Hôte

( Onglet Données )

--md5 md5

Protocole d'authentification SNMPv3 ( ex. md5, sha ).

No Format
HPE-NIMBLE-BY-SNMP__AUTHPASSWORD

l'Hôte

( Onglet Données )

--shinkenpass shinkenpass

Mot de passe d'authentification SNMPv3.

Section
Mode de connexion authPriv
Section
NomModifiable surUnitéDéfautValeur par défaut à l'installation de ShinkenDescription
No Format
HPE-NIMBLE-BY-SNMP__AUTHPROTOCOL

l'Hôte

( Onglet Données )

--md5 md5

Protocole d'authentification SNMPv3 ( ex. md5, sha ).

No Format
HPE-NIMBLE-BY-SNMP__AUTHPASSWORD

l'Hôte

( Onglet Données )

--shinkenpass shinkenpass

Mot de passe d'authentification SNMPv3.

No Format
HPE-NIMBLE-BY-SNMP__PRIVPROTOCOL

l'Hôte

( Onglet Données )

--des des

Protocole de chiffrement SNMPv3 ( ex. des, aes ).

No Format
HPE-NIMBLE-BY-SNMP__PRIVPASSWORD

l'Hôte

( Onglet Données )

--shinkenencrypt shinkenencrypt

Clé de chiffrement SNMPv3.

Note

Les arguments d'authentification et de chiffrement ne sont transmis que pour les modes de connexion qui les utilisent ( noAuthNoPriv / authNoPriv / authPriv ), voir la page Configuration.

Données utilisées provenant des modèles

Données communes pour les checks des modèles

...

Données spécifiques pour ce check

NomModifiable surUnitéDéfautValeur par défaut à l'installation de ShinkenDescription
No Format
HPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__REGEX

l'Hôte

( Onglet Données )

--.* .*

Filtre

...

appliqué sur le nom des interfaces (ifDescr)

...

. Seules les interfaces dont le nom correspond

...

sont comptées. Défaut .* = toutes.

No Format
HPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__MIN-UP-WARN

l'Hôte

( Onglet Données )

...

interfaces

...

2

...

2

Le check est OK tant qu'au moins ce nombre d'interfaces

...

(filtrées) sont UP. En dessous, il passe au minimum en ATTENTION . Doit être à MIN-UP-CRIT.

No Format
HPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__MIN-UP-CRIT

l'Hôte

( Onglet Données )

...

interfaces

...

1

...

1

Le check passe en CRITIQUE si le nombre

...

d'interfaces

...

UP est < à cette valeur ( 1 = passe critique quand plus aucune interface n'est UP ). Doit être à MIN-UP-WARN.

Données utilisées provenant du check

Pas de données provenant du check pour ce modèle

Excerpt
Section

Données globales

Section
NomModifiable surUnitéDéfautValeur par défaut à l'installationDescription
No Format
USERPLUGINSDIR

Non modifiable

( Sauf Admin Shinken )

--/var/lib/shinken-user/libexec /var/lib/shinken-user/libexec

Chemin absolu contenant les sondes installées par Shinken.

No Format
HPE-NIMBLE-BY-SNMP__

...

SHINKEN__VENDOR

Non modifiable

( Sauf Admin Shinken )

--shinken-additional-packs shinken-additional-packs

Dossier fourni par Shinken.

No Format
HPE-NIMBLE-BY-SNMP__SHINKEN__PLUGINSDIR

Non modifiable

( Sauf Admin Shinken )

--
No Format
$USERPLUGINSDIR$/$HPE-NIMBLE-BY-SNMP__SHINKEN__VENDOR$/$HPE-NIMBLE-BY-SNMP__SHINKEN__PACKNAME$
/var/lib/shinken-user/libexec/shinken-additional-packs/hpe-nimble-by-SNMP__shinken

Chemin absolu du dossier contenant les sondes du pack.

Section

Propriétés de l'hôte

Section
NomModifiable surUnitéDéfautValeur par défautDescription
No Format
HOSTADDRESS

l'Hôte

( Onglet Général )

--Nom de l'hôte Nom de l'hôte

Adresse de l'hôte.

Données DFE ( Duplicate Foreach )

Pas de données DFE pour ce check.

Données utilisées provenant du check

...

Résultat

Exemple

Panel

...

Image Added

Interprétation des données

Statut

...

  • Il peut prendre 4 états OK / CRITIQUE / ATTENTION / INCONNU .

    • Le statut dépend du nombre d'interfaces

...

    • UP (filtrées par regex) et de la configuration du check :

      • HPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__MIN-UP-WARN
      • HPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__MIN-UP-CRIT

...

    • OK tant que le nombre d'interfaces UP est à MIN-UP-

...

    • WARN.

Info

Aucune interface UP = plus de stockage accessible aux applications. Les seuils suivent la règle MIN-UP-WARN

...

≥ MIN-UP-CRIT.

Panel

Image Added

...

Situation Statut Exemple

...

  • Le nombre d'interfaces

...

  • UP (parmi celles filtrées) est < à MIN-UP-CRIT.

...

CRITIQUE
Panel

Image Added

  • Le nombre d'interfaces

...

  • UP est compris entre MIN-UP-CRIT

...

  • (inclus) et MIN-UP-WARN (exclu).

...

ATTENTION
Panel

Image Added

...

  • Aucune interface ne correspond au

...

  • regex, ou la baie ne remonte aucune interface / erreur SNMP.
INCONNU

Image Added

...

Résultat

Le résultat court indique combien d'interfaces

...

filtrées sont UP sur le total, combien sont DOWN, et rappelle le regex utilisé. En cas d'état non OK, il précise le seuil non atteint.

Résultat Long

Le résultat long

...

affiche un tableau

...

,

...

une ligne par interface filtrée : statut (Up

...

/ Down

...

), nom (ifDescr)

...

et adresse MAC. Les interfaces DOWN sont listées en premier.

Métriques

...

Interprétation des métriques

Nom de la métriqueUnitéDescriptionSeuil d'avertissementSeuil critique
interfaces_up_count --Nombre d'interfaces

...

filtrées qui sont UP au moment de la vérification.

...

MIN-UP-WARN

...

( 2 par défaut )
MIN-UP-CRIT ( 1 par défaut )

Exemple

Panel

...

Image Added

Erreurs et pré-requis

Excerpt

...

Erreurs de configuration de l'hôte à superviser ( spécifique à ce check )

UNKNOWN – no interfaces on device

La baie de stockage ne remonte aucune interface réseau via SNMP ( la table ifTable / ifDescr est vide ).

Panel

[Capture d'écran]

RESOLUTION : Vérifiez que le service SNMP de la baie expose bien la MIB IF-MIB ( ifDescr, ifOperStatus, ifPhysAddress ). Un snmpwalk manuel sur ces OIDs doit renvoyer au moins une interface.

UNKNOWN – no interface matched regex [...]

Aucune interface de la baie ne correspond au filtre HPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__REGEX configuré.

Panel

[Capture d'écran]

RESOLUTION : Corrigez la valeur de HPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__REGEX. Pour lister les interfaces disponibles et leur nom exact, la commande suivante peut être utilisée depuis le poller :

Code Block
themeEmacs
snmpwalk -v3 -u <utilisateur> -l <niveau> -a <auth_protocol> -A <auth_passphrase> -x <priv_protocol> -X <priv_passphrase> <ip-baie> IF-MIB::ifDescr

UI CONFIGURATION - PARAMETER ISSUE – Invalid argument: Invalid regex pattern '...'

La valeur de HPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__REGEX n'est pas une expression régulière valide.

Panel

[Capture d'écran]

-include
Erreurs du pack hpe-nimble-by-SNMP__shinken
Erreurs du pack hpe-nimble-by-SNMP__shinken
nopaneltrue

...