---
title: "Métriques et événements des sandboxes · Pethost"
description: "Voyez ce qu’a fait chaque sandbox : CPU, mémoire, disque et réseau sur 24 heures, cycle de vie, chaque commande, chaque hôte atteint et chaque tour d’agent."
---

[Agent Sandboxes](https://pethost.dev/fr/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.

Le tableau de bord d’une sandbox : une courbe de CPU, la mémoire utilisée et un flux d’événements : créée, une commande terminée avec le code 0, les hôtes atteints, un tour d’agent avec ses tokens, en pause.

## 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.

Python

CLI

```
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](https://pethost.dev/fr/sandboxes/coding-agents/) : 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é](https://pethost.dev/fr/docs/sandboxes/observability/) détaille chaque champ, et la page de la [liste d’autorisation du trafic sortant](https://pethost.dev/fr/sandboxes/egress-allowlist/) explique comment sont jugés les hôtes des événements de trafic sortant.

[Lire la documentation](https://pethost.dev/fr/docs/sandboxes/observability/)

## 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

- [Les connexions d’une sandbox passent une barrière qui autorise pypi.org et *.github.com et refuse example.com avec un 403 ; une question DNS pour un nom absent de la liste reçoit REFUSED, et l’UDP ne sort pas. Trafic sortant autorisé, par nom Listez les domaines, wildcards, IP et CIDR qu’une sandbox peut atteindre ; son DNS ne répond à rien d’autre, aucun UDP ne sort, et un changement s’applique aussitôt. Comment ça marche](https://pethost.dev/fr/sandboxes/egress-allowlist/)
- [Un prompt à un agent de code dans une sandbox, et ses appels d’outils qui reviennent en direct : il lit un fichier, le modifie, lance les tests, et le tour se termine avec son nombre de tokens. Agents de code installés Claude Code, Codex et OpenCode tournent dans chaque sandbox en pleine autonomie : un appel donne un prompt à l’un d’eux, un autre diffuse chacun de ses appels d’outils. Comment ça marche](https://pethost.dev/fr/sandboxes/coding-agents/)

## Donnez un ordinateur à votre agent en 0,15 s

[Démarrer l’essai gratuit](https://console.pethost.dev/welcome?kind=sandboxes)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Templates](https://pethost.dev/fr/templates/)
- [À propos](https://pethost.dev/about/)
- [Docs](https://pethost.dev/docs/)
- [Blog](https://pethost.dev/fr/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Plugin](https://github.com/pethost-dev/plugin)
- [Conditions](https://pethost.dev/terms/)
- [Confidentialité](https://pethost.dev/privacy/)
- [Remboursements](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Bases de données

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

Agent Sandboxes

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

Comparatifs

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/fr/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/fr/blog/coolify-cloud-vs-dokploy-cloud/)
- [Tarifs Railway vs Render vs Fly.io](https://pethost.dev/fr/blog/railway-vs-render-vs-fly-io-pricing/)
- [Hébergement Docker Compose managé](https://pethost.dev/fr/blog/managed-docker-compose-hosting/)

Alternatives

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