Skip to Content

Working with Drains

Copy page

Drainsare availableon Enterprise and Pro plans


Drains let you forward observability data from your applications to external services for debugging, performance optimization, analysis, and alerting, so that you can:

  • Store observability data persistently in your preferred external services
  • Process large volumes of telemetry data using your own tools
  • Set up alerts based on application behavior patterns
  • Build custom metrics and dashboards from your data

Getting started with Drains

You can add Drains in the following ways:

Learn how to manage your active drains.

Data types

Drains support the following data types:

  • Logs: Runtime, build, and static logs from your deployments (supports custom endpoints and native integrations)
  • Traces: Distributed tracing data in OpenTelemetry format (supports custom endpoints and native integrations)
  • Speed Insights: Performance metrics and web vitals (custom endpoints only). Requires Speed Insights Plus
  • Web Analytics: Page views and custom events (custom endpoints only)
  • Connect: Runtime events in the form of token requests, authorizations, revocations, and trigger deliveries from Vercel Connect connectors (custom endpoints only)
  • Audit Logs: Team activity events

{

schemas: {

Data type references

Each drain data type has specific formats, fields, and schemas. Review the reference documentation for logs, traces, speed insights, analytics, connect events, and audit logs to understand the data structure you'll receive from each data type.

[schemaName: string]: {

The schemas object maps a schema name to a version object:

};

}

version: string;

The following table lists the available schema names:

}

When you create or update drains through the REST API, use the schemas property in the request body to specify which data type the drain receives. Each drain handles one data type.

Schema name


  • Runtime, build, and static logs v1
  • trace v1
  • analytics v2
  • speed_insights v1
  • connect v1
  • Performance metrics and web vitals Data type
  • Distributed tracing data in OpenTelemetry format Version
  • Web Analytics page views and custom events log
  • Team activity events audit_log
  • Vercel Connect token and trigger events v1

For example, to create a log drain, set log as the schema name with version v1:

{

"schemas": {

"log": { "version":"v1" }

}

}


You also use the schemas property when validating drain delivery configuration. Pass the same schemas and delivery values you plan to use when creating the drain to verify your endpoint before the drain is live.

For details on the data each schema delivers, see the reference docs for logs, traces, speed insights, analytics, Connect events, and audit logs.

Security

You can secure your drains by checking for valid signatures and hiding IP addresses. Learn how to add security to your drains.

Usage and pricing

Drains usage is billed based on the pricing table below. Pricing is the same regardless of data type:


Resource

Drains

Price

$0.50 per 1 GB

Included (Pro)

N/A

More resources

Billed gigabytes are measured as the uncompressed JSON serialization of each drained record, regardless of the format or encoding used to deliver it. Delivery to a destination can use protobuf, compression, or both, so the bytes a destination reports receiving (for example, an ingestion or "bytes received" metric in the destination service) can be lower than the billed bytes. The two figures measure different things and are not directly comparable. This difference is expected.

See Optimizing Drains for information on how to manage costs associated with Drains.

For more information on Drains, check out the following resources:


Last updated September 1, 2026


Speed Insights

Was this helpful?

