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 Interface Interfaces Status by SNMPv3SNMPv3 vérifie l'état opérationnel ( up/down ) des interfaces réseau d'une baie HPE Nimble.

Ce check est indépendant des volumes : il est disponible aussi bien sur les modèles all-volumes que selected-volumes.

, 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
Info

Contrairement à un seuil d'utilisation classique, les deux seuils fonctionnent en sens inverse :

  • HPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__MIN-UP-CRIT est le nombre minimum d'interfaces « Up » à observer, en dessous duquel le status passe en CRITIQUE.
  • HPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__MIN-UP-WARN est le nombre minimum d'interfaces « Up » à observer, en dessous duquel le status passe en ATTENTION.

Ce check permet donc :

  • de détecter une ou plusieurs interfaces réseau tombées en panne ( Down perte d'interfaces (aucune UP = stockage inaccessible aux applications),

  • de filtrer les interfaces à surveiller par expression régulière (ex. exclure les interfaces de loopback ou non utilisées)suivre le nombre d'interfaces réseau actives de la baie.

Panel
Image Removed

( capture du résultat du check à insérer )

Paramétrage

Le check utilise la ligne les lignes de commande suivante ( exemple en authPriv, les arguments varient selon le niveau de sécurité configuré ) suivantes en fonction du mode de connexion SNMPv3 :

  • Connexion de type noAuthNoPriv :
Code Block
languagebashtext
themeEmacs
$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$"
    --level "noAuthNoPriv"
    --regex "$_HOSTHPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__REGEX$"
    -w-min-up-warn "$_HOSTHPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__MIN-UP-WARN$"
    -c-min-up-crit "$_HOSTHPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__MIN-UP-CRIT$"
  • Connexion de type authNoPriv :
Code Block
languagetext
themeEmacs
$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"
    --usernameuser "$_HOSTHPE-NIMBLE-BY-SNMP__LOGIN$"
    --auth__V3-LOGIN$password "$_HOSTHPE-NIMBLE-BY-SNMP__AUTHPASSWORD$"
    --auth_protocol "$_HOSTHPE-NIMBLE-BY-SNMP__AUTHPROTOCOL$"
    --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$"
  • Connexion de type authPriv :
Code Block
languagetext
themeEmacs
$HPE-NIMBLE-BY-SNMP__SHINKEN__PLUGINSDIR$/check_hpe_nimble_health_by_snmp_rust --check check_interfaces_status
    -H "$HOSTADDRESS$security_level "authPriv"
    -p "$_HOSTHPE-NIMBLE-auth_protocolBY-SNMP__PORT$"
    -t "$_HOSTHPE-NIMBLE-BY-SNMP__TIMEOUT$"
    --snmp__V3-PROTOCOL-AUTH$version "3"
    --user "$_HOSTHPE-NIMBLE-BY-SNMP__LOGIN$"
    --auth_password "$_HOSTHPE-NIMBLE-BY-SNMP__AUTHPASSWORD$"
    --priv_passphrase "$_HOSTHPE-NIMBLE-BY-SNMP___V3-PASSPHRASE-AUTH$PRIVPASSWORD$"
    --auth_protocol "$_HOSTHPE-NIMBLE-BY-SNMP__AUTHPROTOCOL$"
    --priv_protocol "$_HOSTHPE-NIMBLE-BY-SNMP__V3-PROTOCOL-PRIV$_PRIVPROTOCOL$"
    --level "authPriv"
    --regex "$_HOSTHPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__REGEX$"
    --min-up-warn "$_HOSTHPE-NIMBLE-BY--priv_passphraseSNMP__INTERFACES-STATUS__MIN-UP-WARN$"
    --min-up-crit "$_HOSTHPE-NIMBLE-BY-SNMP__V3-PASSPHRASE-PRIV$"
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

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 )

--161161

Port de connexion SNMP.

No Format
HPE-NIMBLE-BY-SNMP__TIMEOUT

l'Hôte

( Onglet Données )

s55

Délai d'attente de la connexion SNMP.

No Format
HPE-NIMBLE-BY-SNMP__LOGIN

l'Hôte

( Onglet Données )

--shinkenshinken

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 )

--md5md5

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

No Format
HPE-NIMBLE-BY-SNMP__AUTHPASSWORD

l'Hôte

( Onglet Données )

--shinkenpassshinkenpass

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 )

--md5md5

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

No Format
HPE-NIMBLE-BY-SNMP__AUTHPASSWORD

l'Hôte

( Onglet Données )

--shinkenpassshinkenpass

Mot de passe d'authentification SNMPv3.

No Format
HPE-NIMBLE-BY-SNMP__PRIVPROTOCOL

l'Hôte

( Onglet Données )

--desdes

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

No Format
HPE-NIMBLE-BY-SNMP__PRIVPASSWORD

l'Hôte

( Onglet Données )

--shinkenencryptshinkenencrypt

