Skip to content

Health check reports

A health check report summarises one Okta, Auth0 or Microsoft Entra ID tenant. You can read it in the app and download it as a branded PDF. It is the document a client puts in front of their board or their auditor.

For the cards inside each report, see What each report contains.

What Who
See the Reporting section in the sidebar Everyone in a workspace that has reporting
Open the three reporting pages, open a report, download a PDF Admin, member, viewer
Generate a report, cancel a run, delete a report Admin only

Reporting is included from the Max plan. A platform operator can also switch it off for a workspace. When reporting is off, the sidebar section is hidden, and a direct link shows the error Reporting is disabled for this workspace.

There is no single Reporting page. The sidebar has a section headed Reporting with three items:

Sidebar item Use it to
Generate Start a report and watch it run
Reports See stored reports, open one, download the PDF, delete one
Compare Compare two Okta reports

All three pages have the header Reporting and the line Health check reports for a single Okta, Auth0 or Microsoft Entra tenant.

Every reporting page works on one tenant at a time. Choose it under Tenant. The placeholder is Select tenant.

  • Each option shows the tenant name and a provider badge: Okta, Auth0 or Microsoft Entra. Check the badge, because each provider has a different report.
  • If the workspace has no tenant that can be reported on, the picker shows No Okta, Auth0 or Microsoft Entra tenants with the link Add one. The link opens the tenants page.
  • The selected tenant is stored in the page address. You can copy the address and send it to a colleague, and they see the same tenant.

Only admins can generate a report. Reports are generated on demand.

  1. In the sidebar, under Reporting, choose Generate.
  2. In the card Start a health check, choose the tenant under Tenant.
  3. 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 report has a fixed shape and has no window.
  4. Check the Stored reports meter. It must be below 100 / 100.
  5. Choose Generate report. The button reads Starting for a moment, then the message Report started. appears.
Option Label on the Reports list How the charts are drawn
7 days Last 7 days One point for each day
30 days Last 30 days One point for each day
12 weeks (default) Last 12 weeks One point for each week

The page says: 7 and 30 days are charted per day; 12 weeks is charted per week. You cannot change the window while a report is running for the tenant.

The line under Generate report tells you why the button is disabled, or how long to expect.

Line Meaning
Only workspace admins can generate reports. You are a member or a viewer
This tenant is storing the maximum of 100 reports. Delete one from Reports before generating another. The tenant is at the storage limit
A report is already running for this tenant. One report runs for a tenant at a time
Select a tenant at the top of the page to generate a report. No tenant is selected
Can take up to 90 minutes for large, complex tenants. Progress is kept if you leave this page. You can start a report

The card In progress on the Generate page shows the run for the selected tenant.

Element What it shows
Subtitle Run and the first 8 characters of the run ID, then a live message that says what the run is doing now
Status badge Queued, Running or Cancelling
Percentage and bar How far the run is
Checklist One row for each step, with a state word on the right
Cancel run Stops the run

When nothing is running the card shows Nothing running and Start a health check and its progress will appear here.

The page refreshes the progress every 3 seconds while a run is active and the browser tab is visible. You can leave the page. The run continues, and the progress is there when you come back.

Provider Steps, in order
Okta End user lifecycle, International user activity, System log activity (with the sub-steps Platform activity highlights and Suspicious activity), MFA factors, AD / LDAP agent monitoring, Report PDF
Auth0 Aggregate events into daily rollups, Journey success rates, Journey availability (synthetic probes), MFA health, Password reset funnel, Factor usage mix, Connections and social, Attack protection and rate limits, API traffic (Metric Streams), Log stream monitoring, Report PDF
Entra ID Risk detections, Risky users, Sign-in failures, Privileged changes, MFA coverage, Conditional Access, App credentials, Microsoft Secure Score, Poll monitoring, Report PDF
State Meaning
pending Not started yet
running Being built now
completed Done
failed The step failed or was rate limited. The run continues with the next step
cancelled The run stopped before this step
Not available The step was skipped because the tenant cannot produce it: a stream is off, a permission is missing or a licence is missing. This is not a failure

Choose Cancel run in the In progress card. There is no confirmation. The button reads Cancelling…, the message Cancelling report. appears, and the badge changes to Cancelling. The run then appears on the Reports page with the status Cancelled.

A cancelled run still uses one of the tenant’s 100 slots. Delete it if you need the slot.

A finished run has one of four statuses.

