Debug Ensembles

​

Ping

{
  "pong": true,
  "timestamp": 1701234567890,
  "message": "Conductor is running"
}

• Health checks and uptime monitoring
• Verifying worker deployment and routing
• Testing basic HTTP connectivity
• CI/CD pipeline validation

​

Echo

{
  "echo": {
    "request": {
      "method": "POST",
      "path": "/debug/echo",
      "query": { "param": "value" },
      "headers": { "content-type": "application/json" },
      "body": { "test": "data" }
    },
    "echoed_at": "2024-01-15T10:30:45.123Z"
  }
}

• Testing webhook integrations
• Debugging API client implementations
• Verifying request formatting
• Inspecting proxy/CDN modifications

​

Headers

{
  "headers": {
    "cloudflare": {
      "CF-Ray": "...",
      "CF-IPCountry": "US"
    },
    "auth": {
      "Authorization": "[REDACTED]"
    },
    "standard": {
      "Host": "example.com",
      "User-Agent": "...",
      "Accept": "application/json"
    },
    "custom": {
      "X-Custom-Header": "value"
    },
    "total": 12
  }
}

• Debugging CORS configuration
• Verifying auth header propagation
• Inspecting CDN/proxy header injection
• Testing custom header handling

​

Info

• Bearer token: Authorization: Bearer <token>
• API key: X-API-Key: <key>

{
  "conductor": {
    "name": "Ensemble-Edge Conductor",
    "version": "0.4.x"
  },
  "runtime": {
    "env": { "NODE_ENV": "production" },
    "bindings": ["KV", "R2", "D1"],
    "auth": { "method": "bearer", "verified": true },
    "headers": { "..." }
  }
}

• Debugging environment configuration
• Verifying binding availability
• Inspecting runtime state
• Troubleshooting authentication
• Internal diagnostics

• Never set public: true on this endpoint
• Use strong API keys in production
• Rotate credentials regularly
• Monitor access logs
• Disable in production if not actively debugging

​

Slow

• ms (optional): Delay in milliseconds (default: 1000)

{
  "delayed": true,
  "requestedMs": 5000,
  "actualMs": 5001,
  "note": "Delay may vary on free tier (scheduler.wait unavailable)"
}

• Testing timeout configurations
• Simulating slow API responses
• Testing loading states in UI
• Debugging retry logic
• Performance testing

• Cloudflare Workers free tier may have limited scheduler.wait() support
• Actual delay may vary slightly from requested delay
• Maximum delay depends on Worker timeout limits

​

Quick Reference