> ## Documentation Index
> Fetch the complete documentation index at: https://docs.axottle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Уровни проверок

> Что проверяет каждый уровень здоровья — от сетевой достижимости до сквозной проверки маршрута и внешних региональных проб — и чем ручная проверка отличается от плановой.

Проверки здоровья организованы по уровням. Каждый следующий уровень отвечает на всё более «глубокий» вопрос: доступна ли нода по сети → работает ли на ней служба → отвечает ли конечная точка протокола → проходит ли трафик сквозь маршрут целиком → как это выглядит из других регионов. Уровни независимы, но если базовая достижимость не прошла, часть верхних проверок помечается как `skipped`.

<Info>Для кого: администратор панели, SRE. Требуемые права: сессия администратора.</Info>

<Note>
  Здесь описано **поведение** проверок — какой вопрос закрывает каждый уровень. Технические детали проб (адреса контрольных точек, параметры рукопожатий, способ подтверждения доступа) не публикуются намеренно: их раскрытие помогло бы третьим лицам опознавать или подделывать служебный трафик.
</Note>

## Уровни

<Steps>
  <Step title="L1 — Сетевая достижимость" icon="network-wired">
    Базовый уровень: нода доступна по сети. Панель разрешает доменное имя ноды и проверяет TCP-доступность управляющего порта и пользовательских входных портов. Работает **полностью со стороны панели** и не требует агента — поэтому применим даже к ещё не подключённым нодам. Реализован.
  </Step>

  <Step title="L2 — Проверка службы агента" icon="server">
    Проверяет, что серверная часть VPN действительно запущена на ноде. Данные приходят от агента Axottle и трактуются с учётом режима исполнения ноды (runtime-aware). Требует установленного и онлайн-агента. Реализован.
  </Step>

  <Step title="L3 — Рукопожатие протокола (TLS)" icon="lock">
    Конечная точка протокола отвечает на настоящее TLS-рукопожатие с ожидаемым именем сервера. Это сильный сигнал «сервер действительно обслуживает трафик, конфигурация цела» — без владения клиентскими секретами. Реализован для TLS/REALITY-входов; там, где такая проверка неприменима, статус — `not_implemented`.
  </Step>

  <Step title="L4 — Сквозная проверка маршрута" icon="route">
    Проверка «из конца в конец»: доступность шлюза, достижимость целей условных маршрутов и клиентский проход через входную ноду до контрольной точки. Дополнительно панель подтверждает доступ к каждой входной ноде. Реализован.
  </Step>

  <Step title="L5 — Внешние региональные пробы" icon="globe">
    Достижимость ноды глазами внешних региональных провайдеров — как нода видна «снаружи», из других сетей и стран. Работает через подключаемые платные адаптеры и включается по желанию для отдельных входных блоков. Если ни один провайдер не подключён, статус — `external_probe_unavailable`. Реализован.
  </Step>

  <Step title="L6 — Разбор Axosun" icon="robot">
    Это не ещё одна сетевая проба. Axosun получает результаты предыдущих уровней, события и доступный контекст объекта, а затем формирует диагностический отчёт. Запуск доступен с карточки инцидента кнопкой **Разобрать** и не меняет конфигурацию.
  </Step>
</Steps>

<Warning>
  ИИ-диагностика работает **только на чтение**: она не выполняет команд на нодах и не меняет конфигурацию. Любое предложенное ею изменение становится обычным health-действием, которое всё равно требует подтверждения оператора.
</Warning>

## Порядок и пропуски

Уровни L2 и L3 пропускаются (со статусом `skipped`), если базовая достижимость L1 уже провалилась: при недоступной ноде проверять службу и рукопожатие бессмысленно. Это не отдельный сбой, а сокращение лишних запросов.

## Ручная проверка против плановой

Один и тот же уровень можно запустить двумя способами, и ведут они себя по-разному — это важно для интерпретации.

|                                             | Ручная проверка                        | Плановая (по расписанию)                                        |
| ------------------------------------------- | -------------------------------------- | --------------------------------------------------------------- |
| Запуск                                      | Кнопка **Запустить проверку**          | Планировщик по интервалам                                       |
| Сквозной проход (dial)                      | Ровно **один** прогон, без повторов    | До **трёх** попыток подряд                                      |
| Может выставить `critical` со стороны ноды? | **Нет** — единичный сбой не эскалирует | **Да** — но только после устойчивого отказа (несколько попыток) |

<Note>
  Смысл различия: ручная проверка нужна, чтобы быстро посмотреть текущее состояние, и один случайный тайм-аут не должен переводить схему в critical. Плановая проверка эскалирует к critical со стороны ноды только после устойчивого отказа сквозной пробы — трёх попыток (немедленно, затем примерно через интервал/1.5, затем ещё примерно через 30 секунд). Каждая попытка сохраняется как отдельная запись пробы.
</Note>

## Интервалы по умолчанию

Плановые проверки идут по интервалам (значения по умолчанию, настраиваются — см. [Политики здоровья](/ru/health/policies)):

* достижимость (L1) — каждые **60 секунд**;
* служба (L2) — каждые **120 секунд**;
* сквозная проверка схемы (L4) — каждые **10 минут**.

Минимально допустимые значения ограничены снизу (15 / 30 / 60 секунд), чтобы проверки не превращались в самообстрел инфраструктуры.

## Проверка

<Check>История проб схемы отображается во вкладке **Здоровье** в блоке **Server timeline**. Для ноды используйте вкладки **Обзор** и **Журнал**.</Check>

## Откат

Запуск проверки — операция только для чтения (кроме подтверждённых действий восстановления, которые описаны отдельно). Откатывать нечего: проверка не меняет конфигурацию ноды, только фиксирует наблюдения.

## Типовые ошибки

<AccordionGroup>
  <Accordion title="L2 показывает absent / unknown">
    Уровень службы требует онлайн-агента. Если агента нет или он оффлайн, статус — `absent`/`unknown`, а не сбой. Установите агент или дождитесь heartbeat.
  </Accordion>

  <Accordion title="L5 всегда external_probe_unavailable">
    Не подключён ни один внешний провайдер региональных проб, либо L5 не включён для этого блока. Это ожидаемо: L5 — опциональный платный уровень.
  </Accordion>

  <Accordion title="Где открыть L6-разбор">
    Откройте инцидент на странице **Здоровье** и нажмите **Разобрать**. История отчётов находится на вкладке **Axosun History**.
  </Accordion>
</AccordionGroup>

Связанные страницы: [Состояния и severity](/ru/health/states), [Дашборд здоровья](/ru/health/dashboard), [Политики здоровья](/ru/health/policies), [Axosun](/ru/axosun/overview).

<Note>Проверено для версии Axottle текущей ветки. Дата проверки: 2026-07-11.</Note>
