---
title: Manage custom KPIs
source: https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/workloads/intelligent-workload-kpis
---

Custom KPIs let you define and monitor business-specific metrics at the workload level, connecting technical performance to business outcomes. Available exclusively for [Intelligent Workloads](https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/workloads/workloads-overview#intelligent-workloads), KPIs provide visibility into metrics that matter most to your business.

## Default KPIs [#default-kpis]

There are two default KPIs automatically generated upon workload creation. These out-of-the-box tiles establish instant visibility into core transaction activity without requiring any initial setup or custom NRQL configuration. They are **uneditable** but can be hidden if not needed:

### Transaction Throughput

Tracks the total volume of incoming requests processing through your selected transaction over time.

### Transaction Error Rate

Monitors the percentage of failed transactions, giving you an immediate baseline of transaction reliability.

## Add a KPI [#add-kpi]

You can add KPIs to your Intelligent Workloads in two ways: create custom KPIs or add existing KPIs from other workloads.

### Create a custom KPI [#create-custom-kpi]

Create new KPIs to track the metrics most important to your business:

1.  Open the summary page of the Intelligent Workload.
2.  Click **Add new KPI**
    You can either create a new KPI by writing a NRQL query to define a custom metric or using an existing KPI from other workloads.
3.  To create a custom KPI:
    -   **Name**: Give it a descriptive, business-friendly name
    -   **NRQL query**: Write a query that calculates the metric
    -   **Group** (optional): Organize KPIs by functional area (e.g., "Performance", "Business Metrics")
    -   **Category** (optional): Further classify KPIs (e.g., "Latency", "Throughput", "Revenue")
4.  Click **Preview** to verify the query returns expected results
5.  Click **Save**

> #### ⚠️ IMPORTANT
>
> You can display a maximum of **3 KPIs** on the summary page at one time. This limit ensures the summary remains focused and readable.

## View and monitor KPIs [#monitor]

After adding KPIs, up to 3 can be displayed on your workload summary page as tiles. Each KPI tile shows:

-   **Current value**: Real-time KPI measurement
-   **Trend indicator**: Visual showing if the metric is improving or degrading
-   **Time series chart**: Historical performance over the selected time range
-   **Anomaly detection**: Highlights when KPIs deviate from normal patterns

The 3-KPI limit ensures your summary page remains focused and easy to scan. Use the **Manage KPIs** page to view the complete catalog of all KPIs available for your workload.

## Create KPI alerts [#alerts]

Alert on KPIs to notify teams when business-critical metrics deviate from goals:

1.  Click the KPI you want to alert on
2.  Select **Create alert condition**
3.  Configure the alert:
    -   **Threshold type**: Above or below target value
    -   **Threshold value**: Numeric value that triggers the alert
    -   **Duration**: How long the threshold must be breached before alerting
    -   **Notification channels**: Where to send alerts (Slack, PagerDuty, email, etc.)
4.  Give the alert a descriptive name
5.  Save the alert condition

## Edit or delete KPIs [#manage]

The **Manage KPIs** page provides a central location to create, edit, delete, and view all KPIs for your Intelligent Workload:

![Screenshot showing KPI management interface with KPI table and configuration options](https://docs.newrelic.com/images/intelligent-workload-manage-kpis.webp "Manage KPIs page")

**Manage KPIs:** View, edit, and configure your workload KPIs from the Manage KPIs page.

### Edit a KPI [#edit-kpi]

Modify KPI details as your business goals evolve:

1.  Go to **Manage KPIs** in your Intelligent Workload
2.  Find the KPI you want to modify
3.  Click  next to the KPI name
4.  Select **Edit**
5.  Update any of the following:
    -   **NRQL query**: Modify the query logic
    -   **Name**: Change the KPI display name
    -   **Group**: Update the functional grouping
    -   **Category**: Adjust the classification
6.  Click **Preview** to validate changes
7.  Click **Save**

> #### 💡 TIP
>
> Default KPIs (Transaction Throughput and Transaction Error Rate) cannot be edited, but you can hide them from the summary page if they don't meet your needs.

### Delete a KPI [#delete-kpi]

Permanently remove KPIs that are no longer relevant:

1.  Go to **Manage KPIs**
2.  Find the KPI to remove
3.  Click  next to the KPI name
4.  Select **Delete**
5.  Confirm deletion

> #### ⚠️ CAUTION
>
> Deleting a KPI:
>
> -   Permanently removes it from the catalog
> -   Removes any associated alerts
> -   Cannot be undone
>
>     Consider exporting alert configurations before deleting KPIs you might recreate later.

### Hide default KPIs [#hide-default]

If the default KPIs don't align with your monitoring needs:

1.  Go to your workload summary page
2.  Find the default KPI tile
3.  Click 
4.  Select **Hide from summary**

Hidden KPIs remain in the catalog and can be shown again later.

## Next steps [#next-steps]

Enhance your Intelligent Workload monitoring:

-   **[Configure workload alerts](https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/workloads/workload-status-views-notifications)**: Set up notifications for workload status changes
-   **[Learn NRQL query syntax](https://docs.newrelic.com/docs/nrql/get-started/introduction-nrql-new-relics-query-language)**: Master query writing for complex KPIs
-   **[Create custom dashboards](https://docs.newrelic.com/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards)**: Visualize KPIs alongside other metrics