4 min read

Monitoring

Query and visualize your Vercel usage, traffic, and more with Monitoring.
Table of Contents

Monitoring is available on Pro and Enterprise plans

Those with the owner, member, developer role can access this feature

Monitoring allows you to visualize and quantify the performance and traffic of your projects on Vercel. You can use example queries or create custom queries to debug and optimize bandwidth, errors, performance, and bot traffic issues in a production or preview deployment.

Monitoring in the Vercel dashboard.
Monitoring in the Vercel dashboard.

Charts allow you to explore your query results in detail. Use filters to adjust the date, data granularity, and chart type (line or bar).

Graph view to visualize data and usage of your application.
Graph view to visualize data and usage of your application.

Hover and move your mouse across the chart to view your data at a specific point in time. For example, if the data granularity is set to 1 hour, each point in time will provide a one-hour summary.

The tooltip shows you the aggregated data for the date and time selected.
The tooltip shows you the aggregated data for the date and time selected.

To get started with the most common scenarios, use our Example Queries. You cannot edit or add new example queries. For a list of the available options, view our example queries docs.

You can save either personal (My Queries) or Team Queries from the left navigation bar. Personal queries can only be viewed and edited by the user who created them. Only team members with the owner or member roles can access team queries.

You can manage your saved personal and team queries from the query console. Select a query from the left navigation bar and click on the vertical ellipsis (⋮) in the upper right-hand corner. You can choose to Duplicate, Rename, or Delete the selected query from the dropdown menu.

Duplicate, Rename and Delete a query from the query editor.

Alternatively, you can perform the same actions from the left navigation bar. Hover your mouse over a saved query and click on the vertical ellipsis (⋮) to view the drop-down menu.

Manage individual queries from the sidebar right next to their names.

Duplicating a query creates a copy of the query in the same folder. You cannot copy queries to another folder. To rename a saved query, use the ellipses (⋮) drop-down menu or directly click its title to edit.

Deleting a saved personal or team query is permanent and irreversible. To delete a saved query, click the Delete button in the confirmation modal.

You may encounter errors such as invalid queries when using Monitoring. For example, defining an incorrect location parameter generates an invalid query. In such cases, no data appears.

To enable monitoring on Pro plans:

  1. Go to Monitoring tab from the dashboard
  2. Click Enable Monitoring and you see a confirmation modal
  3. Click Next and then Confirm and pay to get access to the feature

Enabling and disabling Monitoring is available on Pro plans

Those with the owner role can access this feature

Enterprise teams can contact sales to get a customized plan based on their requirements.

  1. Go to your team Settings > Billing
  2. Scroll to the Monitoring section
  3. Set the Toggle to the disabled state

Managing IP Address visibility is available on Pro and Enterprise plans

Those with the owner, admin role can access this feature

Vercel creates data points each time a request is made to your website. These data points include unique parameters such as execution time and bandwidth used.

Certain data points such as public_ip may be considered personal information under certain data protection laws. You can hide this information from your Monitoring queries by going to Settings and de-selecting IP Address Visibility. This can only be done by owner and admin roles.

For business purposes, such as DDoS mitigation, Vercel will still collect IP addresses.

For a complete list of fields, see the visualize clause docs.

For more information on what to do next, we recommend the following articles:

Last updated on March 7, 2023