Журнал Monitor

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

[Скриншот 1: локальный журнал Monitor]

Что искать в журнале

• ошибки сбора метрик;
• проблемы HTTPS-соединения с Aggregator;
• ошибки авторизации и токена;
• результаты выполнения команд;
• ошибки бэкапов и smoke-test;
• проблемы update-репозитория или Python-адаптера.

Диагностика обмена

Если локальный сбор успешен, а данных на Aggregator нет, журнал помогает отделить проблему коллектора от сетевой ошибки. Смотрите время запроса и текст последней ошибки.

[Скриншот 2: пример ошибки обмена]

Перед обращением разработчику

1. Зафиксируйте время проблемы.
2. Сохраните текст ошибки без секретных токенов.
3. Укажите версию Monitor.
4. Проверьте URL Aggregator и системное время.
5. Уточните, воспроизводится ли ошибка при ручном сборе.

Безопасность

Не публикуйте в тикетах или скриншотах токен агента, секреты уведомлений и другие учётные данные. Если секрет был раскрыт, его лучше заменить.

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

Разделяйте ошибки по этапам

Полезно определить, на каком шаге возникла проблема: сбор → локальное сохранение → очередь → HTTP-отправка → pull-команда → выполнение → отправка результата. Такой подход быстрее, чем менять сразу URL, токен и настройки коллектора.

Секреты в диагностике

При копировании лога в задачу маскируйте Bearer-токен, токены Telegram, webhook и другие секреты. Installation UID и домен обычно не являются секретами, но всё равно относятся к данным проекта и должны обрабатываться по внутренним правилам.

После устранения

Выполните один полный ручной цикл и убедитесь, что новые записи журнала успешны. Старую ошибку не обязательно удалять: она полезна как история инцидента.

[Скриншот 3: фильтрация записей]