Get-AzureWebsiteMetric
現在のサブスクリプションの Azure Web サイトのメトリックを取得します。
Note
このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用するレガシ Azure リソースを管理するためのものです。 ASM の廃止が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、「Azure Service Manager の廃止」を参照してください。
Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するための推奨される 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
」を入力します。
型: | DateTime |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-InstanceDetails
このコマンドレットにインスタンスごとのレベルの詳細が含まれていることを示します。 Web ホスティング プランが 2 台以上のコンピューターで実行されている場合、このコマンドレットは各コンピューターのメトリックを返します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-MetricNames
取得するメトリックの配列を指定します。 このパラメーターを指定しない場合、コマンドレットはすべてのメトリックを取得します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Name
サブスクリプション内の Web サイトの名前を指定します。 このパラメーターはワイルドカード文字をサポートしていません。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
型: | AzureSMProfile |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Slot
クラウド サービスのデプロイの環境を指定します。 有効な値は、運用とステージングです。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-SlotView
このコマンドレットは、現在のスロットでトラフィックを受信するホスト名のメトリックを取得することを示します。 期間中にスワップが発生した場合、メトリックはマージされます。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-StartDate
メトリックの取得を開始する時間を DateTime オブジェクトとして指定します。
型: | DateTime |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-TimeGrain
メトリックの時間単位を指定します。 有効な値は次のとおりです。
- PT1M (分)
- PT1H (時間)
- P1D (日)
既定値は PT1H です。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
入力
このコマンドレットにはプロパティ名で入力を渡すことができますが、値による渡しはできません。
出力
Microsoft.WindowsAzure.Commands.Utilities.Websites.Services.WebEntities.MetricResponse
既定では、Get-AzureWebsiteMetric は MetricResponse オブジェクトの配列を返します。