---
title: Access and use Performance Risks inbox
source: https://docs.newrelic.com/docs/errors-inbox/performance-risks/access-and-use
---

> #### 💡 PREVIEW
>
> We're still working on this feature, but we'd love for you to try it out!
>
> This feature is currently provided as part of a preview program pursuant to our [pre-release policies](https://docs.newrelic.com/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy).

You can access and use Performance Risks inbox to proactively identify and resolve application performance issues before they impact your end users. This guide walks you through how to access Performance Risks inbox, view the account-wide overview, analyze and get recommendations for specific risks, update detection thresholds, and use the tool within New Relic MCP server. For more information about what Performance Risks inbox is and its key benefits, refer to [introduction to Performance Risks inbox](https://docs.newrelic.com/docs/errors-inbox/performance-risks/introduction).

## Access the Performance Risks inbox [#access]

You can access Performance Risks inbox in two ways: at the entity level, scoped to a single entity or workload, or at the account level, covering every entity in your account.

-   [Access at entity level](#access-entity)
-   [Access at account level](#access-account)

### Access at entity level [#access-entity]

At the entity level, Performance Risks inbox shows performance issues for a single entity's or workload's telemetry data. This is available for:

-   APM services
-   Browser applications
-   Workloads

**To access Performance Risks inbox for an entity:**

1.  Go to [one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities), then select **APM & Services**, **Browser**, or **Workloads**.
2.  Select the required entity or workload.
3.  In the navigation pane, under the **Triage** section, click **Performance Risks**.

### Access at account level [#access-account]

At the account level, Performance Risks inbox is available in two views: an account-wide dashboard, and a list of performance risk groups scoped to a workload or entity that you choose.

**To access Performance Risks inbox for an account:**

1.  Go to [one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Errors Inbox.
2.  In the entity navigation pane, under the **Performance Risks** section, click **Performance Overview** for the account-wide dashboard (see [View the Performance overview](#overview)), or **Risk Groups** for a scoped list.
3.  In **Risk Groups**, use the scope selector to choose **Workload** or **Entities**, then select the specific [workload](https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/workloads/workloads-overview) or entity you want to review, or use the search box to find it by name or description.
4.  Optionally, add more filters, such as by **Performance risk group metadata state** (for example, Unresolved), and use **Sort by** to change the order of results.

## View the Performance overview [#overview]

Performance overview is a dashboard that summarizes performance risks across your account. It shows every performance risk detected across your entities, so you don't have to check each entity individually to find where problems exist.

![Performance overview dashboard.](https://docs.newrelic.com/images/PRperformanceoverview.webp "Performance overview dashboard.")

From here, you can drill into a specific entity to open its [Triage](#triage) view for a closer look.

/\*
\### Summary tiles \[#summary-tiles]

Four tiles summarize the account's current state, each compared against the previous time window:

\* \*\*Entities with risks\*\*: the number of entities that currently have at least one performance risk
\* \*\*% of entities affected\*\*: the share of monitored entities with at least one risk, out of the total monitored
\* \*\*Total risks detected\*\*: the number of risk occurrences detected during the selected time window
\* \*\*Entities with new occurrences\*\*: the number of entities that newly crossed into "at risk" during the selected window
\*//\* ### Occurrences by type \[#occurrences-by-type]

The \*\*Occurrences by type\*\* chart breaks down occurrences by risk type, so you can see which kinds of performance risks are most common across the account.

\### Occurrences over time \[#occurrences-over-time]

The \*\*Occurrences over time\*\* chart shows how risk occurrences change over time, stacked by risk type. You can toggle between viewing occurrences and entities affected.

\### Top affected entities \[#top-affected-entities]

The \*\*Top affected entities\*\* table lists the entities with the most performance risks, along with a risk score, the risk types detected, total risks, and a trend sparkline for the selected time window. The risk score is based on the number of risks, how much signals exceed their thresholds, and the percentage of traffic affected — a higher score means higher risk.

Click \*\*Investigate\*\* next to an entity to open the \[Triage](#triage) view for that entity.

\### Risk totals per entity \[#risk-totals-per-entity]

The \*\*Risk totals per entity\*\* table shows the occurrence count for each entity and risk type, with color intensity indicating where risks are most concentrated. \*/

## View and analyze performance risks [#view-analyze]

Once you access Performance Risks inbox, you can view detected issues in two ways: the **Triage** view and the **Group performance risks** view. Both views display the same underlying data but offer different ways to analyze it.

### Triage [#triage]

The **Triage** view processes and groups similar performance risks together automatically. Similar queries are computed, stored, and merged into a single performance risk group. For example, multiple queries that share the same pattern — such as variations of an `IN` clause — are grouped into one entry rather than appearing as separate items. This makes it easier to identify and prioritize the most impactful problems without reviewing each occurrence individually.

Use the **Triage** view when you want a pre-grouped summary of performance issues to identify patterns across your application.

![Screenshot of the Triage view in Performance Risks inbox showing pre-grouped performance issues.](https://docs.newrelic.com/images/performancerisks_triage.webp "Screenshot of the Triage view in Performance Risks inbox showing pre-grouped performance issues.")

### Group performance risks [#group]

The **Group performance risks** view displays the raw performance risk data without pre-computed groupings. Normal query representations (such as comma and question mark placeholders) are shown, and you can filter and group the data based on different attributes, such as:

-   The user affected by the performance risk
-   The service generating the calls
-   The API triggering the queries

Use the **Group performance risks** view when you need to analyze performance risks based on specific attributes that are relevant to your investigation.

![Screenshot of the Group performance risks view in Performance Risks inbox showing raw performance risk data.](https://docs.newrelic.com/images/performancerisks_grpperrisk.webp "Screenshot of the Group performance risks view in Performance Risks inbox showing raw performance risk data.")

## Get recommendations [#recommendations]

From the **Triage** view, you can generate AI-powered recommendations for a specific performance risk instead of investigating its occurrences manually.

**To get recommendations for a performance risk:**

1.  From the **Triage** view, open a performance risk that has multiple occurrences.
2.  Click **Generate insights**.

Performance Risks inbox analyzes the occurrences for that performance risk and returns a hypothesis about the root cause, along with recommended next steps to resolve it. The exact recommendations vary depending on the performance risk detected.

![Sample performance risk recommendations.](https://docs.newrelic.com/images/PRinsights.webp "Sample performance risk recommendations.")

> #### ⚠️ IMPORTANT
>
> New Relic enables AI features by default for all accounts. If you don't see this option, your account may not have it enabled. Contact your organization admin to request access.

If a recommendation suggests adjusting a threshold, see [Set the thresholds](#set-thresholds).

## Set the thresholds [#set-thresholds]

Performance Risks inbox uses configurable thresholds to automatically detect performance anomalies. You can update these thresholds at both the account and entity levels — including for [workloads](https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/workloads/workloads-overview) — to ensure that the detection criteria align with your specific performance monitoring needs and priorities. These thresholds determine what constitutes a performance risk and help ensure Performance Risks inbox alerts you to the most relevant and actionable performance issues in your applications.

You can set the Performance Risks thresholds at an account or entity level:

-   [Account-level thresholds](#account-thresholds)
-   [Entity-level thresholds](#entity-thresholds)

### Set the account-level thresholds [#account-thresholds]

Setting thresholds at the account level allows you to establish default performance risk detection criteria that apply across all entities within the account. This is useful for maintaining consistent monitoring standards and ensuring that all applications are evaluated against the same performance benchmarks.

**To set the thresholds at an account level:**

**New account-level thresholds**

1.  Go to **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Errors Inbox > Performance Thresholds**..
2.  In the **Accounts** tab, click **+ New**.
3.  From the **Account** dropdown, select the account you want to create a new threshold for.
4.  Set the required limits for each analyzer.
5.  Click **Submit** to save.

**Edit existing account-level thresholds**

1.  Go to **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Errors Inbox > Performance Thresholds**..
2.  In the **Accounts** tab, click the **Edit** button next to the account you want to update.
3.  Set the required limits for each analyzer.
4.  Click **Submit** to save.

> #### 💡 TIP
>
> When you modify thresholds, New Relic displays your username to track who made the changes.

### Set the entity-level thresholds [#entity-thresholds]

Setting thresholds at the entity level allows you to customize performance risk detection criteria for specific applications or services that may have unique performance characteristics or requirements. This is particularly useful for tailoring monitoring to different types of applications, environments, or business priorities.

**To set the thresholds at an entity level:**

You can set the thresholds for a specific entity in one of the following ways:

**From the Performance Risks page**

1.  Go to **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > APM & Services**..
2.  Select the required entity.
3.  In the entity navigation pane, click **Performance Risks** in the **Triage** section.
4.  Click **Adjust performance thresholds** in the top right corner.
5.  Set the required limits for each analyzer.
6.  Click **Submit** to save.

> #### 💡 TIP
>
> When you modify thresholds, New Relic displays your username to track who made the changes.

**From the Performance Thresholds page**

1.  Go to **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Errors Inbox > Performance Thresholds**..
2.  In the **Entities** tab:
3.  From the **Account** dropdown, select the account of your entity.
4.  From the **Entity** dropdown, select the entity you want to update.
5.  Set the required limits for each analyzer.
6.  Click **Submit** to save.

> #### 💡 TIP
>
> When you modify thresholds, New Relic displays your username to track who made the changes.

### View threshold lines on charts [#threshold-guidelines]

Performance risk charts display reference lines to help you interpret whether a value is within an expected range:

-   **Minimum and maximum guidelines**: Calculated automatically from the historical data collected for that chart, showing the typical range of values over time.
-   **Current threshold**: Reflects the threshold that's currently active for that analyzer, based on your account-level or entity-level threshold settings. If both are set, the entity-level threshold takes precedence.

Use these lines to see how close a metric is to its configured threshold, without needing to open the threshold settings.

The following is a sample chart. The values and lines you see depend on your own data and threshold settings.

![Sample performance risk chart with threshold lines.](https://docs.newrelic.com/images/PRIthreshold.webp "Sample performance risk chart with threshold lines.")

## Use the Performance Risks inbox tool in New Relic MCP server [#using]

You can also access the Performance Risks inbox tool ([`list_entity_performance_risk_groups`](https://docs.newrelic.com/docs/agentic-ai/mcp/tool-reference/#performance)) in [New Relic MCP server](https://docs.newrelic.com/docs/agentic-ai/mcp/overview/). This tool lists all the Performance Risks detected for a given entity, along with their details such as risk type, severity, and occurrence count. You can use this tool to programmatically retrieve performance risk data.