Cloudflare Worker

How it works

A Cloudflare Worker sends logs to ByDefault. Workers are available on any Cloudflare plan, free plan included.

Set up the Worker

In ByDefault, open Analytics, click Connect your site, then pick Cloudflare and Worker.

1. Open your Workers dashboard. Click Create Application, then Start with Hello World. As a name choose ByDefault Analytics. Click Deploy.

2. On the Worker's overview, click Edit code, replace the code with the one from the setup, then click Deploy again:

   worker.js

   const TOKEN = 'bd_…'
   const INGEST = 'https://www.bydefault.so/api/ingest/cloudflare'
   
   // Page reads only. Asset requests are skipped.
   const ASSET = /\.(?!(html?|txt|md|xml|json|pdf)$)[a-z0-9]+$/i
   
   export default {
     async fetch(request, env, ctx) {
       const response = await fetch(request)
       ctx.waitUntil(report(request, response).catch(() => {}))
       return response
     },
   }
   
   async function report(request, response) {
     if (request.method !== 'GET') return
     const url = new URL(request.url)
     if (ASSET.test(url.pathname)) return
     const cf = request.cf || {}
     await fetch(INGEST, {
       method: 'POST',
       headers: {
         'content-type': 'application/json',
         authorization: 'Bearer ' + TOKEN,
       },
       body: JSON.stringify({
         host: url.hostname,
         path: url.pathname,
         query: url.search.slice(1),
         statusCode: response.status,
         userAgent: request.headers.get('user-agent') || '',
         // Accept headers carry the fingerprints that identify AI tools
         // hiding behind browser user agents (Cursor, OpenCode).
         accept: request.headers.get('accept') || '',
         acceptLanguage: request.headers.get('accept-language') || '',
         referer: request.headers.get('referer') || '',
         // Verified against the operator's IP ranges, then discarded.
         ip: request.headers.get('cf-connecting-ip') || '',
         country: cf.country || '',
         rayId: request.headers.get('cf-ray') || '',
       }),
     })
   }

3. On the Worker, open the Domains tab, add a Route, and enter these, with your own domain:

   Setting	Value
   Zone	example.com
   Route	*example.com/*

4. Under DNS → Records, make sure the A, AAAA or CNAME records for your domain show the orange cloud, Proxied. On a grey cloud, traffic bypasses Cloudflare, so the Worker never runs.

   

Check the connection

While the setup is open, ByDefault visits your site the way an AI assistant would, every few seconds. When the Worker first reports, the last step reads Your worker reached us. Once it reports our visit, the step turns green.

Troubleshooting