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

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

Prérequis

• Accès à l'interface Web de KentixONE
• Rôle avec les droits pour modifier la configuration
• Facultatif : Navigateur MIB (par ex. iReasoning) pour tester les OIDs

Aperçu

• Le SNMP (Simple Network Management Protocol) permet la surveillance et l'interrogation des appareils via des OIDs décrits dans une MIB.
• KentixONE prend en charge SNMP v2c et v3. De plus, des Traps SNMP (événements) peuvent être envoyés à des systèmes tiers.
• Le glossaire OID peut être téléchargé directement depuis KentixONE et répertorie toutes les valeurs disponibles pour interrogation du système.

Guide pas à pas

1. Accédez à la configuration SNMP

Naviguez vers Configuration → Communication → SNMP.

2. Activez SNMP et ajustez les options

Activez SNMP et, si nécessaire, sélectionnez l'option « Interrogation immédiate après réception de Trap ». Téléchargez le « Glossaire OID » si nécessaire.

Note

Vous devez sauvegarder après activation pour rendre le "Glossaire OID" visible.

Note

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

3. Configurer les accès

Dans « Accès SNMP », vous pouvez configurer des comptes de requête pour des systèmes externes (ex. : Communauté pour v2c ou User/Pass/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 interroge des données de systèmes externes
Envoyer des Traps	Les alertes sont envoyées à des appareils externes

4. Télécharger le glossaire OID

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

5. Comprendre la structure de la MIB

• Les OIDs Kentix commencent sous la branche Enterprise. Les sections fréquentes incluent « system », « sensors », « zones », « logbook », « event ».
• Les tableaux (…Table) contiennent des valeurs de mesure et de statut, organisées par lignes, comme température, humidité, CO, mouvement, vibration, etc.

Structure de la MIB

Les OIDs des appareils Kentix peuvent être consultés via un navigateur MIB (par exemple 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 AlarmManager

6. Interpréter correctement les types de Trap

Les Traps contiennent, entre autres, un ID unique d'appareil (eventGlobalIndex), un horodatage, le type de Trap (eventTraptype) ainsi que des informations détaillées (source, appareil, mesure, zone d'alarme). Cela permet de corréler précisément les alarmes.

Description des Traps (variables)

Voici les principales variables Trap avec leurs OIDs et significations. Ces valeurs correspondent à la MIB Kentix et sont destinées à une é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	Identifiant unique de l'appareil	ex. 5 (AlarmManager)
eventTimestamp	.1.3.6.1.4.1.37954.5.100.2	Horodatage au format Unix lors de l'alarme	ex. 1600438199
(vendredi 18 septembre 2020)
eventTraptype	.1.3.6.1.4.1.37954.5.100.3	Type d'alerte enregistré comme entier	1=Température, 2=Humidité,
3=Point de rosée, etc.
eventAlarmState	.1.3.6.1.4.1.37954.5.100.4	État d'alarme	0=Pas d'alarme, 1=Alarme en cours
eventAlarmDescription	.1.3.6.1.4.1.37954.5.100.5	Valeurs décrivant l'état d'alarme	Alarme sabotage ; Alerte
système ; Alarme, etc.
eventSource	.1.3.6.1.4.1.37954.5.100.6	Source du déclenchement	Batterie ; CO ; Température ; Qualité de
l'air, etc.
eventDevice	.1.3.6.1.4.1.37954.5.100.7	Nom de l'appareil déclencheur	ex. MultiSensor Bureau 1
eventMeasurement	.1.3.6.1.4.1.37954.5.100.8	Mesure ayant déclenché l'alarme	ex. 30,2°C
eventAlarmzone	.1.3.6.1.4.1.37954.5.100.9	Zone d'alarme où l'alarme est apparue	ex. Salle serveur

...

Astuce

Pour des informations détaillées, consultez également SNMP.

7. Docker

Astuce

Ouverture des ports SNMP :

• Ouvrez les ports UDP 161 et 162 pour les communications SNMP (v2/v3)
• Ouvrez également les ports UDP 41.000 et 41.001 pour les réponses