Cloudflare Logpush Setup (Enterprise)

Stream HTTP request logs directly from Cloudflare to BotSights using Logpush. This method requires a Cloudflare Enterprise plan.

For non-Enterprise plans, use the Cloudflare Worker setup instead.

Time to set up: ~10 minutes

Prerequisites

  • A Cloudflare Enterprise account
  • A BotSights account with a project created for your domain
  • Your API Key (found in BotSights → Account → Projects → API Key)

Step 1: Prepare Your Destination URL

Your Logpush destination URL is:

https://www.botsights.com/api/logs/cloudflare?api_key=YOUR_API_KEY_HERE

Replace YOUR_API_KEY_HERE with your actual API key.

Step 2: Create a Logpush Job

  1. Log in to your Cloudflare Dashboard
  2. Select your domain
  3. Go to Analytics & LogsLogs
  4. Click Add Logpush Job

Step 3: Configure the Job

Select Dataset

Choose HTTP Requests as the dataset.

Select Fields

Add the following fields:

FieldRequired
ClientRequestUserAgentYes — for bot detection
ClientIPYes — for geo-lookup
ClientRequestHostYes — domain name
ClientRequestPathYes — page URL path
ClientRequestURIYes — full URI with query string
ClientRequestMethodYes — GET, POST, etc.
ClientRequestRefererYes — referrer URL
ClientCountryYes — visitor country
EdgeResponseStatusYes — HTTP status code
EdgeResponseContentTypeYes — response content type
EdgeStartTimestampYes — for duration
EdgeEndTimestampYes — for duration

Select Destination

  1. Choose Custom HTTP as the destination
  2. Enter your destination URL from Step 1

Advanced Options

  1. Expand Advanced Options
  2. Set Timestamp format to rfc3339

Step 4: Verify

Cloudflare will send a test request to verify your endpoint. BotSights responds automatically. After verification, logs start flowing within 1-5 minutes.

Visit your website, then check your BotSights dashboard → Realtime page.

Note: Logpush delivers logs in batches, so there may be a 1-5 minute delay between a visit and it appearing in your dashboard.

Logpush vs Worker

WorkerLogpush
Cloudflare planAll plansEnterprise only
DeliveryReal-timeBatched (1-5 min delay)
SetupPaste Worker scriptConfigure in Logpush UI
Custom codeYes (Worker runs on your domain)No — uses Cloudflare logging
Request limits100K/day on free planNo Worker limits

For Enterprise users, Logpush is recommended as it requires no custom code on your domain.