Перейти к основному содержанию
Следите отдельно за состоянием установки Telepúrte и состоянием управляемых нод. Общая сводка показывает доступность компонентов и накопление работы; метрики ноды помогают разбирать CPU, память, диск, процессы и сервисы конкретной машины.

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

В Обзоре проверьте парк, источники, агентов, бастионы и активные подключения. Затем переходите к проблемной ноде или заданию. Зелёный HTTP-ответ панели не подтверждает, что каждый агент и SSH-маршрут работает. Для эксплуатационной автоматизации доступны API /api/v1/system/metrics, /api/v1/system/metrics/history и /api/v1/system/alerts с соответствующими правами. Публичные /healthz и /readyz не раскрывают подробную сводку.

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

Online агента или бастиона основан на недавнем heartbeat, обычно в пределах 45 секунд. Для внешнего источника Axottle данные считаются устаревшими после трёх минут без обновления. Эти состояния не доказывают, что конкретный SSH-вход успешен. Эксплуатационная сводка отмечает задержанную очередь при ожидании более пяти минут, просроченное расписание — после минуты задержки, малое свободное место — ниже 512 МиБ. Это пороги диагностики установки, а не гарантия безопасного запаса диска для любой нагрузки. Общесистемные минутные снимки сохраняются до 24 часов; API истории принимает периоды 1, 6 и 24 часа. Не путайте эту историю с графиками конкретной ноды, которые имеют собственный источник и срок жизни.

Инциденты

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

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

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

Подключить webhook

Добавьте в существующий /etc/telepurte/config.json:
Создайте отдельный секрет из 32–128 случайных байт, доступный сервисному пользователю с режимом 0600. Не помещайте его в документацию или URL. Проверьте конфигурацию командой telepurte check с нужным --config, затем перезапустите сервис в согласованное время. Получатель принимает метаданные события, проверяет подпись по исходному телу и времени и устраняет дубли по X-Telepurte-Event-ID. Содержимое файлов и терминалов не отправляется. Доставка может повторяться: ответ 2xx подтверждает приём, сетевые ошибки, 408, 429 и 5xx повторяются с задержкой. После исчерпания попыток событие остаётся в очереди неудачных доставок. Владелец может посмотреть /api/v1/notifications/delivery/dead и повторить выбранную доставку после исправления получателя. Ошибка webhook не отменяет исходное задание или внутреннее уведомление.

Проверка

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

Откат

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