Français
Commencer

Agent Sandboxes Chaque commande, hôte et tour

Voir tout ce qu’a fait une sandbox

Quand l’exécution d’un agent tourne mal, vous voulez savoir ce qui s’est passé dans sa sandbox. L’observabilité des sandboxes garde la réponse : des métriques, une trace de chaque commande, de chaque hôte atteint et de chaque tour d’agent, par la même API que celle qui les exécute.

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 sortant

Commandes, 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.

Lire la documentation

Questions

Combien de temps les métriques d’une sandbox sont-elles gardées ?

24 heures, sur le serveur de la sandbox, avec un pas de 5 s ou plus.

Puis-je envoyer les événements à ma supervision ?

Pas encore en push : il n’y a ni webhooks ni export OpenTelemetry. Suivez watch_sandbox_events, ou interrogez list_sandbox_events avec l’ID du dernier événement lu.

Les transcriptions d’un agent sont-elles gardées ?

Oui, sur le disque de la sandbox, aussi longtemps qu’elle vit. Une pause les garde, et une duplication les emporte.

Puis-je voir quels hôtes une sandbox a atteints ?

Oui. Ses événements de trafic sortant listent chaque hôte et port minute par minute, autorisé ou refusé, avec ses connexions et les octets dans chaque sens.

Que reste-t-il après la suppression d’une sandbox ?

Sa fiche, avec sa consommation finale, pendant 30 jours ; ses événements et ses métriques pendant un jour.

Voir aussi

Donnez un ordinateur à votre agent en 0,15 s

Démarrer l’essai gratuit