Skip to main content

Logging and Observability

Summary​

Recruitment uses shared structured console logging, request correlation, and OpenTelemetry instrumentation for server requests and outbound HTTP. Export depends on environment configuration. Health and diagnostic foundations exist, but dependency readiness and lifecycle-level service objectives were not found.

Audience​

Developers, support engineers, site reliability engineers, and solution architects.

Observability flow​

Verified signals​

  • Correlation identifiers are propagated through request scope and response context.
  • Shared telemetry instruments inbound server work and outbound HTTP clients.
  • Outbox relay failures produce warning logs.
  • Recruitment exposes health/service information and audit, timeline, and outbox diagnostic foundations.

Operational boundaries​

The inspected health registration does not establish readiness for the database, message transport, Employee Service, Document Service, or Workflow Service. No onboarding completion latency objective, outbox backlog alert, downstream projection lag metric, or exit-processing health model was found.

Avoid placing personal, candidate, employee, token, or tenant-sensitive values in lifecycle logs. The source inspection does not certify redaction across all handlers and external clients.

Suggested diagnostic sequence​

For a failed extracted completion, correlate the inbound request, Employee client call, Recruitment commit, outbox record, relay attempt, and downstream consumer state. For offboarding, correlate the HR Operations action, exit audit record, user/labor updates, and notification processing. This is diagnostic guidance, not evidence of an automated end-to-end trace view.

Requires confirmation​

  • Production exporter, retention, redaction, access-control, and alerting policy.
  • Dependency readiness checks and outbox backlog thresholds.
  • Cross-service trace propagation through message consumers.
  • Operational dashboards for onboarding completion and exit processing.

Source References​

  • microservices/src/shared-kernel/Extensions/ObservabilityExtensions.cs
  • microservices/src/shared-kernel/Middleware/CorrelationIdMiddleware.cs
  • microservices/src/recruitment-service/Program.cs
  • microservices/src/recruitment-service/Messaging/OutboxRelayHostedService.cs

See Also​

Keywords​

  • Correlation
  • OpenTelemetry
  • Operational diagnostics

Revision Information​

  • Status: Draft
  • Last reviewed: 2026-07-20
  • Review cycle: Quarterly