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

Быстрый старт: Docker Compose

За 15 минут вы поднимете Agent на своём сервере, увидите его онлайн в дашборде и подключите первое приложение по OTLP. Агент — один статический бинарник без зависимостей: он выполняет проверки и отправляет результаты только исходящим HTTPS-трафиком.

Что получите​

  • Агент со статусом Online в дашборде через ~30 секунд после запуска.
  • Персистентный буфер: результаты проверок переживают перезапуск контейнера.
  • Prometheus-метрики агента на loopback-порту 127.0.0.1:9090.

Предварительные требования​

  • Docker Engine 20.10+ и Docker Compose v2.
  • Токен агента из дашборда: Agents → Add agent.
warning

Токен показывается один раз — сохраните его в secret manager до закрытия диалога. Flaree хранит только SHA-256-хеш, восстановить токен нельзя.

docker-compose.yml​

services:
  flaree-agent:
    image: registry.flaree.ru/agent:1
    restart: unless-stopped
    environment:
      FLAREE_AGENT_TOKEN: ${FLAREE_AGENT_TOKEN}
      FLAREE_AGENT_SERVER: https://api.flaree.ru
      FLAREE_AGENT_PERSISTENT_BUFFER: "true"
    volumes:
      - flaree-agent-state:/var/lib/flaree-agent
    ports:
      - "127.0.0.1:9090:9090"

volumes:
  flaree-agent-state:

Том flaree-agent-state хранит файл состояния и SQLite-буфер. Порт 9090 публикуется только на loopback хоста — метрики не видны из сети.

Запуск​

FLAREE_AGENT_TOKEN=<token> docker compose up -d

Проверка​

docker logs flaree-agent | head -20
curl -s http://127.0.0.1:9090/metrics | grep flaree_agent_checks_total

Ожидаемый вывод curl — счётчики проверок, значения растут по мере работы:

flaree_agent_checks_total{type="http",ok="true"} 4

В дашборде агент появится в разделе Agents со статусом Online в течение ~30 секунд.

Подключение приложения по OTLP​

Агент принимает OTLP/JSON от приложений на том же хосте и пересылает метрики и логи в Flaree — приложению не нужен отдельный токен и доступ в интернет. Включите receiver:

    environment:
      FLAREE_AGENT_OTLP_ENABLED: "true"

Receiver слушает только 127.0.0.1:4318. В приложении задайте стандартную переменную OpenTelemetry SDK:

OTEL_EXPORTER_OTLP_ENDPOINT=http://127.0.0.1:4318
к сведению

Из контейнера приложения loopback хоста доступен как host.docker.internal — либо запускайте приложение с network_mode: host.

Дальше​