Skip to main content
A Vercel Log Drain sends your project’s request logs to Quotable as they happen. Nothing runs in your request path, and every field is available.

Requirements

  • A Vercel plan that includes Drains, and permission to create one for your team.
  • The Vercel project that serves the domain the source is created for.
What it measures: every field, including response time, cache status and country.

Set up

1

Create the source in Quotable

In Agent Analytics, select Connect source, choose Vercel Log Drain and select Generate credentials. Keep the wizard open: you’ll paste values in both directions.
2

Create the drain in Vercel

In your Vercel team settings, create a log drain:
  • Data: logs.
  • Projects: only the project that serves this domain.
  • Sources: the request log sources (static files, functions, edge, external rewrites). Build logs aren’t request traffic and are dropped as not_http_traffic.
  • Environment: production. Preview traffic is dropped unless you opt in (below).
  • Delivery format: JSON or NDJSON. Both are accepted.
  • Endpoint URL: the endpoint URL from the wizard.
  • Custom header: Authorization with the value Bearer aa_live_….
3

Map the Vercel project in Quotable

Under Vercel project mapping in the wizard, fill in:
  • Vercel project id: the prj_… ID of the project. Logs from any other Vercel project are then dropped as project_mismatch.
  • Drain verification key: the key Vercel shows while you create the drain. Quotable returns it in the x-vercel-verify header, which is how Vercel confirms the endpoint is yours.
  • Include preview deployments: leave off unless you want preview traffic counted.
Select Save mapping, then finish creating the drain in Vercel.
4

Confirm delivery

Select Check now in Quotable. Vercel delivers within seconds of a request.
The project mapping is optional, but set it. It protects the source if a drain is ever widened to more projects, and it makes the setup hints in Check now precise.

Preview deployments

By default, only production traffic is counted. A preview deployment is a different site with a different audience, and its crawls would distort your production numbers. Records from other environments are dropped as environment_filtered. To count previews, turn on Include preview deployments in the project mapping and select Save mapping.

Test the endpoint

The wizard shows a curl command with the x-agent-analytics-test: 1 header. It proves the token and endpoint work and shows how a GPTBot request is classified, without storing anything. See Test deliveries.

Rotate the token

  1. Rotate the token in Quotable. The old token stops working immediately.
  2. Update the Authorization header of the drain in Vercel.

Disconnect

Delete the drain in Vercel, then disconnect the source in Quotable.

Troubleshooting

Next steps

Read the dashboard

What to look at once data arrives.

Troubleshooting

Fix deliveries that fail or arrive empty.
Last modified on November 18, 2026