Observabilidad — el modelo de lectura que el motor tiene de sí mismo
Observabilidad (modules/observability) es uno de los 30 módulos — al igual que
live-ingest, cumple un papel arquitectónico
más que ocupar una ranura de capacidad. Es el modelo de lectura que el motor
tiene de sí mismo: tres superficies de solo lectura bajo
/v1/m/observability/ que responden a las preguntas que renderiza la sección
System de la consola de administración, sin poseer una sola entidad del store.
Las tres superficies
Sección titulada «Las tres superficies»| Ruta | Responde |
|---|---|
GET /ingestion-health | qué fluye hacia dentro y hacia fuera del motor por estándar de interoperabilidad — los estándares que el motor fija (OTel GenAI semconv, OCSF, ASIM, los formatos SIEM unificados, el push del ledger, Prometheus text, W3C Trace Context), cada uno con su versión verificada |
GET /traces, GET /traces/{id} | qué dice el audit ledger correlacionado con W3C sobre una traza — la vista del lado de auditoría de una traza distribuida, unida por Trace Context |
GET /attestation | qué es demostrablemente cierto sobre la cadena de suministro del binario en ejecución — la superficie de atestación que alimenta la cadena de verificación de una release |
Las tres son lecturas con permisos acotados al módulo; nada aquí muta nada.
Por qué es un módulo siquiera
Sección titulada «Por qué es un módulo siquiera»La consola de administración necesitaba una respuesta autoritativa a “¿qué habla realmente este motor, y en qué versión fijada?” — y la forma honesta de servir eso es desde el propio motor, no desde documentación que puede desviarse. La tabla de ingestion-health se genera a partir de los mismos pins contra los que compilan los conectores y exportadores, así que cuando un pin se mueve, la superficie se mueve con él.
Contexto acotado, dicho con claridad
Sección titulada «Contexto acotado, dicho con claridad»- No posee entidades del store y no persiste nada — un modelo de lectura puro sobre sustratos que ya existen (los pins, el ledger, la evidencia de atestación).
- No es el módulo XXII (salud/SLA), que está acotado a la fiabilidad de los agentes y servidores MCP del estate. Este módulo trata del motor.
- No es el endpoint de métricas: las series temporales operativas viven en
/metrics; este módulo sirve respuestas estructuradas, no series.
Relacionado
Sección titulada «Relacionado»- Monitorizar con Prometheus — las métricas operativas y los SLOs.
- Referencia de eventos — el vocabulario del bus sobre el que informa la tabla de ingesta.
- Verificar una release — la evidencia de cadena de suministro que refleja la superficie de atestación.