Partilhar via

Get-AzureWebsiteMetric

  • Referência
Módulo:
Azure

Obtém métricas para o site do Azure na assinatura atual.

Nota

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Syntax

Get-AzureWebsiteMetric
   [-MetricNames <String[]>]
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-TimeGrain <String>]
   [-InstanceDetails]
   [-SlotView]
   [-Name <String>]
   [-Slot <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

Este tópico descreve o cmdlet na versão 0.8.10 do módulo PowerShell do Microsoft Azure. Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.

O cmdlet Get-AzureWebsiteMetric obtém métricas para o site do Azure na assinatura atual.

Exemplos

Exemplo 1: Obter métricas das últimas três horas em um nível por instância para um site

PS C:\> Get-AzureWebsiteMetric -Name "ContosoWebSite" -StartDate (get-date).AddHours(-3) -MetricNames "Requests" -InstanceDetails -SlotView -TimeGrain "PT1M" 
PS C:\> $metrics[1].Data Name : Requests 

Unit : Count 

StartTime : 8/11/2014 7:05:00 AM 

EndTime : 8/11/2014 5:06:01 PM 

TimeGrain : PT1M 
PrimaryAggregationType : Instance 
Values : {Time:8/11/2014 7:05:00 AM, Total:4, Min:, Max:, Time:8/11/2014 7:06:00 AM, Total:3, Min:, Max:, 
Time:8/11/2014 7:07:00 AM, Total:3, Min:, Max:, Time:8/11/2014 7:08:00 AM, Total:12, Min:, Max:...} 
$metrics[1].Data.Values | ft 
TimeCreated Total Minimum Maximum Count InstanceName 
----------- ----- ------- ------- ----- ------------ 
8/11/2014 7:05:00 AM 4 1 RD00155DC24599 
8/11/2014 7:06:00 AM 3 1 RD00155DC24599 
8/11/2014 7:07:00 AM 3 1 RD00155DC24589 
8/11/2014 7:08:00 AM 12 1 RD00155DC24599
8/11/2014 7:09:00 AM 37 1 RD00155DC24599 
8/11/2014 7:10:00 AM 9 1 RD00155DC24599

Este comando obtém métricas das últimas três horas em um nível por instância para um site.

Parâmetros

-EndDate

Especifica a hora, como um objeto DateTime , para parar de obter métricas. Para obter um objeto DateTime , use o cmdlet Get-Date . Para obter mais informações, digite Get-Help Get-Date.

Tipo:DateTime
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:True
Accept wildcard characters:False

-InstanceDetails

Indica que esse cmdlet inclui detalhes em um nível por instância. Se o plano de hospedagem na Web for executado em dois ou mais computadores, esse cmdlet retornará métricas para cada computador.

Tipo:SwitchParameter
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:True
Accept wildcard characters:False

-MetricNames

Especifica uma matriz de métricas a serem obtidas. Se você não especificar esse parâmetro, o cmdlet obterá todas as métricas.

Tipo:String[]
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica o nome de um site na assinatura. Este parâmetro não suporta caracteres curinga.

Tipo:String
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:True
Accept wildcard characters:False

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet é lido. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

Tipo:AzureSMProfile
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-Slot

Especifica o ambiente de uma implantação de serviço de nuvem. Os valores válidos são: Produção e Preparação.

Tipo:String
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:True
Accept wildcard characters:False

-SlotView

Indica que esse cmdlet obtém métricas para os nomes de host que recebem tráfego no slot atual. Se ocorrer uma troca durante o período de tempo, as métricas serão mescladas.

Tipo:SwitchParameter
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:True
Accept wildcard characters:False

-StartDate

Especifica a hora, como um objeto DateTime , para começar a obter métricas.

Tipo:DateTime
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:True
Accept wildcard characters:False

-TimeGrain

Especifica a unidade de tempo para métricas. Os valores válidos são:

  • PT1M (Minuto)
  • PT1H (Hora)
  • P1D (Dia)

O valor padrão é PT1H.

Tipo:String
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:True
Accept wildcard characters:False

Entradas

Você pode passar a entrada para esse cmdlet pelo nome da propriedade, mas não pelo valor.

Saídas

Microsoft.WindowsAzure.Commands.Utilities.Websites.Services.WebEntities.MetricResponse

Por padrão, Get-AzureWebsiteMetric retorna uma matriz de objetos MetricResponse .