[Ops] Added custom alert rounding info (#1859)

* Added custom alert rounding info

* Update alerts.mdx

---------

Co-authored-by: Carlos Trevino <carlostrevino@vhhf74m7m4-carlostrevino.corp.mixpanel.com>
Co-authored-by: myronkaifung <97630035+myronkaifung@users.noreply.github.com>

Author: 3 people

pages/docs/features/alerts.mdx

@@ -8,11 +8,11 @@ import { Callout } from 'nextra/components'
 
 ## Overview
 
-Mixpanel provides the ability to create alerts for your Insights and Funnels reports, allowing you to monitor custom report conditions, or automatically detect anomalies and receive email notifications when those conditions are met. Additionally, Mixpanel offers a Root Cause Analysis feature that helps you investigate and understand the underlying data behind alerts, enabling you to identify the user segments affected and address any issues quickly.
+Mixpanel provides the ability to create alerts for your Insights and Funnels reports, allowing you to monitor custom report conditions or automatically detect anomalies and receive email notifications when those conditions are met. Additionally, Mixpanel offers a Root Cause Analysis feature that helps you investigate and understand the underlying data behind alerts, enabling you to identify the user segments affected and address any issues quickly.
 
 ## Create an Alert
 Create an alert for your Insights and Funnels reports and be notified when report conditions reach certain thresholds. Alerts are sent as an email or Slack message and can be sent to multiple users.
-**To create an alert follow these steps:**
+**To create an alert, follow these steps:**
 
 1. **Save your report**, click the 3 dots icon, go to Alerts, and select Create Alert.
 *Note: You won't be able to create alerts if the report has unsaved changes. Save your report before setting up the alert.*
@@ -21,16 +21,18 @@ Create an alert for your Insights and Funnels reports and be notified when r
 
 2. **Enter a name** for your alert.
 3. If your report has more than one event, select an event to track. If your report has a breakdown applied, either select a segment to alert on, or select any segment to be alerted when any segment matches the alert criteria.
-4. **Set your alert criteria.** Depending on the report you’re working from, choose between anomaly detection or custom alert types. More details on each criteria type can be found below.
+4. **Set your alert criteria.** Depending on the report you’re working from, choose between anomaly detection or custom alert types. More details on each criterion type can be found below.
 5. **Set your notification frequency.** Depending on your alert criteria, you can choose a notification frequency spanning from an hour to at most a month. This frequency informs how often *at most* you’ll receive an alert.
     *Note:*
-    - *for time-series reports, alert query frequency (how often we check if your data matches your alert condition) is determined by the time bucket of your report visualization. For instance, if your chart is hourly, the alert will be checked for at an hourly interval.*
-    - *if you have an hourly chart, but set the alert frequency to daily, we’ll check your report for an alert condition match every hour. If we find a match, we’ll send you the alert message and will stop checking your report for a match until the next day.*
-6. **Set your notification delivery preferences.** When alert conditions are met, we can send notification via email or Slack.
-    - For email, enter the recipient emails that you would like to receive this alert. You can enter any email here, not just internal users.
-    - For Slack, select any Slack channels you want to send this alert to. *Note: private Slack channels are not available at this time.*
+    - *For time-series reports, alert query frequency (how often we check if your data matches your alert condition) is determined by the time bucket of your report visualization. For instance, if your chart is hourly, the alert will be checked for at an hourly interval.*
+    - *If you have an hourly chart, but set the alert frequency to daily, we’ll check your report for an alert condition match every hour. If we find a match, we’ll send you the alert message and will stop checking your report for a match until the next day.*
+6. **Set your notification delivery preferences.** When alert conditions are met, we can send a notification via email or Slack.
+    - For email, enter the email of the recipient. You can enter any email here, not just Mixpanel users.
+    - For Slack, select any Slack channels you want to send this alert. Private Slack channels are not supported.
 
-    **IMPORTANT:** In order to send alerts to Slack, you may need to configure the Mixpanel Slack app if you haven’t before. Click "Add Mixpanel to Slack" and follow the prompts on the following screens. You will be brought back to this page when you have added Mixpanel to Slack.
+<Callout type="info">
+    In order to send alerts to Slack, you may need to configure the Mixpanel Slack app if you haven’t before. Click "Add Mixpanel to Slack" and follow the prompts on the following screens. You will be brought back to this page when you have added Mixpanel to Slack.
+</Callout>
 
 ![](/255713687-91a2bb99-3a79-43d4-9d97-3b397aab0305.png)
 
@@ -49,7 +51,9 @@ You can view and manage all alerts under your personal settings.
 
 You can view the details of another user’s alert, but you are not able to edit or delete it unless you're a project owner.
 
-***IMPORTANT: If you need to modify alerts you didn't create, contact the project owner.***
+<Callout type="info">
+    If you need to modify alerts you didn't create, contact the project owner.
+</Callout>
 
 ## Alert Criteria Types
 
@@ -60,8 +64,8 @@ Custom Threshold alerts monitor your metrics and notify you when the metric reac
 
 - **Above**: The alert will check if the current value is above a set threshold value and if it is, you will be sent an alert.
 - **Below**: The alert will check if the current value is below a set threshold value and if it is, you will be sent an alert.
-- **Increases by more than**: Available in line chart reports. The alert will compare the current value with the previous value (frequency set by report time-series setting). If the new value has increased by the custom amount or percentage over the previous value, you will be sent an alert.
-- **Decreases by more than**: Available in line chart reports. The alert will compare the current value with the previous value (frequency set by report time-series setting). If the new value has decreased by the custom amount or percentage below the previous value, you will be sent an alert.
+- **Increases by more than**: Available in line chart reports. The alert will compare the current value with the previous value (frequency set by the report time-series setting). If the new value has increased by the custom amount or percentage over the previous value, you will be sent an alert.
+- **Decreases by more than**: Available in line chart reports. The alert will compare the current value with the previous value (frequency set by the report time-series setting). If the new value has decreased by the custom amount or percentage below the previous value, you will be sent an alert.
 
 ![](/255714489-2a4921bb-0fd7-44f9-a6ba-5a88ee14358a.png)
 
@@ -104,6 +108,10 @@ Currently, each organization has a limit of 50 active Anomaly Detection Alerts.
 
 By setting up Anomaly Detection Alerts in Mixpanel, you can gain valuable insights into unusual patterns in your metrics and take proactive actions based on detected anomalies. Stay ahead of potential issues and leverage data-driven decision-making with Anomaly Detection Alerts.
 
+**Rounding in alert messages**
+
+When displaying decimal values, the current value shown in alert messages is rounded to 2 decimal places.  This can make it appear to be outside the alert range when it is very close to the boundary.  However, the actual alert is always checked against the full unrounded value.
+
 ## Root Cause Analysis
 
 Mixpanel's Root Cause Analysis (RCA) feature analyzes the properties of unexpected events and automatically generates a Board with reports broken down by relevant properties so you can search for the underlying cause of any unexpected data point or fired alert.
@@ -113,7 +121,7 @@ RCA Boards can be generated from alert trigger messages delivered via Slack or e
 ![alert_rca](/alert_rca.png)
 
 <Callout type="info">
-    Note: each alert is tied to one Root Cause Analysis Board that can be accessed and edited by anyone in your organization. Duplicate the board if you wish to make independent edits. If the original Board is deleted, another can be generated from the alert trigger message.
+    Each alert is tied to one Root Cause Analysis Board that can be accessed and edited by anyone in your organization. Duplicate the board if you wish to make independent edits. If the original Board is deleted, another can be generated from the alert trigger message.
 </Callout>
 
 ### Root Cause Analysis Board
@@ -124,8 +132,8 @@ Here are the key features and components of the RCA Board:
 
 - We generate 12 segmented reports on the RCA Board, showing the triggered event broken down by its top relevant properties. This breakdown helps you explore the data from different angles and identify any patterns or insights that contributed to the data point.
 - Each segmented report is filtered by a date range to enable point-in-time exploration of the data surrounding the data point. For example, if you set an alert on a last 30-day report, the reports on the RCA board will be filtered by a custom date range spanning 30 days. Using a custom date range instead of a fixed number of days ensures that the time range remains consistent for future explorations.
-- To provide additional context, we include links to the original report where you ran RCA. In the case where you ran RCA from an alert, we include a link to the report where the alert was initially set up, and a link to the custom alert settings. This allows you to refer back to the report, make adjustments to the alert criteria if necessary, and compare the data with the RCA Board.
+- To provide additional context, we include links to the original report where you ran RCA. In the case where you ran RCA from an alert, we include a link to the report where the alert was initially set up and a link to the custom alert settings. This allows you to refer back to the report, make adjustments to the alert criteria if necessary, and compare the data with the RCA Board.
 
 ![alert_rca_board](/alert_rca_board.gif)
 
-By leveraging the Root Cause Analysis feature in Mixpanel, you can gain in-depth insights to quickly understand the factors driving anomalies. This empowers you to take targeted actions, resolve issues, and capitalize on opportunities effectively.
+By leveraging the Root Cause Analysis feature in Mixpanel, you can gain in-depth insights to quickly understand the factors driving anomalies. This empowers you to take targeted actions, resolve issues, and capitalize on opportunities effectively.