Get-AzureWebsiteMetric

  • リファレンス
モジュール:
Azure

現在のサブスクリプションの 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 オブジェクトの配列を返します。