Check browser proxy support before wiring products together
Understand why a proxy user does not automatically route a Lupin Cloudflare Browser Run session.
Log resource identity, allocation and sanitized failures while keeping passwords and sensitive destination data out of telemetry.
Useful proxy telemetry explains whether a resource was allocated, whether the client connected and whether the destination request produced the intended result. Those are separate events. Start with a resource identifier, task identifier, timestamp and sanitized outcome category. Avoid recording the full proxy URL because it can embed username and password. Avoid recording entire destination bodies unless the task specifically requires them and the storage is appropriate. A health dashboard should let an operator find the failing layer without becoming another copy of the customer's credentials and browsing data.
Creation and top-up operations allocate megabytes under the proxy.allocated_mb billing product. used_mb is derived from cumulative allocated traffic minus observed remaining traffic. quota_mb describes the refill target. Log these quantities with clear names instead of a generic balance field. A refill can increase remaining traffic while usage continues rising, so a stable remaining amount does not prove the client was idle. The current retail catalog prices allocation at $3 per 1,000 MB, but usage observations alone are not a complete invoice. Retain the operation identities needed to reconcile allocation events with the workspace billing record.
Reading an active proxy user can synchronize upstream state and invoke configured auto-refill; a background sweep also does that work. Do not label every such read as financially inert. Follow the approved policy and retain refill outcomes separately from the read's data result. The code can return stored state when synchronization fails, so updated information is best-effort rather than a guaranteed immediate view of traffic. A proxy.pool.low event can indicate a dry pool or another refill failure. Alert on a meaningful actionable condition, and avoid turning every unchanged poll into a noisy operator notification.
{"event":"proxy_request_failed","proxy_user_id":"pxu_resource","task_id":"task-001","layer":"proxy_auth","credentials_redacted":true}Credential exposure can happen in application logs, reverse-proxy access logs, HTTP debug traces, shell history and support screenshots. Redact the connection block and any embedded credentials before those systems retain the event. Keep the resource ID for correlation and restrict access to any secret store that must retain the original configuration. The current public API does not promise password recovery or a credential-reset endpoint, so a leaked password can require operator intervention. Do not print a fresh creation response wholesale as a convenient diagnostic. The agent's final task summary should describe the outcome without copying access authority.
Record whether a failure was management validation, missing permission, proxy authentication, capacity, destination access or an uncertain allocation. Preserve stable Idempotency-Key values for paid management retries. A client failure should not automatically trigger another user creation or traffic purchase. Keep a small approved diagnostic budget and report what it actually established. When the task finishes, stop client traffic and follow the supported operator lifecycle for cleanup or policy changes. Good observability helps make those decisions with less uncertainty while keeping secrets and private source material out of the evidence trail.
Reviewed against the current Lupin route, provider adapter and shared input contracts, plus the linked official references. Examples were not run against live services.
Prepared with AI assistance by Lupin editorial. How we research and maintain these guides.