Переменные окружения

info

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

Env-vars используются для настройки агента и некоторых backend-компонентов. Каждая переменная имеет соответствующий ключ в agent.yaml или подпись, где её значение применяется.

Agent env vars

Переменная	Область	Тип	По умолчанию	Соответствующий ключ agent.yaml	Описание
FLAREE_TOKEN	агент	string	—	token	agent token из дашборда
FLAREE_ENDPOINT	агент	url	https://api.flaree.ru	endpoint	URL Flaree API
FLAREE_WORKSPACE	агент	string	—	workspace	идентификатор workspace
FLAREE_LOG_LEVEL	агент	enum	info	log_level	уровень логов (debug/info/warn/error)
FLAREE_OTLP_ENDPOINT	агент	url	http://127.0.0.1:4318	otlp.endpoint	куда приложения шлют OTLP
FLAREE_SPOOL_PATH	агент	path	/var/lib/flaree-agent/spool	spool.path	путь к SQLite spool
FLAREE_AGENT_AUTO_UPDATE	агент	boolean	true	update.enabled	включить/выключить auto-update
FLAREE_AGENT_OTLP_ENABLED	агент	boolean	false	otlp.enabled	включить OTLP receiver
FLAREE_AGENT_OTLP_HOST	агент	string	127.0.0.1	otlp.host	bind-адрес (только loopback)
FLAREE_AGENT_OTLP_PORT	агент	number	4318	otlp.port	порт receiver
FLAREE_AGENT_PERSISTENT_BUFFER	агент	boolean	true	spool.persistent	диск вместо in-memory
FLAREE_AGENT_CONFIG	агент	path	/etc/flaree-agent/agent.yaml	—	путь к agent.yaml
FLAREE_AGENT_LOG_FORMAT	агент	enum	text	log_format	формат логов (text/json)

Backend env vars

Backend-переменные применяются операторами платформы при развёртывании Flaree.Api и воркеров. Конечные пользователи агента их обычно не трогают.

Переменная	Область	Тип	По умолчанию	Соответствующий ключ agent.yaml	Описание
FLAREE_DB_CONNECTION	backend	string	—	—	Postgres connection string
FLAREE_REDIS_CONNECTION	backend	string	—	—	Redis connection
FLAREE_CLICKHOUSE_CONNECTION	backend	string	—	—	ClickHouse connection

Приоритет конфигурации

Источники конфигурации агента применяются послойно. Каждый следующий слой перетирает значения из предыдущего:

1. agent.yaml — читается первым как базовый набор значений.
2. CLI-аргументы (--token=..., --endpoint=...) — переопределяют значения из agent.yaml.
3. Переменные окружения (FLAREE_*) — имеют наивысший приоритет и перетирают оба предыдущих слоя.

Пример конфликта и разрешения:

• agent.yaml содержит log_level: info.
• CLI не задаёт уровень логов.
• В окружении установлен FLAREE_LOG_LEVEL=debug.
• Итоговое значение: debug (env перетирает agent.yaml).

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

• Справочник agent.yaml
• Концепция: агент