Skip to main content

​
When to use the connector

The connector is the recommended way to send Vercel’s platform data to Bronto. Connect your account once, and Bronto creates the ingestion API key and a drain for each data type in every project of your Vercel team. Use drains you configure yourself instead when you want drains for only some projects, a different dataset layout, or drains managed in your own infrastructure code.

​
Prerequisites

  • A Vercel Pro or Enterprise plan. See Vercel’s drain documentation for plan details.
  • A Bronto account. You can also create one during the connect flow. The connector creates its own ingestion API key, so you don’t need to make one first.

​
Connect your account

The whole flow in 43 seconds, from the Marketplace listing to the drains in Vercel and the first logs in Bronto

1

Open the Bronto listing on the Vercel Marketplace

Go to vercel.com/marketplace/bronto and select Connect Account.You can also reach the listing from inside Vercel at Team Settings → Drains → Add Drain → External Integrations, or from Bronto at Ingestion → Cloud platforms → Vercel.
2

Choose the Vercel team and approve access

Select the Vercel team whose projects you want to stream into Bronto, then approve the access Bronto requests. Bronto uses it to list your projects and create drains on your behalf.
3

Sign in to Bronto

Vercel redirects you to the Bronto sign-in page. Sign in to the organisation you want the data to land in, or create an account if you don’t have one yet. Bronto links the two accounts.
4

Return to Vercel

When you see Vercel Account Linked Successfully!, select Back to Vercel. Drain creation continues in the background.
The Bronto organisation you sign in to is the one the drains are created against, and its region decides which ingestion endpoint they use. If you manage more than one Bronto organisation, make sure you’re signed in to the right one before you connect.

​
What the connector creates

Once the accounts are linked, Bronto:
  • Creates a Bronto API key named Vercel Drain Ingestion API Key with the Ingestion role. Every drain it creates authenticates with this key, and you can see it under API Keys.
  • Lists every project in the connected Vercel team.
  • Creates four drains per project (Logs, Traces, Speed Insights, and Web Analytics), already pointed at the ingestion endpoint for your Bronto account’s region, with the correct encoding and headers.
Each drain is named Bronto Drain - <project>-<type>, so they’re easy to find and edit under Team Settings → Drains in Vercel: For the log and event drains, the dataset tells you which signal the data is and the collection tells you which Vercel project it came from. To look at one project in isolation, filter on its collection; to compare projects, query the log dataset and group by collection. Traces don’t use datasets or collections: find them in Explore Traces and filter by vercel.projectId.
Drains are created in the background and retried to stay within Vercel’s API rate limits, so on a team with many projects it can take a few minutes for all of them to appear under Team Settings → Drains.

​
After connecting

Everything the connector creates is an ordinary Vercel drain that you own from that point on:
  • Sources and environments: each drain forwards all the data it covers. Edit a drain in Vercel to narrow its log sources or environments. See Vercel Drains for what each drain contains.
  • Projects added later: the connector provisions drains for the projects that exist when you connect. For a project created afterwards, contact support to re-run provisioning.
  • Audit logs: audit log drains apply to the whole team rather than to individual projects, so the connector doesn’t create one.

​
Verify Data Flow

Once the drains appear under Team Settings → Drains, data from your projects begins flowing into Bronto. For Logs, Speed Insights, and Web Analytics, open the log, speed_insights, or analytics dataset in Log Search and filter on the project’s collection. For Traces, open Explore Traces and filter by vercel.projectId or vercel.deploymentId.

​
Correlate telemetry across drains

With every drain flowing into Bronto, you can look at frontend and backend data side by side instead of switching between tools. The payloads share a few identifiers that make that work: For example, when a Speed Insights regression shows up on a route, filter Logs and Traces by the same deploymentId to find the release that introduced it, then use the traceId on an error log to open the exact span behind it.

​
Next steps