Troubleshooting Hub — start here
Purpose: Route from symptom to the right diagnostic page, and set the universal first steps.
Who this page is for
| Audience | Why it matters to you |
|---|---|
| All engineers | Bookmark for bad days |
Universal first three moves
- error.log first — tail it while reproducing; most AEM mysteries announce themselves there.
- What changed? — deploys, config, content ops, SP installs in the window before the symptom (dashboards + release annotations).
- Which layer? — reproduce against publish directly, then dispatcher, then CDN; the first correct layer localises the fault.
Method in full: The triage method.
Symptom router
| You see | Go to |
|---|---|
| Code deployed but not running / bundle Installed | Bundle won't start |
| Component missing, wrong, or raw placeholder | Component not rendering |
| Dialog won't open / fields missing / values not saving | Dialog issues |
| Model null in HTL / fields empty | Sling Model injection failures |
| Stale/missing content on the site | Dispatcher caching issues |
| Author changes never reach publish | Replication queue blocked |
| Slow pages, traversal warnings | Slow queries & indexes |
| Disk filling, backups slowing | Repository growth |
| Users can't log in / can't see content | Login & permissions |
| Workflows piling up / stuck | Workflow stuck |
| High CPU / OOM / GC thrash | Memory & CPU issues |
| mvn install fails / package won't install | Build & deploy failures |