Установка агента: выбор канала

Agent распространяется через шесть каналов — они взаимозаменяемы и используют одну модель конфигурации. Выберите канал под свою инфраструктуру и переходите на страницу с командами.

Канал	Когда удобнее	Автообновление	Управление жизненным циклом
Docker	Быстрая оценка / один VPS	да	docker restart
Docker (compose)	Один хост в проде	да	compose up -d
Helm (Kubernetes)	Флот / мульти-хост	да	rolling update
systemd (Linux)	Bare-metal / VM без Docker	да	systemctl restart
MSI (Windows)	Windows Server / корпоративные ПК	да	Windows Service
PKG (macOS)	macOS, рабочие станции разработчиков	да	launchd

warning

Перед установкой создайте токен агента в дашборде: Agents → Add agent. Токен показывается один раз — сохраните его в secret manager до закрытия диалога.

Общая модель конфигурации

Приоритет источников: env-переменные > CLI-аргументы > agent.yaml > значения по умолчанию. Env перебивает всё.

Путь к файлу — /etc/flaree-agent/agent.yaml, переопределяется переменной FLAREE_AGENT_CONFIG.

Минимальный agent.yaml

server: "https://api.flaree.ru"
token: "<token>"
buffer_path: "/var/lib/flaree-agent"
persistent_buffer: true
max_concurrent_checks: 50

Парсер agent.yaml намеренно упрощён и понимает только ключи server, token, name, buffer_path, persistent_buffer, max_concurrent_checks, http_timeout_sec, metrics_endpoint, heartbeat_endpoint и секции secrets:, connections:, otlp:. Параметры логирования и автообновления задаются только через env — полный список в справочнике env-переменных.

Основные env-переменные

Переменная	По умолчанию	Назначение
FLAREE_AGENT_TOKEN	—	Токен агента (обязательно)
FLAREE_AGENT_SERVER	https://api.flaree.ru	URL API
FLAREE_AGENT_CONFIG	/etc/flaree-agent/agent.yaml	Путь к конфигу
FLAREE_AGENT_PERSISTENT_BUFFER	false	SQLite-буфер вместо in-memory
FLAREE_AGENT_BUFFER_PATH	/var/lib/flaree-agent	Каталог state и буфера
FLAREE_AGENT_METRICS	127.0.0.1:9090	Endpoint Prometheus
FLAREE_AGENT_LOG_FORMAT	text	text или json
FLAREE_AGENT_AUTO_UPDATE	true	Автообновление
FLAREE_AGENT_OTLP_ENABLED	false	OTLP receiver на loopback

Проверка после установки

Независимо от канала, через ~30 секунд после старта:

1. Агент виден в разделе Agents дашборда со статусом Online.
2. Счётчик flaree_agent_checks_total{ok="true"} на 127.0.0.1:9090/metrics растёт.
3. Компоненты с проверками переходят в статус Operational.

Дальше

• Справочник: agent.yaml — все ключи файла.
• Справочник: env-переменные — полная таблица.
• Концепция: Агент — жизненный цикл, буфер, автообновление.