LMS Gateway Troubleshooting
Symptoms
Employee Training fails to load, shows a Gateway error, returns an empty list, or appears to include rows outside expected employee scope.
Scope
Gateway ESS forwarding and the read-only employee Training page.
Cause
Likely causes
Client session/feature visibility; Gateway downstream failure; tenant context propagation; Training unavailable; empty enrollment data; or missing employee ownership enforcement.
Safe diagnostic steps
- Distinguish client route, Gateway response, and Training response categories.\n2. Record sanitized correlation and time window.\n3. Compare an approved synthetic tenant/employee case.\n4. Do not inspect another employee's learning records.
Resolution
Safe resolution
Restore only the approved client/Gateway/Training path. Do not add query values or alter records to simulate ownership.
Validation
Confirm the synthetic employee page loads the expected scoped category and handles empty/error states.
Evidence to collect
Collect only environment category, time window, capability/route, status or error category, sanitized correlation reference, lifecycle state category, and recent approved change context.
Escalation
Client rendering to frontend; forwarding to Gateway; data scope to Gateway, Training, Identity, and security.
Related documentation
Source References
microservices/src/gateway-api/EssEndpoints.csUI/salary-ui/apps/client-hrms-portal/src/ess/EssPages.tsx
Summary
This Draft page provides non-destructive, source-backed diagnosis and stops where recovery authority is not confirmed.
Audience
LMS users, support, operations, engineering, QA, architecture, security, and implementation teams.
Overview
Use supported reads and sanitized evidence. Never expose personal learning data, credentials, configuration values, infrastructure details, or operational commands.
Related Articles
See Also
Keywords
- LMS troubleshooting
- Safe diagnostics
Revision Information
- Status: Draft
- Last reviewed: 2026-07-17
- Review cycle: Quarterly