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 オブジェクトの配列を返します。