Что считается простоем
Песочница простаивает, пока в ней ничего не происходит: нет вызовов к ней и открытых потоков, нет открытых ссылок, SSH-сессий и запросов к ее портам, не идет ход агента и не работает команда, запущенная с keep_awake. Фоновый процесс сам по себе не дает ей уснуть: когда песочница встает на паузу, процесс замораживается вместе с ней и продолжает работу после пробуждения. Каждый сервер проверяет все свои песочницы раз в секунду.
Три таймера: автопауза, автоостановка, автоудаление
pause_after_idle_seconds, по умолчанию 300: работающая песочница встает на паузу, ее память и процессы сохраняются, за 30% цены работы.stop_after_idle_seconds, по умолчанию 1800: работающая песочница или песочница на паузе останавливается; ее процессы завершаются, а диск уходит в объектное хранилище по 0,03 $ в месяц за GiB ее собственных данных.delete_after_idle_seconds, по умолчанию 0, то есть никогда: песочница удаляется в любом состоянии.
Все три считают по одним часам — времени с тех пор, как в песочнице что-то происходило в последний раз. Если таймер остановки не позже таймера паузы, работающая песочница останавливается, не вставая сначала на паузу. get_sandbox сообщает, что и когда сделает жизненный цикл дальше, в полях next_state и next_state_time. Таймеры задаются при создании песочницы, меняются потом через update_sandbox, а шаблон может передавать их каждой песочнице, созданной из него.
from pethost.sandboxes import Lifecycle, Sandboxes, SandboxSettings
sandboxes = Sandboxes() # читает PETHOST_TOKEN
lifecycle = Lifecycle(
pause_after_idle_seconds=60, # пауза после минуты простоя
stop_after_idle_seconds=3600, # остановка после часа простоя
delete_after_idle_seconds=7 * 86400, # удаление после недели простоя
)
sandbox = sandboxes.create_sandbox("base", settings=SandboxSettings(lifecycle=lifecycle))
# Работа, к которой никто не обращается, пока она идет: keep_awake откладывает паузу, но не дольше часа.
install = "python3 -m venv env && env/bin/pip install pandas scikit-learn"
sandboxes.run_command(sandbox.sandbox_id, command=install, keep_awake=True, timeout_seconds=3600, wait_seconds=0)id=$(pethost sandbox new --pause-after 1m --stop-after 1h --delete-after 168h)
pethost sandbox run "$id" --keep-awake --timeout 1h -d -- 'python3 -m venv env && env/bin/pip install pandas scikit-learn'Когда серверу не хватает ресурсов
Сервер может поставить песочницы на паузу или остановить их раньше их таймеров. Когда ему не хватает памяти, он ставит на паузу работающие песочницы, которые простаивают минуту и дольше; когда не хватает диска, он останавливает песочницы на паузе, которые простаивают дольше всех. Ничего не теряется: песочница на паузе просыпается как любая другая, остановленная снова запускается со своего диска, а state_message объясняет, почему так вышло.
Как разбудить остановленную песочницу
По умолчанию вызов к остановленной песочнице отклоняется (FAILED_PRECONDITION с Stopped), а запрос к ее порту получает ответ 503, пока ее не запустит resume_sandbox. Если включен wake_when_stopped, остановленная песочница просыпается от вызова, входа по SSH или запроса к порту, как песочница на паузе: примерно за 0,2 с или примерно за 10 с на GiB, если диск приходится забирать из объектного хранилища. Ее vCPU тогда засчитываются в ваш тариф, даже пока она остановлена. Это подходит песочнице, которую время от времени вызывает вебхук.
Сколько стоит простой
Максимального срока жизни у песочниц нет: та, которой не дают уснуть, работает, пока вы ее не остановите, а оставленная в покое с каждым шагом стоит меньше. Возьмем одну песочницу SMALL, в которой агент работает 2 часа в день, а остальные 22 она простаивает, и месяц из 30 дней. Если в простое она на паузе, использование стоит 4,64 $: 60 часов по 0,018 $ и 660 по 0,0054 $. Если бы она все время работала, вышло бы 12,96 $. Если в простое она остановлена и хранит 5 GiB собственных данных, она стоит 1,22 $, но каждый запуск тогда загружает ее с диска, без прежних процессов. Как считается каждая из этих секунд, описано на странице о посекундной оплате.
Сравнение с другими
Другие провайдеры ограничивают срок жизни песочницы. По их страницам на 21 ноября 2026 года сессии E2B длятся до 1 часа на Hobby и до 24 часов на Pro, а пауза начинает отсчет заново; песочницы Modal живут по умолчанию 5 минут, а максимум 24 часа; сессии Vercel Sandbox длятся 45 минут на Hobby и 24 часа на Pro. Pethost такого ограничения не ставит: песочница встает на паузу и останавливается по своим таймерам и живет, пока ее не удалите вы или заданный вами таймер удаления.