---
title: "Путь проверки состояния в App Platform"
description: "Настройка проверки состояния (healthcheck) в App Platform. Документация и инструкции по использованию и настройке облачных сервисов Timeweb Cloud."
---

> Полный индекс документации для ИИ-агентов: [llms.txt](https://timeweb.cloud/llms.txt).

Путь проверки состояния нужен, если вы хотите выполнять периодическую проверку того, запущено ли приложение и работает ли оно корректно.

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

Чтобы избежать таких ситуаций, можно настроить путь проверки состояния. Для этого в приложении должен быть реализован эндпоинт, который не зависит от внешних факторов (например, готовности базы данных или сторонних сервисов) и отражает состояние приложения.

Этот эндпоинт вы сможете указать при настройке — например, `/health`, `/status` или `/ping`.

## Как работает

Во всех случаях запрос к пути проверки состояния выполняется с `localhost`. 

Главное требование — возвращать код `2xx`. Содержимое ответа неважно, главное — корректный код ответа.

### При редеплое

Если путь проверки состояния указан, система делает до трех последовательных GET-запросов к новому инстансу приложения.

-   Если хотя бы один запрос возвращает код `2xx` — деплой считается успешным, и новая версия приложения становится активной.
-   Если три проверки подряд завершаются ошибкой (любой ответ, отличный от `2xx`) — деплой считается неуспешным, и продолжает работать предыдущая версия.
-   Проверки продолжаются до тех пор, пока не будет:
    -   один успешный ответ,
    -   три неуспешных ответа подряд через 40 секунд после запуска,
    -   или не пройдет 180 секунд — если за это время ни одно из условий не выполнено, деплой считается неуспешным.

В логах деплоя появится сообщение, если проверка не пройдена.

### После запуска

После успешного деплоя система продолжает регулярно проверять работоспособность приложения: один запрос каждые 30 секунд.

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

![Scr 20251125 Olid](https://content.timeweb.com/assets/e710bb31-70ef-4448-a157-49f7a170b5c3.png?width=2152&height=1666)

## Настройка

Путь проверки состояния можно указать как при создании приложения, так и для уже существующего.

### При создании приложения

В разделе «Настройка приложения» укажите путь в поле «Путь проверки состояния».

Например, если в приложении реализован эндпоинт `/health`, который доступен по адресу `https://домен/health`, укажите:

```shell
/health
```

![Scr 20251125 Qqdp](https://content.timeweb.com/assets/acf63b28-a9a1-4566-857e-6f257f2898d7.png?width=1010&height=822)

### Для уже созданного приложения

1.  Откройте нужное приложение в панели управления.
    
2.  Перейдите на вкладку «Настройки».
    
3.  В блоке «Настройки деплоя» нажмите кнопку «Редактировать».
    
4.  Введите путь проверки состояния.
    
5.  Нажмите «Сохранить данные».
    

После этого автоматически запустится новый деплой с обновленной настройкой.

![Scr 20251125 Qqlz](https://content.timeweb.com/assets/de3a0ff1-626e-4f84-a558-10b221016303.png?width=2140&height=1552)

## Docker и Docker Compose

Если вы используете деплой через Dockerfile, в панели управления будет доступна [настройка пути проверки состояния](https://timeweb.cloud/docs/apps/healthcheck-path#nastrojka). Но если в самом Dockerfile прописан `HEALTHCHECK`, он имеет приоритет — настройка из панели в этом случае игнорируется.

Настройка через Dockerfile подробно описана в [официальной документации](https://docs.docker.com/reference/dockerfile/#healthcheck).

Пример:

```shell
HEALTHCHECK --interval=30s --timeout=10s --retries=3 \
CMD curl -f http://localhost/health || exit 1
```

Для деплоев через Docker Compose настройка пути проверки состояния в панели управления не поддерживается. Если при этом используется Dockerfile, вы можете настроить `HEALTHCHECK` внутри него — правило будет работать, как описано выше.