Page History

Scroll Ignore

scroll-pdf	true
scroll-office	true
scroll-chm	true
scroll-docbook	true
scroll-eclipsehelp	true
scroll-epub	true
scroll-html	false

Panel

title	Sommaire

Table of Contents

style	none

Contexte

Le check Interface Interfaces Status by SNMPv3 SNMPv3 vérifie l'état opérationnel (up/down) des interfaces réseau de la baie de stockage HPE Nimble.

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.

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
Panel
Image Removed

Paramétrage

Le check utilise la ligne de commande suivante ( exemple en authPriv, les arguments varient selon le niveau de sécurité configuré ) une des lignes de commandes suivantes selon le modèle d'hôte utilisé :

Code Block

language	bash
theme	Emacs
title	Commande noAuthNoPriv

$GLOBAL__HPE$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$"
    -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$"

Code Block

language	bash
theme	Emacs
title	Commande 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$"
    --usernameauth_password "$_HOSTHPE-NIMBLE-BY-SNMP__V3-LOGIN$_AUTHPASSWORD$"
    --auth_protocol "$_HOSTHPE-NIMBLE-BY-SNMP__AUTHPROTOCOL$"
    --context "$_HOSTHPE-NIMBLE-BY-security_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

language	bash
theme	Emacs
title	Commande authPriv

$GLOBAL__HPE-NIMBLE-BY-SNMP__SHINKEN__PLUGINSDIR$/check_hpe_nimble_health_by_snmp_rust --check check_interfaces_status
    -H "$HOSTADDRESS$"
    --auth_protocolp "$_HOSTHPE-NIMBLE-BY-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__PRIVPASSWORD$"
    --auth__V3-PASSPHRASE-AUTH$protocol "$_HOSTHPE-NIMBLE-BY-SNMP__AUTHPROTOCOL$"
    --priv_protocol "$_HOSTHPE-NIMBLE-BY-SNMP__PRIVPROTOCOL$"
    --context "$_HOSTHPE-NIMBLE-BY-SNMP__V3-PROTOCOL-PRIV$_CONTEXT$"
    --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

Nom

Modifiable sur

Unité

Défaut

Valeur par défaut à l'installation de Shinken

Description

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 )

s

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

Nom

Modifiable sur

Unité

Défaut

Valeur par défaut à l'installation de Shinken

Description

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

Nom

Modifiable sur

Unité

Défaut

Valeur par défaut à l'installation de Shinken

Description

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.

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

Données spécifiques pour ce check

Nom

Modifiable sur

Unité

Défaut

Valeur par défaut à l'installation de Shinken

Description

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.modèle

Excerpt

Section
Données globales

Section

Nom

Modifiable sur

Unité

Défaut

Valeur par défaut à l'installation

Description

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

Données utilisées provenant du check

Excerpt IncludeUptime by SNMPv3Uptime by SNMPv3nopaneltrue

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__MIN-UP-WARN

SHINKEN__VENDOR

Non modifiable

( Sauf Admin Shinken )

--

shinken-additional-packs

shinken-additional-packs

Dossier fourni par Shinken.

No Format
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__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

Nom

Modifiable sur

Unité

Défaut

Valeur par défaut

Description

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.

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-

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.

Panel
Image Added

Situation	Statut	Exemple

ATTENTION Panel

Image Removed


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 .

Image Added

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

ATTENTION

Panel
Image Added

INCONNU

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

Image Added

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étrique	Unité	Description	Seuil d'avertissement	Seuil 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 Modified

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

theme	Emacs

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
nopanel	true

Page tree

Versions Compared

Old Version 8

New Version Current

Key

Contexte

Paramétrage

Données utilisées provenant des modèles

Données communes pour les checks des modèles

Données utilisées provenant du modèle

Données communes pour les checks du modèle

Mode de connexion noAuthNoPriv

Mode de connexion authNoPriv

Mode de connexion authPriv

Données spécifiques pour ce check

Données

utilisées provenant du check

Données globales

Données utilisées provenant du check

Résultat

Exemple

Interprétation des données

Statut

Propriétés de l'hôte

Résultat

Exemple

Interprétation des données

Statut

Résultat

Résultat Long

Métriques

Interprétation des métriques

Exemple

Erreurs et pré-requis

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

UNKNOWN – no interfaces on device

UNKNOWN – no interface matched regex [...]

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