Формат agent.yaml
info
Перевод в процессе / Translation in progress. See русская версия.
agent.yaml — основной конфиг Flaree Agent, путь по умолчанию /etc/flaree-agent/agent.yaml или переменная FLAREE_AGENT_CONFIG. Приоритет: agent.yaml → CLI-аргументы → env-переменные FLAREE_*. CLI и env перетирают значения из файла.
Минимальный пример
endpoint: https://api.flaree.ru
token: ${FLAREE_TOKEN}
workspace: prod
otlp:
enabled: true
host: 127.0.0.1
port: 4318
Полная таблица ключей
| Ключ | Тип | Обязательность | По умолчанию | Описание |
|---|---|---|---|---|
endpoint | url | обязателен | — | URL Flaree API, https |
token | string | обязателен | — | agent token из дашборда (рекомендовано хранить в env и подставлять через ${FLAREE_TOKEN}) |
workspace | string | обязателен | — | идентификатор workspace |
log_level | enum | опционален | info | уровень логов (debug/info/warn/error) |
log_format | enum | опционален | text | формат логов (text/json) |
otlp | object | опционален | {enabled: false, host: "127.0.0.1", port: 4318} | OTLP loopback receiver |
otlp.enabled | boolean | опционален | false | включить OTLP |
otlp.host | string | опционален | 127.0.0.1 | bind-адрес, только loopback |
otlp.port | number | опционален | 4318 | порт receiver |
spool | object | опционален | {persistent: true, path: "/var/lib/flaree-agent/spool"} | SQLite spool |
spool.persistent | boolean | опционален | true | использовать диск (true) или in-memory (false) |
spool.path | path | опционален | /var/lib/flaree-agent/spool | путь к SQLite |
spool.max_size_mb | number | опционален | 512 | максимум спула на диске (MB) |
update | object | опционален | {enabled: true, channel: "stable"} | auto-update |
update.enabled | boolean | опционален | true | включить auto-update |
update.channel | enum | опционален | stable | канал (stable/canary) |
update.min_version_strict | boolean | опционален | true | обновляться немедленно при 401 minimum_version_required |
logs | object | опционален | {} | настройки сбора логов |
logs.redact | array | опционален | [] | паттерны/имена полей для маскирования на агенте |
metrics | object | опционален | {} | настройки сбора метрик |
telemetry | object | опционален | {} | настройки self-telemetry агента |
tls | object | опционален | {} | ca/cert/key для mTLS до Flaree API |
tls.ca_file | path | опционален | — | файл CA-сертификата |
tls.cert_file | path | опционален | — | клиентский сертификат |
tls.key_file | path | опционален | — | клиентский ключ |
proxy | object | опционален | {} | HTTP-proxy |
proxy.url | url | опционален | — | proxy URL (http/https) |
proxy.no_proxy | array | опционален | [] | исключения |
Максимальный пример
endpoint: https://api.flaree.ru
token: ${FLAREE_TOKEN}
workspace: prod
log_level: info
log_format: json
otlp:
enabled: true
host: 127.0.0.1
port: 4318
spool:
persistent: true
path: /var/lib/flaree-agent/spool
max_size_mb: 1024
update:
enabled: true
channel: stable
min_version_strict: true
logs:
redact:
- Authorization
- Cookie
- "password=*"
tls:
ca_file: /etc/flaree-agent/ca.pem
proxy:
url: http://proxy.local:3128
no_proxy:
- .internal
Дрейф значений с исходным кодом
Значения default'ов и min-version строго совпадают с Flaree.Agent.Core. Используйте ссылку «Edit this page» в подвале страницы, чтобы проверить актуальность — ссылка сгенерирована из editUrl в docusaurus.config.ts и ведёт в GitLab-репозиторий.