Cloudflare Worker Setup

Use a Cloudflare Worker to capture all traffic on your domain and forward it to Sona for server-side analytics. This approach runs at the edge — before your origin server — giving you complete visibility into every request.

Prerequisites

• A Cloudflare account (free tier works)
• A domain added to Cloudflare with DNS proxied through Cloudflare (the orange cloud icon)

Step 1: Create the Worker Script

1. Go to dash.cloudflare.com and log in
2. In the left sidebar, click Workers & Pages
3. Click Create application
4. Click Start with Hello World!
5. Give your worker a name (e.g., sona-traffic-observer) and click Deploy

Once deployed, you'll land on the worker's overview page. Click Edit code to open the editor.

6. The editor will open with a default Hello World script.

7. Replace everything in the editor with the following:

export default {
  async fetch(request, env, ctx) {
    const url = new URL(request.url);

    const TARGET = "https://api2.sonalabs.com/webhooks/cloudflare/worker";

    const payload = {
      timestamp: (new Date()).toISOString(),
      ip: request.headers.get("CF-Connecting-IP"),
      method: request.method,
      path: url.pathname,
      search: url.search,
      headers: Object.fromEntries(request.headers),
      body: await request.text(),
      params: Object.fromEntries(url.searchParams),
      organization: "{REPLACE_WITH_YOUR_ORGANIZATION_ID}"
    };

    // Send to Sona in the background — does not block the response
    ctx.waitUntil(
      fetch(new Request(TARGET, {
        method: "POST",
        headers: { "Content-Type": "application/json" },
        body: JSON.stringify(payload),
      }))
    );

    // Pass the original request through untouched
    return fetch(request);
  },
};

Replace {REPLACE_WITH_YOUR_ORGANIZATION_ID} with your actual Sona organization ID, then click Deploy.

Step 2: Attach the Worker to Your Domain

Now you need to route traffic from your domain through this Worker.

1. Go back to Workers & Pages in the left sidebar. Find your worker in the list.

2. Click on the worker, then open the Settings tab. Scroll down to Domains & Routes.

3. Click + Add. A panel will appear on the right — select Route.

4. In the Route form, select your Zone (your domain) and enter a Route pattern. For example, to capture all traffic on your main domain:

   • Zone: sona.com
   • Route: *.sona.com/*

   Leave Failure mode set to Fail closed (block) unless you want traffic to bypass the Worker if it fails.

5. Click Add route. You can repeat this to add routes for specific subdomains. For example:

   www subdomain:

   

   docs subdomain:

   

6. Once you've added all your routes, the Domains & Routes section will show each one listed.

Every request to your domain will now be intercepted by the Worker, forwarded to Sona in the background, and passed through to your origin server without any impact on response time.