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.
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 salidaComandos, 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: 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 tiene cada campo, y la página de la lista de destinos permitidos explica cómo se juzgan los hosts de los eventos de salida.