Skip to main content

Agent offline

info

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

Агент показывается в дашборде как offline: heartbeat перестаёт приходить, статус в сайдбаре становится красным, по агенту зажигаются incidents. Ниже — как локализовать причину и восстановить связь.

Симптом​

  • Статус-бэдж агента в дашборде app.flaree.ru становится красным (offline).
  • Не приходит heartbeat уже N минут (обычно > 2× интервала отправки).
  • Incidents создаются по самому агенту (проверки agent.heartbeat, agent.liveness).
  • В списке агентов last_seen_at давно не обновлялся.

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

Соберите состояние сервиса, логи и проверьте egress до API:

systemctl status flaree-agent
journalctl -u flaree-agent --since "15 min ago" | tail -n 50
curl -sS -H "X-Flaree-Token: ${FLAREE_TOKEN}" https://api.flaree.ru/api/agent/heartbeat -o /dev/null -w '%{http_code}\n'
ss -tnp | grep 4318

Интерпретация вывода:

  • 401 на heartbeat — токен невалиден или отозван (см. invalid_agent_token), проверьте FLAREE_TOKEN и статус агента в дашборде.
  • timeout, Could not resolve host, Connection refused — сетевая проблема: исходящий HTTPS до api.flaree.ru:443 закрыт фаерволом, прокси или DNS.
  • systemctl показывает Inactive (dead) или failed — процесс агента упал, смотрите journalctl на предмет panic/exit code.
  • ss без записи на 4318 — агент не поднял OTLP receiver, значит процесс либо не стартанул, либо упал после старта.

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

  1. Перезапустите агент и убедитесь, что сервис поднялся.
  2. Проверьте переменную FLAREE_TOKEN (не пустая, не отозвана в дашборде).
  3. Проверьте egress до api.flaree.ru:443 с хоста агента (фаервол, прокси, NAT).
  4. Если сервер возвращает minimum_version_required, обновите агент до актуальной версии.
systemctl restart flaree-agent

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