Troubleshooting

Start here when something is failing and you need to identify the likely cause. These guides are organized by symptom and point to the operational pages that help with deeper investigation.

Deployment

CloudFormation Stack Failed

Inspect root and nested stack events to find the first failed resource and error message.

API errors

Internal Server Error

Diagnose API Gateway 500 responses after installation or during API usage.

API calls

Authentication or API Calls Fail

Check API URL, authentication method, credentials, and request headers.

Processing

DLQ Has Messages

Investigate failed asynchronous processing before redriving messages.

Search Results Are Missing

Check search indexing, metadata filters, OpenSearch behavior, and reindexing options.

Console

Document Console Issues

Check console configuration, API URL, site access, browser errors, and backend logs.