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
- Log in to your Cloudflare Dashboard
- Select your domain
- Go to Analytics & Logs → Logs
- Click Add Logpush Job
Step 3: Configure the Job
Select Dataset
Choose HTTP Requests as the dataset.
Select Fields
Add the following fields:
| Field | Required |
|---|---|
ClientRequestUserAgent | Yes — for bot detection |
ClientIP | Yes — for geo-lookup |
ClientRequestHost | Yes — domain name |
ClientRequestPath | Yes — page URL path |
ClientRequestURI | Yes — full URI with query string |
ClientRequestMethod | Yes — GET, POST, etc. |
ClientRequestReferer | Yes — referrer URL |
ClientCountry | Yes — visitor country |
EdgeResponseStatus | Yes — HTTP status code |
EdgeResponseContentType | Yes — response content type |
EdgeStartTimestamp | Yes — for duration |
EdgeEndTimestamp | Yes — for duration |
Select Destination
- Choose Custom HTTP as the destination
- Enter your destination URL from Step 1
Advanced Options
- Expand Advanced Options
- 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
| Worker | Logpush | |
|---|---|---|
| Cloudflare plan | All plans | Enterprise only |
| Delivery | Real-time | Batched (1-5 min delay) |
| Setup | Paste Worker script | Configure in Logpush UI |
| Custom code | Yes (Worker runs on your domain) | No — uses Cloudflare logging |
| Request limits | 100K/day on free plan | No Worker limits |
For Enterprise users, Logpush is recommended as it requires no custom code on your domain.