Skip to main content
The platform support console gives support staff a real-time view of tenant health signals, making it easy to identify tenants that need attention and initiate support sessions.
Access to the support console requires the support_admin or super_admin platform staff role. For details on how impersonation sessions work, see Support access sessions.

Health overview

The top of the support page shows four stat cards summarizing tenant health across the platform:
  • Total tenants — total number of tenants.
  • Healthy — tenants with no detected issues.
  • Warning — tenants with elevated error rates or reduced activity.
  • Critical — tenants with high error rates or no recent activity.

Tenant health dashboard

Below the stats, a searchable, paginated table lists all tenants with live health signals. Each tenant row shows:
SignalDescription
StatusTenant lifecycle status (active, suspended, etc.)
HealthOverall health — healthy, warning, critical, or unknown
API calls (24h)Number of API calls the tenant made in the last 24 hours
Error ratePercentage of API calls that returned errors
Health status is shown as a color-coded badge:
  • Green — healthy, no issues detected.
  • Yellow — warning, elevated error rate or reduced activity.
  • Red — critical, high error rate or no recent activity.
  • Gray — unknown, insufficient data to determine health.
Use the search bar to filter tenants by name or ID. Each row provides two action buttons: View Details to open the tenant’s support detail page, and Create Support Session to start a new session immediately.

Tenant support detail

Click a tenant row to open the tenant support detail page. The page displays four health signal cards (health status, last seen, API calls, and error rate) and a Support Actions toolbar with two options:
  • Create Support Session — opens a dialog to start an impersonation session (see below).
  • Force Logout All Sessions — immediately terminates all active user sessions for the tenant. Users will need to sign in again. A confirmation dialog appears before execution.
Force logout is irreversible. All of the tenant’s active sessions are terminated immediately.

Creating a support session

1

Click Create Support Session

From the tenant support detail page, click Create Support Session.
2

Provide a reason

Enter a reason for the session (minimum 10 characters). This is recorded in the audit log.
3

Set the TTL

Choose how long the session should last, from 1 to 60 minutes. The default is 15 minutes.
4

Create

Click Create Session. You receive a confirmation with the session ID and expiration time.
Always review the tenant’s health signals before creating an impersonation session. Many issues — such as elevated error rates — can be diagnosed from the health dashboard without needing to access the tenant’s data.

Support session management

Navigate to Support > View Sessions to see all active and historical support sessions across the platform. The page opens with stat cards showing the count of active, revoked, and expired sessions. Each session row shows:
  • Status — Active, Expired, or Revoked.
  • Tenant — the tenant the session was created for.
  • Scopes — the permissions granted (for example, read_only).
  • Reason — why the session was created.
  • Issued — when the session was created.
  • Expires — when the session automatically expires.
Active sessions can be revoked immediately if they are no longer needed. All session activity is recorded in the tenant’s audit log.

Session detail and access logs

Click a session row to open the session detail page. The detail page shows two information cards:
  • Session details — status, tenant ID, platform user ID, and the scopes granted.
  • Timing — when the session was issued, when it expires, and (if applicable) when it was revoked.
Below the cards, the Access Logs table records every API request made during the session. Each entry includes:
ColumnDescription
MethodHTTP method (GET, POST, etc.)
PathAPI path that was accessed
StatusHTTP response status code
Request IDUnique request identifier for correlation
TimeTimestamp of the request
To revoke an active session, click Revoke Session at the top of the page. You can optionally provide a reason for revocation.

Next steps

Support access sessions

How impersonation sessions work, including scopes and TTL.

Tenant management

View and manage tenant lifecycle, plans, and settings.