---
title: "Obserwowalność sandboxów: metryki i zdarzenia · Pethost"
description: "Zobacz, co zrobił każdy sandbox Pethost: CPU, pamięć, dysk i sieć z 24 godzin, zdarzenia cyklu życia, każde polecenie, osiągnięty host i turę agenta."
---

[Agent Sandboxes](https://pethost.dev/pl/sandboxes/) Każde polecenie, host i tura

# Zobacz wszystko, co zrobił sandbox

Gdy przebieg agenta pójdzie źle, chcesz wiedzieć, co stało się w jego sandboxie. Obserwowalność sandboxów przechowuje odpowiedź: metryki, zapis każdego polecenia, każdego osiągniętego hosta i każdej tury agenta, przez to samo API, które je uruchamia.

Panel sandboxa: linia CPU, zajęta pamięć i strumień zdarzeń: utworzony, polecenie zakończone kodem 0, hosty, do których dotarł, tura agenta z tokenami, wstrzymany.

## Metryki sandboxa

`get_sandbox_metrics` odpowiada CPU, gdzie 100% to wszystkie vCPU zajęte, zajętą pamięcią, zajętym dyskiem oraz bajtami przychodzącymi i wychodzącymi, jako punkty uśrednione w kroku: domyślnie z ostatniej godziny albo z dowolnego zakresu w ostatnich 24 godzinach, z krokiem co najmniej 5 s, do 1000 punktów. Serwer sandboxa trzyma jego metryki przez 24 godziny.

## Zdarzenia: co się stało i kiedy

Każdy sandbox zapisuje, co się w nim działo, od najstarszych, jako listę, którą przeglądasz stronami, albo strumień na żywo, który śledzisz od dowolnego miejsca:

- **Cykl życia:** utworzenie, wstrzymanie, zatrzymanie, wznowienie, zmiana rozmiaru i usunięcie, każde z powodem, takim jak żądanie, bezczynność, wybudzenie albo awaria; utworzenie podaje rozmiar, a fork swój oryginał.
- **Polecenia**, które się zakończyły: pierwsze 1024 bajty polecenia, kod wyjścia, czas działania i to, czy uruchomiło je API, SSH czy terminal.
- **Ruch wychodzący,** minuta po minucie na host i port: dozwolony albo odrzucony, liczba połączeń, bajty w każdą stronę i sekrety podstawione w jego żądaniach.
- **Porty,** minuta po minucie: żądania, ile z nich dostało odpowiedź 5xx, i bajty w każdą stronę.
- **Tury agentów:** agent, pierwsze 200 znaków promptu, jak tura się zakończyła, i jej tokeny wejściowe i wyjściowe.

Sandbox trzyma najnowsze 10 000 zdarzeń każdego rodzaju, a lista albo strumień może zawierać tylko te rodzaje, o które prosisz. Zapisuje do 600 poleceń i tur agentów na minutę; nadwyżka jest zapisywana w kolejnych minutach.

Python

CLI

```
from pethost.sandboxes import Sandboxes

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

points = sandboxes.get_sandbox_metrics(sandbox_id).points  # ostatnia godzina
print(max(point.cpu_percent for point in points), points[-1].memory_used_bytes)

for event in sandboxes.watch_sandbox_events(sandbox_id):  # to, co już się stało, potem na żywo
    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                    # każde zdarzenie, potem nowe na bieżąco
pethost sandbox events api-dev --kind egress -n 50   # ostatnie 50 zdarzeń ruchu wychodzącego
```

## Polecenia, transkrypty i zużycie

Obok zdarzeń `list_commands` pokazuje, co teraz działa, uruchomione przez API, SSH albo terminal. `get_command` i `watch_command` dają wynik polecenia, ostatnie 64 KiB, a potem na żywo, a sandbox trzyma 100 ostatnich zakończonych poleceń.

`watch_conversation` przesyła na żywo rozmowę [agenta kodującego](https://pethost.dev/pl/sandboxes/coding-agents/): każdy prompt, wiadomość, wywołanie narzędzia z wejściem i wyjściem i koniec każdej tury. Rozmowa zostaje na dysku sandboxa: wstrzymanie ją zachowuje, fork przenosi, a szablon pomija.

Każdy sandbox podaje sekundy działania i wstrzymania, GiB-godziny przechowywania i to, ile dotąd kosztował, a `list_usage` daje wiersz na każdy dzień, licznik i rozmiar, tak jak zostały naliczone. Konsola webowa pokazuje metryki i zdarzenia sandboxa na jego stronie.

## Co jest przechowywane i jak długo

Metryki zostają 24 godziny, a zdarzenia, najnowsze 10 000 każdego rodzaju, tak długo, jak żyje sandbox. Gdy sandbox zostanie usunięty, jego rekord zostaje 30 dni, z końcowym zużyciem, a zdarzenia i metryki jeden dzień.

## Czego jeszcze nie zbudowaliśmy

Nie ma jeszcze webhooków ani eksportu do OpenTelemetry. Żeby zasilić własny monitoring, śledź strumień albo przeglądaj listę od id ostatniego przeczytanego zdarzenia: późniejsze zdarzenie ma zawsze większy id, więc nigdy nie przeczytasz żadnego dwa razy. [Przewodnik po obserwowalności](https://pethost.dev/pl/docs/sandboxes/observability/) ma każde pole, a strona [listy dozwolonych dla ruchu wychodzącego](https://pethost.dev/pl/sandboxes/egress-allowlist/) mówi, jak oceniane są hosty w zdarzeniach ruchu wychodzącego.

[Przeczytaj dokumentację](https://pethost.dev/pl/docs/sandboxes/observability/)

## Pytania

**Jak długo przechowywane są metryki sandboxa?**

24 godziny, na serwerze sandboxa, z krokiem co najmniej 5 s.

**Czy mogę wysyłać zdarzenia do swojego monitoringu?**

Jeszcze nie w trybie push: nie ma webhooków ani eksportu do OpenTelemetry. Śledź `watch_sandbox_events` albo odpytuj `list_sandbox_events` z id ostatniego przeczytanego zdarzenia.

**Czy transkrypty agenta są przechowywane?**

Tak, na dysku sandboxa, tak długo, jak sandbox żyje. Wstrzymanie je zachowuje, a fork przenosi.

**Czy widać, do których hostów dotarł sandbox?**

Tak. Jego zdarzenia ruchu wychodzącego wymieniają każdy host i port minuta po minucie, dozwolony albo odrzucony, z liczbą połączeń i bajtów w każdą stronę.

**Co zostaje po usunięciu sandboxa?**

Jego rekord, z końcowym zużyciem, przez 30 dni; zdarzenia i metryki przez jeden dzień.

## Powiązane

- [Połączenia sandboxa przechodzą przez bramkę, która przepuszcza pypi.org i *.github.com, a example.com odrzuca kodem 403; pytanie DNS o nazwę spoza listy dostaje REFUSED, a UDP nie wychodzi. Ruch wychodzący tylko tam, gdzie pozwolisz Wypisz domeny, wieloznaczniki, IP i CIDR, do których sandbox może dotrzeć; jego DNS nie zna innych nazw, UDP nie wychodzi, a zmiana działa od razu. Jak to działa](https://pethost.dev/pl/sandboxes/egress-allowlist/)
- [Prompt do agenta kodującego w sandboxie i jego wywołania narzędzi wracające na żywo: czyta plik, edytuje go, uruchamia testy, a tura kończy się jako gotowa z liczbą tokenów. Agenci kodujący, zainstalowani Claude Code, Codex i OpenCode działają w każdym sandboxie z pełną autonomią: jedno wywołanie daje agentowi prompt, drugie przesyła na żywo każde jego wywołanie narzędzia. Jak to działa](https://pethost.dev/pl/sandboxes/coding-agents/)

## Daj swojemu agentowi komputer w 0,15 s

[Zacznij darmowy okres próbny](https://console.pethost.dev/welcome?kind=sandboxes)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Szablony](https://pethost.dev/pl/templates/)
- [O nas](https://pethost.dev/about/)
- [Dokumentacja](https://pethost.dev/docs/)
- [Blog](https://pethost.dev/pl/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Plugin](https://github.com/pethost-dev/plugin)
- [Regulamin](https://pethost.dev/terms/)
- [Prywatność](https://pethost.dev/privacy/)
- [Zwroty](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Bazy danych

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

Agent Sandboxes

- [Sandboxy](https://pethost.dev/pl/sandboxes/)
- [Cennik](https://pethost.dev/pl/sandboxes/#pricing)
- [Dokumentacja](https://pethost.dev/pl/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Porównania

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/pl/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/pl/blog/coolify-cloud-vs-dokploy-cloud/)
- [Cennik Railway vs Render vs Fly.io](https://pethost.dev/pl/blog/railway-vs-render-vs-fly-io-pricing/)
- [Zarządzany hosting Docker Compose](https://pethost.dev/pl/blog/managed-docker-compose-hosting/)

Alternatywy

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