lupin.Open console
Proxies

Observe proxy health without leaking connection secrets

Log resource identity, allocation and sanitized failures while keeping passwords and sensitive destination data out of telemetry.

Log the operational question, not every byte

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.

Keep allocation and consumption events distinct

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.

Account for side effects of synchronization

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.

Illustrative request; source reviewed, not executed against a live provider.
{"event":"proxy_request_failed","proxy_user_id":"pxu_resource","task_id":"task-001","layer":"proxy_auth","credentials_redacted":true}

Redact at every capture point

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.

Use evidence to drive bounded recovery

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.

Sources & verification

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.

Put it into practice

Give your agent the right tools.

Review the API, workspace requirements and permissions before enabling a workflow.

Explore proxies