Аннотации
Тема дорожной карты · Grafana
Аннотации в Grafana — это маркеры событий, накладываемые на панели временных рядов в виде вертикальных линий или закрашенных областей, позволяющие операторам сопоставлять изменения метрик с реальными событиями: деплойментами, изменениями конфигурации или инцидентами. Grafana поддерживает два типа аннотаций: ручные, создаваемые кликом прямо по панели (правой кнопкой мыши или Ctrl+click) для пометки момента времени описанием и тегами, и аннотации на основе запросов, получающие события из источника данных — например, Loki-запрос, выбирающий строки логов о деплойменте, или SQL-запрос, извлекающий записи из таблицы управления изменениями. Аннотации настраиваются для каждого дашборда в Dashboard settings > Annotations, где задаются источник данных, запрос, цвет и иконка для каждого слоя аннотаций. Когда аннотации от Grafana Alerting включены (что является поведением по умолчанию), переходы состояний правил алертинга — например, Firing или Resolved — автоматически отображаются как аннотации на панелях, показывающих соответствующую метрику, давая мгновенный визуальный контекст для аномалий, связанных с алертами. Теги аннотаций позволяют фильтровать: элемент управления фильтром тегов над панелями аннотаций в интерфейсе 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, игнорируя текущий контекст).