Monitoring

Sync Log (Primary View)

Dashboard → Syncs is the main place to monitor sync activity. Use filters:

Review failed rows regularly; open the detail modal for full error and payload.

GET /health – Returns 200 and a simple status (e.g. {"status":"ok"}) when the Worker is running. Does not verify LGL or third-party APIs.

bash

curl -s https://your-worker-url.workers.dev/health

Settings page typically has Test buttons that call the Worker to verify:

Use after changing secrets or when debugging connectivity.

Email alerts – When a sync fails after retries, the Worker can send an email to configured alert recipients. Set recipients in Settings → Alert recipients.
Development – In dev, alerts may be logged only (not sent). Production deploy uses the configured mail provider (e.g. Mailchannels).

Schedule	Job	Purpose
Every 15 minutes	Polling	Fetch recent Givebutter (and Square) transactions; sync any not already in sync_log. Catches missed webhooks.
Weekly (e.g. Sunday)	Summary	Email weekly sync stats (success/failed counts, optional campaign totals) to alert recipients.
Hourly (or as configured)	Campaign sync	Refresh Givebutter campaign cache so Mappings has up-to-date campaign list.

Cron triggers are configured in Cloudflare Workers (wrangler.toml or dashboard). No user action needed for them to run.

For real-time Worker logs (including console.log and request/response):

bash

cd noma-sync
wrangler tail

Use --format pretty for readable output. Helpful when testing webhooks or debugging.

Failed syncs – Resolve or fix mapping/credentials.
Skipped (idempotent) – Normal; no action unless you expect a new gift.
Recovered (polling) – Indicates webhook was missed; polling caught it. If frequent, check webhook delivery from Givebutter/Square.