Status Colour Meaning
Completed Green Every section was built, or was skipped as Not available
Partial Amber At least one section failed, was rate limited, or was not reached before the 90 minute limit. The run message is Report generated with partial data. A PDF is still produced
Failed Red No section produced data (All report sections failed.) or the run itself broke (Report generation failed.)
Cancelled Grey An admin chose Cancel run

When a run has no PDF, the PDF column on the Reports list shows -.

A run has a hard limit of 90 minutes. When the limit is reached, the sections that were not reached are recorded as Skipped: report generation exceeded 90 minute budget. and the run ends as Partial, with a PDF of what was collected.

A rate limit from the provider does not stop a run. The live message says, for example, System log activity section rate limited by Okta. Continuing with next section. For Entra ID it says that the section was throttled by Microsoft Graph. Continuing with next section. That section is marked failed and the run ends as Partial.

Report Where the reason is
Okta, Partial or Failed In amber at the bottom of the End user lifecycle card, as raw technical text. It is shown only when that card has data
Auth0 and Entra ID Each affected card has a heading that ends in was not collected or were not collected, with the recorded error, or This report has no … section.

The reason for a run that failed as a whole is not shown on the report page after the run ends. For an Entra ID tenant, a common cause is that Microsoft rejected the stored client ID and secret. Check the credentials on the tenant’s Edit page, then run the report again. See Rotate credentials.

In the sidebar, under Reporting, choose Reports. The card is Report history. Under the title it says how many reports are listed for the tenant, for example 4 stored for Acme Okta. Select one to open it. With none, it says Completed reports appear here.

Column What it shows
Generated Date and time, then Run and the first 8 characters of the run ID. For Auth0 and Entra ID, also the window: Last 7 days, Last 30 days or Last 12 weeks
Status Completed, Partial, Failed or Cancelled
PDF A download icon with the tooltip Download PDF, or - when the run has no PDF
Actions A bin icon with the tooltip Delete report
  • Select a row to open the report.
  • The list shows 10 reports on a page.
  • A run that is still in progress is not on this list. It is on the Generate page.
  • With no reports, the page shows No reports yet and Generate a health check and it will appear here once it finishes.

Select a row on the Reports list. The report page shows:

  • The link All reports, which goes back to the list.
  • The heading, which is the date and time followed by health check.
  • A line with the tenant name, Run and the short run ID, and for Auth0 and Entra ID the window.
  • The status badge.
  • The button Download PDF, when the PDF is ready.
  • One card for each section. See What each report contains.

If the report cannot be found, the page says That report is no longer available. It may have been deleted.

A Completed or Partial report has a PDF. There are two places to download it:

  • On the Reports list, choose the download icon in the PDF column.
  • On the report page, choose Download PDF.

Members and viewers can download PDFs. The PDF contains a monitoring section that the app does not show as a card. See Sections only in the PDF.

Only admins can delete. For members and viewers the bin icon is disabled, with the tooltip Admin access required to delete reports.

  1. On the Reports list, choose the bin icon (Delete report) on the row.
  2. The dialog Delete this report? opens. It says: Run xxxxxxxx (Status) and its stored PDF are removed permanently, freeing a slot for a new report.
  3. Choose Delete. The message Report deleted. appears.

You cannot undo a deletion. You can delete a report with any finished status, including Failed and Cancelled. You cannot delete a run that is still in progress.

Limit Value
Reports running at the same time, for each tenant 1
Longest run 90 minutes, then the run ends as Partial
Stored reports for each tenant 100. Every run counts, including Partial, Failed and Cancelled runs
Reports shown on Reports and Compare The newest 20 for the tenant
Automatic removal A finished report is removed with its PDF 180 days after it was created

The automatic removal happens each time a report for the tenant finishes or is cancelled. It removes that tenant’s finished runs that are older than 180 days. A tenant with no new report activity keeps its old reports until the next run.

Compare shows what changed between two Okta reports for the same tenant. Members and viewers can use it.

  1. In the sidebar, under Reporting, choose Compare.
  2. Choose the Okta tenant under Tenant.
  3. Choose the Current report and the report to Compare against. Each option reads as a date and a short run ID, for example 03 Nov 2026 · 1a2b3c4d.

Both choices are stored in the page address, so you can copy the address to share the same comparison.

The page then shows three things:

Part What it is
What changed Up to 6 tiles with the largest changes, Calculated directly from the two reports. Each tile names the section and the metric, then the previous value, the current value and the difference. A tile title is green for an improvement and red for a decline. With no change the card says No material differences between these two.
Alex’s read A summary in plain language, Written from the two reports above. Choose Generate. The button reads Generating, then a list of points appears with Generated and the time. Choose Regenerate for a new reading
Section tables One card for each section, with the columns Metric, Previous, Current and Change

