Поделиться через

az monitor metrics

Просмотр метрик ресурсов Azure.

Команды

Имя Описание Тип Состояние
az monitor metrics alert

Управление правилами оповещений метрик почти в реальном времени.

 Core GA
az monitor metrics alert condition

Управление условиями правила генерации оповещений о метриках почти в реальном времени.

 Core GA
az monitor metrics alert condition create

Создайте условие правила генерации оповещений метрик.

 Core Preview
az monitor metrics alert create

Создайте правило генерации оповещений на основе метрик.

 Core GA
az monitor metrics alert delete

Удалите правило генерации оповещений на основе метрик.

 Core GA
az monitor metrics alert dimension

Управление измерениями правил генерации оповещений о метриках почти в реальном времени.

 Core GA
az monitor metrics alert dimension create

Создание измерения правила генерации оповещений метрик.

 Core Preview
az monitor metrics alert list

Список правил генерации оповещений на основе метрик.

 Core GA
az monitor metrics alert show

Отображение правила генерации оповещений на основе метрик.

 Core GA
az monitor metrics alert update

Обновите правило генерации оповещений на основе метрик.

 Core GA
az monitor metrics list

Вывод списка значений метрик для ресурса.

 Core GA
az monitor metrics list-definitions

Список определений метрик для ресурса.

 Core GA
az monitor metrics list-namespaces

Список пространств имен метрик для ресурса.

 Core Preview
az monitor metrics list-sub

Выводит данные метрик для подписки. Параметры можно указать в тексте.

 Core GA
az monitor metrics list-sub-definitions

Список определений метрик для подписки.

 Core GA

az monitor metrics list

Изменить

Вывод списка значений метрик для ресурса.

az monitor metrics list --resource
                        [--aggregation {Average, Count, Maximum, Minimum, None, Total}]
                        [--dimension]
                        [--end-time]
                        [--filter]
                        [--interval]
                        [--metadata]
                        [--metrics]
                        [--namespace]
                        [--offset]
                        [--orderby]
                        [--resource-group]
                        [--resource-namespace]
                        [--resource-parent]
                        [--resource-type]
                        [--start-time]
                        [--top]

Примеры

Перечисление использования ЦП виртуальной машины за последний час

az monitor metrics list --resource {ResourceName} --metric "Percentage CPU"

Вывод списка задержки E2E учетной записи хранения и разделения ряда данных на основе имени API

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --dimension ApiName

Вывод списка задержки E2E учетной записи хранения и разделения ряда данных на основе имени API и географического типа

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --dimension ApiName GeoType

Вывод списка задержки E2E учетной записи хранения и разделения ряда данных на основе имени API и географического типа с помощью параметра --filter

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --filter "ApiName eq '*' and GeoType eq '*'"

Вывод списка задержки успешного выполнения E2E учетной записи хранения и разделения ряда данных на основе имени API и географического типа. Ограничивает имя API "DeleteContainer"

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --filter "ApiName eq 'DeleteContainer' and GeoType eq '*'"

Вывод списка транзакций учетной записи хранения в день с 2017-01-01

az monitor metrics list --resource {ResourceName} --metric Transactions \
                        --start-time 2017-01-01T00:00:00Z \
                        --interval PT24H

Список значений метаданных для учетной записи хранения в измерении имени API метрик транзакций с 2017 г.

az monitor metrics list --resource {ResourceName} --metric Transactions \
                        --filter "ApiName eq '*'" \
                        --start-time 2017-01-01T00:00:00Z

Обязательные параметры

--resource

Имя или идентификатор целевого ресурса.

Свойство Значение
Группа параметров: Target Resource Arguments

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--aggregation

Список типов агрегирования (разделенных пробелами) для извлечения.

Свойство Значение
Допустимые значения: Average, Count, Maximum, Minimum, None, Total
Значение из: az monitor metrics list-definitions
--dimension

Список измерений (разделенных пробелами) метрики запрашиваются.

Свойство Значение
Значение из: az monitor metrics list-definitions
--end-time

Время завершения выполнения запроса. По умолчанию используется текущее время. Формат: дата (гггг-mm-dd) часовой пояс (hh:mm:ss.xxxxx) (+/-hh:mm).

Свойство Значение
Группа параметров: Time Arguments
--filter

