[Deprecated] This method of integration will continue to be supported. However, a smoother experience is now available via the Vercel Connectable Account Integration

​
Overview

Vercel Log Drains provide a way to forward your Vercel application logs to Profound Agent Analytics platform. By integrating with Profound’s Agent Analytics platform, you gain access to comprehensive monitoring features including automated agent detection and real-time performance analysis.

​
Prerequisites

Before beginning the integration process, ensure you have:
  • A Vercel account with administrative access
  • A Profound account with an active subscription
  • Administrative access to your Vercel project settings

​
Configuration

1

Enter Domain

Enter your domain to begin the onboarding process.Enter Name
2

Configure Vercel Domain

Profound will automatically detect your hosting provider. Ensure the correct provider is selected before proceeding. Click Continue when ready.
If Vercel is not your hosting provider, please see the documentation for Cloudfront, Cloudflare Logpush, Cloudflare Worker, Fastly, Netlify, or Custom.
Detect Vercel Domain
3

Copy Endpoint and API Key

At this step you will receive an API Key and log drain Endpoint.
Leave this tab open while you continue. The next steps will require the key and endpoint.
Vercel Keys
4

Access Project Settings

Log into your Vercel dashboard and navigate to your project’s settings. From there, go to Team Settings > Log Drains.Add Log DrainClick “Add Log-Drain” and select “Custom Log Drain”, then click “Continue”.Add Custom Log Drain
5

Configure Log Drain

Now, configure the following settings:
  1. Projects: Select the Specific Projects option and select the project that is associated with your domain. The project domain does not need to be the same as your target domain, but your target domain should be configured as a Custom Domain for the project’s production environment.
Select Project
  1. Sources: Select Function and Static Sources. Selecting other sources may result in duplicate request counting from middleware.
Select Sources
  1. Delivery Format: JSON
Select Delivery Format
  1. Environments: Production
Select Environments
  1. Sampling Rate: 100%
Select Sampling Rate
Please contact support if you do not have an assigned API URL.
Please do not press Verify yet. You will need to configure the x-vercel-verify header first in the next step.
  1. Endpoint: https://artemis.api.tryprofound.com/v1/logs/vercel.
Add Endpoint
  1. Custom Headers: Add X-API-Key: Your_Profound_API_Key as a custom header.
Add Custom Headers
6

Finish Domain Configuration in Profound

Switch back to Profound. At this point, you should have visted these docs.
You will not be able to continue until you have pressed Visit API Docs. If the button remains disabled, please ensure you have clicked Visit API Docs at least once.
Docs VisitedClick I’ve configured the integration near the bottom. At this point, Profound will save your configuration details and confirm the domain and authentication.Domain Connected
7

Prepare for API Key Verification

Click Close. Then, using the tabs at the top, navigate to Settings.
Leave this tab open while you continue. The next steps will involve editing the API key.
Key Settings
8

Configure Verification

Vercel should prompt you to verify URL ownership by configuring an x-vercel-verify header:
  1. Copy your x-vercel-verify value
Copy x-vercel-verify
  1. Switch back to your Profound tab at Settings from the previous step. Click Edit next to your API key. Add it to x-vercel-verify field and click Save at the bottom. Edit Vercel Verify
  2. Verify the API key by clicking the Verify button in the Vercel dashboard. If successful, you should see a green checkmark. Now you can proceed by clicking Add Log Drain.
If you see a notification for non-200 response, please ensure that your Profound API key is configured as a custom header, and the x-vercel-verify header is configured in the Profound dashboard. If the issue persists, try again with a new API key or contact support@profound.com for assistance.
9

Enable Signature Verification

Now that you’ve added the Log Drain, you can enable signature verification for enhanced security.
  1. Copy your x-vercel-signature Secret shown in the Vercel dashboard
Copy x-vercel-signature
  1. Switch back to your Profound tab at Settings from the previous step. Click Edit next to your API key. Add it to x-vercel-signature field and click Save at the bottom. Edit Vercel Signature
10

Success

Now that you’ve configured your Vercel Log Drain, you should begin to see data populate in your Profound dashboard. Data should begin to populate within 5 minutes.
That’s it! Vercel will now send real-time logs to Profound. Data should begin appearing in your dashboard within a few minutes.

​
Troubleshooting

  • If logs aren’t appearing in your Profound dashboard:
    • Verify your API key and metadata are correctly configured
    • Check that your Log Drain URL is properly formatted
    • Ensure your sampling rate isn’t set too low for your traffic volume
    • Review your Vercel project’s Function logs for any error messages
  • For verification issues:
    • Double-check the format of your metadata JSON
    • Ensure the Profound API key is correctly configured as a custom header X-API-Key: Your_Profound_API_Key
    • Ensure both verification keys x-vercel-verify and x-vercel-signature are copied exactly as shown with no extra spaces or characters
    • Avoid pressing Verify before configuring the x-vercel-verify header. Try again with a new API key and avoid pressing Verify until the x-vercel-verify header is configured in the Profound dashboard.

​
Security Considerations

  • Store API keys securely and never expose them in your application code
  • Regularly rotate your API keys and update Log Drain configurations accordingly
  • Monitor your log drain usage for unusual patterns or unexpected traffic spikes

​
Additional Resources