Data links
Тема дорожной карты · Grafana
Ссылки на данные в Grafana — это кликабельные URL, прикреплённые к отдельным точкам данных, рядам или ячейкам таблицы в панели, позволяющие инженерам переходить от конкретного значения метрики к связанному дашборду, запросу в Explore или внешнему runbook одним кликом. Ссылки на данные настраиваются в разделе Data links параметров поля любой панели или через Overrides для конкретных рядов с указанием шаблона URL, который может содержать подстановки переменных Grafana — ${__value.text}, ${__series.labels.instance}, $__from, $__to — для создания контекстно-зависимого URL назначения. Например, ссылка на данные в панели Time series может открывать Loki Explore с запросом, предварительно отфильтрованным по метке instance кликнутого ряда и ограниченным тем же временным диапазоном, реализуя рабочий процесс корреляции логов одним кликом при любом всплеске метрики. Ссылки на данные отображаются в панелях Time series, Stat, Gauge, Bar chart, Table и других при наведении или клике пользователя на точку данных — обычно в виде всплывающей подсказки с кликабельной ссылкой. Поскольку ссылки на данные используют динамические переменные шаблонов, они остаются корректными даже при изменении значений переменных дашборда или копировании дашборда в другое окружение, что делает их удобным паттерном навигации в крупных развёртываниях Grafana.
Как это работает
Data links: annotations — вертикальные маркеры на time-series панелях, показывающие события (деплои, инциденты, ручные заметки). Источник — annotation store Grafana, datasource-запрос или изменения состояния алертов. Links: panel-level (например "drill в логи этого сервиса"), dashboard-level (связанные дашборды). Переменные в links передают текущий контекст панели.
Когда применять
Добавляйте deploy-annotations из CI/CD-пайплайна — мгновенно коррелируете изменения метрик с деплоями ("когда начался всплеск latency? сразу после того деплоя"). Panel-links — прыжок с "всплеск API-errors" на "Loki-логи этого сервиса в том же time range". Annotations умеренно — > 10 маркеров/час нечитаемо.
Типичные ошибки
Ловушки Data links: annotation-запрос возвращает 1000+ событий (панель давится); annotation-source указывает на исчезнувший datasource (пустая панель); links без переменных (всегда открывают тот же target, игнорируя текущий контекст).