The section tables are End User Lifecycle Summary, International User Activity, System Log Activity, Suspicious Activity, Platform Activity Highlights and AD / LDAP Agent Monitoring. Metrics include Lifecycle Events, Account Lock / Unlock, Password Reset / Change, Session Successful Sign-ins, Countries Tracked, Total International Sign-ins, Sign-ins, Failed Logins, Application SSO Sign-ins, Password Reset Attempts, Password Reset Failures, Security Threats Detected, End User Reported Suspicious Activity, Applications Tracked, the disrupted and degraded agent counts for AD, LDAP and RADIUS, and Out-of-date Agents. A section with nothing to compare is left out.

Good to know:

  • Only Okta reports that contain data can be compared, and only from the newest 20 for the tenant.
  • For an Auth0 or Entra ID tenant the page shows Comparison not available.
  • Alex’s read needs AI switched on twice: for the workspace under AI & MCP access in Settings, and for your own account on the AI & MCP access page. See Your account. When either is off, there is no Generate button and the card says that the comparison is calculated without AI. What changed and the tables do not use AI and always work.
  • A reading is kept only while the Compare page stays open. After you leave or reload, choose Generate again.

For the steps as a task, see Compare two reports.

What you see Why What to do
Reporting is disabled for this workspace. (error page) The plan does not include reporting, or a platform operator switched it off Move to the Max or Super plan, or ask a platform operator. See Plans and billing
The Reporting section is missing from the sidebar Same cause Same fix
Only workspace admins can generate reports. You are a member or a viewer Ask an admin to generate the report
Select a tenant at the top of the page to generate a report. No tenant is selected Choose a tenant under Tenant
No Okta, Auth0 or Microsoft Entra tenants The workspace has no tenant that can be reported on Choose Add one and connect a tenant
A report is already running for this tenant. A run is queued, running or cancelling for the tenant Wait for it, or choose Cancel run
A report is already queued or running for this tenant. (message) Same cause, for example two admins chose Generate report at the same moment Wait for it, or choose Cancel run
This tenant is storing the maximum of 100 reports. Delete one from Reports before generating another. 100 runs of any status are stored for the tenant Delete a report on the Reports page. Only the newest 20 are listed
This tenant is storing the maximum of 100 reports. Delete one before generating another. (message) Same cause Same fix
Could not start the report. The report service did not accept the run Try again. A failed run may appear on Reports, and you can delete it. If it repeats, escalate to support
Could not cancel the report. You are not an admin, or the run already finished, or the report service refused Reload the page. Ask an admin
A checklist row reads failed That section failed or was rate limited. The run continues Wait for the run to end, then open the report and read the affected card
A checklist row reads Not available A stream is off, a permission is missing or a licence is missing Open the report and read the hint on the card. See What each report contains
What you see Why What to do
Status Partial One or more sections failed, were rate limited, or were not reached in 90 minutes Open the report and read the affected cards. Generate again at a quieter time for the provider
Status Failed Every section failed, or the run broke. For Entra ID, often rejected credentials Check the tenant’s credentials on its Edit page, then generate again. Delete the failed run
Status Cancelled An admin chose Cancel run Delete the run if you need the slot
What you see Why What to do
Admin access required to delete reports (tooltip) You are a member or a viewer Ask an admin
Could not delete the report. The deletion failed in storage Try again
Only completed, partially completed, failed, rate-limited failed, or cancelled reports can be deleted The run is still in progress Wait until it finishes, or cancel it first
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 and pick another report
- in the PDF column The run has no PDF, for example it was cancelled or it failed Generate a new report
The meter shows more reports than the list The list shows only the newest 20 Expected. See Limits and retention
What you see Why What to do
Two reports needed with Comparison needs at least two completed reports for this tenant. The Okta tenant has fewer than two reports with data in the newest 20 Generate another report
Comparison not available with Comparison is not available for Auth0 reports yet. Open a report from Reports to read it on its own. (or Microsoft Entra) Comparison works for Okta only Read each report on its own
AI features are turned off for your account or this workspace, so Alex does not read these reports. The comparison above is calculated without AI. AI is off for the workspace or for your account An admin switches on AI & MCP access in Settings. You switch it on for yourself on the AI & MCP access page of your account
AI features are turned off for your account or this workspace. (red, after you choose Generate) AI was switched off after the page loaded Same fix, then reload
Could not generate observations. The AI request failed, or the two reports cannot be compared Try again. Choose two Okta reports with data from the same tenant
The model did not return any observations. The AI reply was empty Choose Regenerate