# Troubleshoot report generation

Use this checklist when report generation fails, runs slowly, or returns unexpected data.

<table><thead><tr><th width="181">Issue</th><th>Likely cause</th><th width="291.3333740234375">What to do</th></tr></thead><tbody><tr><td>Empty report</td><td>No records match the filters</td><td>Review the filter values and date range.</td></tr><tr><td>Slow performance</td><td>Large dataset or broad query</td><td>Add filters and reduce the date range.</td></tr><tr><td>Memory error</td><td>Large file built in memory</td><td>Split the report into smaller runs.</td></tr><tr><td>Missing approvers</td><td>Legacy data format</td><td>Review older workflow and approval data.</td></tr><tr><td>Wrong data</td><td>Stale cached objects</td><td>Clear cache between test runs if needed.</td></tr><tr><td>Date parsing error</td><td>Invalid date format</td><td>Verify the input format and locale handling.</td></tr></tbody></table>

### Tuning tips

Start with the smallest useful scope.

* test with a narrow date range
* filter by user, managed system, or status
* download one report at a time during validation

### When performance matters

Focus on these areas:

* pagination size
* service call volume
* ElasticSearch usage
* memory usage during file creation

Large reports work best when you reduce result size early and avoid broad unfiltered queries.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-beta.openiam.com/openiam-report-services/troubleshoot-report-generation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
