On this page

Topline Alerts

Get notified when metrics shift beyond a fixed threshold or relative change in value.

Topline Alerts are in a limited beta. Reach out if you would like these enabled for your project.

Topline Alerts are available in Statsig Cloud and Statsig Warehouse Native with support available for three types of Topline Alerts:

Creating a topline alert

  1. Go to Analytics → Topline Alerts in the product menu.

  2. Create a New Alert

    Click +Create and give the new alert a name.

  3. Select the Event or Metric Source

    <p> Pick the data you want to monitor. </p>

    • On Statsig Warehouse Native: Select a Metric Source, filter, and group by the dimensions you want.
    • On Statsig Cloud: Select the event, aggregation, filters, and group-by conditions for this alert.

    This example sets up an alert to monitor P90 latency for mex\_query events, filtering out internal employee queries and grouping by the hadGroupBy dimension.

    Select events or metrics for a Topline Alert

  4. Review the Alert Preview

    <p> The preview shows how your metric is trending with the current setup. Confirm values look correct, or open the metric in

    Metrics Explorer

    for deeper analysis. </p>

    Topline Alert preview showing trending metric

  5. Set Alert Conditions

    <p> The preview updates along with each change. Define the: </p>

    • Condition type (threshold, change, change %)
    • Directionality
    • Alert and Warn values
    • Evaluation window

    On Warehouse Native: Define the evaluation frequency, lookback, and max delay. These values directly influence warehouse compute costs.

    Configure alert conditions for a Topline Alert

  6. Add Notifications

    <p> Notifications go to email, the Statsig Console, and Slack (if connected). Project-wide defaults live in Settings. </p>

    • Draft a clear, actionable message subscribers receive when the alert fires.
    • Add subscribers.
    • Set alert priority.
    • Configure re-notification rules if alerts should resend while conditions hold.
  7. Save and Monitor

    <p> After saving, triggered alerts appear at the top of the page. From here you can: </p>

    • View samples of the event.
    • Open the trend in Metrics Explorer.
    • Mute the alert temporarily if it is noisy or already under investigation.

    Topline Alerts table with active alerts

Diagnostics

Navigate to the Diagnostics tab to review alert history, inspect samples, open Metrics Explorer, or mute noisy alerts.

Diagnostics tab showing alert history


Was this helpful?