---
title: "Наблюдаемость песочниц: метрики и события · Pethost"
description: "Что делала каждая песочница Pethost: CPU, память, диск и сеть за 24 часа, события жизненного цикла, каждая команда, каждый хост и каждый ход агента."
---

[Agent Sandboxes](https://pethost.dev/ru/sandboxes/) Каждая команда, хост и ход

# Все, что сделала песочница, на виду

Когда запуск агента идет не так, хочется знать, что происходило внутри его песочницы. Наблюдаемость песочниц хранит ответ: метрики и запись каждой команды, каждого хоста и каждого хода агента — через тот же API, который их запускает.

Панель песочницы: линия CPU, занятая память и поток событий: создана, команда завершилась с кодом 0, хосты, к которым она обращалась, ход агента с токенами, пауза.

## Метрики песочницы

`get_sandbox_metrics` возвращает CPU, где 100% — все vCPU заняты, занятую память, занятый диск и байты на входе и выходе в виде точек, усредненных по шагу: по умолчанию за последний час или за любой интервал в последние 24 часа, с шагом от 5 с, до 1 000 точек. Сервер песочницы хранит ее метрики 24 часа.

## События: что случилось и когда

Каждая песочница записывает, что в ней происходило, от старых к новым, — списком, который можно листать, или живым потоком, за которым можно следить с любой точки:

- **Жизненный цикл:** создана, на паузе, остановлена, возобновлена, изменен размер, удалена — каждое с причиной, например запрос, простой, пробуждение или сбой; создание указывает размер, а форк — источник.
- **Завершившиеся команды:** первые 1 024 байта команды, ее код выхода, сколько она работала и кто ее запустил — API, SSH или терминал.
- **Исходящий трафик** поминутно по каждому хосту и порту: разрешено или отклонено, число соединений, байты в каждую сторону и секреты, подставленные в запросы.
- **Порты** поминутно: запросы, сколько из них получили ответ 5xx, и байты в каждую сторону.
- **Ходы агентов:** агент, первые 200 символов промпта, чем закончился ход, входные и выходные токены.

Песочница хранит 10 000 последних событий каждого вида, а список или поток может брать только те виды, которые вы попросите. Она записывает до 600 команд и ходов агентов в минуту; остальные записываются в следующие минуты.

Python

CLI

```
from pethost.sandboxes import Sandboxes

sandboxes = Sandboxes()  # читает PETHOST_TOKEN
sandbox_id = sandboxes.list_sandboxes(name="api-dev").sandboxes[0].sandbox_id

points = sandboxes.get_sandbox_metrics(sandbox_id).points  # последний час
print(max(point.cpu_percent for point in points), points[-1].memory_used_bytes)

for event in sandboxes.watch_sandbox_events(sandbox_id):  # что уже случилось, потом вживую
    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                    # все события, потом новые по мере появления
pethost sandbox events api-dev --kind egress -n 50   # последние 50 событий исходящего трафика
```

## Команды, разговоры и использование

Помимо событий, `list_commands` показывает, что работает сейчас, запущенное через API, SSH или терминал. `get_command` и `watch_command` отдают вывод команды, последние 64 KiB, а потом вживую, и песочница хранит последние 100 завершившихся команд.

`watch_conversation` отдает потоком разговор [агента для кода](https://pethost.dev/ru/sandboxes/coding-agents/): каждый промпт, сообщение, вызов инструмента с его входом и выходом и конец каждого хода. Разговор остается на диске песочницы: пауза его сохраняет, форк переносит, а шаблон оставляет за бортом.

Каждая песочница сообщает, сколько секунд она работала и стояла на паузе, сколько GiB-часов хранилась и сколько уже стоила, а `list_usage` отдает строку на каждый день, счетчик и размер — так, как было списано. Панель показывает метрики и события песочницы на ее странице.

## Что хранится и как долго

Метрики хранятся 24 часа, а события, 10 000 последних каждого вида, — пока песочница живет. Когда песочницу удаляют, ее запись хранится 30 дней вместе с итоговым использованием, а ее события и метрики — сутки.

## Чего пока нет

Вебхуков и экспорта в OpenTelemetry пока нет. Чтобы передавать данные в свой мониторинг, следите за потоком или листайте список от id последнего прочитанного события: id более позднего события всегда больше, так что одно событие не прочитать дважды. Все поля описаны в [руководстве по наблюдаемости](https://pethost.dev/ru/docs/sandboxes/observability/), а как проверяются хосты в событиях исходящего трафика, сказано на странице о [списке разрешенных адресов](https://pethost.dev/ru/sandboxes/egress-allowlist/).

[Читать документацию](https://pethost.dev/ru/docs/sandboxes/observability/)

## Вопросы

**Сколько хранятся метрики песочницы?**

24 часа, на сервере песочницы, с шагом от 5 с.

**Можно ли отправлять события в мой мониторинг?**

Сами они пока не отправляются: вебхуков и экспорта в OpenTelemetry нет. Следите за `watch_sandbox_events` или опрашивайте `list_sandbox_events` с id последнего прочитанного события.

**Хранятся ли разговоры агента?**

Да, на диске песочницы, пока песочница живет. Пауза их сохраняет, а форк переносит.

**Можно ли увидеть, к каким хостам обращалась песочница?**

Да. Ее события исходящего трафика поминутно перечисляют каждый хост и порт, разрешенные или отклоненные, с числом соединений и байтами в каждую сторону.

**Что остается после удаления песочницы?**

Ее запись с итоговым использованием — на 30 дней; ее события и метрики — на сутки.

## По теме

- [Подключения песочницы проходят через шлюз, который пропускает pypi.org и *.github.com и отказывает example.com с 403; DNS-запрос имени не из списка получает REFUSED, а UDP не выходит. Исходящий трафик только по списку Перечислите домены, wildcard, IP и CIDR, до которых может достучаться песочница; ее DNS больше ничего не отвечает, UDP не выходит, а изменение действует сразу. Как это устроено](https://pethost.dev/ru/sandboxes/egress-allowlist/)
- [Промпт агенту в песочнице и поток его вызовов инструментов: он читает файл, правит его, запускает тесты, и ход заканчивается с состоянием DONE и числом токенов. Агенты для кода уже установлены Claude Code, Codex и OpenCode работают в каждой песочнице с полной автономией: один вызов дает агенту промпт, другой потоком отдает каждый его вызов инструмента. Как это устроено](https://pethost.dev/ru/sandboxes/coding-agents/)

## Дайте агенту компьютер за 0,15 с

[Начать пробный период](https://console.pethost.dev/welcome?kind=sandboxes)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Шаблоны](https://pethost.dev/ru/templates/)
- [О нас](https://pethost.dev/about/)
- [Документация](https://pethost.dev/docs/)
- [Блог](https://pethost.dev/ru/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Плагин](https://github.com/pethost-dev/plugin)
- [Условия](https://pethost.dev/terms/)
- [Конфиденциальность](https://pethost.dev/privacy/)
- [Возвраты](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Базы данных

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

Agent Sandboxes

- [Песочницы](https://pethost.dev/ru/sandboxes/)
- [Цены](https://pethost.dev/ru/sandboxes/#pricing)
- [Документация](https://pethost.dev/ru/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Сравнения

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/ru/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/ru/blog/coolify-cloud-vs-dokploy-cloud/)
- [Цены Railway, Render и Fly.io](https://pethost.dev/ru/blog/railway-vs-render-vs-fly-io-pricing/)
- [Управляемый хостинг Docker Compose](https://pethost.dev/ru/blog/managed-docker-compose-hosting/)

Альтернативы

- [Альтернативы Railway](https://pethost.dev/ru/blog/railway-alternatives/)
- [Альтернативы Heroku](https://pethost.dev/ru/blog/heroku-alternatives/)
- [Альтернативы Dokploy](https://pethost.dev/ru/blog/dokploy-alternatives/)
- [Альтернативы Coolify](https://pethost.dev/ru/blog/coolify-alternatives/)
- [Альтернативы Render](https://pethost.dev/ru/blog/render-alternatives/)
- [Альтернативы Sliplane](https://pethost.dev/ru/blog/sliplane-alternatives/)
