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)
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).