Comment surveiller les appareils du réseau via SNMP et lire des valeurs spécifiques ?

Ce guide explique brièvement ce qu'est le SNMP, comment activer le SNMP dans KentixONE, et comment utiliser le glossaire OID, la structure des MIB, et les informations de trap pour l'intégration dans des systèmes externes.

Prérequis

• Accès à l'interface web KentixONE
• Rôle avec des autorisations pour modifier la configuration
• Optionnel : Navigateur MIB (par ex. iReasoning) pour tester les OID

Vue d'ensemble

• SNMP (Simple Network Management Protocol) est utilisé pour surveiller et interroger des appareils via des OID décrites dans une MIB.
• KentixONE prend en charge SNMP v2c et v3. Des traps SNMP (événements) peuvent également être envoyés vers des systèmes tiers.
• Le glossaire OID peut être téléchargé directement depuis KentixONE et liste toutes les valeurs interrogeables du système.

Guide étape par étape

1. Ouvrir SNMP dans la configuration

Accédez à Configuration → Communication → SNMP.

2. Activer SNMP et définir les options

Activez SNMP et sélectionnez en option « Interrogation immédiate après réception d'un trap ». Téléchargez le « Glossaire OID » si nécessaire.

Note

Vous devez enregistrer après l'activation pour rendre visible le "Glossaire OID".

Note

Versions SNMP : Utilisez v3 si possible, car elle offre une authentification/chiffrement. Pour des tests simples, v2c suffit.

3. Ajouter des accès

Dans « Accès SNMP », vous pouvez configurer des comptes d'interrogation pour des systèmes externes (par ex., Communauté pour v2c ou Utilisateur/Mot de passe/Privé pour v3).

Type SNMP	Description
Fournir des données	Les données peuvent être interrogées par un appareil externe
Récupérer des données	L'appareil Kentix récupère des données depuis des systèmes externes
Envoyer un trap	Les alertes sont envoyées vers des appareils externes

4. Télécharger le glossaire OID

Via « Télécharger le glossaire OID », vous recevez un aperçu CSV de toutes les OID. Utilisez-le pour les systèmes de surveillance et les navigateurs MIB.

5. Comprendre la structure des MIB

• Les OID Kentix commencent sous la branche « Enterprise ». Les domaines fréquents incluent « system », « sensors », « zones », « logbook », « event ».
• Les tableaux (…Table) contiennent des valeurs de mesure et d'état basées sur des lignes comme température, humidité, CO, mouvement, vibration, etc.

Structure des MIB

Les OID des appareils Kentix peuvent être mieux explorées à l'aide d'un navigateur MIB (par ex. https://ireasoning.com/mibbrowser.shtml).

La structure de base pour un AlarmManager est la suivante :

OID	Nom
.1.3.6.1.4.1.37954.5	kentixdevices
.1.3.6.1.4.1.37954.5.1	system
.1.3.6.1.4.1.37954.5.1.1	valuemultiplier
.1.3.6.1.4.1.37954.5.1.2	alarmstate
.1.3.6.1.4.1.37954.5.1.3	energy
.1.3.6.1.4.1.37954.5.2	sensors
.1.3.6.1.4.1.37954.5.2.1	generalTable
.1.3.6.1.4.1.37954.5.2.2	temperatureTable
.1.3.6.1.4.1.37954.5.2.3	humidityTable
.1.3.6.1.4.1.37954.5.2.4	dewpointTable
.1.3.6.1.4.1.37954.5.2.5	coTable
.1.3.6.1.4.1.37954.5.2.6	motionTable
.1.3.6.1.4.1.37954.5.2.7	vibrationTable
.1.3.6.1.4.1.37954.5.2.8	latencyTable
.1.3.6.1.4.1.37954.5.2.100	inputs
.1.3.6.1.4.1.37954.5.2.101	outputs
.1.3.6.1.4.1.37954.5.2.102	pdus
.1.3.6.1.4.1.37954.5.3	zones
.1.3.6.1.4.1.37954.5.3.1	zoneTable
.1.3.6.1.4.1.37954.5.4	logbook
.1.3.6.1.4.1.37954.5.4.1	systemLogbookTable
.1.3.6.1.4.1.37954.5.4.2	accessLogbookTable
.1.3.6.1.4.1.37954.5.4.3	eventLogbookTable
.1.3.6.1.4.1.37954.5.100	event

Exemple de table MIB d’un AlarmManager

6. Interpréter correctement les types de trap

Les traps contiennent entre autres un ID unique de l'appareil (eventGlobalIndex), un horodatage, le type de trap (eventTraptype), ainsi que des détails (source, appareil, valeur mesurée, zone d'alarme). Ils permettent une corrélation précise des alarmes.

Description des traps (variables)

Ci-dessous figurent les principales variables de traps, y compris les OID et leur signification. Les valeurs correspondent au MIB Kentix et sont destinées à l’évaluation dans des systèmes externes.

