Skip to main content

Troubleshoot Leave Employee Profile Synchronization

Summary​

Safe triage for missing, stale, duplicate, or failed Employee projection updates.

Audience​

Employees or administrators affected by the scenario, first-line support, QA, service owners, and architects.

Symptoms​

Leave cannot resolve an employee, shows stale active/joining information, or a recent Employee change is absent.

Scope​

Employee event publication, messaging delivery, Leave consumer handling, and local EmployeeProfile.

Cause​

The cause must be confirmed from current state and source-backed evidence.

Likely causes​

  • Event not published/delivered
  • Consumer failure and requeue
  • Event classified duplicate/stale
  • Identity mapping invalid
  • Deletion propagation not implemented

Safe diagnostic steps​

  1. Confirm the Employee source change and safe event identity/time.
  2. Review consumer outcome and projection freshness.
  3. Distinguish delivery from consumption and note unsupported deletion propagation.

Resolution​

Restore/retry through approved messaging/service operations or an owner-approved reconciliation process. Do not edit the projection or replay broker messages manually.

Safe resolution​

Use only the resolution above and approved operational processes. Do not modify databases, replay messages, bypass authorization, or repeat ambiguous state-changing actions.

Validation​

Confirm the projection matches the authoritative non-sensitive employee state and a safe Leave read resolves.

Evidence to collect​

Collect the safe UTC window, route/operation category, response/status category, deployed version, affected scope count, and a correlation identifier. Exclude credentials, tokens, personal Leave details, employee identifiers, payloads, configuration values, and private topology.

Escalation​

Employee service/integration, messaging, and Leave owners.

Source References​

  • microservices/src/leave-service/Messaging/EmployeeProfileConsumer.cs
  • microservices/src/leave-service/Domain/Leave/EmployeeProfile.cs
  • microservices/src/contracts/Events/EmployeeUpdatedEvent.cs

See Also​

Keywords​

  • Leave troubleshooting
  • Troubleshoot Leave Employee Profile Synchronization
  • Safe diagnostics

Revision Information​

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