Аннотации и ссылки
Тема дорожной карты · Grafana
Аннотации и ссылки в Grafana работают вместе, создавая связанный и удобный для навигации опыт наблюдаемости: аннотации отмечают значимые события на панелях, а ссылки предоставляют кликабельные пути к связанным дашбордам, запросам или внешним системам. Аннотации маркируют моменты времени на визуализациях временных рядов — события деплоймента, изменения состояния алертов, объявление инцидентов, — давая зрителям немедленный контекст о причинах изменения формы метрики. Ссылки на дашборды и ссылки на данные расширяют интерактивность Grafana: ссылка на дашборд появляется как кнопка или выпадающий список в заголовке дашборда и переводит на другой дашборд Grafana с сохранением текущего временного диапазона и значений переменных, тогда как ссылка на данные прикрепляется к конкретным значениям панели и появляется при наведении или клике пользователя на точку ряда. Ссылки на данные в Grafana поддерживают переменные шаблонов и встроенные макросы — ${__value.text}, ${__series.name}, $__from/$__to — формируя динамические URL, открывающие предварительно отфильтрованный второй дашборд, поток логов Loki или внешнюю страницу runbook, привязанную к той конкретной точке данных, на которую кликнул пользователь. Совместное использование аннотаций и ссылок — например, аннотирование панели событиями деплоймента с добавлением ссылки на данные, открывающей логи деплоймента в Loki, — создаёт целостный рабочий процесс анализа первопричин полностью внутри интерфейса Grafana.
Как это работает
Аннотации и ссылки: 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 маркеров/час нечитаемо.
Типичные ошибки
Ловушки Аннотации и ссылки: annotation-запрос возвращает 1000+ событий (панель давится); annotation-source указывает на исчезнувший datasource (пустая панель); links без переменных (всегда открывают тот же target, игнорируя текущий контекст).