AlarmManager / PowerManager / PDU

Nom	OID	Description	Valeurs possibles
eventGlobalIndex	.1.3.6.1.4.1.37954.5.100.1	ID unique de l'appareil	par ex., 5 (AlarmManager)
eventTimestamp	.1.3.6.1.4.1.37954.5.100.2	Horodatage au moment de l'alerte/statut acquittable au format Unix
par ex., 1600438199 (vendredi 18 septembre 2020)
eventTraptype	.1.3.6.1.4.1.37954.5.100.3	Type d'alerte inscrit en tant qu'entier	1=Température, 2=Humidité,
3=Point de rosée, 4=Feu (DI comme alarme incendie), 5=Intrusion, 6=Vibration, 7=Latence, 8=Connexion au service
perdue, 9=SNMP, 11=Chaleur, 12=Qualité de l'air, 14=TI-Incendie, 15=Compteur de personnes, 16=Incendie-Qualité de
l’air, 18=CO2, 21=Dérive de courant, 24=Excès de puissance réelle, 30=Surtension, 31=RCM (AC), 32=RCM (DC),
33=Coupe-circuit, 51=Sabotage (par ex., Inclinaison/DI), 52=Perte de connexion (Caméra/Appareil), 53=Panne de
courant, 54=Batterie, 101=Entrée numérique (pas une alarme incendie/sabotage)
eventAlarmState	.1.3.6.1.4.1.37954.5.100.4	Statut de l'alarme	0=Pas d'alarme, 1=Alarme en cours (même si
acquittable)
eventAlarmDescription	.1.3.6.1.4.1.37954.5.100.5	Selon l'association de l'alarme, les valeurs suivantes sont
émises	Alarme de sabotage (en cas de sabotage); Notification système (en cas d'alarme batterie); Alarme (pour les
autres types d'alarme – permanent, déclenché, etc.)
eventSource	.1.3.6.1.4.1.37954.5.100.6	Quelle alarme a été déclenchée	Batterie; CO/Dioxyde de carbone;
Imagerie thermique; Nombre de personnes; Qualité de l’air; Capteur de chaleur; Point de rosée; Énergie; Température
ambiante; Humidité relative; Reed; Mouvement; Latence; Connexion; Sabotage; Vibration; SNMP; Nom de l’entrée
numérique (s'il a été déclenché via DI)
eventDevice	.1.3.6.1.4.1.37954.5.100.7	Nom de l'appareil ayant déclenché l'alarme	par ex., MultiSensor
Bureau 1
eventMeasurement	.1.3.6.1.4.1.37954.5.100.8	Valeur mesurée à l’origine de l’alerte/température	par ex., 30,2
°C
eventAlarmzone	.1.3.6.1.4.1.37954.5.100.9	Nom de la zone de l’alarme	par ex., Salle serveur

Astuce

Pour plus d'informations, consultez également SNMP.

Conseils et Astuces

• Commencez avec v3 (authPriv) si votre système le prend en charge ; définissez des mots de passe/clefs robustes.
• Utilisez le glossaire OID comme « vérité » pour les requêtes ; vérifiez les modifications après les mises à jour du firmware.
• Pour les tests : interrogez de manière ciblée des OID uniques avec un navigateur MIB et comparez-les avec l'interface KentixONE.
• Téléchargez un fichier MIB (SNMP V2/3) directement depuis notre site Web (Ressources -> Téléchargements de logiciels).

Exemples de requêtes

Interrogation de l’état de la batterie sur les DoorLocks

L'état de la batterie à l'interrogation SNMP retourne les valeurs suivantes :

• 0 = Batterie OK
• 1 = Avertissement, batterie presque déchargée (tient généralement encore plusieurs jours)
• 2 = Critique, batterie très faible (doit être remplacée « immédiatement »)
• 3 = Batterie déchargée

Signal GSM

L'interrogation du signal GSM donne les valeurs suivantes :

• 0 = Pas de réception
• 1 = 25% de réception
• 2 = 50% de réception
• 3 = 75% de réception
• 4 = 100% de réception

Dépannage

• Aucune valeur à l'interrogation : Vérifiez la version de SNMP, la Communauté/Utilisateur, le pare-feu, et si SNMP est activé dans KentixONE.
• Valeurs incorrectes : Comparez l'OID et l'index (pour les tableaux) ; utilisez le glossaire OID actuel.
• Les traps ne parviennent pas : Vérifiez l'hôte cible/le port, l'accessibilité réseau, et si les traps sont activés sur le système.

Glossaire

• OID : Identifiant d'objet – identification unique d'une valeur dans la MIB.
• MIB : Base d'informations de gestion – structure décrivant toutes les OID d'un fabricant/domaine fonctionnel.
• Trap : Notification d'événement asynchrone qu'un appareil envoie à un gestionnaire SNMP.
• v2c/v3 : Versions du protocole, v3 prenant en charge authentification/confidentialité (auth/priv).