Get-AzMetric

Модуль:: Az.Monitor Module

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

Синтаксис

GetWithDefaultParameters (по умолчанию)

Get-AzMetric
    [-ResourceId] <String>
    [[-MetricName] <String[]>]
    [-TimeGrain <TimeSpan>]
    [-StartTime <DateTime>]
    [-EndTime <DateTime>]
    [-MetricFilter <String>]
    [-Dimension <String[]>]
    [-DetailedOutput]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetWithFullParameters

Get-AzMetric
    [-ResourceId] <String>
    [-MetricName] <String[]>
    [-TimeGrain <TimeSpan>]
    [-AggregationType <AggregationType>]
    [-StartTime <DateTime>]
    [-EndTime <DateTime>]
    [-Top <Int32>]
    [-OrderBy <String>]
    [-MetricNamespace <String>]
    [-ResultType <ResultType>]
    [-MetricFilter <String>]
    [-Dimension <String[]>]
    [-DetailedOutput]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Описание

Командлет Get-AzMetric получает значения метрик для указанного ресурса.

Примеры

Пример 1. Получение метрики с сводными выходными данными

Get-AzMetric -ResourceId "/subscriptions/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3" -TimeGrain 00:01:00

Id         : /subscriptions/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3/providers/Microsoft.Insights/metrics/Requests
Name       :
                LocalizedValue : Requests
                Value          : Requests

Type       : Microsoft.Insights/metrics
Unit       : Count
Data       : {Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue, Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue,
             Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue, Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue…}
Timeseries : {Microsoft.Azure.Management.Monitor.Models.TimeSeriesElement}

Эта команда получает значения метрик для веб-сайта3 с интервалом времени в 1 минуту.

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

Get-AzMetric -ResourceId "/subscriptions/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3" -TimeGrain 00:01:00 -DetailedOutput

Id         : /subscriptions/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3/providers/Microsoft.Insights/metrics/Requests
Name       : Microsoft.Azure.Management.Monitor.Models.LocalizableString

Type       : Microsoft.Insights/metrics
Unit       : Count
Data       : {Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue, Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue,
             Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue, Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue…}
Timeseries : {Microsoft.Azure.Management.Monitor.Models.TimeSeriesElement}

Эта команда получает значения метрик для веб-сайта3 с интервалом времени в 1 минуту. Выходные данные подробно описаны.

Пример 3. Получение указанной метрики

Get-AzMetric -ResourceId "/subscriptions/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3" -MetricName "Requests" -TimeGrain 00:01:00

Id         : /subscriptions/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3/providers/Microsoft.Insights/metrics/Requests
Name       :
                LocalizedValue : Requests
                Value          : Requests

Type       : Microsoft.Insights/metrics
Unit       : Count
Data       : {Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue, Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue,
             Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue, Microsoft.Azure.Commands.Insights.OutputClasses.PSMetricValue…}
Timeseries : {Microsoft.Azure.Management.Monitor.Models.TimeSeriesElement}

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

Пример 4. Получение суммированных выходных данных для указанной метрики с указанным фильтром измерений

$dimFilter = "$(New-AzMetricFilter -Dimension City -Operator eq -Value "Seattle","Toronto") and $(New-AzMetricFilter -Dimension AuthenticationType -Operator eq -Value User)"

Get-AzMetric -ResourceId <ResourceId> -MetricName availabilityResults/availabilityPercentage -TimeGrain 00:05:00 -MetricFilter $dimFilter -StartTime 2024-07-02T00:00:00Z -EndTime 2024-07-02T00:10:00Z -AggregationType Average

Id         : [ResourceId]/providers/Microsoft.Insights/metrics/availabilityResults/availabilityPercentage
Name       :
                LocalizedValue : Availability
                Value          : availabilityResults/availabilityPercentage

Type       : Microsoft.Insights/metrics
Unit       : Percent
Data       :
Timeseries : {}

Эта команда получает суммированные выходные данные для метрики PageViews с указанным фильтром измерений и типом агрегирования.

Параметры

-AggregationType

Тип агрегирования запроса

Свойства параметра

Тип:	Nullable<T>[Microsoft.Azure.Management.Monitor.Models.AggregationType]
Default value:	None
Допустимые значения:	None, Average, Count, Minimum, Maximum, Total
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

GetWithFullParameters

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.

Свойства параметра

Тип:	IAzureContextContainer
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-DetailedOutput

Указывает, что этот командлет отображает подробные выходные данные. По умолчанию выходные данные суммируются.

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Dimension

Измерения метрик для запроса метрик

Свойства параметра

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-EndTime

Указывает время окончания запроса в локальном времени. Значение по умолчанию — текущее время.

Свойства параметра

Тип:	DateTime
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-MetricFilter

Указывает фильтр измерения метрик для запроса метрик.

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-MetricName

Задает массив имен метрик.

Свойства параметра

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	MetricNames

Наборы параметров

GetWithDefaultParameters

Position:	1
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-MetricNamespace

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

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

GetWithFullParameters

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-OrderBy

Указывает агрегирование, используемое для сортировки результатов и направление сортировки (пример: sum asc).

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

GetWithFullParameters

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-ResourceId

Указывает идентификатор ресурса метрики.

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	0
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-ResultType

Указывает тип результата, возвращаемый (метаданные или данные).

Свойства параметра

Тип:	Nullable<T>[Microsoft.Azure.Management.Monitor.Models.ResultType]
Default value:	None
Допустимые значения:	Data, Metadata
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

GetWithFullParameters

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-StartTime

Указывает время начала запроса в локальном времени. По умолчанию используется текущее локальное время минус один час.

Свойства параметра

Тип:	DateTime
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-TimeGrain

Задает интервал времени для метрики в виде объекта TimeSpan в формате hh:mm:ss.

Свойства параметра

Тип:	TimeSpan
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Top

Указывает максимальное количество записей для получения (по умолчанию:10), которое необходимо указать с помощью $filter.

Свойства параметра

Тип:	Nullable<T>[Int32]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

GetWithFullParameters

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Выходные данные

PSMetric

Примечания

Дополнительные сведения о поддерживаемых метриках можно найти по адресу: https://learn.microsoft.com/azure/azure-monitor/platform/metrics-supported

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

Get-AzMetric

Синтаксис

GetWithDefaultParameters (по умолчанию)

GetWithFullParameters

Описание

Примеры

Пример 1. Получение метрики с сводными выходными данными

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

Пример 3. Получение указанной метрики

Пример 4. Получение суммированных выходных данных для указанной метрики с указанным фильтром измерений

Параметры

-AggregationType

Свойства параметра

Наборы параметров

-DefaultProfile

Свойства параметра

Наборы параметров

-DetailedOutput

Свойства параметра

Наборы параметров

-Dimension

Свойства параметра

Наборы параметров

-EndTime

Свойства параметра

Наборы параметров

-MetricFilter

Свойства параметра

Наборы параметров

-MetricName

Свойства параметра

Наборы параметров

-MetricNamespace

Свойства параметра

Наборы параметров

-OrderBy

Свойства параметра

Наборы параметров

-ResourceId

Свойства параметра

Наборы параметров

-ResultType

Свойства параметра

Наборы параметров

-StartTime

Свойства параметра

Наборы параметров

-TimeGrain

Свойства параметра

Наборы параметров

-Top

Свойства параметра

Наборы параметров

CommonParameters

Входные данные

Выходные данные

Примечания

Связанные ссылки

Обратная связь