Строка, используемая для уменьшения набора возвращаемых данных метрик. eg. "BlobType eq '*'".

Полный список фильтров см. в справочнике по строке фильтра по https://learn.microsoft.com/rest/api/monitor/metrics/list.

--interval

Интервал, по которому следует агрегировать метрики в формате ##h##m.

Свойство Значение
Группа параметров: Time Arguments
Default value: 1m
--metadata

Возвращает значения метаданных вместо данных метрик.

--metrics

Список имен метрик, разделенных пробелами для получения.

Свойство Значение
Значение из: az monitor metrics list-definitions
--namespace

Пространство имен для запроса определений метрик.

Свойство Значение
Значение из: az monitor metrics list-namespaces
--offset

Смещение времени диапазона запросов в формате ##d##h.

Можно использовать с параметром --start-time или --end-time. Если используется с --start-time, то время окончания будет вычисляться путем добавления смещения. Если используется с --end-time (по умолчанию), время начала вычисляется путем вычитания смещения. Если задано время --start-time и --end-time, то --offset будет игнорироваться.

Свойство Значение
Группа параметров: Time Arguments
Default value: 1h
--orderby

Агрегирование, используемое для сортировки результатов и направления сортировки. Можно указать только один заказ. Примеры: sum asc.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Свойство Значение
Группа параметров: Target Resource Arguments
--resource-namespace

Целевое пространство имен поставщика ресурсов.

Свойство Значение
Группа параметров: Target Resource Arguments
--resource-parent

Целевой родительский путь к ресурсу, если применимо.

Свойство Значение
Группа параметров: Target Resource Arguments
--resource-type

Целевой тип ресурса. Также может принимать формат пространства имен и типа (например, Microsoft.Compute/virtualMachines).

Свойство Значение
Группа параметров: Target Resource Arguments
--start-time

Время начала выполнения запроса. Формат: дата (гггг-mm-dd) часовой пояс (hh:mm:ss.xxxxx) (+/-hh:mm).

Свойство Значение
Группа параметров: Time Arguments
--top

Максимальное количество записей для получения.

Свойство Значение
Default value: 10
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az monitor metrics list-definitions

Изменить

Список определений метрик для ресурса.

az monitor metrics list-definitions --resource
                                    [--namespace]
                                    [--resource-group]
                                    [--resource-namespace]
                                    [--resource-parent]
                                    [--resource-type]

Примеры

Список определений метрик для ресурса. (autogenerated)

az monitor metrics list-definitions --resource /subscriptions/{subscriptionID}/resourceGroups/{resourceGroup}/Microsoft.Network/networkSecurityGroups/{resourceName}

Обязательные параметры

--resource

Имя или идентификатор целевого ресурса.

Свойство Значение
Группа параметров: Target Resource Arguments

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--namespace

Пространство имен для запроса определений метрик.

Свойство Значение
Значение из: az monitor metrics list-namespaces
--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Свойство Значение
Группа параметров: Target Resource Arguments
--resource-namespace

Целевое пространство имен поставщика ресурсов.

Свойство Значение
Группа параметров: Target Resource Arguments
--resource-parent

Целевой родительский путь к ресурсу, если применимо.

Свойство Значение
Группа параметров: Target Resource Arguments
--resource-type

Целевой тип ресурса. Также может принимать формат пространства имен и типа (например, Microsoft.Compute/virtualMachines).

Свойство Значение
Группа параметров: Target Resource Arguments
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az monitor metrics list-namespaces

Изменить
Предварительный просмотр

Эта команда находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Список пространств имен метрик для ресурса.

az monitor metrics list-namespaces --resource-uri
                                   [--start-time]

Примеры

Список пространств имен метрик для ресурса.

az monitor metrics list-namespaces --resource /subscriptions/{subscriptionID}/resourceGroups/{resourceGroup}/Microsoft.Network/networkSecurityGroups/{resourceName} --start-time 2021-03-01T00:00:00Z

Обязательные параметры

--resource-uri

Идентификатор ресурса.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--start-time

Время начала выполнения запроса. Формат: дата (гггг-mm-dd) часовой пояс (hh:mm:ss.xxxxx) (+/-hh:mm).

Свойство Значение
Группа параметров: Time Arguments
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az monitor metrics list-sub

Изменить

