> ## 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.

# Custom Metric

> Detail view for a single custom metric showing trend chart, SLA thresholds, violation history, and manual value recording.

The Custom Metric detail screen shows a single metric's history and thresholds at the route `/settings/system-health/custom-metrics/:metricId`.

## Overview

The screen loads a single custom metric by `metricId` from `useCustomMetric`, displaying its metadata, a `MetricChart` of recent values, and a `SLAViolationsList`. SLA thresholds are managed via `useSLAThresholds` with create/edit/delete actions. A `RecordMetricValueDialog` allows manually recording a new value for the metric. The `useEntityBreadcrumb` hook sets the breadcrumb to the metric name.

## Who it's for

Required permission: `platform.system_health.manage`

## Before you start

* You must hold the `platform.system_health.manage` permission.
* Navigate from the Custom Metrics list at `/settings/system-health/custom-metrics`.

## Steps

<Steps>
  <Step title="Open Custom Metric">Navigate from Custom Metrics list or directly to `/settings/system-health/custom-metrics/:metricId`.</Step>
  <Step title="Review metric chart">View the trend chart of recent recorded values.</Step>
  <Step title="Manage SLA thresholds">Add, edit, or remove SLA thresholds for this metric.</Step>
  <Step title="View violation history">Review the SLA violations list for threshold breaches.</Step>
  <Step title="Record a manual value">Open the record-value dialog to manually submit a metric data point.</Step>
</Steps>

## Key concepts

* `MetricChart` — trend visualization of recorded metric values
* SLA thresholds — warning/critical bounds for the metric
* `SLAViolationsList` — historical list of threshold breaches

## 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/CustomMetricDetailPage.tsx
</Accordion>