az monitor metrics

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

Команды

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

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

Основные сведения Общедоступная версия
az monitor metrics alert condition

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

Основные сведения Общедоступная версия
az monitor metrics alert condition create

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

Основные сведения Предварительный просмотр
az monitor metrics alert create

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

Основные сведения Общедоступная версия
az monitor metrics alert delete

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

Основные сведения Общедоступная версия
az monitor metrics alert dimension

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

Основные сведения Общедоступная версия
az monitor metrics alert dimension create

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

Основные сведения Предварительный просмотр
az monitor metrics alert list

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

Основные сведения Общедоступная версия
az monitor metrics alert show

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

Основные сведения Общедоступная версия
az monitor metrics alert update

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

Основные сведения Общедоступная версия
az monitor metrics list

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

Основные сведения Общедоступная версия
az monitor metrics list-definitions

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

Основные сведения Общедоступная версия
az monitor metrics list-namespaces

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

Основные сведения Предварительный просмотр
az monitor metrics list-sub

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

Основные сведения Общедоступная версия
az monitor metrics list-sub-definitions

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

Основные сведения Общедоступная версия

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

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

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

--aggregation

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

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

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

значение из: az monitor metrics list-definitions
--end-time

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

--filter

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

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

--interval

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

значение по умолчанию: 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 будет игнорироваться.

значение по умолчанию: 1h
--orderby

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

--resource-group -g

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

--resource-namespace

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

--resource-parent

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

--resource-type

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

--start-time

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

--top

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

значение по умолчанию: 10
Глобальные параметры
--debug

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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

az monitor metrics list-definitions

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

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

Примеры

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

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

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

--resource

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

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

--namespace

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

значение из: az monitor metrics list-namespaces
--resource-group -g

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

--resource-namespace

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

--resource-parent

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

--resource-type

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

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

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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

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

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

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

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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

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

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

--auto-adjust-timegrain

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

допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--filter

$filter используется для уменьшения набора возвращаемых данных метрик.
Пример:
Метрика содержит метаданные A, B и C.
— возвращает все временные ряды C, где A = a1 и B = b1 или b2
$filter=A eq 'a1' и B eq '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' и B eq 'b1' и C eq 'c1'
— возвращает все временные ряды, где A = a1
$filter=A eq 'a1' и Bq '' и C eq ''.

--interval

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

--metricnames

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

--metricnamespace

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

--order-by

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

--result-type

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

допустимые значения: Data, Metadata
--roll-up-by

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

--timespan

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

--top

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

--validate-dimensions

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

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

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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

az monitor metrics list-sub-definitions

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

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

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

--region

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

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

--metricnamespace

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

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

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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