Документацияbreadcrumb arrow Grafanabreadcrumb arrow Документация GlaberGraphbreadcrumb arrow Источники данныхbreadcrumb arrow Amazon CloudWatchbreadcrumb arrow Переменные шаблонов
Последнее обновление: июня 23, 2026

Шаблонные переменные CloudWatch

Вместо жёсткого задания таких сведений, как имена серверов, приложений и датчиков, в запросах метрик вы можете использовать переменные. Grafana выводит эти переменные в раскрывающихся списках в верхней части дашборда, чтобы помочь вам изменять отображаемые на дашборде данные. Grafana называет такие переменные шаблонными переменными.

Введение в шаблонизацию и шаблонные переменные см. в разделах Templating и Добавление переменных и управление ими.

Использование переменных-запросов

Вы можете указать эти запросы к источнику данных CloudWatch в поле Query type представления редактирования переменной. Используйте их, чтобы заполнить список вариантов переменной значениями вроде regions, namespaces, metric names и dimension keys/values.

Имя Возвращаемый список
Regions Все регионы AWS.
Namespaces Все пространства имён, поддерживаемые CloudWatch.
Metrics Метрики в пространстве имён. (Укажите регион или используйте “default” для пользовательских метрик.)
Dimension Keys Ключи измерений в пространстве имён.
Dimension Values Значения измерений, соответствующие указанным region, namespace, metric и dimension key. Используйте filters по измерениям для более точных результатов.
EBS Volume IDs Идентификаторы томов, соответствующие указанным region и instance ID.
EC2 Instance Attributes Атрибуты, соответствующие указанным region, attribute name и filters.
Resource ARNs ARN, соответствующие указанным region, resource type и tags.
Statistics Все стандартные статистики.
Log Groups Группы логов, соответствующие указанным region и необязательному prefix группы логов. Значением переменной является ARN группы логов.
Accounts Идентификаторы связанных учётных записей мониторинга для указанного region. Доступно только когда включена наблюдаемость между учётными записями.

Когда включена наблюдаемость между учётными записями, типы запросов Metrics, Dimension Keys, Dimension Values и Log Groups также показывают необязательное поле Account. Используйте его, чтобы нацелиться на конкретную связанную учётную запись мониторинга, или оставьте незаданным, чтобы запрашивать все связанные учётные записи. Подробнее см. Наблюдаемость между учётными записями.

Подробности о доступных измерениях см. в справочнике по метрикам и измерениям CloudWatch.

Подробности о метриках, которые предоставляет CloudWatch, см. в документации CloudWatch.

Использование переменных в запросах

Используйте синтаксис переменных Grafana, чтобы включать переменные в запросы. Переменная-запрос динамически получает значения из вашего источника данных с помощью запроса. Подробности см. в документации по синтаксису переменных.

Запросы метрик CloudWatch поддерживают переменные в полях Region, Namespace, Metric name, а также в полях ключа измерения и значения измерения.

Например, если вы создадите переменную с именем region с типом запроса Regions и переменную с именем instance с типом запроса EC2 Instance Attributes, вы сможете ссылаться на них в запросе метрики, установив в редакторе запросов Region в $region, а значение измерения — в $instance. После этого дашборд будет обновляться при изменении выбранного региона и инстанса.

Запрос атрибутов инстанса EC2

Тип запроса EC2 Instance Attributes извлекает метаданные инстанса с помощью API AWS ec2:DescribeInstances. Настройте его с помощью следующих полей в редакторе переменных:

  • Region: регион AWS для запроса.
  • Attribute name: атрибут инстанса, возвращаемый для каждого соответствующего инстанса.
  • Filters: Необязательно. Фильтры, ограничивающие набор возвращаемых инстансов.

Note

Ранее использовавшийся синтаксис запроса ec2_instance_attribute(region, attributeName, filters) по-прежнему поддерживается. Grafana автоматически переносит существующие переменные, которые его используют, на тип запроса EC2 Instance Attributes.

Фильтры

Каждый фильтр состоит из ключа и списка соответствующих значений, разделённых запятыми. Используйте фильтры, поддерживаемые ec2:DescribeInstances, например свойства инстанса. Чтобы фильтровать по тегу, используйте ключ вида tag:<name>, например tag:Environment.

Выбор атрибутов

Запрос возвращает один атрибут на инстанс. Вы можете выбрать любой атрибут, который имеет единственное значение и не является объектом или массивом, — так называемый плоский атрибут. Эти атрибуты отражают поля объекта AWS EC2 Instance, где можно найти определение каждого из них. Поскольку доступные атрибуты отслеживают API AWS, следующий список может быть неполным:

  • AmiLaunchIndex
  • Architecture
  • ClientToken
  • EbsOptimized
  • EnaSupport
  • Hypervisor
  • ImageId
  • InstanceId
  • InstanceLifecycle
  • InstanceType
  • KernelId
  • KeyName
  • LaunchTime
  • Platform
  • PrivateDnsName
  • PrivateIpAddress
  • PublicDnsName
  • PublicIpAddress
  • RamdiskId
  • RootDeviceName
  • RootDeviceType
  • SourceDestCheck
  • SpotInstanceRequestId
  • SriovNetSupport
  • SubnetId
  • VirtualizationType
  • VpcId

Некоторые атрибуты являются объектами, а не плоскими значениями. Чтобы выбрать вложенное значение, используйте точечную нотацию, например IamInstanceProfile.Arn.

Чтобы выбрать значение тега, добавьте перед именем тега префикс Tags.. Например, выберите тег Name, используя Tags.Name.