# Vercel

### Overview

Vercel's Log Drain feature lets you forward logs, traces, speed insights, and analytics to third-party providers or custom endpoints. This guide walks you through connecting your Vercel project to Limy Analytics in 5 steps.

***

### Prerequisites

* A Vercel project (with admin access to Settings)
* Your **Limy Analytics API key** (found in your Limy dashboard)

***

### Step 1 — Open Drains in Vercel Project Settings

1. Go to your Vercel dashboard and open your project.
2. Click **Settings** in the left sidebar.
3. Scroll down and select **Drains** from the menu.
4. Click the **Add Drain** button in the top-right corner.

If no drains exist yet, you'll see an empty state with a "No drains are associated with this project" message.<br>

<figure><img src="https://3264818889-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfwoYt71NlEqR8u7MWxGE%2Fuploads%2FB3SmbwENw2yUFOdnEu0w%2Fimage.png?alt=media&#x26;token=d30bbf77-4d2f-4582-bc84-5f777b8b3d84" alt=""><figcaption></figcaption></figure>

***

### Step 2 — Choose Data to Drain

In the **Add Drain** wizard:

1. Select **Logs** *(Runtime, build and static logs)*.
2. Click **Next**.

> The other options — Traces, Speed Insights, and Web Analytics — are not required for Limy Analytics log ingestion.

<figure><img src="https://3264818889-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfwoYt71NlEqR8u7MWxGE%2Fuploads%2FNlt7U4FDoJn5l5NQ8Umv%2Fimage.png?alt=media&#x26;token=eed2f969-e389-4903-b9d2-21e403967a4c" alt=""><figcaption></figcaption></figure>

***

### Step 3 — Configure the Drain

Fill in the drain settings:

| Field           | Value                                                               |
| --------------- | ------------------------------------------------------------------- |
| **Drain Name**  | `LimyAnalytics` (or any name you prefer)                            |
| **Projects**    | Select **Specific Projects**, then choose your project              |
| **Sources**     | Check at least: `Static Files`, `Rewrites`, `Firewall`, `Redirects` |
| **Environment** | Select **Production** (optionally add Preview)                      |
| **Sampling**    | Leave empty to capture all logs                                     |

Click **Next** when done.

<figure><img src="https://3264818889-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfwoYt71NlEqR8u7MWxGE%2Fuploads%2FuSakrKChTbrhQwHOupjX%2Fimage.png?alt=media&#x26;token=88164c68-ab1e-41f9-9ed3-105abf60bc4f" alt=""><figcaption></figcaption></figure>

***

### Step 4 — Configure the Destination

On the **Configure the destination** step:

1. Stay on the **Custom Endpoint** tab.
2. Set the URL to:

```
https://stream.getlimy.ai
```

3. Set **Encoding** to `JSON`.
4. Enable the **Custom Headers** toggle and add:

```
x-api-key: <Your Limy Analytics Key>
```

Replace `<Your Limy Analytics Key>` with your actual API key from the Limy dashboard. Do not share this key publicly.

5. Click **Create Drain**.

<figure><img src="https://3264818889-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfwoYt71NlEqR8u7MWxGE%2Fuploads%2F7BhF6W2QD3hcfZkfV45S%2Fimage.png?alt=media&#x26;token=d8914d0a-e218-4214-bdc7-50f8d89c6c6a" alt=""><figcaption></figcaption></figure>

***

### Step 5 — Verify the Connection

Once saved, your drain will appear in the **Drains** list. Confirm it shows:

* **Name:** LimyAnalytics
* **Type:** Logs
* **Connected Projects:** your selected project
* A **blue checkmark** icon indicating the drain is active

<figure><img src="https://3264818889-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfwoYt71NlEqR8u7MWxGE%2Fuploads%2FT8IQqGO40QozcmmB2iJm%2Fimage.png?alt=media&#x26;token=bfe5d2cc-3c7d-4b98-bd21-c509d2b88c53" alt=""><figcaption></figcaption></figure>

***

### You're all set! 🎉

After setup, it may take **up to 10 minutes** before data appears in your Limy Analytics dashboard.

If you have any questions, reach out to **Limy Support**.
