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 requestClone = request.clone();
    const response = await fetch(request);
    const payload = {
      timestamp: new Date().toISOString(),
      ip: request.headers.get("CF-Connecting-IP"),
      method: request.method,
      path: url.pathname,
      search: url.search,
      httpCode: response.status,
      headers: Object.fromEntries(request.headers),
      params: Object.fromEntries(url.searchParams),
      organization: "{REPLACE_WITH_YOUR_ORGANIZATION_ID}"
    };
    ctx.waitUntil(
      (async () => {
        payload.body = await requestClone.text();
        await fetch(TARGET, {
          method: "POST",
          headers: { "Content-Type": "application/json" },
          body: JSON.stringify(payload),
        });
      })()
    );
    return response;
  },
};

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

You can find your organization ID here: https://platform.sonalabs.com/account-settings/business-information

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/*

   Change Failure mode to Fail open (proceed).

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.