Перейти к основному содержимому

Сбор support bundle

Если остальные playbook-и не помогли локализовать проблему, соберите диагностический архив командой flaree-agent --support-bundle и приложите его к тикету в support@flaree.ru. Архив редактируется автоматически: токены и секреты вычищаются до записи на диск.

Симптом​

  • Неочевидная проблема: агент частично работает, данные идут с пропусками или задержками, метрики расходятся с дашбордом.
  • Страницы agent-offline, no-data, otlp-not-receiving и quota-exceeded не объясняют наблюдаемое поведение.
  • Поддержка запросила диагностический архив для воспроизведения контекста без доступа к вашему хосту.

Диагностика​

Соберите архив одной командой и убедитесь, что он создан:

flaree-agent --support-bundle /tmp/bundle.zip
systemctl status flaree-agent
journalctl -u flaree-agent --since "1 hour ago" | tail -n 5

Что внутри bundle.zip:

  • логи агента за последнее окно работы;
  • agent.yaml с вычищенными секретами — значения token, secrets: и connections: заменены на маркеры;
  • state.json — идентификатор агента, версия и служебное состояние; сам токен там не хранится, только его SHA-256 хеш.

Вывод systemctl и хвост journalctl помогут вам приложить к тикету код выхода (77/78/79) и последние строки лога, если процесс падает и bundle собрать не удаётся.

Исправление​

  1. Соберите архив: flaree-agent --support-bundle /tmp/bundle.zip. В Docker: docker exec flaree-agent flaree-agent --support-bundle /tmp/bundle.zip && docker cp flaree-agent:/tmp/bundle.zip ..
  2. Зафиксируйте версию агента: flaree-agent --version.
  3. Отправьте архив на support@flaree.ru, указав: имя агента из дашборда, симптом, временное окно в UTC и код выхода процесса, если он завершался (77 — токен, 78 — версия/конфиг, 79 — нужен ручной рестарт).
  4. Архив уже отредактирован, но перед отправкой можно убедиться, что секретов нет:
unzip -l /tmp/bundle.zip
# Ожидаемо: логи, agent.yaml (redacted), state.json

Связанные страницы​