Выводит данные метрик для подписки. Параметры можно указать в тексте.

az monitor metrics list-sub --region
                            [--aggregation]
                            [--auto-adjust-timegrain {0, 1, f, false, n, no, t, true, y, yes}]
                            [--filter]
                            [--interval]
                            [--metricnames]
                            [--metricnamespace]
                            [--order-by]
                            [--result-type {Data, Metadata}]
                            [--roll-up-by]
                            [--timespan]
                            [--top]
                            [--validate-dimensions {0, 1, f, false, n, no, t, true, y, yes}]

Обязательные параметры

--region

Регион, в котором находятся метрики.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--aggregation

Список типов агрегирования (разделенных запятыми) для извлечения.

Свойство Значение
Группа параметров: Body Arguments
--auto-adjust-timegrain

Если задано значение true, если интервал времени, переданный этой метрикой, не поддерживается этой метрикой, API вернет результат с помощью ближайшего поддерживаемого интервала времени. Если задано значение false, возвращается ошибка для недопустимых параметров интервала времени. По умолчанию false.

Свойство Значение
Группа параметров: Body Arguments
Допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--filter

$filter используется для уменьшения набора возвращаемых данных метрик.
Example:
Метрика содержит метаданные A, B и C.
— возвращает все временные ряды C, где A = a1 и B = b1 или b2
$filter=A eq 'a1' и Bq 'b1' или Bq 'b2' и C eq '*'
— недопустимый вариант:
$filter=A eq 'a1' и Bq 'b1' и C eq '*' или B = 'b2'
Это недопустимо, так как логический или оператор не может разделить два разных имена метаданных.
— возвращает все временные ряды, где A = a1, B = b1 и C = c1:
$filter=A eq 'a1' и Bq 'b1' и C eq 'c1'
— возвращает все временные ряды, где A = a1
$filter=A eq 'a1' и B eq '' и C eq ''.

Свойство Значение
Группа параметров: Body Arguments
--interval

Интервал (т. е. timegrain) запроса в формате длительности ISO 8601. По умолчанию используется PT1M. Особый случай для значения FULL, возвращающего единую точку данных для всего запрошенного периода времени. Примеры: PT15M, PT1H, P1D, FULL.

Свойство Значение
Группа параметров: Body Arguments
--metricnames

Имена метрик (разделенные запятыми) для извлечения.

Свойство Значение
Группа параметров: Body Arguments
--metricnamespace

Пространство имен метрик, в котором находятся метрики.

Свойство Значение
Группа параметров: Body Arguments
--order-by

Агрегирование, используемое для сортировки результатов и направления сортировки. Можно указать только один заказ. Примеры: sum asc.

Свойство Значение
Группа параметров: Body Arguments
--result-type

Уменьшает набор собранных данных. Допустимый синтаксис зависит от операции. Дополнительные сведения см. в описании операции.

Свойство Значение
Группа параметров: Body Arguments
Допустимые значения: Data, Metadata
--roll-up-by

Имена измерений для свертки результатов. Например, если вы хотите просмотреть только значения метрик с фильтром, например City eq Seattle или City eq Tacoma, но не хотите видеть отдельные значения для каждого города, можно указать RollUpBy=City, чтобы просмотреть результаты для Сиэтла и Tacoma, свернутые в один раз.

Свойство Значение
Группа параметров: Body Arguments
--timespan

Интервал времени запроса. Это строка со следующим форматом "startDateTime_ISO/endDateTime_ISO".

Свойство Значение
Группа параметров: Body Arguments
--top

Максимальное количество записей для получения. Допустимо только в том случае, если указан $filter. Значение по умолчанию равно 10.

Свойство Значение
Группа параметров: Body Arguments
--validate-dimensions

Если задано значение false, недопустимые значения параметров фильтра будут игнорироваться. Если задано значение true, возвращается ошибка для недопустимых параметров фильтра. По умолчанию используется значение true.

Свойство Значение
Группа параметров: Body Arguments
Допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az monitor metrics list-sub-definitions

Изменить

Список определений метрик для подписки.

az monitor metrics list-sub-definitions --region
                                        [--metricnamespace]

Обязательные параметры

--region

Регион, в котором находятся метрики.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--metricnamespace

Пространство имен метрик, в котором находятся метрики.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False