Maintenance Events
Maintenance events indicate browser lifecycle issues such as unexpected closures, startup failures, and authentication errors.
Maintenance events appear under the Access category in the Events screen but represent system health and availability concerns rather than user-initiated access activity.
The authenticationFailure event is also included here because it typically indicates a system or configuration issue rather than a deliberate user action.
Event Types
| Event Type | UI Name | Description |
|---|
| browserClosure | Browser closure | The Prisma Browser was closed (normally or unexpectedly) |
| browserStartupFailure | Browser startup failure | The Prisma Browser failed to start properly |
| authenticationFailure | Authentication failure | An authentication flow failed (SSO errors, MFA failures, token issues) |
Context Fields
| Field | UI Label | Description |
|---|
| maintenance.issueReason | Issue reason | The specific reason for the failure or closure |
| maintenance.authenticated | Authenticated | Whether the event was sent via the authenticated pipeline (true) or the unauthenticated public API (false) |
Issue Reasons — Internal Errors
| Reason | Description |
|---|
| Internal error | An unspecified internal error occurred |
| Out of memory | The browser ran out of memory |
| Crash | The browser process crashed |
| Killed externally | The browser process was terminated by an external process |
| Binary corrupted | The browser binary failed integrity verification |
Issue Reasons — Extension Issues
| Reason | Description |
|---|
| Extension not found | The Prisma Browser Extension is not installed |
| Extension load failed | The extension failed to load |
| Extension pending install | The extension is pending installation |
| Extension not ready | The extension is installed but not ready |
| Extension init timeout | The extension initialization timed out |
| Extension not running | The extension is not currently running |
| Extension error | The extension encountered an error |
Issue Reasons — Authentication / Server Issues
| Reason | Description |
|---|
| Server unreachable | The management server could not be reached |
| Auth service rejected | Authentication was rejected by the server |
| SSO flow failed | The SSO authentication flow failed |
| Auth token invalid | The authentication token is invalid or expired |
Issue Reasons — Configuration Issues
| Reason | Description |
|---|
| Policy load failed | The policy configuration failed to load |
| Tenant removed | The tenant was removed from the system |
| Tenant not found | The tenant could not be found |
| Profile bind failed | The browser profile binding failed |
| Profile already bound | The profile is already bound to another device |
Issue Reasons — Administrative
| Reason | Description |
|---|
| Tampering | Browser closure triggered by tampering detection |
| Admin action | Browser closure initiated by administrator action |
| Update required | The browser requires a mandatory update |
Maintenance events with authenticated: false are sent through a public API path because the browser was unable to establish an authenticated session. These events may have limited device and user context.
Examples
Browser Startup Failure — Extension Not Found
| Field | Value |
|---|
| Type | Browser startup failure |
| Category | Access |
| Time | 2026-07-06 07:00:15 UTC |
| User | john.smith@acme.com |
| Issue reason | Extension not found |
| Authenticated | Yes |
| Device | ACME-LAPTOP-042 |
| OS | Windows 11 |
| Browser version | 126.0.6478.127 |
Browser Startup Failure — Server Unreachable (Unauthenticated)
| Field | Value |
|---|
| Type | Browser startup failure |
| Category | Access |
| Time | 2026-07-06 08:30:00 UTC |
| User | (limited — unauthenticated event) |
| Issue reason | Server unreachable |
| Authenticated | No |
| Device | UNKNOWN-DEVICE |
| OS | macOS 14.5 |
Browser Closure — Crash
| Field | Value |
|---|
| Type | Browser closure |
| Category | Access |
| Time | 2026-07-06 16:45:33 UTC |
| User | sarah.kim@acme.com |
| Issue reason | Crash |
| Authenticated | Yes |
| Device | ACME-MACBOOK-089 |
| OS | macOS 14.5 |
| Browser version | 126.0.6478.127 |
Browser Closure — Admin Action
| Field | Value |
|---|
| Type | Browser closure |
| Category | Access |
| Time | 2026-07-06 14:00:00 UTC |
| User | mike.chen@acme.com |
| Issue reason | Admin action |
| Authenticated | Yes |
| Device | ACME-DESKTOP-117 |
| OS | Windows 10 |
