Generate a report
This guide takes you from an empty page to a report you can send to a client. It also covers the related tasks: cancel a run, read a report, free a storage slot, and find out why a report is incomplete.
For the reference, see Health check reports and What each report contains.
Generate a report
Section titled “Generate a report”You need: the admin role. A workspace on the Max plan or above, with reporting switched on. A connected Okta, Auth0 or Entra ID tenant.
1. Check the tenant is ready
Section titled “1. Check the tenant is ready”A report reads what the tenant has collected and what Identiguard is permitted to read.
- Okta: the integration needs its report scopes. See Connect Okta.
- Auth0: the report uses what the log stream has sent. A tenant connected yesterday has one day of data.
- Entra ID: open the tenant’s Edit page. Check that the streams you want are switched on, and check Reporting permissions (optional). Each permission you want shows Granted.
2. Start the report
Section titled “2. Start the report”- In the sidebar, under Reporting, choose Generate.
- In the card Start a health check, choose the tenant under Tenant. Check the provider badge beside the name: Okta, Auth0 or Microsoft Entra.
- For an Auth0 or Entra ID tenant, choose the Reporting window: 7 days, 30 days or 12 weeks. The default is 12 weeks. An Okta tenant has no window.
- Check that Stored reports is below 100 / 100.
- Choose Generate report.
It worked when: the message Report started. appears, and the card In progress shows the run with the badge Queued or Running.
3. Wait
Section titled “3. Wait”The checklist in In progress shows which section is being built. A large, complex tenant can take up to 90 minutes. You can close the page and come back. The progress is kept.
Start the report the day before a client meeting.
4. Open the result
Section titled “4. Open the result”When the run finishes, the In progress card shows Nothing running. In the sidebar, choose Reports. The new report is at the top, with the status Completed or Partial. Both have a PDF.
5. Read it before you send it
Section titled “5. Read it before you send it”- Look for cards that say Not available for this tenant. They mean a stream, a permission or a licence is missing, not that something is wrong. Be ready to explain which.
- Look for headings that end in was not collected. They mean a section failed.
- Pick the three findings that matter most to this client. See Choosing pages for a client.
6. Show what changed (Okta)
Section titled “6. Show what changed (Okta)”For a second or later Okta report, see Compare two reports.
Cancel a running report
Section titled “Cancel a running report”You need: the admin role.
- In the sidebar, under Reporting, choose Generate, and choose the tenant.
- In the card In progress, choose Cancel run. There is no confirmation.
It worked when: the message Cancelling report. appears and the badge shows Cancelling. The run then appears on the Reports page with the status Cancelled.
A cancelled run still uses a storage slot. Delete it if you do not need it. See Free a slot at the 100 report limit.
Read a report in the app and download the PDF
Section titled “Read a report in the app and download the PDF”You need: any role. Members and viewers can read reports and download PDFs.
- In the sidebar, under Reporting, choose Reports, and choose the tenant.
- Select the row. It shows the date and time, and Run with a short ID.
- Read the cards. Note any card that says Not available for this tenant and any heading that ends in was not collected.
- Choose Download PDF at the top of the report. You can also choose the download icon in the PDF column of the list.
- Choose All reports to go back to the list.
It worked when: the PDF downloads. A row with - in the PDF column has no PDF.
The PDF also contains the monitoring section, which has no card in the app. See Sections only in the PDF.
Free a slot at the 100 report limit
Section titled “Free a slot at the 100 report limit”Each tenant stores up to 100 reports. Every run counts, including Partial, Failed and Cancelled runs. At the limit, Generate report is disabled.
You need: the admin role.
- In the sidebar, under Reporting, choose Reports, and choose the tenant.
- Choose the bin icon (Delete report) on a row you no longer need. Failed and cancelled runs are good candidates.
- In the dialog Delete this report?, choose Delete.
- Go back to Generate.
It worked when: the message Report deleted. appears and the Stored reports meter is lower.
Reports are also removed automatically 180 days after they were created.
Fix a “Not available” Entra ID section
Section titled “Fix a “Not available” Entra ID section”A card that says Not available for this tenant tells you the reason and gives a hint.
You need: the admin role in Identiguard. For permissions, an administrator of the client’s Entra ID tenant who can grant admin consent.
-
Open the report and read the reason on the card.
-
Follow the row for that reason:
Reason on the card What to do The … stream is not enabled for this tenant. In Identiguard, open the tenants page, choose Edit on the tenant and switch the stream on. See Change event subscriptions. Events collect from then on … has not been granted. In the Entra admin centre, open the app registration, open API permissions, add the Microsoft Graph application permission named on the card, then choose Grant admin consent Microsoft Graph refused the request (403). The permission is there but has no admin consent. Choose Grant admin consent This tenant is not licensed for this data (Entra ID P1 or higher). The tenant needs an Entra ID P1 or P2 licence. There is nothing to change in Identiguard -
Generate a new report.
It worked when: the card in the new report shows data. After you switch a stream on, the first report covers only the days since then, and the card says Covers X of Y days, limited by when monitoring started.
For which section needs what, see What gates each Entra ID section.
Work out why a report is Partial or Failed
Section titled “Work out why a report is Partial or Failed”Partial means at least one section failed, was rate limited, or was not reached within 90 minutes. Failed means no section produced data, or the run itself broke.
You need: any role to read the report. The admin role to generate again or delete.
- In the sidebar, under Reporting, choose Reports, and select the report.
- Find the reason:
- Okta: read the amber text at the bottom of the End user lifecycle card. It names each section that failed and why.
- Auth0 and Entra ID: find the headings that end in was not collected or were not collected. The text under each is the recorded error.
- Decide what to do:
- The text mentions a rate limit or throttling: generate again at a quieter time for the client, for example out of office hours.
- The text says the report exceeded the 90 minute budget: the tenant is large. Generate again. For Auth0 or Entra ID, try a shorter Reporting window.
- An Entra ID report is Failed and shows no reason: Microsoft may have rejected the stored client ID and secret. Update them on the tenant’s Edit page. See Rotate credentials.
- Generate a new report.
- Delete the failed run, so that it does not use a storage slot.
It worked when: the new report has the status Completed.
Good to know
Section titled “Good to know”- One report runs for a tenant at a time.
- Each tenant stores up to 100 reports, and the list shows the newest 20.
- Reports are removed automatically after 180 days.
- Reports are not scheduled. For a monthly service review, put a reminder in your own calendar.
If it does not work
Section titled “If it does not work”| What you see | Why | What to do |
|---|---|---|
| The Reporting section is not in the sidebar, or Reporting is disabled for this workspace. | The plan does not include reporting, or it is switched off for the workspace | Move to the Max plan or above, or ask a platform operator |
| Only workspace admins can generate reports. | You are a member or a viewer | Ask an admin |
| A report is already running for this tenant. | One report runs for a tenant at a time | Wait, or cancel the run |
| This tenant is storing the maximum of 100 reports. Delete one from Reports before generating another. | The tenant is at the limit | Free a slot |
| Could not start the report. | The report service did not accept the run | Try again. If it repeats, escalate to support |
| Could not cancel the report. | You are not an admin, or the run already finished | Reload the page. Ask an admin |
| Admin access required to delete reports | You are a member or a viewer | Ask an admin |
| That report is no longer available. It may have been deleted. | The report was deleted, was removed after 180 days, or is older than the newest 20 | Choose All reports |
For every message, see Troubleshooting on the reports page.