Title: User-Defined Thresholds for anomalies
Author: WordPress VIP Documentation
Published: July 31, 2025

---

 1. [Performance](https://docs.wpvip.com/performance/)
 2. [Insights & Metrics](https://docs.wpvip.com/performance/insights-metrics/)
 3. [Performance metrics anomalies](https://docs.wpvip.com/performance/insights-metrics/anomalies/)
 4. User-Defined Thresholds for anomalies

#  User-Defined Thresholds for anomalies

[Performance metrics anomalies](https://docs.wpvip.com/performance/insights-metrics/anomalies/)
in an application’s [**Insights & Metrics** panel](https://docs.wpvip.com/performance/insights-metrics/)
are measured against the known range of metrics for a performant application. Users
can define additional custom metric thresholds for performance anomalies based on
their own criteria.

[Notifications for anomaly events related to the custom thresholds](https://docs.wpvip.com/notifications/event-types/#Performance-Metrics-Anomalies)
can be optionally configured to be sent to a specific Destination to alert when 
the threshold is crossed.

**Prerequisites**

 * **To view** existing User-Defined Thresholds in the **Insights & Metrics** panel,
   a user must have at minimum an [Org member role](https://docs.wpvip.com/manage-user-access/vip-dashboard/org-roles)
   or an [App read role](https://docs.wpvip.com/app-role/) for that application.

 * User-Defined Thresholds are only available for applications with an [Enhanced, Signature, or Premier package](https://wpvip.com/pricing/).

![](https://docs.wpvip.com/wp-content/uploads/sites/2/2025/07/UDMT.gif?w=1024)

Video capture of the steps to add a User-Defined Threshold and view its associated
data in the **Insights & Metrics** panel

## Limitations

 * The performance data charts and tables provided in the **Insights & Metrics**
   panel each track their own types of data. The set of data types for a specific
   chart or table is displayed in the area labeled “**Data Series**“. Only one User-
   Defined Threshold can be configured per-data type for a chart or a table.
 * Only data for one User-Defined Threshold can be displayed in a chart or a table
   at one time.
 * Only production environments can have User-Defined Thresholds.

## Add or edit a User-Defined Threshold

**Prerequisite**

**To add, edit, or remove** User-Defined Thresholds in the **Insights & Metrics**
panel—and to configure a Notification—a user must have at minimum an [Org member role](https://docs.wpvip.com/manage-user-access/vip-dashboard/org-roles)
or an [App write role](https://docs.wpvip.com/app-role/) for that application.

In the **Insights & Metrics** panel of the [VIP Dashboard](https://dashboard.wpvip.com/)
for a specific application environment:

 1. Locate the performance data chart (e.g., “[Origin Response Time](https://docs.wpvip.com/performance/insights-metrics/http-metrics/#HTTP-Origin-Response-Time)“,“
    [Object Cache Hit Rate](https://docs.wpvip.com/performance/insights-metrics/cache-metrics/#Object-Cache-Hit-Rate)“,“
    [Slow Queries](https://docs.wpvip.com/performance/insights-metrics/database-metrics/#Database-Slow-Queries)“)
    to which the User-Defined Threshold will be added.
 2. Locate the button labeled “**+Add Threshold**” or “**+Edit Threshold**” at the 
    bottom right of the chart. The title is dependent on the types of data that are
    listed in the current data chart’s Data Series and whether a User-Defined Threshold
    already exists within that series.

![](https://docs.wpvip.com/wp-content/uploads/sites/2/2025/07/Add-Threshold-Button_d5c309.
png?w=1024)

Example screenshot of the location of the button labeled “**+ Add Threshold**“

 3. Add or edit a metric threshold in the dialog titled “**Add Metric Threshold**” 
    or “**Edit Metric Threshold**“. Configure the available setting options:
 4.  * In the section labeled “**Data Series**“, select the radio button for a data
       type.
     * In the section labeled “**Threshold**“, select either “Above” or “Below” from
       the dropdown menu to specify the direction of monitoring for a metric in relation
       to the threshold.
     * In the section labeled “**Threshold**“, add an integer value to the input field.
       Or, select the “up” or “down” arrows to increase or decrease the integer value
       in the input field.
 5. Optionally enable a Notification for the new or edited User-Defined Threshold.
 6.  * Select the checkbox labeled “**Send notification when data crosses the threshold**“.
     * Select the dropdown labeled “**Destination**” and choose [a Destination](https://docs-admin-wpvip-com-staging-content.go-vip.net/docs-vip/notifications/destinations/)
       for the Notification from the dropdown list. Only an existing Destination can
       be assigned to the Notification. A new Destination cannot be created from within
       the dialog.
 7. Add, update, or remove a User-Defined Threshold:
 8.  * To add the new metric threshold, select the button labeled “**Add Threshold**“.
     * To save updates made to an existing metric threshold, select the button labeled“**
       Update**“.
     * To remove an existing metric threshold, select the button labeled “**Remove 
       Threshold**“.

![](https://docs.wpvip.com/wp-content/uploads/sites/2/2025/07/Edit-Metric-Threshold.
png?w=1024)

Example screenshot of the **Edit Metric Threshold** dialog for the Origin Response
Time chart in the Insights & Metrics panel of the VIP Dashboard.

Last updated: July 31, 2025