Skip to Content

Debug applications with Vercel Observability

Expected revenue
$50M

Find production errors, capture request traces, and discover queryable metrics from the dashboard or Vercel CLI.

vercel logs--environmentproduction--status-code500--json

all plans

You can use Observability on all plans to monitor your projects. Observability Plus is available on Pro and Enterprise teams, providing additional features and metrics, higher limits, and increased retention.


  Observability feature access

Debug errors and latency with Observability

Use logs to find failing requests, traces to inspect one request path, and metrics to compare behavior over time. Use JSON output when a script or coding agent needs structured data.

How you use Observability depends on the needs of your project, for example, perhaps builds are taking longer than expected, or your Vercel Functions seem to be increasing in cost. A brief overview of how you might use the tab would be:

  1. Decide what feature you want to investigate. For example, Vercel Functions.
  2. Use the date picker or the time range selector to choose the time period you want to investigate. Users on Observability Plus will have a longer retention period and more granular data.
  3. Let's investigate our graphs in more detail, for example, Error Rate. Click and drag to select a period of time and press the Zoom In button.
  1. Then, from the list of routes below, choose to reorder either based on the error rate or the duration to get an idea of which routes are causing the most issues.
  2. To learn more about specific routes, click on the route.
  3. The functions view will show you the performance of each route or function, including details about the function, latency, paths, and External APIs. Note that Latency and breakdown by path are only available for Observability Plus users.
  4. The function view also provides a direct link to the logs for that function, enabling you to pinpoint the cause of the issue.

Available insights

Observability provides different sections of features and traffic sources that help you monitor, analyze, and manage your applications either at the team or the project level. The following table shows their availability at each level:

Data source

Project Level

Team Level

Tracked events

Vercel tracks the following event types for Observability:


Pricing and limitations

Pro and Enterprise teams can use Observability Plus for additional features, higher limits, and increased retention.

If you've excluded specific projects from Observability Plus, those projects won't generate metered events.

Vercel creates one or more of these events each time a request is made to your site. Depending on your application and configuration a single request to Vercel might be:

  • Edge Requests
  • Vercel Function Invocations
  • External API Requests
  • Routing Middleware Invocations
  • AI Gateway Requests
  • 1 edge request event if it's cached.
  • 1 Edge Request, 1 Middleware, 1 Function Invocation, 2 External API calls, and 1 AI Gateway request, for a total of 6 events.
  • 1 edge request event if it's a static asset.

CLI workflows

For more information on pricing, see Pricing.

Vercel tracks events at the team level, counting them across all projects in the team.

For step-by-step debugging workflows using the Vercel CLI with Observability data, see Debugging production 500 errors.

You can also manage which projects are included in your Observability Plus subscription to control costs.

Users on all plans can use Observability at no additional cost, with some limitations. The Observability section in the sidebar is available on the project dashboard for all projects in the team.

