Переменные окружения
Переменные FLAREE_AGENT_* — самый сильный источник конфигурации Flaree Agent: они перетирают и CLI-аргументы, и agent.yaml. Ниже — полный список из 19 переменных, которые агент действительно читает.
Переменные агента
| Переменная | Тип | По умолчанию | Ключ agent.yaml | Описание |
|---|---|---|---|---|
FLAREE_AGENT_TOKEN | string | — (обязательна) | token | agent token из дашборда |
FLAREE_AGENT_SERVER | url | https://api.flaree.ru | server | URL Flaree API |
FLAREE_AGENT_CONFIG | path | /etc/flaree-agent/agent.yaml | — | путь к agent.yaml |
FLAREE_AGENT_NAME | string | hostname | name | имя агента в дашборде |
FLAREE_AGENT_BUFFER_PATH | path | /var/lib/flaree-agent | buffer_path | каталог для state.json и SQLite-буфера |
FLAREE_AGENT_METRICS | string | 127.0.0.1:9090 | metrics_endpoint | endpoint Prometheus; пусто — выключить |
FLAREE_AGENT_HEARTBEAT_ENDPOINT | string | 127.0.0.1:9091 | heartbeat_endpoint | локальный приёмник heartbeat |
FLAREE_AGENT_CERT_PIN | string | — | cert_pin_sha256 | SHA-256 SPKI в hex для cert-pinning |
FLAREE_AGENT_PERSISTENT_BUFFER | boolean | false | persistent_buffer | SQLite-буфер вместо in-memory |
FLAREE_AGENT_MAX_CONCURRENT | number | 50 | max_concurrent_checks | параллельные проверки, 1…1024 |
FLAREE_AGENT_HTTP_TIMEOUT_SEC | number | 15 | http_timeout_sec | таймаут HTTP-транспорта, 1…120 с |
FLAREE_AGENT_LOG_FORMAT | enum | text | — (только env) | формат логов агента: text или json |
FLAREE_AGENT_OTEL_ENDPOINT | url | — | — (только env) | OTLP/HTTP-endpoint для экспорта телеметрии самого агента |
FLAREE_AGENT_AUTO_UPDATE | boolean | true | — (только env) | автообновление; minimumVersion сервера обновляет принудительно даже при false |
FLAREE_AGENT_UPDATE_CHANNEL | string | stable | — (только env) | канал релизов |
FLAREE_AGENT_UPDATE_MANIFEST_URL | url | https://get.flaree.ru/agent/manifest.json | — (только env) | URL манифеста обновлений; переопределяйте только для self-hosted / staging |
FLAREE_AGENT_OTLP_ENABLED | boolean | false | otlp.enabled | включить OTLP receiver |
FLAREE_AGENT_OTLP_HOST | string | 127.0.0.1 | otlp.host | bind-адрес receiver, только loopback |
FLAREE_AGENT_OTLP_PORT | number | 4318 | otlp.port | порт OTLP receiver |
warning
Переменных FLAREE_TOKEN, FLAREE_ENDPOINT, FLAREE_WORKSPACE, FLAREE_LOG_LEVEL, FLAREE_SPOOL_PATH не существует — агент их не читает. Используйте только префикс FLAREE_AGENT_* из таблицы выше.
Приоритет конфигурации
Источники применяются послойно, каждый следующий слой перетирает предыдущий:
- Значения по умолчанию из кода агента.
agent.yaml— базовый набор значений.- CLI-аргументы (
--server,--token,--metrics, …). - Переменные окружения
FLAREE_AGENT_*— наивысший приоритет.
Пример конфликта и разрешения:
agent.yamlсодержитserver: "https://staging.flaree.ru".- Агент запущен с
--server https://api.flaree.ru. - В окружении установлено
FLAREE_AGENT_SERVER=https://api.flaree.ru. - Итог:
https://api.flaree.ru— env перетирает и CLI, и файл.