Cloudflare Logpush Setup (Enterprise)
Temporarily unavailable. The Logpush ingestion endpoint is being reworked for our new collector infrastructure. Use the Cloudflare Worker setup instead — it works on all Cloudflare plans, including Enterprise, and captures the same data. This page will be updated when Logpush support returns.
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.