Документацияbreadcrumb arrow Grafanabreadcrumb arrow Документация GlaberGraphbreadcrumb arrow Источники данныхbreadcrumb arrow Google Cloud Monitoringbreadcrumb arrow Аннотации
Последнее обновление: августа 11, 2026

Аннотации Google Cloud Monitoring

Аннотации накладывают насыщенную информацию о событиях поверх графиков. С помощью аннотаций можно отмечать важные события, развёртывания или инциденты на дашбордах.

Прежде чем начать

Перед настройкой аннотаций убедитесь в наличии следующего:

  • Настроенный источник данных Google Cloud Monitoring.
  • Дашборд, на который вы хотите добавить аннотации.

Ограничения аннотаций

Учитывайте следующие ограничения при использовании аннотаций:

  • Производительность: отрисовка аннотаций ресурсоёмка. Ограничивайте количество возвращаемых строк, чтобы поддерживать производительность дашборда.
  • Нативные события: нет поддержки отображения нативных аннотаций и событий Google Cloud Monitoring. Однако аннотации хорошо работают с пользовательскими метриками в Google Cloud Monitoring.

Добавление запроса аннотации

Чтобы добавить запрос аннотации на дашборд:

  1. Перейдите к дашборду, который хотите изменить, и нажмите Edit.
  2. Нажмите значок Add new element (синий знак плюса).
  3. Нажмите Annotation query.
  4. Введите имя для запроса аннотации.
  5. Если вы не хотите использовать запрос аннотации сразу, снимите флажок Enabled.
  6. Выберите цвет для маркеров событий аннотации.
  7. Выберите вариант в раскрывающемся списке Show annotation controls in, чтобы управлять тем, где на дашборде отображается аннотация.
  8. Выберите вариант в раскрывающемся списке Show in, чтобы управлять тем, на каких панелях отображается аннотация.
  9. Нажмите Open query editor, чтобы открыть диалоговое окно Annotation Query.
  10. Выберите ваш источник данных Google Cloud Monitoring в раскрывающемся списке Data source.
  11. Настройте запрос аннотации и сопоставления полей.
  12. (Необязательно) Нажмите Test annotation query, чтобы убедиться, что запрос работает корректно.
  13. Нажмите Close, когда завершите настройку запроса.
  14. Нажмите Save.
  15. (Необязательно) Введите описание внесённых изменений.
  16. Нажмите Save.
  17. Нажмите Exit edit.

Настройка запроса аннотации

С помощью редактора запросов для аннотаций можно выбрать метрику и фильтры, чтобы определить, какие точки данных создают аннотации.

Поля Title и Text поддерживают шаблонизацию и могут использовать данные, возвращённые запросом.

Например, поле Title может содержать следующий текст:

{{metric.type}} has value: {{metric.value}}

Пример результата: monitoring.googleapis.com/uptime_check/http_status has this value: 502

Шаблоны аннотаций

Используйте следующие шаблоны в полях Title и Text для отображения данных метрик в ваших аннотациях:

Формат шаблона Описание Пример Результат
{{metric.value}} Значение метрики/точки. {{metric.value}} 555
{{metric.type}} Возвращает полный Metric Type. {{metric.type}} compute.googleapis.com/instance/cpu/utilization
{{metric.name}} Возвращает часть с именем метрики. {{metric.name}} instance/cpu/utilization
{{metric.service}} Возвращает часть с сервисом. {{metric.service}} compute
{{metric.label.xxx}} Возвращает значение метки метрики. {{metric.label.instance_name}} grafana-1-prod
{{resource.label.xxx}} Возвращает значение метки ресурса. {{resource.label.zone}} us-east1-b

Пример: аннотации сбоев проверки доступности

Чтобы создать аннотации для сбоев проверки доступности (uptime check):

  1. Добавьте запрос аннотации с использованием источника данных Google Cloud Monitoring.
  2. Выберите метрику monitoring.googleapis.com/uptime_check/check_passed.
  3. Добавьте фильтр check_passed = false.
  4. Задайте для Title значение: Uptime check failed: {{metric.label.check_id}}
  5. Задайте для Text значение: Region: {{resource.label.zone}}

Это создаёт маркер аннотации на графике каждый раз, когда проверка доступности завершается неудачно.