Vercel data source
Note
This plugin is in public preview. Refer to the Grafana Labs release life cycle documentation for more information. If you find any issues or have a feature request, create a support ticket through your Grafana Enterprise support channel.
The Vercel data source plugin lets you query and visualize data from the Vercel REST API in Grafana. Use it to build dashboards for deployments, projects, domains, log drains, security firewall activity, and other Vercel resources.
Note
The Vercel data source is a Grafana Enterprise plugin. It’s available on Grafana Cloud, including the Free plan, which allows up to three active users, and on self-managed Grafana Enterprise. You must enable Enterprise plugins for your account before you install the plugin. For installation instructions, refer to Install Grafana Enterprise plugins.
Supported features
The Vercel data source supports the following Grafana features.
The plugin requires Grafana 11.6.7 or later.
Available data
The Vercel data source queries the Vercel REST API, so it surfaces deployment and configuration data, including:
- Deployments, their state, and build events and build logs.
- Projects, domains, and aliases.
- Checks, access groups, teams, and authentication tokens.
- Drain and log drain configurations, Edge Configs, webhooks, and remote caching status.
- Security firewall attack data.
Note
The Vercel data source doesn’t provide Vercel runtime or application logs. It surfaces deployment and build data from the REST API, not streamed request logs, and the log drain actions return log drain configurations rather than log content. To bring runtime logs into Grafana, configure a Vercel log drain to forward logs to Loki and query them with a Loki data source. This is a separate setup from the Vercel data source.
Requirements
Before you use the Vercel data source, ensure you have the following:
- A Vercel access token. For more information, refer to Creating an access token in the Vercel documentation.
- Access to Grafana Enterprise plugins, through one of the following:
- A Grafana Cloud plan. Enterprise plugins are available on the Free plan, which allows up to three active users, as well as the Pro and Advanced plans.
- A self-managed Grafana Enterprise instance with an activated license.
You must enable Enterprise plugins for your account. To enable them on Grafana Cloud, sign in to Grafana Cloud, then open My Account > Manage Plan. Contracted Cloud customers might need the Enterprise plugin entitlement added to their account. If the plugin isn’t available after you enable it, refer to License and setup errors.
Get started
The following pages help you get started with the Vercel data source:
- Configure the Vercel data source
- Vercel query editor
- Template variables
- Annotations
- Alerting
- Troubleshooting
Additional features
After you configure the data source, you can:
- Use Explore to query Vercel data without building a dashboard.
- Add Transformations to manipulate query results.
- Set up Alerting rules on Vercel queries.
Pre-built dashboards
The Vercel data source includes the following pre-built dashboards, which you can import when you configure the data source or from the plugin’s page in Grafana:
To import a pre-built dashboard:
- Navigate to Connections > Data sources.
- Select your Vercel data source.
- Go to the Dashboards tab.
- Select Import next to the dashboard you want to use.
Plugin updates
Always ensure that your plugin version is up-to-date so you have access to all current features and improvements. Navigate to Plugins and data > Plugins to check for updates. Grafana recommends upgrading to the latest Grafana version, and this applies to plugins as well.
Note
On Grafana Cloud, Grafana manages the Vercel plugin, and it updates automatically. On self-managed Grafana, you must update Enterprise plugins manually. Refer to Version and upgrade guidance.
