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

> Manage custom system health metrics, SLA thresholds, violations, and compliance report exports in a tabbed interface.

The Custom Metrics screen manages custom health metrics at the route `/settings/system-health/custom-metrics`.

## Overview

The screen provides a tabbed view of custom metrics management. A metrics list shows all defined custom metrics with edit, delete, record-value, and export actions. SLA threshold management and a SLA violations list are also available. A compliance report export dialog (`ComplianceReportExportDialog`) provides export capability. Metrics can be created via `CustomMetricForm` and modified via `SLAThresholdForm`. The feature is gated by `useCustomMetricsEnabled`. Clicking a metric name navigates to the detail page at `/settings/system-health/custom-metrics/:metricId`.

## Who it's for

Required permission: `platform.system_health.manage`

## Before you start

* You must hold the `platform.system_health.manage` permission.
* The custom metrics feature must be enabled (`useCustomMetricsEnabled`).

## Steps

<Steps>
  <Step title="Open Custom Metrics">Navigate to Settings → System Health → Custom Metrics.</Step>
  <Step title="Create a metric">Click the create action and complete `CustomMetricForm` to define a new custom metric.</Step>
  <Step title="Edit or delete a metric">Use the edit/delete actions on any metric card.</Step>
  <Step title="Record a manual value">Use the record-value action to submit a data point for a metric.</Step>
  <Step title="Manage SLA thresholds">Add or modify SLA thresholds for any metric via `SLAThresholdForm`.</Step>
  <Step title="Export compliance report">Open the compliance report export dialog to generate and download a report.</Step>
</Steps>

## Key concepts

* Custom metric — an organization-defined measurement tracked over time
* SLA thresholds — warning/critical bounds for automated violation detection
* Compliance report export — periodic export of metric and violation data

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