Query

You can use Query to get deeper visibility into your application when debugging issues, monitoring usage, or optimizing for speed and reliability. Query lets you explore traffic, errors, latency and similar metrics in order to:

• Investigate errors, slow routes, and high-latency functions
• Analyze traffic patterns and request volumes by path, region, or device
• Monitor usage and performance of AI models or API endpoints
• Track build and deployment behavior across your projects
• Save queries to notebooks for reuse and team collaboration
• Customize dashboards and automate reporting or alerts

To start using Query, you first need to enable Observability Plus. Then, you can create a new query based on the metrics you want to analyze.

• Pro and Enterprise teams should Upgrade to Observability Plus to edit queries in modal.
• Free observability users can still open a query, but they cannot modify any filters or create new queries.

1. Access the Observability dashboard

   • At the Team level: Go to the Vercel dashboard and click the Observability tab
   • At the Project level: Go to the Vercel dashboard, select the project you would like to monitor from the scope selector, and click the Observability tab

2. Initiate a new query

   • Start a new query: In the Observability section, click the button (New Query) to open the query creation interface.
   • Select a data source: Under "Visualize", select the metric you want to analyze such as edge requests, serverless function invocations, external API requests, or other events.

3. Define query parameters

   • Select the data aggregation: Select how you would like the values of your selected metric to be compiled such as sum, percentage, or per second.
   • Set Time Range: Select the time frame for the data you want to query. This can be a predefined range like "Last 24 hours" or a custom range.
   • Filter Data: Apply filters to narrow down the data. You can filter by a list of fields such as project, path, WAF rule, edge region, etc.

4. Visualize Query

   • View the results: The graph below the filter updates automatically as you change the filters.
   • Adjust as Needed: Refine your query parameters if needed to get precise insights.

5. Save and Share Query

   • Save the query: Once you are satisfied with your query, you can save it by clicking Add to Notebook.
   • Select a notebook: Select an existing notebook from the dropdown.
   • Share Query: You can share the saved query from the notebook with team members by clicking on the Share with team button.

• When building queries, you can select the most appropriate view, and visualize results with:
  • a line or a volume chart
  • a table, if your query has a group by clause
  • a big number (with a time series), if your query has no group by clause
• You can save your queries in notebooks either for personal use or to share with your team.
• In the dashboard, you can create a new query using the query form fields or the AI assistant at top of the new query form.

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

Certain events such as public_ip may be considered personal information under certain data protection laws. To hide IP addresses from your query:

1. Go to the Vercel dashboard and ensure your team is selected in the scope selector.
2. Go to the Settings tab and navigate to Security & Privacy.
3. Under IP Address Visibility, toggle the switch next to "Off" so the text reads IP addresses are currently hidden in the Vercel Dashboard..

• Learn about available metrics and aggregations and how you can group and filter the data in Query Reference.