abx-observe

Diagnose failing AgentBox sandboxes and pools using events, logs, and E2B metrics endpoints.

11|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/scitix/Agent-Sandbox --skill abx-observe-scitix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: abx-observe
Source: https://github.com/scitix/Agent-Sandbox/tree/main/plugin/skills/abx-observe
Command: npx skills add https://github.com/scitix/Agent-Sandbox --skill abx-observe-scitix

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires e2b.

What problem does it solve? When an AgentBox sandbox will not start, a pool sits below its target size, or commands inside a sandbox fail, it is hard to know where to look first. This Skill provides a structured troubleshooting workflow that starts from Kubernetes events and pool status, then moves to sandbox logs and E2B-native metrics, so you find the root cause instead of guessing. ## Core Features & Use Cases - Event-first diagnosis: Inspect environment readiness, pool desired/idle/running counts, and Kubernetes events with abx envs and abx sandboxes commands. - E2B-native metrics: Read CPU, memory, and disk usage through the E2B SDK's get_metrics() and the /sandboxes/{id}/metrics endpoints, with correct unit interpretation (percentage of sandbox cores vs. console cores). - Failure pattern matching: A lookup table maps common symptoms (commands failing to connect, pools stuck at zero, empty lists) to their usual causes. - Use Case: A pool reports Ready but nothing is claimable. Run abx envs demo pools demo-1c2gi --json and check idleReplicas to see the real claimable count, then check events for the reservation or quota warning blocking growth. ## Quick Start Ask the assistant to investigate why your sandbox or pool is failing, for example: "My AgentBox pool is stuck at zero available sandboxes, find out why."

Frequently Asked Questions about abx-observe

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug an AgentBox sandbox that will not start?

Start with `abx envs <env> events` to see Kubernetes warnings, then check `abx sandboxes <id> logs` to see whether the runtime came up inside the Pod. Events are the highest-yield source and usually state the cause directly.

How do I get CPU and memory metrics for an E2B sandbox?

Use the E2B SDK's `get_metrics()` method after connecting with `Sandbox.connect(sandbox_id)`, or call `GET /sandboxes/{id}/metrics`. Run `abx envs <env> docs` to find the E2B API URL and data-plane domain to point the SDK at.

Why does my pool show Ready but no sandboxes are available?

A pool can report Ready while having nothing claimable because `replicas` is intent and `updatedReplicas` is rollout progress. Only `idleReplicas` answers whether you can claim one right now; check it with `abx envs <env> pools <pool> --json`.

Why is cpuUsedPct different between the API and the console?

The API reports `cpuUsedPct` as a percentage of the sandbox's own cores, while the console charts plot raw cores. A 16-core sandbox using 8 cores reads about 50 in the API and 8 in the console, and both are correct.

Does the E2B metrics API support team-level metrics?

No, `/teams/{id}/metrics` is deliberately not implemented and returns 501. For usage across a team, use `abx statistics` or the console instead of the E2B metrics surface.

Why does disk usage show zero in sandbox metrics?

A zero `diskTotal` or `diskUsed` means the backend does not collect `container_fs_*` metrics for that sandbox, not that the disk is empty. Treat zero on these fields as 'not collected'.