> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Alert History

> View, acknowledge, and resolve triggered system health alerts with status filtering.

The Alert History screen displays triggered system health alerts at the route `/settings/system-health/alerts/history`.

## Overview

The screen shows a filterable list of alert history records via `AlertHistoryList`, fetched through `useAlertHistory`. A dropdown filter allows viewing All Alerts, Active Only (triggered/acknowledged), or Resolved Only (resolved/expired). Individual alerts can be acknowledged or resolved (with optional notes) inline. A "Configure" button links back to the Alert Configuration page.

## Who it's for

Required permission: `platform.system_health.manage`

## Before you start

* You must hold the `platform.system_health.manage` permission.

## Steps

<Steps>
  <Step title="Open Alert History">Navigate to Settings → System Health → Alert History, or click "View History" from Alert Configuration.</Step>
  <Step title="Filter alerts">Use the status dropdown to show All, Active Only, or Resolved Only alerts.</Step>
  <Step title="Acknowledge an alert">Click the acknowledge action on a triggered alert to mark it as acknowledged.</Step>
  <Step title="Resolve an alert">Click the resolve action to mark an alert resolved, optionally adding resolution notes.</Step>
  <Step title="Return to configuration">Click "Configure" to go back to Alert Configuration.</Step>
</Steps>

## Key concepts

* Status values: `triggered`, `acknowledged`, `resolved`, `expired`
* Acknowledge — intermediate state indicating a team member is aware
* Resolve — final state; accepts optional resolution notes

## Related

<Columns cols={2}>
  <Card title="Platform Foundation" icon="layer-group" href="/pf/overview">
    Platform Foundation overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index">
    Documentation coverage and governance.
  </Card>
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/platform.tsx
  * src/platform/health/pages/AlertHistoryPage.tsx
</Accordion>
