Supervision externe

VergeOS ne prend pas en charge SNMP. Ce guide couvre les voies prises en charge pour la supervision externe — le Prometheus Exporter (ioMetrics), l’API REST et IPMI — ainsi que les outils SNMP-first comme SolarWinds.

Aperçu

Cette page décrit comment intégrer VergeOS avec des plateformes externes de surveillance et d’observabilité. VergeOS est API-first et expose la santé de la plateforme, les performances et les données des capteurs matériels via trois chemins pris en charge.

SNMP n’est pas pris en charge

VergeOS n’inclut ni agent SNMP, ni MIB, ni mécanisme de trap. SNMP a été conçu à la fin des années 1980 pour gérer des périphériques réseau matériels, tels que des routeurs, des commutateurs et des imprimantes, et non des plateformes modernes définies par logiciel. VergeOS est API-first : chaque métrique et chaque ressource qu’un agent SNMP exposerait est déjà disponible via l’API REST et l’Exportateur Prometheus, qui fournissent des données structurées plus riches sur HTTP standard. Cela reflète l’évolution plus large du secteur, Microsoft ayant abandonné le service SNMP dans Windows Server 2012, et les plateformes cloud-native et hyperviseurs s’alignant sur le format d’exposition Prometheus. Si votre outil de surveillance legacy exige SNMP, voir Outils orientés SNMP ci-dessous pour les solutions de contournement disponibles.

Chemins de surveillance pris en charge

Chemin	Utilisation	Public cible
Exportateur Prometheus (ioMetrics)	Métriques vSAN, de cluster et de nœud	Point de départ recommandé pour la plupart des environnements
API REST	Collecteurs personnalisés, interrogation de n’importe quelle ressource	Intégrations spécifiques à l’outil, vérifications scriptées
IPMI	Santé matérielle et capteurs par nœud	Surveillance au niveau matériel en dehors de VergeOS

---

Exportateur Prometheus (ioMetrics)

Le Exportateur Prometheus VergeOS (ioMetrics) est le chemin recommandé pour les métriques au niveau de la plateforme. Il collecte les métriques des couches vSAN, cluster et nœud depuis VergeOS et les expose au format Prometheus standard, prêtes à être récupérées par Prometheus, Grafana, VictoriaMetrics ou tout système compatible Prometheus.

Pourquoi c’est le chemin recommandé

• Première partie — maintenu au sein de l’organisation verge-io
• Basé sur des standards — tout outil de surveillance compatible Prometheus peut consommer la sortie

Voir la Exportateur Prometheus (ioMetrics) page pour l’aperçu intégré, les métriques exposées et les liens vers le projet open source.

---

API REST

L’API REST de VergeOS expose chaque ressource que l’interface utilisateur peut lire, ce qui en fait le bon chemin pour les collecteurs personnalisés, les vérifications de santé scriptées ou l’intégration avec des outils qui ne parlent pas Prometheus.

Authentification

Les collecteurs de surveillance externes sont des processus de longue durée et doivent s’authentifier avec une clé API plutôt qu’avec un jeton de session. Les clés API sont créées par utilisateur, peuvent être limitées à certaines adresses IP et avoir une date d’expiration. Voir Clés API pour la configuration et le Guide API pour la liste complète des méthodes d’authentification prises en charge.

Documentation Swagger

La référence API complète et exacte selon la version est disponible dans VergeOS :

1. Cliquez sur l’ icône utilisateur en haut à droite de l’interface VergeOS.
2. Sélectionnez Système.
3. Sélectionnez Documentation de l’API.

La page Swagger répertorie chaque table et opération, avec des exemples qui peuvent être exécutés directement sur le système.

Par où commencer

Pour le contexte sur les conventions HTTP, le filtrage, le tri et des exemples de requêtes, voir le Guide API dans la base de connaissances.

Quand utiliser l’API REST pour la surveillance

• L’outil de surveillance prend en charge l’interrogation HTTP mais pas Prometheus
• Une métrique ou ressource spécifique n’est pas exposée par l’Exportateur Prometheus
• Un collecteur personnalisé est nécessaire pour s’intégrer à une plateforme d’observabilité interne

---

IPMI

Pour les données de santé matérielle et de capteurs par nœud — température, vitesse des ventilateurs, tension, consommation électrique, erreurs matérielles — VergeOS expose directement l’interface IPMI du nœud.

