Get-AzureRmMetric
Возвращает значения метрик ресурса.
Предупреждение
Модуль AzureRM PowerShell официально устарел с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.
Хотя модуль AzureRM по-прежнему может функционировать, он больше не поддерживается или не поддерживается, размещая любое постоянное использование на усмотрение и риск пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.
Синтаксис
Get-AzureRmMetric
[-ResourceId] <String>
[-TimeGrain <TimeSpan>]
[-StartTime <DateTime>]
[-EndTime <DateTime>]
[[-MetricName] <String[]>]
[-DetailedOutput]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzureRmMetric
[-ResourceId] <String>
[-TimeGrain <TimeSpan>]
[-AggregationType <AggregationType>]
[-StartTime <DateTime>]
[-EndTime <DateTime>]
[-Top <Int32>]
[-OrderBy <String>]
[-MetricNamespace <String>]
[-ResultType <ResultType>]
[-MetricFilter <String>]
[-MetricName] <String[]>
[-DetailedOutput]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Описание
Командлет Get-AzureRmMetric получает значения метрик для указанного ресурса.
Примеры
Пример 1. Получение метрики с сводными выходными данными
PS C:\>Get-AzureRmMetric -ResourceId "/subscriptions/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3" -TimeGrain 00:01:00
DimensionName :
DimensionValue :
Name : AverageResponseTime
EndTime : 3/20/2015 6:40:46 PM
MetricValues : {Microsoft.Azure.Insights.Models.MetricValue, Microsoft.Azure.Insights.Models.MetricValue,
Microsoft.Azure.Insights.Models.MetricValue, Microsoft.Azure.Insights.Models.MetricValue...}
Properties : {}
ResourceId : /subscriptions/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3
StartTime : 3/20/2015 5:40:00 PM
TimeGrain : 00:01:00
Unit : Seconds
DimensionName :
DimensionValue :
Name : AverageMemoryWorkingSet
EndTime : 3/20/2015 6:40:46 PM
MetricValues : {Microsoft.Azure.Insights.Models.MetricValue, Microsoft.Azure.Insights.Models.MetricValue,
Microsoft.Azure.Insights.Models.MetricValue, Microsoft.Azure.Insights.Models.MetricValue...}
Properties : {}
ResourceId : /subscriptions/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3
StartTime : 3/20/2015 5:40:00 PM
TimeGrain : 00:01:00
Unit : Bytes
Эта команда получает значения метрик для веб-сайта3 с интервалом времени в 1 минуту.
Пример 2. Получение метрики с подробными выходными данными
PS C:\>Get-AzureRmMetric -ResourceId "/subscriptions/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3" -TimeGrain 00:01:00 -DetailedOutput
MetricValues :
Average : 0
Count : 1
Last :
Maximum :
Minimum :
Properties :
Timestamp : 3/20/2015 6:37:00 PM
Total : 0
Average : 0.106
Count : 1
Last :
Maximum :
Minimum :
Properties :
Timestamp : 3/20/2015 6:39:00 PM
Total : 0.106
Average : 0.064
Count : 1
Last :
Maximum :
Minimum :
Properties :
Timestamp : 3/20/2015 6:41:00 PM
Total : 0.064
Properties :
DimensionName :
DimensionValue :
Name : AverageResponseTime
EndTime : 3/20/2015 6:43:33 PM
ResourceId : /subscriptions/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3
StartTime : 3/20/2015 5:43:00 PM
TimeGrain : 00:01:00
Unit : Seconds
Эта команда получает значения метрик для веб-сайта3 с интервалом времени в 1 минуту. Выходные данные подробно описаны.
Пример 3. Получение подробных выходных данных для указанной метрики
PS C:\>Get-AzureRmMetric -ResourceId "/subscriptions/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3" -MetricNames "Requests" -TimeGrain 00:01:00 -DetailedOutput
MetricValues :
Average : 1
Count : 1
Last :
Maximum :
Minimum :
Properties :
Timestamp : 3/20/2015 6:39:00 PM
Total : 1
Average : 1
Count : 1
Last :
Maximum :
Minimum :
Properties :
Timestamp : 3/20/2015 6:41:00 PM
Total : 1
Average : 0
Count : 1
Last :
Maximum :
Minimum :
Properties :
Timestamp : 3/20/2015 6:43:00 PM
Total : 0
Average : 1
Count : 1
Last :
Maximum :
Minimum :
Properties :
Timestamp : 3/20/2015 6:44:00 PM
Total : 1
Average : 0
Count : 1
Last :
Maximum :
Minimum :
Properties :
Timestamp : 3/20/2015 6:45:00 PM
Total : 0
Properties :
DimensionName :
DimensionValue :
Name : Requests
EndTime : 3/20/2015 6:47:56 PM
ResourceId : /subscriptions/e3f5b07d-3c39-4b0f-bf3b-40fdeba10f2a/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/website3
StartTime : 3/20/2015 5:47:00 PM
TimeGrain : 00:01:00
Unit : Count
Эта команда получает подробные выходные данные для метрики запросов.
Пример 4. Получение суммированных выходных данных для указанной метрики с указанным фильтром измерений
PS C:\> $dimFilter = @((New-AzureRmMetricFilter -Dimension City -Operator eq -Values "Seattle","Toronto"), (New-AzureRmMetricDimensionFilter -Dimension AuthenticationType -Operator eq -Values User))
PS C:\> Get-AzureRmMetricValues -ResourceId <resourcId> -MetricName PageViews -TimeGrain PT5M -MetricFilter $dimFilter -StartTime 2018-02-01T12:00:00Z -EndTime 2018-02-01T12:10:00Z -AggregationType -Average
ResourceId : [ResourceId]
MetricNamespace : Microsoft.Insights/ApplicationInsights
Metric Name :
LocalizedValue : Page Views
Value : PageViews
Unit : Seconds
Timeseries :
City : Seattle
AuthenticationType : User
Timestamp : 2018-02-01 12:00:00 PM
Average : 3518
Timestamp : 2018-02-01 12:05:00 PM
Average : 1984
City : Toronto
AuthenticationType : User
Timestamp : 2018-02-01 12:00:00 PM
Average : 894
Timestamp : 2018-02-01 12:05:00 PM
Average : 967
Эта команда получает суммированные выходные данные для метрики PageViews с указанным фильтром димезии и типом агрегирования.
Параметры
-AggregationType
Тип агрегирования запроса
Тип: | Nullable<T>[AggregationType] |
Допустимые значения: | None, Average, Count, Minimum, Maximum, Total |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.
Тип: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DetailedOutput
Указывает, что этот командлет отображает подробные выходные данные. По умолчанию выходные данные суммируются.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-EndTime
Указывает время окончания запроса в локальном времени. Значение по умолчанию — текущее время.
Тип: | DateTime |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-MetricFilter
Указывает фильтр измерения метрик для запроса метрик.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-MetricName
Задает массив имен метрик.
Тип: | String[] |
Aliases: | MetricNames |
Position: | 1 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-MetricNamespace
Указывает пространство имен метрик для запроса метрик.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-OrderBy
Указывает агрегирование, используемое для сортировки результатов и направление сортировки (пример: sum asc).
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-ResourceId
Указывает идентификатор ресурса метрики.
Тип: | String |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-ResultType
Указывает тип результата, возвращаемый (метаданные или данные).
Тип: | Nullable<T>[ResultType] |
Допустимые значения: | Data, Metadata |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-StartTime
Указывает время начала запроса в локальном времени. По умолчанию используется текущее локальное время минус один час.
Тип: | DateTime |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-TimeGrain
Задает интервал времени для метрики в виде объекта TimeSpan в формате hh:mm:ss.
Тип: | TimeSpan |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Top
Указывает максимальное количество записей для получения (по умолчанию:10), которое необходимо указать с помощью $filter.
Тип: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
Входные данные
Nullable<T>[[Microsoft.Azure.Management.Monitor.Models.AggregationType, Microsoft.Azure.Management.Monitor, Version=0.19.1.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]
Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
Nullable<T>[[Microsoft.Azure.Management.Monitor.Models.ResultType, Microsoft.Azure.Management.Monitor, Version=0.19.1.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]
String[]