> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/automate-protect-and-extend/fr/integrations-et-api/external-monitoring.md). # Surveillance externe ## 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. {% hint style="warning" %} **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](#snmp-first-tools) ci-dessous pour les solutions de contournement disponibles. {% endhint %} ### Chemins de surveillance pris en charge | Chemin | Utilisation | Public cible | | -------------------------------------------------------------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------- | | [Exportateur Prometheus (ioMetrics)](#prometheus-exporter-iometrics) | Métriques vSAN, de cluster et de nœud | Point de départ recommandé pour la plupart des environnements | | [API REST](#rest-api) | Collecteurs personnalisés, interrogation de n’importe quelle ressource | Intégrations spécifiques à l’outil, vérifications scriptées | | [IPMI](#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)](/automate-protect-and-extend/fr/integrations-et-api/prometheus-exporter.md) 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](/automate-protect-and-extend/fr/surfaces-dadministration-partagees/api-keys.md) pour la configuration et le [Guide API](/knowledge-base/fr/automation-api/verge-api-guide.md) 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. {% hint style="success" %} **Par où commencer** Pour le contexte sur les conventions HTTP, le filtrage, le tri et des exemples de requêtes, voir le [Guide API](/knowledge-base/fr/automation-api/verge-api-guide.md) dans la base de connaissances. {% endhint %} ### 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. {% hint style="info" %} **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. {% endhint %} Pour configurer les identifiants IPMI stockés et tester la connectivité, voir la [IPMI](/run-the-platform/fr/administration-systeme/ipmi.md) 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. {% hint style="success" %} **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](#prometheus-exporter-iometrics) 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**. {% endhint %} ### 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 API](/knowledge-base/fr/automation-api/verge-api-guide.md)Guide 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](#prometheus-exporter-iometrics) 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. {% hint style="warning" %} **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. {% endhint %} *** ## Choisir un chemin | Scénario | Chemin recommandé | | ------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Nouveau déploiement de surveillance, sans engagement avec un outillage existant | [Exportateur Prometheus](#prometheus-exporter-iometrics) + Grafana | | Pile Prometheus / Grafana / VictoriaMetrics existante | [Exportateur Prometheus](#prometheus-exporter-iometrics) | | Outil de surveillance qui interroge HTTP mais pas Prometheus | [API REST](#rest-api) collecteur personnalisé | | Santé matérielle (température, ventilateurs, alimentation) | [IPMI](#ipmi) | | SolarWinds / LogicMonitor / PRTG / Nagios (centrés SNMP) | [Collecteur REST personnalisé](#option-1-custom-rest-collector) préféré, [Passerelle Prometheus-vers-SNMP](#option-2-prometheus-to-snmp-bridge) en solution de repli | ## Étapes suivantes * [Exportateur Prometheus (ioMetrics)](/automate-protect-and-extend/fr/integrations-et-api/prometheus-exporter.md) — aperçu intégré et liens vers le projet open source * [Guide API](/knowledge-base/fr/automation-api/verge-api-guide.md) — authentification, conventions HTTP et exemples de requêtes * [IPMI](/run-the-platform/fr/administration-systeme/ipmi.md) — test de la connectivité, gestion des identifiants et accès à l’interface web IPMI ## Documentation et ressources | Ressource | Description | | ----------------------------------------------------------------------------- | -------------------------------------------------------------- | | [vergeos-exporter](https://github.com/verge-io/vergeos-exporter) | Exportateur Prometheus open source pour VergeOS | | [Documentation Prometheus](https://prometheus.io/docs/introduction/overview/) | Documentation Prometheus en amont | | [Documentation Grafana](https://grafana.com/docs/) | Création de tableaux de bord à partir des métriques Prometheus | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/automate-protect-and-extend/fr/integrations-et-api/external-monitoring.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.