Les métriques d’une sandbox
get_sandbox_metrics renvoie le CPU, où 100 % veut dire tous les vCPU occupés, la mémoire utilisée, le disque utilisé et les octets entrants et sortants, en points moyennés sur un pas : la dernière heure par défaut, ou n’importe quelle période des dernières 24 heures, avec un pas de 5 s ou plus, jusqu’à 1 000 points. Le serveur d’une sandbox garde ses métriques pendant 24 heures.
Les événements : ce qui s’est passé, au moment où ça s’est passé
Chaque sandbox enregistre ce qui s’y est passé, du plus ancien au plus récent, en liste que vous parcourez page par page ou en flux direct que vous suivez à partir de n’importe quel point :
- Cycle de vie : créée, mise en pause, arrêtée, reprise, redimensionnée et supprimée, chaque fois avec sa raison, comme une requête, l’inactivité, un réveil ou un plantage ; une création indique sa taille, et une duplication sa source.
- Les commandes terminées : les 1 024 premiers octets de la commande, son code de sortie, sa durée, et qui l’a lancée, l’API, SSH ou un terminal.
- Le trafic sortant, minute par minute, par hôte et par port : autorisé ou refusé, ses connexions, les octets dans chaque sens, et les secrets substitués dans ses requêtes.
- Les ports, minute par minute : les requêtes, combien ont reçu une réponse 5xx, et les octets dans chaque sens.
- Les tours d’agent : l’agent, les 200 premiers caractères du prompt, la façon dont le tour s’est terminé, et ses tokens en entrée et en sortie.
Une sandbox garde les 10 000 événements les plus récents de chaque type, et une liste ou un flux peut ne prendre que les types que vous demandez. Elle enregistre jusqu’à 600 commandes et tours d’agent par minute ; au-delà, ils sont enregistrés dans les minutes qui suivent.
from pethost.sandboxes import Sandboxes
sandboxes = Sandboxes() # lit PETHOST_TOKEN
sandbox_id = sandboxes.list_sandboxes(name="api-dev").sandboxes[0].sandbox_id
points = sandboxes.get_sandbox_metrics(sandbox_id).points # la dernière heure
print(max(point.cpu_percent for point in points), points[-1].memory_used_bytes)
for event in sandboxes.watch_sandbox_events(sandbox_id): # ce qui s'est passé jusqu'ici, puis en direct
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 # tous les événements, puis les nouveaux au fil de l'eau
pethost sandbox events api-dev --kind egress -n 50 # les 50 derniers événements de trafic sortantCommandes, transcriptions et consommation
À côté des événements, list_commands montre ce qui tourne en ce moment, lancé par l’API, SSH ou un terminal. get_command et watch_command donnent la sortie d’une commande, les 64 derniers KiB puis en direct, et la sandbox garde les 100 dernières commandes terminées.
watch_conversation diffuse la conversation d’un agent de code : chaque prompt, chaque message, chaque appel d’outil avec son entrée et sa sortie, et la fin de chaque tour. Une conversation reste sur le disque de la sandbox : une pause la garde, une duplication l’emporte, et un template la laisse de côté.
Chaque sandbox indique les secondes où elle a tourné et où elle a été en pause, les GiB-heures où elle a été stockée et ce qu’elle a coûté jusqu’ici, et list_usage donne une ligne par jour, compteur et taille, telle qu’elle a été facturée. La console web montre les métriques et les événements d’une sandbox sur sa page.
Ce qui est gardé, et combien de temps
Les métriques restent 24 heures, et les événements, les 10 000 plus récents de chaque type, aussi longtemps que vit la sandbox. Quand une sandbox est supprimée, sa fiche reste 30 jours, avec sa consommation finale, et ses événements et ses métriques un jour.
Ce qui n’existe pas encore
Il n’y a pas encore de webhooks ni d’export OpenTelemetry. Pour alimenter votre propre supervision, suivez le flux, ou parcourez la liste à partir de l’ID du dernier événement lu : l’ID d’un événement plus récent est toujours plus grand, vous n’en lisez donc jamais un deux fois. Le guide de l’observabilité détaille chaque champ, et la page de la liste d’autorisation du trafic sortant explique comment sont jugés les hôtes des événements de trafic sortant.