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

# Состояние системы и уведомления

> Метрики Telepúrte, свежесть источников, очереди, инциденты и доставка событий через HTTPS webhook.

Следите отдельно за состоянием установки Telepúrte и состоянием управляемых нод. Общая сводка показывает доступность компонентов и накопление работы; [метрики ноды](https://docs.axottle.com/ru/telepurte/node-workspace.md) помогают разбирать CPU, память, диск, процессы и сервисы конкретной машины.

## С чего начать диагностику

В **Обзоре** проверьте парк, источники, агентов, бастионы и активные подключения. Затем переходите к проблемной ноде или заданию. Зелёный HTTP-ответ панели не подтверждает, что каждый агент и SSH-маршрут работает.

Для эксплуатационной автоматизации доступны API `/api/v1/system/metrics`, `/api/v1/system/metrics/history` и `/api/v1/system/alerts` с соответствующими правами. Публичные `/healthz` и `/readyz` не раскрывают подробную сводку.

| Показатель | Что помогает обнаружить |
| - | - |
| Присутствующие и SSH-проверенные ноды | Разницу между каталогом и готовностью подключения |
| Агенты и бастионы | Отсутствие исполнителя или точки входа |
| Ожидающие задания и передачи | Накопление работы |
| Возраст старейшей работы | Задержку обработки |
| Включённые и просроченные расписания | Проблему планировщика или доступности целей |
| Размер БД и свободное место | Риск остановки записи и автоматизации |

## Как понимать свежесть

Online агента или бастиона основан на недавнем heartbeat, обычно в пределах 45 секунд. Для внешнего источника Axottle данные считаются устаревшими после трёх минут без обновления. Эти состояния не доказывают, что конкретный SSH-вход успешен.

Эксплуатационная сводка отмечает задержанную очередь при ожидании более пяти минут, просроченное расписание — после минуты задержки, малое свободное место — ниже 512 МиБ. Это пороги диагностики установки, а не гарантия безопасного запаса диска для любой нагрузки.

Общесистемные минутные снимки сохраняются до 24 часов; API истории принимает периоды 1, 6 и 24 часа. Не путайте эту историю с графиками конкретной ноды, которые имеют собственный источник и срок жизни.

## Инциденты

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

Подтверждение уведомления означает, что оно замечено, но не исправляет причину и не скрывает активный инцидент. Проверяйте фактическое состояние компонента после принятого действия.

## Какие события уведомляют

Telepúrte сохраняет персональные уведомления о неудачных, истёкших и неопределённых заданиях, отказах и пропусках расписаний, расхождении конфигураций и изменении эксплуатационных инцидентов.

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

Лента доступна через `/api/v1/notifications`, подтверждение — через её операцию `ack`. Для внешней системы предусмотрен HTTPS webhook; настройка получателя выполняется на сервере, а не произвольным адресом из формы браузера.

## Подключить webhook

Добавьте в существующий `/etc/telepurte/config.json`:

```json theme={null}
"notification_webhook": {
  "url": "https://alerts.example.com/telepurte/events",
  "secret_file": "/etc/telepurte/notification-webhook.key"
}
```

Создайте отдельный секрет из 32–128 случайных байт, доступный сервисному пользователю с режимом `0600`. Не помещайте его в документацию или URL. Проверьте конфигурацию командой `telepurte check` с нужным `--config`, затем перезапустите сервис в согласованное время.

Получатель принимает метаданные события, проверяет подпись по исходному телу и времени и устраняет дубли по `X-Telepurte-Event-ID`. Содержимое файлов и терминалов не отправляется. Доставка может повторяться: ответ `2xx` подтверждает приём, сетевые ошибки, `408`, `429` и `5xx` повторяются с задержкой.

После исчерпания попыток событие остаётся в очереди неудачных доставок. Владелец может посмотреть `/api/v1/notifications/delivery/dead` и повторить выбранную доставку после исправления получателя. Ошибка webhook не отменяет исходное задание или внутреннее уведомление.

## Проверка

На тестовом событии проверьте внутреннюю запись, доставку, проверку подписи и обработку повтора. Для инцидента убедитесь, что после исправления причины он закрывается, а не только помечается прочитанным.

## Откат

Верните прежнюю конфигурацию webhook и проверьте её перед перезапуском. Удаление настройки приостанавливает внешнюю доставку; при повторном включении оставшаяся очередь может продолжиться. События, созданные до первого включения, задним числом не отправляются.

Команды относятся к стандартной Linux-установке; фактические пути проверьте в своей конфигурации.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.