Trasversale · Package · Active seed

@platform/observability

Shared request-context and structured logging helpers used by platform services to emit consistent JSON logs and request ids.

• Node AsyncLocalStorage
• Express middleware types
• CommonJS and ESM exports

Spec sheet

Package name

@platform/observability

Repository path

platform-shared-packages/packages/observability

Core primitive

AsyncLocalStorage-backed request context

Responsibilities

• Create request context stores and HTTP middleware for request-id propagation.
• Emit structured logger lines with service, severity, request context and HTTP timing fields.
• Give Core and Experience services a shared logging contract for Loki/Grafana analysis.

Interfaces and contract surface

• createRequestContextStore
• buildHttpRequestContext
• createHttpRequestContextMiddleware
• createHttpRequestLoggingMiddleware
• createStructuredLogger

Consumers

• platform-ai-service
• platform-mcp-service
• platform-status-service
• funnel backend

Notes

• Promtail in platform-local-stack collects the service logs that use this structured format.

Source references

• platform-shared-packages/packages/observability/package.json
• platform-shared-packages/packages/observability/index.d.ts