---
title: "Observabilidad de sandboxes: métricas y eventos · Pethost"
description: "Mira qué hizo cada sandbox de Pethost: CPU, memoria, disco y red de 24 h, eventos del ciclo de vida, cada comando, cada host alcanzado y cada turno de agente."
---

[Agent Sandboxes](https://pethost.dev/es/sandboxes/) Cada comando, host y turno

# Mira todo lo que hizo un sandbox

Cuando la ejecución de un agente sale mal, quieres saber qué pasó dentro de su sandbox. La observabilidad del sandbox guarda la respuesta: métricas y un registro de cada comando, cada host alcanzado y cada turno de agente, con la misma API que los ejecuta.

El panel de un sandbox: una línea de CPU, la memoria en uso y un stream de eventos: creado, un comando que terminó con 0, los hosts a los que llegó, un turno de agente con sus tokens, en pausa.

## Métricas del sandbox

`get_sandbox_metrics` responde con la CPU, donde el 100 % es todas las vCPU ocupadas, la memoria en uso, el disco en uso y los bytes de entrada y de salida, como puntos promediados por intervalo: la última hora por defecto, o cualquier periodo de las últimas 24 horas, con un intervalo de 5 s o más, hasta 1000 puntos. El servidor de un sandbox conserva sus métricas 24 horas.

## Eventos: qué pasó, a medida que pasaba

Cada sandbox registra lo que pasó en él, del más antiguo al más reciente, como una lista que recorres por páginas o un stream en tiempo real que sigues desde cualquier punto:

- **Ciclo de vida:** creado, pausado, detenido, reanudado, cambio de tamaño y eliminado, cada uno con su motivo, como una petición, la inactividad, un despertar o un fallo; una creación indica su tamaño, y un fork su original.
- **Comandos** que terminaron: los primeros 1024 bytes del comando, su código de salida, cuánto tiempo se ejecutó y si lo inició la API, SSH o una terminal.
- **Salida,** minuto a minuto por host y puerto: permitida o rechazada, sus conexiones, los bytes en cada sentido y los secretos puestos en sus peticiones.
- **Puertos,** minuto a minuto: las peticiones, cuántas recibieron un 5xx y los bytes en cada sentido.
- **Turnos de agente:** el agente, los primeros 200 caracteres del prompt, cómo terminó el turno y sus tokens de entrada y de salida.

Un sandbox conserva los 10.000 eventos más recientes de cada tipo, y una lista o un stream pueden traer solo los tipos que pidas. Registra hasta 600 comandos y turnos de agente por minuto; los que pasen de ahí se registran en los minutos siguientes.

Python

CLI

```
from pethost.sandboxes import Sandboxes

sandboxes = Sandboxes()  # lee PETHOST_TOKEN
sandbox_id = sandboxes.list_sandboxes(name="api-dev").sandboxes[0].sandbox_id

points = sandboxes.get_sandbox_metrics(sandbox_id).points  # la última hora
print(max(point.cpu_percent for point in points), points[-1].memory_used_bytes)

for event in sandboxes.watch_sandbox_events(sandbox_id):  # lo que pasó hasta ahora, luego en tiempo real
    if event.command:
        print(event.time, event.command.exit_code, event.command.command)
    elif event.egress and not event.egress.allowed:
        print(event.time, "refused:", event.egress.host)
```

```
pethost sandbox events api-dev -f                    # todos los eventos, y luego los nuevos según llegan
pethost sandbox events api-dev --kind egress -n 50   # los últimos 50 eventos de salida
```

## Comandos, transcripciones y uso

Además de los eventos, `list_commands` muestra lo que se ejecuta ahora, iniciado por la API, SSH o una terminal. `get_command` y `watch_command` dan la salida de un comando, los últimos 64 KiB y luego en tiempo real, y el sandbox conserva los últimos 100 comandos que terminaron.

`watch_conversation` transmite la conversación de un [agente de programación](https://pethost.dev/es/sandboxes/coding-agents/): cada prompt, cada mensaje, cada llamada a herramienta con su entrada y su salida, y el final de cada turno. Una conversación se queda en el disco del sandbox: una pausa la conserva, un fork la lleva consigo y una plantilla la deja fuera.

Cada sandbox informa de los segundos que estuvo en ejecución y en pausa, de las GiB-hora que estuvo guardado y de lo que lleva costado, y `list_usage` da una fila por día, contador y tamaño, tal como se cobró. El panel web muestra las métricas y los eventos de un sandbox en su página.

## Qué se conserva, y cuánto tiempo

Las métricas se conservan 24 horas, y los eventos, los 10.000 más recientes de cada tipo, mientras viva el sandbox. Cuando se elimina un sandbox, su registro se conserva 30 días, con su uso final, y sus eventos y métricas, un día.

## Lo que aún no está hecho

Aún no hay webhooks ni exportación a OpenTelemetry. Para alimentar tu propio monitoreo, sigue el stream, o recorre la lista desde el id del último evento que leíste: el id de un evento posterior siempre es mayor, así que nunca lees uno dos veces. La [guía de observabilidad](https://pethost.dev/es/docs/sandboxes/observability/) tiene cada campo, y la página de la [lista de destinos permitidos](https://pethost.dev/es/sandboxes/egress-allowlist/) explica cómo se juzgan los hosts de los eventos de salida.

[Leer la documentación](https://pethost.dev/es/docs/sandboxes/observability/)

## Preguntas

**¿Cuánto tiempo se conservan las métricas de un sandbox?**

24 horas, en el servidor del sandbox, con un intervalo de 5 s o más.

**¿Puedo enviar los eventos a mi monitoreo?**

Aún no por push: no hay webhooks ni exportación a OpenTelemetry. Sigue `watch_sandbox_events`, o consulta `list_sandbox_events` con el id del último evento que leíste.

**¿Se conservan las transcripciones de un agente?**

Sí, en el disco del sandbox, mientras viva el sandbox. Una pausa las conserva, y un fork las lleva consigo.

**¿Puedo ver a qué hosts llegó un sandbox?**

Sí. Sus eventos de salida listan cada host y puerto minuto a minuto, permitido o rechazado, con sus conexiones y los bytes en cada sentido.

**¿Qué queda después de eliminar un sandbox?**

Su registro, con su uso final, durante 30 días; sus eventos y métricas, durante un día.

## Relacionado

- [Las conexiones de un sandbox pasan por una puerta que permite pypi.org y *.github.com y rechaza example.com con un 403; una consulta DNS por un nombre fuera de la lista recibe REFUSED, y UDP no sale. La salida que permites, por nombre Lista los dominios, comodines, IP y CIDR a los que puede llegar un sandbox; su DNS no responde nada más, ningún UDP sale, y un cambio se aplica al momento. Cómo funciona](https://pethost.dev/es/sandboxes/egress-allowlist/)
- [Un prompt a un agente de programación en un sandbox, y sus llamadas a herramientas llegando en tiempo real: lee un archivo, lo edita, ejecuta los tests, y el turno termina con éxito y su cuenta de tokens. Agentes de programación, ya instalados Claude Code, Codex y OpenCode se ejecutan en cada sandbox con autonomía total: una llamada le da un prompt a uno, otra transmite cada llamada a herramienta que hace. Cómo funciona](https://pethost.dev/es/sandboxes/coding-agents/)

## Dale a tu agente una VM en 0,15 s

[Empezar la prueba gratis](https://console.pethost.dev/welcome?kind=sandboxes)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Plantillas](https://pethost.dev/es/templates/)
- [Sobre nosotros](https://pethost.dev/about/)
- [Docs](https://pethost.dev/docs/)
- [Blog](https://pethost.dev/es/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Plugin](https://github.com/pethost-dev/plugin)
- [Términos](https://pethost.dev/terms/)
- [Privacidad](https://pethost.dev/privacy/)
- [Reembolsos](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Bases de datos

- [Postgres](https://pethost.dev/es/postgres/)
- [Valkey](https://pethost.dev/es/valkey/)

Agent Sandboxes

- [Sandboxes](https://pethost.dev/es/sandboxes/)
- [Precios](https://pethost.dev/es/sandboxes/#pricing)
- [Docs](https://pethost.dev/es/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Comparativas

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/es/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/es/blog/coolify-cloud-vs-dokploy-cloud/)
- [Precios de Railway vs Render vs Fly.io](https://pethost.dev/es/blog/railway-vs-render-vs-fly-io-pricing/)
- [Hosting gestionado para Docker Compose](https://pethost.dev/es/blog/managed-docker-compose-hosting/)

Alternativas

- [Alternativas a Railway](https://pethost.dev/es/blog/railway-alternatives/)
- [Alternativas a Heroku](https://pethost.dev/es/blog/heroku-alternatives/)
- [Alternativas a Dokploy](https://pethost.dev/es/blog/dokploy-alternatives/)
- [Alternativas a Coolify](https://pethost.dev/es/blog/coolify-alternatives/)
- [Alternativas a Render](https://pethost.dev/es/blog/render-alternatives/)
- [Alternativas a Sliplane](https://pethost.dev/es/blog/sliplane-alternatives/)
