> ## 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.

# Компоненты и проверки

> Из чего собирается страница: группы, компоненты, источники их состояния, собственные проверки и графики метрик.

Компонент — одна строчка на странице статуса: «Личный кабинет», «Серверы в Германии», «Подписки». Посетитель видит её название, текущее состояние и историю за 30 дней. Всё остальное на вкладке **Компоненты** нужно для того, чтобы это состояние бралось откуда надо.

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

## С чего начать

Начните с того, о чём вас чаще всего спрашивают клиенты, и назовите это их словами. Внутренние имена вроде `de1-inbound` посетителю ничего не говорят; «Серверы в Германии» говорят.

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

## Откуда берётся состояние

При создании компонента первый вопрос — источник.

| Источник               | Кто следит | Когда выбирать                                                     |
| ---------------------- | ---------- | ------------------------------------------------------------------ |
| Нода                   | Панель     | Состояние берётся из ноды, которой панель управляет                |
| Хост (Connection Unit) | Панель     | Состояние хоста подключения из вашей схемы                         |
| Свой сервис            | Страница   | Свой адрес, который страница проверяет сама                        |
| Ручной статус          | Вы         | Всё, что панель не видит: биллинг, офисная почта, сторонний сервис |

Разница между первыми двумя и третьим важнее, чем кажется. Состояние нод и Connection Units знает панель, поэтому она отправляет его на страницу раз в минуту. Свой сервис страница проверяет сама, со своего сервера, и продолжит это делать, даже когда панель недоступна.

У компонента-ноды страна подставляется из карточки ноды: на странице рядом с названием появляется флаг. Вводить её второй раз не нужно.

## Что показывать посетителю

Режим отображения задаёт, что окажется в строке компонента:

* **Статус** — только текущее состояние;
* **Uptime** — состояние и доля работоспособности за 30 дней;
* **Метрики** — состояние и график;
* **Статус и метрики** — всё вместе.

История рисуется 30 дневными делениями. Дни, на которые пришлись инцидент или плановые работы, кликабельны: посетитель открывает связанное событие.

В разделе «Дополнительно» прячется остальное: показывать компонент посетителям или нет и через сколько секунд без свежих данных считать их устаревшими. Устаревший компонент показывается как «состояние уточняется», а не остаётся с последним хорошим значением.

## Собственные проверки

Проверки выполняет сервер страницы. Их пять типов:

| Тип            | Что задаётся                                                                                                        |
| -------------- | ------------------------------------------------------------------------------------------------------------------- |
| HTTP(S)        | URL, метод, диапазон ожидаемых кодов ответа, подстрока в ответе, следовать ли редиректам, заголовок `Authorization` |
| TCP            | Хост и порт                                                                                                         |
| DNS            | Имя, тип записи, ожидаемые значения                                                                                 |
| TLS-сертификат | За сколько дней до истечения предупреждать                                                                          |
| Heartbeat      | Допустимая задержка: сервис сам стучится на страницу, и молчание дольше этого срока считается сбоем                 |

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

<Note>
  Секрет для заголовка `Authorization` показывается один раз, при сохранении. Дальше панель говорит только, задан он или нет. Чтобы заменить, введите новое значение; чтобы убрать, очистите поле.
</Note>

## Графики метрик

Компонент может показывать волнистые графики: задержка, доступность, загрузка процессора. Серия задаётся ключом (`latency_ms`, `availability`, `cpu_percent`), названием и единицей измерения. Собирает и хранит их сама страница.

## Проверка

<Check>На вкладке **Обзор** у компонента видно текущее состояние и заполненная история, а превью на вкладке **Оформление** показывает ровно то, что увидит посетитель.</Check>

## Ограничения

* Число видимых компонентов ограничено тарифом. Скрытый компонент в лимит не идёт.
* Компонент с источником «нода» или «хост» обязан быть привязан к конкретному ресурсу панели. Без привязки он не сохранится.
* Историю аптайма нельзя перенести из другого сервиса статуса: она начинается с момента установки страницы.

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

<AccordionGroup>
  <Accordion title="Компонент показывает «Состояние уточняется»">
    Данные о нём давно не приходили. Для источника от панели проверьте, что панель на связи и что нода или Connection Unit жив; для своего сервиса — что проверка включена и её цель отвечает. Порог устаревания настраивается там же, в «Дополнительно».
  </Accordion>

  <Accordion title="Проверка HTTP красит компонент в сбой, хотя сайт открывается">
    Чаще всего дело в диапазоне ожидаемых кодов или в редиректе: страница по умолчанию за ним не идёт. Проверьте также, что адрес доступен с сервера страницы, а не только из вашей сети.
  </Accordion>

  <Accordion title="Не сохраняется компонент со своей проверкой">
    У каждой проверки должна быть заполнена цель: URL для HTTP, хост и порт для TCP, имя для DNS. Пустую цель панель не примет.
  </Accordion>
</AccordionGroup>

Связанные страницы: [Страница статуса: обзор](/ru/statuspage/overview), [Инциденты и плановые работы](/ru/statuspage/incidents), [Оформление](/ru/statuspage/appearance).