Clé de chiffrement SNMPv3.

Excerpt IncludeModèle hpe-nimble-by-SNMPv3__all-volumesModèle hpe-nimble-by-SNMPv3__all-volumesnopaneltrue

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

par expression régulière

appliqué sur le nom des interfaces (ifDescr)

des interfaces réseau

. Seules les interfaces dont le nom correspond

au filtre sont analysées.

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

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

l'Hôte

( Onglet Données )

--
interfaces
1
2
1Nombre minimum
2

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

« Up » ( parmi celles retenues par le filtre ) en dessous duquel le check passe en ATTENTION.

(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
2
1
2
1

Le check passe en CRITIQUE si le nombre

Nombre minimum

d'interfaces

« Up » ( parmi celles retenues par le filtre ) en dessous duquel le check passe en CRITIQUE. Doit être supérieur ou égal à HPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__

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

Données

DFE ( Duplicate Foreach )

utilisées provenant du check

Pas de données DFE provenant du check pour ce check.

Données utilisées provenant du check

Excerpt IncludeUptime by SNMPv3Uptime by SNMPv3nopaneltrue

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-packsshinken-additional-packs

Dossier fourni par Shinken.

No Format

Résultat

Exemple

Panel

Image Removed

Interprétation des données

Statut

Le check compte le nombre d'interfaces « Up » parmi celles retenues par le filtre, et compare ce nombre aux seuils :
HPE-NIMBLE-BY-SNMP__
INTERFACES-STATUS
SHINKEN__
MIN-UP-WARN
PLUGINSDIR

Non modifiable

( Sauf Admin Shinken )

--
No Format
$USERPLUGINSDIR$/$HPE
HPE
-NIMBLE-BY-SNMP__
INTERFACES-STATUS__MIN-UP-CRIT
Info

Contrairement à un seuil d'utilisation classique, ici MIN-UP-CRIT est la valeur la plus haute : elle représente le nombre d'interfaces « Up » à atteindre pour être totalement OK. En dessous, le check passe en ATTENTION ; en dessous de MIN-UP-WARN, il passe en CRITIQUE.

Voici un tableau récapitulatif du statut attendu suivant le retour de sonde ( avec les valeurs par défaut warn=1, crit=2 ) :

Situation Statut Exemple Le nombre d'interfaces Up ( parmi celles retenues par le filtre ) est à
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ôteNom de l'hôte

Adresse de l'hôte.

Résultat

Exemple

Panel

( capture du résultat à insérer )

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-
CRIT. OK
Panel

Image Removed

Le nombre d'interfaces Up est à
      • WARN
      • HPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__MIN-UP-
WARN et < à
      • 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 ≥

HPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__

MIN-UP-CRIT.

ATTENTION
Situation
panel
Statut
Image Removed
Exemple
  • Le nombre d'interfaces
Up
  • UP (parmi celles filtrées) est < à
HPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__
  • MIN-UP-
WARN
  • CRIT.
CRITIQUE
Panel

Image Removed

  • Aucune interface n'est remontée par la baie .
INCONNU PanelImage Removed

( capture à insérer )

  • Le nombre d'interfaces UP est compris entre MIN-UP-CRIT (inclus) et MIN-UP-WARN (exclu).
ATTENTION

( capture à insérer )

  • Aucune interface ne correspond au
filtre HPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__REGEX
  • regex, ou la baie ne remonte aucune interface / erreur SNMP.
INCONNU
Panel

Image Removed

( capture à insérer )

Résultat

Le résultat court indique combien d'interfaces retenues sont Up/Down ( ex. « All 4 matched interfaces are UP. » ou « 1 out of 4 matched interfaces are UP. 3 are DOWN. » ), le taux de correspondance du filtre par rapport au nombre total d'interfaces de l'équipement, et, si le statut n'est pas OK, le seuil qui explique le changement de statutfiltré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 contient affiche un tableau listant, pour chaque interface retenue par le filtre ( triées par statut ) :

Son

une ligne par interface filtrée : statut (Up

, Down, Testing, Dormant, Not Present, Lower Layer Down ou Unknown ).Son

/ Down), nom (ifDescr)

.Son

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

Métriques

Définition

Interprétation des métriques

HPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__
Nom de la métriqueUnitéDescriptionSeuil d'avertissementSeuil critique
interfaces_up_count--Nombre d'interfaces
« Up » parmi celles retenues par le filtre ( min=0, max=nombre d'interfaces retenues )
filtrées qui sont UP au moment de la vérification.
HPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__
MIN-UP-WARN
(2 par défaut)
MIN-UP-CRIT (1 par défaut)

Exemple

Panel
Image Removed

( capture du perfdata à insérer )

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]

RESOLUTION : Corrigez la syntaxe de l'expression régulière renseignée dans HPE-NIMBLE-BY-SNMP__INTERFACES-STATUS__REGEX ( ex. .* pour toutes les interfaces ).

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