Share via


Get-AzureWebsiteMetric

現在のサブスクリプションの Azure Web サイトのメトリックを取得します。

注意

このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az PowerShell モジュールを参照してください。

構文

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

説明

このトピックでは、Microsoft Azure PowerShell モジュールの 0.8.10 バージョンのコマンドレットについて説明します。 使用しているモジュールのバージョンを取得するには、Azure PowerShell コンソールで「.」と入力します (Get-Module -Name Azure).Version

Get-AzureWebsiteMetric コマンドレットは、現在のサブスクリプションの Azure Web サイトのメトリックを取得します。

例 1: Web サイトのインスタンスごとのレベルで過去 3 時間のメトリックを取得する

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

このコマンドは、Web サイトのインスタンスごとのレベルで過去 3 時間のメトリックを取得します。

パラメーター

-EndDate

メトリックの取得を停止する時間を DateTime オブジェクトとして指定します。 DateTime オブジェクトを取得するには、Get-Date コマンドレットを使用します。 詳細を表示するには「Get-Help Get-Date」を入力します。

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-InstanceDetails

このコマンドレットにインスタンスごとのレベルの詳細が含まれていることを示します。 Web ホスティング プランが 2 台以上のコンピューターで実行されている場合、このコマンドレットは各コンピューターのメトリックを返します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MetricNames

取得するメトリックの配列を指定します。 このパラメーターを指定しない場合、コマンドレットはすべてのメトリックを取得します。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

サブスクリプション内の Web サイトの名前を指定します。 このパラメーターはワイルドカード文字をサポートしていません。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Profile

このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Slot

クラウド サービスのデプロイの環境を指定します。 有効な値は、運用とステージングです。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SlotView

このコマンドレットは、現在のスロットでトラフィックを受信するホスト名のメトリックを取得することを示します。 期間中にスワップが発生した場合、メトリックはマージされます。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StartDate

メトリックの取得を開始する時間を DateTime オブジェクトとして指定します。

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TimeGrain

メトリックの時間単位を指定します。 有効な値は次のとおりです。

  • PT1M (分)
  • PT1H (時間)
  • P1D (日)

既定値は PT1H です。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

入力

このコマンドレットにはプロパティ名で入力を渡すことができますが、値による渡しはできません。

出力

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

既定では、Get-AzureWebsiteMetric は MetricResponse オブジェクトの配列を返します。