1. Accédez à Infrastructure > Nœuds dans le menu supérieur.
2. Double-cliquez sur le nœud souhaité pour ouvrir le tableau de bord du nœud.
3. Sous le IPMI sous-menu, cliquez sur Connecter pour ouvrir l’interface web IPMI dans un nouvel onglet, ou Tester pour vérifier la connectivité depuis VergeOS.

Matériel uniquement

IPMI expose l’ matériel physique état d’un nœud hôte — pas les métriques de la couche applicative de VergeOS. La plupart des plateformes de surveillance incluent déjà des collecteurs IPMI capables d’interroger directement les BMC des nœuds, en parallèle des chemins Exportateur Prometheus et API REST ci-dessus.

Pour configurer les identifiants IPMI stockés et tester la connectivité, voir la IPMI page.

---

Outils orientés SNMP

Des outils tels que SolarWinds, LogicMonitor, PRTG, et Nagios sont souvent configurés pour surveiller l’infrastructure via SNMP. VergeOS n’a pas d’intégration prête à l’emploi pour ces outils, car il n’y a aucun agent SNMP à cibler.

Vérifiez d’abord la prise en charge native de Prometheus

Certaines de ces plateformes ingèrent désormais les métriques Prometheus de manière native — LogicMonitor (source de données OpenMetrics) et SolarWinds Observability (intégration Prometheus). Si votre plateforme en fait partie, pointez-la vers l’ Exportateur Prometheus et ignorez le reste de cette section. Les deux options ci-dessous couvrent les outils qui ne parlent pas Prometheus — y compris la plateforme sur site SolarWinds Platform / SAM, PRTG, et Nagios.

Option 1 — Collecteur REST personnalisé

La plupart des plateformes de surveillance d’entreprise autorisent des collecteurs HTTP/REST personnalisés :

Plateforme	Mécanisme
SolarWinds	Interrogateur API (SAM)
LogicMonitor	Source de données scriptée (Groovy / HTTP)
PRTG	Capteur personnalisé HTTP XML/REST
Nagios	check_http / plugin personnalisé

Pointez le collecteur vers l’API REST de VergeOS, authentifiez-vous selon le Guide APIGuide API, et analysez la réponse JSON. C’est le chemin le moins coûteux en surcharge — aucun processus intermédiaire à maintenir, et le collecteur communique directement avec la source de vérité.

Option 2 — Passerelle Prometheus-vers-SNMP

Si l’outil de surveillance ne parle que SNMP et qu’un collecteur personnalisé n’est pas une option, le schéma communautaire consiste à exécuter le Exportateur Prometheus Exportateur Prometheus et à placer devant lui une passerelle Prometheus-vers-SNMP. La passerelle réexpose les métriques Prometheus sous forme d’OID SNMP que le sondeur SNMP peut interroger.

Non pris en charge par Verge

Les passerelles Prometheus-vers-SNMP sont des projets communautaires et ne sont ni développées, ni testées, ni prises en charge par Verge. Nous ne recommandons pas de passerelle spécifique — le choix dépend de la sous-partie des métriques Prometheus qui doit être réexposée et de la manière dont l’outil en aval consomme SNMP. Considérez ce chemin comme une solution provisoire, et non comme une intégration à long terme.

---

Choisir un chemin

Scénario	Chemin recommandé
Nouveau déploiement de surveillance, sans engagement avec un outillage existant	Exportateur Prometheus + Grafana
Pile Prometheus / Grafana / VictoriaMetrics existante	Exportateur Prometheus
Outil de surveillance qui interroge HTTP mais pas Prometheus	API REST collecteur personnalisé
Santé matérielle (température, ventilateurs, alimentation)	IPMI
SolarWinds / LogicMonitor / PRTG / Nagios (centrés SNMP)	Collecteur REST personnalisé préféré, Passerelle Prometheus-vers-SNMP en solution de repli

Étapes suivantes

• Exportateur Prometheus (ioMetrics) — aperçu intégré et liens vers le projet open source
• Guide API — authentification, conventions HTTP et exemples de requêtes
• IPMI — test de la connectivité, gestion des identifiants et accès à l’interface web IPMI

Documentation et ressources

Ressource	Description
vergeos-exporter	Exportateur Prometheus open source pour VergeOS
Documentation Prometheus	Documentation Prometheus en amont
Documentation Grafana	Création de tableaux de bord à partir des métriques Prometheus