Documentation Index
Fetch the complete documentation index at: https://docs.bronto.io/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Vercel’s drains forward observability data to an external destination in real time. Routing this data into Bronto lets you correlate frontend performance, user behaviour, and backend telemetry in a single place, with long-term retention and unified alerting across your full stack.| Drain | What it contains | Schema reference |
|---|---|---|
| Logs | Runtime logs from your Vercel deployments | Log Drains reference |
| Traces | Distributed trace spans across your serverless functions | Traces reference |
| Speed Insights | Core Web Vitals and real user performance metrics | Speed Insights reference |
| Web Analytics | Visitor events and page view data | Analytics reference |
Prerequisites
- A Vercel Pro or Enterprise plan. See Vercel’s drain documentation for plan details.
- A Bronto API key with at least the Ingestion role. See API Keys for instructions on creating one.
Drain Types
Vercel exposes four drain types. Each maps to a separate Bronto ingestion endpoint and encoding format:| Drain | Endpoint URL | Encoding |
|---|---|---|
| Logs | https://ingestion.<region>.bronto.io/ | NDJSON |
| Traces | https://ingestion.<region>.bronto.io/v1/traces | Protobuf |
| Speed Insights | https://ingestion.<region>.bronto.io/ | NDJSON |
| Web Analytics | https://ingestion.<region>.bronto.io/ | NDJSON |
<region> with your Bronto account’s region — either eu or us.
All four drain types use the same set of required headers:
| Header | Value |
|---|---|
x-bronto-api-key | Your Bronto API key |
x-bronto-dataset | The dataset name to write into |
x-bronto-collection | The collection name to write into |
Configure a Drain in Vercel
The steps below apply to all four drain types. Repeat this process for each type you want to enable.- Navigate to your team settings in Vercel and go to the Drains section
- Click Add Drain in the top-right corner
- Select the drain type you want to configure (Logs, Traces, Speed Insights, or Web Analytics)
- Configure the drain name and select which projects should be associated with it
All data associated with a single drain configuration will be grouped in the same dataset. We recommend creating separate drains for different projects and environments.
- For Logs drains: select the log sources and environments (e.g., production, preview) you want to include
- Most customers send all data to Bronto without sampling — Bronto is designed to handle high-volume ingestion. Sampling rules are available if you need to control Vercel drain costs.
- Select Custom Endpoint and set the URL to the appropriate endpoint from the table above
- Select the encoding format from the table above (NDJSON or Protobuf)
- Add the three required headers (
x-bronto-api-key,x-bronto-dataset,x-bronto-collection) - Click Test — if everything is configured correctly you should see a 200 status response
If you receive an error, double-check that the endpoint URL is correct for the drain type, the API key has the Ingestion role assigned, and all three required headers are present and correctly formatted. If issues persist, contact Bronto Support.
- Click Create Drain to finish setup