Cloudflare Workers

Accounts

Environment	Account ID
Dev/Staging/Preprod	3a8e992c9f607dcb3b401878264df92e
Prod	96d9ae8ad2fe71a3c6ead54f3a775c05

Quick Reference

# Tail worker logs (live)
npx wrangler tail {worker-name}
# e.g. npx wrangler tail staging-ecom-api

# List deployments
npx wrangler deployments list --name {worker-name}

# Read a KV key
npx wrangler kv key get --namespace-id {namespace-id} "{key}"

# List KV keys (first 1000)
npx wrangler kv key list --namespace-id {namespace-id} --prefix "{prefix}"

# Check worker routes/domains
npx wrangler deployments list --name {worker-name}

Note: You need CLOUDFLARE_API_TOKEN or CLOUDFLARE_ACCOUNT_ID env vars set, or use npx wrangler login.

Workers

Worker Name Pattern	Component	Purpose	Custom Domain
{env}-ecom-api	search_proxy	Search API proxy	{env}-ecom.dev-marqo.org (staging: staging-ecom.dev-marqo.org, prod: ecom.marqo-ep.ai)
{env}-agentic-search	agentic_search	AI-powered conversational search	No public domain (RPC only via service binding)
{env}-admin-api	admin_worker	Admin dashboard (React SSR)	{env}-admin.dev-marqo.org (prod: admin.marqo-internal.org)

KV Namespaces

Binding	Worker	Staging ID	Purpose
KV	search_proxy	b89e4485d04b480fb3a6e1cfc9920c1b	Index settings cache
KV_QCFG	search_proxy	(env-specific)	Query config cache

KV is populated by the Settings Exporter Lambda (reads DDB stream from EcomIndexSettingsTable) and the Admin Lambda (writes query configs).

Durable Objects

Name	Worker	Class	Storage	Purpose
CONVERSATION_DO	agentic_search	ConversationSqlDO	SQLite	Multi-turn conversation history

Service Bindings (Inter-Worker RPC)

graph TD
    subgraph proxy["search_proxy (ecom-api)"]
        A["MARQO_WORKER (global-worker) — Marqo search backend"]
        B["PIXEL_WORKER (pixel-ingestion) — Analytics tracking"]
        C["AGENTIC_SEARCH_WORKER — AI search"]
    end

    subgraph agentic["agentic_search"]
        D["SEARCH_PROXY_WORKER (ecom-api) — Document retrieval"]
    end

What to Look For

Symptom	Check
Search errors	npx wrangler tail {env}-ecom-api and look for error logs
Stale settings	Check KV key for the account: npx wrangler kv key get --namespace-id {id} "{system_account_id}"
Agentic failures	npx wrangler tail {env}-agentic-search
Admin dashboard issues	npx wrangler tail {env}-admin-api
Deployment issues	npx wrangler deployments list --name {worker-name}
Metrics not flowing	Check SQS queue depth (metrics go search_proxy -> SQS -> metrics worker Lambda)

Configuration Files

Worker configs are in components/{worker}/wrangler.toml (prod) and wrangler.dev.toml (dev/PR).