Skip to content

feat(observability): correlated structured logs and full health #28

Description

@Fluory

Goal

Operations can follow one request through web, worker and AI service, and the health endpoint reports everything the pilot depends on.

Acceptance criteria

  • Structured JSON logs (pino in TS, JSON logging in the AI service) with requestId, jobId, companyId
  • Correlation ID propagated web → worker → AI service (X-Request-Id)
  • /api/health adds queue backlog and AI-service reachability
  • A test proves that a full synthetic run writes no document content or personal data to the logs

Not part of this task

  • Central log shipping, alerting (production add-on)

Affected areas

  • src/features/observability/
  • src/features/jobs/
  • services/ai/

Test plan

Criterion Check
no PII in logs integration test scanning captured log lines
health extensions unit + integration test

Security/Privacy affected?

Logs are a data-leak path – IDs only.

Epic: #18 · Architecture: docs/decisions/ADR-0001-pilot-architecture.md

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

featureNew capabilityreadyDefinition of Ready met – may be claimedsecuritySecurity or privacy relevant

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions