Documentationbreadcrumb arrow Pluginsbreadcrumb arrow Vercel data sourcebreadcrumb arrow Alerting
Grafana Cloud Enterprise
Last reviewed: July 10, 2026

Vercel alerting

The Vercel data source supports Grafana Alerting, so you can create alert rules on Vercel data, such as deployment failures or firewall attack activity. The plugin is a backend data source, so Grafana evaluates these queries server-side during each alert rule evaluation.

Before you begin

Before you create an alert rule, ensure you have configured the Vercel data source and are familiar with the Vercel query editor.

How alerting works

The Vercel data source doesn’t have a dedicated alerting query type. Instead, an alert rule runs a standard Vercel action, reduces the result to a single number, and evaluates that number against a condition. Vercel actions return tables, so you typically add a Reduce expression that counts the returned rows, or reduces a numeric field, before applying a threshold. Common patterns include:

  • List deployments filtered by state to count failed or building deployments.
  • Read active attack data to alert on firewall activity for a project.

An alert query uses the rule’s own time range, so the since and until parameters resolve to the range you set on the query.

Create an alert rule

To create an alert rule on a Vercel query:

  1. Navigate to Alerting > Alert rules, then select New alert rule.
  2. Enter a name for the rule.
  3. In the query section, select your Vercel data source.
  4. Select an action and set any required parameters, such as a state filter on List deployments.
  5. Set the query’s time range to the window you want to evaluate.
  6. Add a Reduce expression to convert the query result to a single value, then add a Threshold expression to define the alert condition.
  7. Set the alert condition to the threshold expression, set the evaluation behavior, add labels and notifications, then save the rule.

Example: alert on failed deployments

Use this example to fire an alert whenever a deployment fails to build.

  1. Navigate to Alerting > Alert rules, then select New alert rule and name it Failed Vercel deployments.
  2. For query A, select your Vercel data source and select the List deployments action.
  3. Expand Additional Parameters, set projectId to your project, and set state to ERROR.
  4. Set the query time range to the window you want to check, such as the last 10 minutes.
  5. Add a Reduce expression B with the Count function and input A to count the failed deployments.
  6. Add a Threshold expression C with input B and the condition is above 0.
  7. Set expression C as the alert condition, then configure the evaluation interval, labels, and notifications.
  8. Save the rule.

The rule fires when the List deployments action returns one or more ERROR deployments within the evaluation window.

Next steps