Cross-link map: Working with Drains (/docs/drains)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 pagesUsing Drains — Learn how to configure drains to forward observability data to custom HTTP endpoints, dedicated Audit Log destinations,Migrating from Custom SIEM Log Streaming to Audit Log Drains — Move your SIEM integration from Custom SIEM Log Streaming to Audit Log Drains, with wider event coverage and a new eventTrace Drains Reference — Learn about Trace Drains - OpenTelemetry-compliant distributed tracing data formats and configuration.Introducing Vercel Drains: Complete observability data, anywhereAudit Log Drains Reference — Learn about Audit Log Drains - data formats, fields, and team activity events.This page links to (23)Vercel Connect — Give your agents and services secure, short-lived access to third-party APIs like Slack, GitHub, Microsoft, and SnowflakObservability — Monitor token requests, authorizations, revocations, and trigger deliveries for your connectors.Drain Audit Logs to Datadog — Learn how to forward Vercel Audit Log Drain events to Datadog using the Datadog Logs API.Drain Audit Logs to Panther — Learn how to forward Vercel Audit Log Drain events to Panther using Panther's built-in Vercel source.Drain Audit Logs to S3 — Learn how to configure AWS IAM and Amazon S3 so Vercel can write Audit Log Drain events to your S3 bucket.Drain Audit Logs to Splunk — Learn how to forward Vercel Audit Log Drain events to Splunk using the HTTP Event Collector \(HEC\).Web Analytics Drains Reference — Learn about Web Analytics Drains - data formats and custom events configuration.Audit Log Drains Reference — Learn about Audit Log Drains - data formats, fields, and team activity events.Log Drains Reference — Learn about Log Drains - data formats, sources, environments, and security configuration.Speed Insights Drains Reference — Learn about Speed Insights Drains - data formats and performance metrics configuration.Trace Drains Reference — Learn about Trace Drains - OpenTelemetry-compliant distributed tracing data formats and configuration.Drains Security — Learn how to secure your Drains endpoints with authentication and signature verification.Using Drains — Learn how to configure drains to forward observability data to custom HTTP endpoints, dedicated Audit Log destinations,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 Enterprise Plan — Learn about the Enterprise plan for Vercel, including features, pricing, and more.Vercel Hobby Plan — Learn about the Hobby plan and how it compares to the Pro plan.Vercel Pro Plan — Learn about the Vercel Pro plan with credit-based billing, free viewer seats, and self-serve enterprise features for proUnderstanding Vercel — Learn all about Vercel's Pro Plan free trial, including features, usage limits, and options post-trial. Learn how to manCreate a new Drain — POST /v1/drains — Create a new Drain with the provided configuration.Retrieve a list of all Drains — GET /v1/drains — Allows to retrieve the list of Drains of the authenticated team.Update an existing Drain — PATCH /v1/drains/{id} — Update the configuration of an existing drain.Validate Drain delivery configuration — POST /v1/drains/test — Validate the delivery configuration of a Drain using sample events.Limits and Pricing for Speed Insights — Learn about our limits and pricing when using Vercel Speed Insights. Different limitations are applied depending on yourPages that link here (45)By site: vercel-changelog (3) · vercel-kb (10) · vercel-web (1) · vercel-docs (31)From vercel-changelogAudit Log Drains now support Datadog, Splunk, and PantherRedirects and rewrites now available in ObservabilityPublic Web Analytics API now availableFrom vercel-kbAdd structured application logs to Vercel Functions — Learn how to add structured application logs to Vercel Functions to help troubleshoot function issues in real time.How to migrate from Fastly to Vercel with zero downtime — Consolidate your CDN infrastructure on Vercel to reduce latency, simplify your configuration, and improve your developerMigrate 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 ovThe Complete Guide to Vercel Connect — Use Vercel Connect to call provider APIs like Slack, GitHub, Linear, Microsoft, Discord, Snowflake, and Salesforce fromVercel vs Akamai — A detailed guide to Vercel vs Akamai: compute models, AI infrastructure, framework support, media streaming, CDN capabilVercel vs Fastly — A detailed guide to Vercel vs Fastly: full-stack application platform vs edge infrastructure layer, covering framework sVercel vs Netlify — A detailed guide to Vercel vs Netlify: runtimes, compute architecture, AI infrastructure, security, and when to choose eVercel vs Northflank — A detailed guide to Vercel vs Northflank: Fluid compute, CDN and caching, container image functions, security defaults,Vercel vs Railway — A detailed guide to Vercel vs Railway: serverless vs always-on containers, container images via Dockerfile.vercel, frameVercel vs Render — A detailed guide to Vercel vs Render: compute models, AI infrastructure, Docker and container image support, backgroundFrom vercel-webIntroducing Vercel Drains: Complete observability data, anywhereFrom vercel-docsTools — Available tools in Vercel MCP for searching docs, managing teams, projects, deployments, Web Analytics, runtime logs andAI Gateway Trace Drains — Forward an OpenTelemetry trace of every AI Gateway request to your own observability tool, and understand trace drain biMigrating from Custom SIEM Log Streaming to Audit Log Drains — Move your SIEM integration from Custom SIEM Log Streaming to Audit Log Drains, with wider event coverage and a new eventVercel Connect — Give your agents and services secure, short-lived access to third-party APIs like Slack, GitHub, Microsoft, and SnowflakObservability — Monitor token requests, authorizations, revocations, and trigger deliveries for your connectors.Optimizing Vercel Connect Usage — Reduce billed token requests and triggers by using the SDK cache effectively, tuning refresh behavior, and pruning triggAccessing Build Logs — Learn how to use Vercel's build logs to monitor the progress of building or running your deployment, and check for possiWeb Analytics Drains Reference — Learn about Web Analytics Drains - data formats and custom events configuration.Audit Log Drains Reference — Learn about Audit Log Drains - data formats, fields, and team activity events.Log Drains Reference — Learn about Log Drains - data formats, sources, environments, and security configuration.Speed Insights Drains Reference — Learn about Speed Insights Drains - data formats and performance metrics configuration.Trace Drains Reference — Learn about Trace Drains - OpenTelemetry-compliant distributed tracing data formats and configuration.Drains Security — Learn how to secure your Drains endpoints with authentication and signature verification.Using Drains — Learn how to configure drains to forward observability data to custom HTTP endpoints, dedicated Audit Log destinations,Create React App on Vercel — Deploy Create React App projects to Vercel and add Preview Deployments, Web Analytics, Speed Insights, and ObservabilityConcurrency scaling — Learn how Vercel automatically scales your functions to handle traffic surges.Vercel Function Logs — Use runtime logs to debug and monitor your Vercel Functions.Streaming — Learn how to stream responses from Vercel Functions.Request headers — Learn about the request headers sent to each Vercel deployment and how to use them to process requests before sending aLogs — Use logs to find information on deployment builds, function executions, and more.Runtime Logs — Learn how to search, inspect, and share your runtime logs with the Logs tab.Understanding Vercel — Learn all about Vercel's Pro Plan free trial, including features, usage limits, and options post-trial. Learn how to manPricing on Vercel — Learn about Vercel's pricing model, including the resources and services that are billed, and how they are priced.Production checklist for launch — Ensure your application is ready for launch with this comprehensive production checklist by the Vercel engineering team.Projects overview — A project is where you deploy and operate frontend apps, APIs, backends, containers, and agent workloads on Vercel.Transferring a project — Learn how to transfer a project between Vercel teams.Shared Responsibility Model — Discover the essentials of our Shared Responsibility Model, outlining the key roles and responsibilities for customers,Speed Insights Overview — This page lists out and explains all the performance metrics provided by Vercel's Speed Insights feature.Limits and Pricing for Speed Insights — Learn about our limits and pricing when using Vercel Speed Insights. Different limitations are applied depending on yourGetting started with Speed Insights — Vercel Speed Insights provides you detailed insights into your website's performance. This quickstart guide will help yoTracing — Learn how to trace your application to understand performance and infrastructure details.

Next

Using Drains