Observabilité — le modèle de lecture du moteur sur lui-même
Observabilité (modules/observability) est l’un des 30 modules — comme
live-ingest, il remplit un rôle
architectural plutôt qu’il ne comble une fonctionnalité. C’est le modèle de
lecture du moteur sur lui-même : trois surfaces en lecture seule sous
/v1/m/observability/ qui répondent aux questions que rend la section System de
la console d’administration, sans posséder une seule entité de stockage.
Les trois surfaces
Section intitulée « Les trois surfaces »| Route | Réponses |
|---|---|
GET /ingestion-health | ce qui entre et sort du moteur par standard d’interopérabilité — les standards que le moteur épingle (OTel GenAI semconv, OCSF, ASIM, les formats SIEM unifiés, le push du journal, le texte Prometheus, W3C Trace Context), chacun avec sa version vérifiée |
GET /traces, GET /traces/{id} | ce que le journal d’audit corrélé W3C dit d’une trace — la vue côté audit d’une trace distribuée, jointe par Trace Context |
GET /attestation | ce qui est prouvable concernant la chaîne d’approvisionnement du binaire en cours d’exécution — la surface d’attestation que la chaîne de vérification d’une version alimente |
Les trois sont des lectures avec des permissions à portée de module ; rien ici ne modifie quoi que ce soit.
Pourquoi c’est un module à part entière
Section intitulée « Pourquoi c’est un module à part entière »La console d’administration avait besoin d’une réponse faisant autorité à la question « que parle réellement ce moteur, et à quelle version épinglée ? » — et la manière honnête de la servir est depuis le moteur lui-même, non depuis une documentation susceptible de dériver. La table ingestion-health est générée à partir des mêmes épingles contre lesquelles les connecteurs et les exportateurs sont compilés, de sorte que lorsqu’une épingle bouge, la surface bouge avec elle.
Contexte délimité, énoncé clairement
Section intitulée « Contexte délimité, énoncé clairement »- Il ne possède aucune entité de stockage et ne persiste rien — un modèle de lecture pur sur des substrats qui existent déjà (les épingles, le journal, les preuves d’attestation).
- Ce n’est pas le module XXII (santé/SLA), qui est délimité à la fiabilité des agents et serveurs MCP du parc (estate). Ce module concerne le moteur.
- Ce n’est pas le point de terminaison des métriques : les séries
temporelles opérationnelles vivent sur
/metrics; ce module sert des réponses structurées, pas des séries.
Voir aussi
Section intitulée « Voir aussi »- Superviser avec Prometheus — les métriques opérationnelles et les SLO.
- Référence des événements — le vocabulaire du bus sur lequel la table d’ingestion fait rapport.
- Vérifier une version — les preuves de chaîne d’approvisionnement que la surface d’attestation reflète.