Cross-link map: Observability (/docs/observability)From the Vercel docs graph (built 2026-09-21T05:26:59.511Z), spanning vercel.com docs + KB, nextjs.org, ai-sdk.dev, and other Vercel documentation sites. Full graph as JSON: https://vercel.com/docs/graph.jsonSemantically closest pagesObservability Plus — Learn about using Observability Plus and its limits.Observability Insights — List of available data sources that you can view and monitor with Observability on Vercel.Manage and optimize usage for Observability — Learn how to understand the different charts in the Vercel dashboard, how usage relates to billing, and how to optimizeVercel Observability is now generally availableQuery — Query and visualize your Vercel usage, traffic, and more in observability.This page links to (5)Notebooks — Learn more about Notebooks and how they allow you to organize and save your queries.Debugging production 500 errors — Find, fix, and verify production 500 errors using the Vercel CLI.Observability Insights — List of available data sources that you can view and monitor with Observability on Vercel.Observability Plus — Learn about using Observability Plus and its limits.Monitoring — Query and visualize your Vercel usage, traffic, and more with Monitoring.Pages that link here (87)By site: vercel-changelog (25) · vercel-kb (29) · vercel-web (8) · workflow (1) · vercel-docs (24)From vercel-changelogAI query prompting now available in Observability PlusAnomaly alert configuration now availableCreate and share queries with notebooks in Vercel ObservabilityEdge Function metrics now available in MonitoringEnhanced firewall data now available in MonitoringExpanded search for workflow runs in Vercel ObservabilityGenerate shareable snapshots of Observability chartsImproved metrics search in Observability PlusMicrofrontends now generally availableMiddleware insights now available in Vercel ObservabilityMonitoring pricing reduced up to 87%New custom visualization in Vercel ObservabilityObservability added to AI Gateway alphaObservability for Edge Requests now includes more traffic parametersOne-click linking from Usage to Vercel Observability dashboardsOverview page in ObservabilityPull anomaly alert details using the Vercel CLIQuery and visualize workflow data in Vercel ObservabilityQuery data on external API requests in Vercel ObservabilityRedirects and rewrites now available in ObservabilityRun and share custom queries in Observability PlusObservability for Vercel Functions now offers a quick-view of key insightsVercel Observability is now generally availableVercel Observability is now route-aware for SvelteKit appsView & query bot verification data in Vercel ObservabilityFrom vercel-kbHow to architect an AI evaluation dashboard on Vercel — Map eval orchestration, traces, and run storage to AI Gateway, Observability, and Marketplace Postgres, and learn when sHow to prepare your storefront for Black Friday traffic — A practical checklist for keeping your storefront fast and your checkout path healthy through Black Friday and Cyber MonRunning Docker on Vercel — Learn how to run Docker on Vercel by deploying OCI container images as Vercel Functions, storing them in Vercel ContaineBuild an incident response sre agent with eve — sre is an incident response agent for Slack. It investigates production issues using a hypothesis-driven approach and reHosting your API on Vercel — Learn how to build and scale performant APIs on Vercel.Building AI apps on Vercel: an overview — Learn the key AI concepts and tools for building and scaling AI apps.How to Optimize Next.js + Sitecore JSS — This guide covers performance and usage considerations when building and deploying your Next.js and Sitecore JSS applicaHow to Optimize RSC Payload Size — Learn how to use React Server Components efficiently in Next.js to reduce cost and improve performanceHow to Utilize Vercel’s Bot Management Features — A practical, step-by-step guide to identifying unwanted automated traffic and securing your Vercel apps with Bot ProtectHow can I improve function cold start performance on Vercel? — Learn how to confirm whether cold starts cause function latency on Vercel, and how Fluid compute reduces how often theyIncremental Migrations with Microfrontends — Learn how to migrate legacy applications using microfrontendsInvestigate latency issues and slowness on Vercel — Learn how to use Observability to investigate latency issues and slowness on Vercel.Translate Kubernetes manifests to vercel.json — Translate Kubernetes Deployments, Services, Ingress, ConfigMaps, and CronJobs into vercel.json configuration and VercelMigrate self-hosted Next.js and containers from AWS to Vercel — Migrate containers from AWS to Vercel: deploy with Dockerfile.vercel, keep RDS, S3, and SQS in AWS over OIDC, and cut ovTroubleshoot and optimize Active CPU usage on Fluid compute — Diagnose which routes drive Active CPU usage and learn to optimize it. Separate traffic growth from per-request CPU workProduction architecture for a RAG chatbot on Vercel — Architect a production RAG chatbot on Vercel Functions with Fluid compute, AI Gateway, and a region-pinned vector store.How to choose a Salesforce Commerce Cloud storefront: PWA Kit, Storefront Next, or Next.js — Compare PWA Kit, Storefront Next, and a Next.js storefront on Vercel for Salesforce Commerce Cloud. Learn how caching, pHow to ship an H3 app on Vercel — Deploy an H3 app to Vercel with zero configuration. Learn to configure streaming, middleware, cron jobs, the Bun runtimeHow to ship a Koa app on Vercel — Deploy a Koa app to Vercel with zero configuration. Learn how to ship from the Vercel CLI or Git, and configure responseHow to ship a NestJS app on Vercel — Deploy a NestJS app to Vercel with zero configuration. Learn how to ship from a template, the Nest CLI, or Git, and confTroubleshooting Build Error: "Build step did not complete within the maximum of 45 minutes" — Learn common reasons Vercel builds hit the 45-minute limit and how to reduce build times so your deployments stay fast aTroubleshooting Builds Failing with SIGKILL or Out of Memory Errors — Learn how to troubleshoot builds failing with SIGKILL or Out of Memory errors on a Vercel Deployment.Understand the Cost Impact of Function Invocations — Learn how to use Observability to understand function invocations and their cost impact.Using Vercel as a Standalone CDN — Use Vercel's external rewrites to proxy and cache content from external websites or APIs through Vercel's global edge neDoes Vercel support Kubernetes? — Vercel doesn't run Kubernetes clusters. Learn how Kubernetes workloads like Deployments, Ingress, ConfigMaps, and CronJoVercel vs Kubernetes — Compare Vercel and Kubernetes on operational ownership, deployment workflow, scaling, and cost model to decide which plaBuild a Weather API on Vercel: Express, FastAPI, and Nitro — Build a weather API on Vercel with FastAPI, Express, or Nitro. Compare the three runtimes, add caching and ObservabilityHow to Build a Weather API with Nitro and Vercel — Provide real-time weather data to apps and websites with a single Nitro route, Vercel cache storage, and Observability.How to stop Vercel Functions from timing out — Vercel Functions that time out usually trace back to a few causes. Learn how Fluid Compute fixes most of them and how toFrom vercel-webAgentic InfrastructureHow to integrate AI into your businessHow we’re adapting SEO for LLMs and AI searchProtecting your app (and wallet) against malicious trafficHeadless Salesforce: An incremental migration from monolith to composableThe AI Cloud: A unified platform for AI workloadsNext.js 16.3 support on VercelVercel Pricing — Choose a Vercel plan and compare features and usage pricing.From workflowStep executed multiple times — Diagnose duplicate step_started events caused by function timeouts, OOMs, or network issues.From vercel-docsBot Management — Learn how to manage bot traffic to your site.vercel project — Perform the following commands from the terminal for your Vercel Projects: list, add, inspect, update settings, rename,eve — Build and deploy durable backend AI agents with eve, an open-source, filesystem-first framework.Observability — View agent runs in the Vercel dashboard with no setup, and optionally export AI SDK spans through OpenTelemetry.Nitro on Vercel — Deploy Nitro applications to Vercel with zero configuration. Learn about observability, ISR, and custom build configuratCreate React App on Vercel — Deploy Create React App projects to Vercel and add Preview Deployments, Web Analytics, Speed Insights, and ObservabilityVite + Nitro on Vercel — Add a backend to any Vite app with Nitro and deploy to Vercel with zero configuration.Container Images — Deploy OCI container images with a Dockerfile or Containerfile on Vercel Functions.Debugging slow Vercel Functions — Diagnose and fix slow Vercel Functions using CLI tools, logs, and timing analysis.Integrating Vercel and Kubernetes — Deploy your frontend on Vercel alongside your existing Kubernetes infrastructure.Manage and optimize usage for Observability — Learn how to understand the different charts in the Vercel dashboard, how usage relates to billing, and how to optimizeTesting & troubleshooting microfrontends — Learn about testing, common issues, and how to troubleshoot microfrontends on Vercel.Debugging production 500 errors — Find, fix, and verify production 500 errors using the Vercel CLI.Observability Plus — Learn about using Observability Plus and its limits.Account Plans on Vercel — Learn about the different plans available on Vercel.Vercel Enterprise Plan — Learn about the Enterprise plan for Vercel, including features, pricing, and more.Pricing on Vercel — Learn about Vercel's pricing model, including the resources and services that are billed, and how they are priced.Products — Browse Vercel products for building, deploying, securing, observing, and scaling web applications.Projects overview — A project is where you deploy and operate frontend apps, APIs, backends, containers, and agent workloads on Vercel.Monitoring Quickstart — In this quickstart guide, you'll discover how to create and execute a query to visualize the most popular posts on yourRouting Middleware — Learn how you can use Routing Middleware, code that executes before a request is processed on a site, to provide speed aSession tracing — Learn how to trace your sessions to understand performance and infrastructure details.Vercel Blob — Vercel Blob is a scalable, cost-effective object storage service with private and public access modes for files up to 5Workflow Pricing and Limits — Understand how Vercel Workflows billing works and the limits that apply to runs, streams, and platform resources.

Was this helpful?