Привязка метрик к компоненту
Привязка (binding) связывает имя метрики и набор лейблов с конкретным Component. Без привязки метрика принимается, расходует квоту и доступна в поиске, но не отображается на карточке компонента и не годится для MetricRule. Привязки настраиваются в дашборде, на вкладке метрик компонента — конфиг агента править не нужно.
Предварительные требования
- Компонент создан в дашборде.
- Метрика реально поступает на бэкенд — от агента (host/docker/kubernetes-источники) или по OTLP. Дашборд показывает метрики, замеченные за последние 24 часа.
- У вас есть права на изменение компонента в организации.
Минимальная конфигурация
В дашборде: Компоненты → ваш компонент → Настройка метрик → Добавить привязку. Выберите метрику из списка доступных; матчер лейблов можно оставить пустым:
{}
Пустой матчер {} привязывает все серии метрики к компоненту.
Полная конфигурация
Поля привязки:
| Поле | Тип | По умолчанию | Описание |
|---|---|---|---|
| Метрика | string | — | Точное имя, например docker.container.cpu.usage. Выбирается из замеченных за 24 ч. |
| Матчер лейблов | JSON-объект | {} | Пары лейбл: значение; привязка применяется только к сериям, где все пары совпали. |
| Публичность | bool | false | Показывать ли метрику на публичной статус-странице компонента. |
Пример матчера, когда один агент отдаёт метрики нескольких контейнеров:
{ "container": "api" }
Привязка применится только к сериям docker.container.* с лейблом container=api; серии остальных контейнеров на карточку не попадут.
Типовые лейблы для разделения серий: container (Docker-источник), iface (сеть хоста), host.name / service.name (OTLP-метрики приложений). Агрегации, окна и переименования на уровне привязки нет — привязка только маршрутизирует серии в компонент; графики и MetricRule работают с сырыми значениями.
Одну метрику можно привязать к нескольким компонентам с разными матчерами: docker.container.cpu.usage с {"container": "api"} — к компоненту API, с {"container": "worker"} — к воркеру. Так один агент обслуживает карточки всех сервисов хоста.
Удаление привязки не удаляет уже принятые данные и не возвращает квоту.
Проверка работы
- Привязка появилась в списке на вкладке «Настройка метрик» компонента.
- График метрики отображается на карточке компонента в течение минуты.
- При создании MetricRule метрика доступна в выпадающем списке.
# Метрика продолжает поступать от агента (пример для docker-источника)
curl -s http://127.0.0.1:9090/metrics | grep flaree_agent
# счётчики агента растут — транспорт жив
docker logs flaree-agent --tail 20
Troubleshooting
- Метрика поступает, но не видна на карточке — чек-лист нет данных; чаще всего матчер лейблов не совпадает ни с одной серией.
- Метрики нет в списке доступных — она не приходила последние 24 часа; проверьте источник (Docker, OTLP) и квоты.
- Матчер выглядит верным, но серий нет — сравните точные значения лейблов в поступающих сериях: матчер сравнивает строки без подстановочных знаков.
Связанные страницы: OTLP · метрики хоста · правила и инциденты.