BE-10 Observabilidad base
BE-10 — Observabilidad base
Sección titulada «BE-10 — Observabilidad base»- Depende de: BE-01, ARCH-01.
- Módulo:
shared(infraestructura). - Capacidad: ARCH-06.
Objetivo
Sección titulada «Objetivo»Dejar salud, métricas básicas y logging estructurado, sin montar OpenTelemetry (post-MVP).
Alcance
Sección titulada «Alcance»- Actuator expuesto:
health,info,metrics. No se exponeenv. GET /actuator/healthes público.infoymetricsexigen rol ADMIN.management.endpoint.health.show-details:when_authorizeden local;neverenapplication-prod.yml.- Cada request lleva
X-Request-Idsaneado en el MDC (logging.pattern.level) y lo repite en la respuesta. Un valor inseguro se sustituye por un UUID. El header de entrada no se reescribe (firma del webhook). - Métricas JVM y
http.server.requestslas registra Actuator. Sin Prometheus ni OpenTelemetry.
Criterios de aceptación
Sección titulada «Criterios de aceptación»- Health en verde con dependencias arriba.
- Cada request tiene un id de correlación en logs.
- No se registran secretos ni tokens.
- Fuera de local,
/actuator/healthno revela componentes internos.
Evidencia
Sección titulada «Evidencia»RequestCorrelationFilterTest: reutiliza un id seguro, descarta un header con salto de línea y limpia el MDC.ActuatorHealthIntegrationTest: health anónimo y de admin en UP sincomponentscuandoshow-details=never;infoymetricssin token responden 401; un CUSTOMER recibe 403; un ADMIN leejvm.memory.usedyhttp.server.requests.