Hermetry peut lire les commutateurs, routeurs, onduleurs (UPS), serveurs, imprimantes et autres équipements dotés d’un agent SNMP. Le poller de la plateforme demande à l’agent les OID que le profil de votre appareil associe, et enregistre les réponses sous forme de télémesures et d’attributs de l’appareil. Aucun fichier MIB n’est nécessaire : vous associez des OID numériques à des clés.
Fonctionnalités prises en charge
| Élément | Prise en charge |
|---|---|
| Versions | SNMPv3 (recommandé) et SNMPv2c (désactivé jusqu’à ce qu’un administrateur de l’espace de travail l’active) |
| Sécurité SNMPv3 | authPriv (par défaut) ou authNoPriv ; noAuthNoPriv n’est pas proposé |
| Authentification SNMPv3 | SHA-256 (par défaut), SHA-512, SHA-384, SHA-224, SHA-1 (ancien) |
| Chiffrement SNMPv3 | AES-128 |
| Emplacement du poller | Dans le cloud. L’agent doit être joignable à une adresse publique, directement ou via votre VPN ou tunnel. |
| Traps | Non reçus. Le cloud ne dispose d’aucun écouteur de traps. |
| Interrogation sur site par une passerelle sous licence | En cours de développement |
| Fichiers MIB | Non utilisés. OID numériques uniquement. |
Étape 1 : créer le profil
- Sous Profils d’appareils, sélectionnez Nouveau profil et choisissez SNMP comme Transport. La règle de connexion est Dernière activité uniquement.
- Ouvrez l’onglet SNMP du profil et construisez le mappage (étape 4). Les modèles intégrés de la référence des modèles SNMP listent des OID et clés prêts à l’emploi pour les équipements courants.
Étape 2 : ajouter l’appareil et son point de terminaison
Ajoutez-le via Appareils > Nouvel appareil > Appareil réseau, choisissez le protocole SNMP et un nouveau point de terminaison. Les étapes sont décrites dans Points de terminaison de protocole. Champs du point de terminaison SNMP :
| Champ | Valeur par défaut | Remarques |
|---|---|---|
| Agent | — | Nom d’hôte ou adresse IP publique à laquelle le cloud joint l’agent |
| Port UDP | 161 | 1 à 65 535 |
| Version SNMP | SNMPv3 (recommandé) | Ou SNMPv2c (communauté en clair) |
| Communauté | — | v2c uniquement. Secret, « Envoyé en clair avec chaque requête. » |
| Utilisateur | — | v3 uniquement |
| Niveau de sécurité | Authentification et chiffrement (authPriv) | Ou Authentification seule (authNoPriv) |
| Authentification | SHA-256 | v3 uniquement |
| Mot de passe d’authentification | — | v3 uniquement. Secret, au moins 8 caractères |
| Chiffrement | AES-128 | v3 avec authPriv |
| Mot de passe de chiffrement | — | v3 avec authPriv. Secret, au moins 8 caractères |
| Nom de contexte | vide | Facultatif. « La plupart des agents utilisent le contexte vide. » |
| Accès du cloud à l’agent | Via un VPN ou un tunnel (recommandé) | Ou Directement via Internet |
Le test de connexion lit le groupe système (sysDescr, sysObjectID, sysUpTime, sysName). Un agent qui ne répond ni à sysUpTime ni à sysObjectID échoue au test.
Avertissements affichés lors d’un test (ils ne le font pas échouer) : « SNMPv2c : la chaîne de communauté circule en clair. », « SNMPv2c directement via Internet : la chaîne de communauté le traverse en clair. », « authNoPriv : les messages sont signés mais non chiffrés. », « L’authentification SHA-1 est ancienne. »
Étape 3 (v2c uniquement) : activer SNMPv2c
SNMPv2c envoie sa communauté en clair ; l’interrogation v2c depuis le cloud est donc désactivée pour chaque espace de travail jusqu’à ce qu’un administrateur l’active. Enregistrer un point de terminaison v2c alors que cette option est désactivée est refusé : « L’interrogation SNMPv2c depuis le cloud est désactivée pour cet espace de travail. Utilisez SNMPv3, enregistrez le point de terminaison désactivé, ou laissez un administrateur de l’espace de travail activer v2c ci-dessous. »
- Sous le refus, sélectionnez Activer SNMPv2c pour cet espace de travail.
- Lisez l’avertissement, cochez « Je comprends que la chaîne de communauté circule en clair. » et sélectionnez Activer.
- Enregistrez ou réactivez à nouveau le point de terminaison. Activer v2c n’active aucun point de terminaison par lui-même.
Un point de terminaison v2c accessible Directement via Internet nécessite aussi sa propre confirmation : « Je comprends que la chaîne de communauté traverse Internet en clair ».
Désactiver à nouveau SNMPv2c côté cloud désactive d’un coup chaque point de terminaison v2c de l’espace de travail ; leur interrogation s’arrête au prochain rafraîchissement du poller. Le réactiver plus tard ne réactive rien : activez de nouveau chaque point de terminaison. Les deux changements sont consignés dans le journal d’audit.
Étape 4 : associer les OID aux clés
L’onglet SNMP du profil, Mappage SNMP, indique « Les OID que la plateforme lit depuis les appareils de ce profil et les clés sous lesquelles elle les enregistre. »
Valeurs (scalaires) : un OID, une clé, lus à chaque interrogation.
| Champ | Signification |
|---|---|
| OID | Numérique, par exemple 1.3.6.1.2.1.1.3.0 pour sysUpTime.0 |
| Clé | Commence par une lettre ; lettres, chiffres et _ . : -, 96 caractères au maximum |
| Enregistré comme | Télémesure (série temporelle) ou Attribut (dernière valeur) |
| Type | Automatique, Jauge / entier, Counter32, Counter64, TimeTicks (secondes), Texte, Énumération, Adresse IP |
| Taux par seconde | Pour les compteurs : la variation par seconde. Le premier échantillon après un démarrage est ignoré ; un dépassement de 32 bits est géré. Non applicable aux attributs. |
| Échelle | Un multiplicateur, par exemple 0.1 pour convertir des dixièmes en unités. Pas 0. |
| Unité | 16 caractères au maximum |
| Valeurs et leurs libellés | Pour une énumération, une par ligne : 1=up. 64 valeurs au maximum. |
Tables : colonnes parcourues. Chaque ligne de la table devient une clé par colonne, <clé>.<ligne>.
| Champ | Signification |
|---|---|
| Nom | Un libellé pour vous (par exemple ifTable) ; non utilisé par la plateforme |
| Lignes nommées par | L’index de ligne (le suffixe de l’OID) ou La valeur d’une autre colonne (par exemple ifName, les clés se lisent alors if.in_bps.eth0) |
| Limite de lignes | 1 à 256 lignes, 64 par défaut. Les lignes supplémentaires sont écartées et signalées. |
| Colonnes | 1 à 16 colonnes, chacune avec les champs de valeur ci-dessus. OID de colonne est la colonne sans l’index de ligne. |
Paramètres d’interrogation : Délai d’attente (ms) 200 à 10 000 (2 000 par défaut), Nouvelles tentatives 0 à 3 (1 par défaut), Lignes par requête en bloc 1 à 50 (10 par défaut). « L’intervalle d’interrogation est l’intervalle attendu du profil » ; voir Intervalles d’interrogation, temporisation et quotas.
Sélectionnez Enregistrer. Le mappage est vérifié avant d’être enregistré :
| Limite | Valeur |
|---|---|
| Valeurs | 200 lignes |
| Tables | 8 |
| Clés de télémesure qu’un mappage peut produire (toutes les tables pleines) | 200 par appareil |
| Attributs | 50 par appareil |
| Clés ou OID en double | Non autorisés |
L’éditeur affiche « Ce mappage produit jusqu’à {telemetry} clés de télémesure et {attributes} attributs par appareil. » Réduisez la limite de lignes d’une table ou supprimez des colonnes lorsque la valeur est dépassée.
La suppression d’une valeur ou d’une table arrête sa lecture à la prochaine interrogation ; l’historique enregistré est conservé.
Interrogation de test
Dans l’onglet SNMP, Interrogation de test demande à un appareil de ce profil les OID avec les identifiants stockés de son point de terminaison. Rien n’est enregistré.
- Choisissez l’Appareil (connecté via un point de terminaison SNMP).
- Choisissez Groupe système, Valeurs de ce mappage, ou saisissez des OID (numériques, un par ligne, dans la limite indiquée).
- Sélectionnez Lancer l’interrogation de test. La réponse liste l’OID, le Type SNMP, la Valeur brute et ce à quoi elle est Associée. Sélectionnez Ajouter au mappage sur une ligne pour l’ajouter (enregistrez ensuite).
Lancer une interrogation de test requiert la permission de gérer les points de terminaison de protocole. Les interrogations de test sont limitées en débit (« Trop d’interrogations de test. Réessayez dans {seconds} s. »).
Traps
La liste Traps de l’onglet SNMP sert au mappage des traps sur les passerelles sous licence installées sur site, fonctionnalité en cours de développement. Le cloud ne reçoit pas de traps. Pour être alerté rapidement, interrogez les OID d’état concernés et ajoutez une règle d’alarme sur leurs clés.
Dépannage
| Le test d’interrogation indique | Correction |
|---|---|
| « L’agent n’a pas répondu à temps (vérifiez l’adresse, le port ainsi que le pare-feu ou le VPN). » | Autorisez les adresses du poller vers l’UDP 161 (ou votre port). |
| « Échec de l’authentification (vérifiez l’utilisateur et les clés). » | Utilisateur v3 ou mot de passe d’authentification incorrect. |
| « L’agent n’a pas pu déchiffrer la requête (vérifiez le mot de passe de chiffrement). » | Mot de passe de chiffrement incorrect. |
| « L’agent ne connaît pas cet utilisateur SNMPv3. » | Créez l’utilisateur sur l’agent. |
| « L’agent a refusé la requête car hors de sa fenêtre temporelle. » | Réessayez ; vérifiez l’horloge de l’agent. |
| « No such object » / « No such instance » | L’agent ne possède pas cet OID. Vérifiez l’OID et l’index de ligne. |
| « Le SNMPv2c depuis le cloud est désactivé pour ce compte. Un administrateur de l’espace de travail peut l’activer. » | Voir l’étape 3. |