Skip to main content

Сбор support bundle

info

Перевод в процессе / Translation in progress. See русская версия.

Если предыдущие playbook-и (agent-offline, no-data, otlp-not-receiving, quota-exceeded) не помогли локализовать проблему, соберите набор данных для поддержки и отправьте его на support@flaree.ru. Bundle включает состояние сервиса, отредактированный agent.yaml, логи и текущие метрики — этого достаточно, чтобы команда Flaree воспроизвела контекст инцидента без доступа к вашему хосту.

Симптом​

  • Неочевидная проблема: агент частично работает, но данные идут с пропусками, задержками или метрики расходятся с дашбордом.
  • Ни одна из предыдущих troubleshooting-страниц (agent-offline, no-data, otlp-not-receiving, quota-exceeded) не объясняет наблюдаемое поведение.
  • Нужно эскалировать инцидент в support@flaree.ru и приложить воспроизводимый набор данных.

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

Цель — снять состояние агента, версию, agent.yaml с отредактированными секретами, логи за интересующее окно и текущие метрики в один приём:

systemctl status flaree-agent
journalctl -u flaree-agent --since "1 hour ago" > /tmp/flaree-agent.log
docker inspect flaree-agent > /tmp/flaree-agent-inspect.json
curl -sS http://127.0.0.1:9100/metrics > /tmp/flaree-agent-metrics.txt

Что даёт каждый шаг:

  • systemctl status flaree-agent — состояние unit, PID, время последнего рестарта, краткий хвост stdout.
  • journalctl --since "1 hour ago" — все строки за интересующее окно; при необходимости расширьте окно до нужного интервала (UTC).
  • docker inspect flaree-agent — версия образа, параметры запуска, примонтированные тома (если агент в Docker).
  • curl http://127.0.0.1:9100/metrics — срез метрик агента на момент сбора (buffers, spool, heartbeat).

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

Bundle собирается и отправляется по фиксированному чек-листу:

  1. Собрать логи агента: journalctl -u flaree-agent --since "1 hour ago" > /tmp/flaree-agent.log.
  2. Собрать agent.yaml с отредактированными секретами: замените значение ${FLAREE_TOKEN} и любые прочие токены на *** перед отправкой.
  3. Собрать текущие метрики агента: curl -sS http://127.0.0.1:9100/metrics > /tmp/flaree-agent-metrics.txt.
  4. Приложить идентификаторы: id инцидента (из dashboard) и agent_id (из ответа /api/agent/register).
  5. Создать tarball:
tar czvf flaree-support-$(date +%F).tar.gz /tmp/flaree-agent-*
  1. Отправить архив на support@flaree.ru с описанием симптома и временным окном в UTC (YYYY-MM-DD HH:MM:SS..HH:MM:SS UTC).

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