Connect Your Cloudflare Website to Agent & LLM Analytics (Using Logpush)

Overview

This integration uses Cloudflare Logpush to send analytics events to Known Agents. Logpush is only available to Cloudflare accounts with an Enterprise plan. Please contact us if you need help getting set up.

Step 1: Configure Custom Fields

• Select your domain in your Cloudflare dashboard
• In the sidebar, click Logpush under Analytics & Logs
• In the Custom log fields section, click Edit Custom Fields
• Add the following three Request Header custom fields:
  • signature
  • signature-agent
  • signature-input

Step 2: Create a Logpush Job

• Select your domain in your Cloudflare dashboard
• In the sidebar, click Logpush under Analytics & Logs
• Select HTTP destination
• Paste in this endpoint:

https://api.knownagents.com/logs/cloudflare?header_Authorization=Bearer%20YOUR_ACCESS_TOKEN

• Navigate to the Known Agents Projects page and open your project
• Copy your access token from the Settings page
• Back in Cloudflare, swap in your access token where it says YOUR_ACCESS_TOKEN (don't delete the "%20")
• Click Continue
• Select the HTTP requests dataset
• Make sure these fields are selected:
  • EdgeStartTimestamp
  • ClientRequestHost
  • ClientIP
  • ClientRequestMethod
  • EdgeResponseStatus
  • ClientRequestPath
  • ClientRequestURI
  • ClientRequestUserAgent
  • ClientRequestReferer
  • EdgeEndTimestamp
  • RequestHeaders
• Expand Advanced Options and make sure rfc3339 is selected in the Timestamp format dropdown
• Click Submit

Step 3: Test Your Integration

• Navigate to the Projects page
• Select your project
• Click Settings
• Click Send a Test Visit
• Click Realtime

If your website is correctly connected, you should see visits from a test agent in the realtime timeline within a few seconds.