Export-AzLogAnalyticRequestRateByInterval

  • リファレンス
モジュール:
Az.Compute

特定の時間枠でこのサブスクリプションによって行われた API 要求を示すログをエクスポートして、調整アクティビティを表示します。

構文

Export-AzLogAnalyticRequestRateByInterval
      [-Location] <String>
      [-FromTime] <DateTime>
      [-ToTime] <DateTime>
      [-BlobContainerSasUri] <String>
      [-IntervalLength] <IntervalInMins>
      [-GroupByOperationName]
      [-GroupByResourceName]
      [-GroupByThrottlePolicy]
      [-GroupByApplicationId]
      [-GroupByUserAgent]
      [-AsJob]
      [-NoWait]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

定義済みの時間間隔で、サブスクリプションの Microsoft.Compute API の呼び出しに関する統計データを、成功、失敗、または調整済み状態別にエクスポートします。 ログは、GroupByOperationName、GroupByThrottlePolicy、GroupByResourceName、GroupByUserAgent、または GroupByApplicationId の 5 つのパラメーターでさらにグループ化できます。 このコマンドレットでは、コンピューティング リソース プロバイダーのログのみが収集されることに注意してください。さらに、ディスクとスナップショットのリソースの種類に関するデータはまだ使用できません。

コンピューティング リソース プロバイダーの API 調整の概要については、次を参照してください https://learn.microsoft.com/azure/azure-resource-manager/resource-manager-request-limits。

例

例 1: 操作名で集計されたレコードをエクスポートする

Export-AzLogAnalyticRequestRateByInterval -Location 'West Central US' -FromTime '2018-02-20T17:54:14.8806951-08:00' -ToTime '2018-02-22T17:54:17.5832413-08:00' -BlobContainerSasUri 'https://wkuotest1.blob.core.windows.net/mylogs?someSasUri' -IntervalLength ThirtyMins -GroupByOperationName

This command downloads a .csv file to the provided container. The format of the file is:

TIMESTAMP             operationName   TotalRequests SuccessfulRequests ThrottledRequests
---------             -------------   ------------- ------------------ -----------------
2/21/2018  7:00:00 PM <operationName> 10            10                 0
2/21/2018  7:30:00 PM <operationName> 8             8                  0
2/21/2018  9:00:00 PM <operationName> 9             9                  0

このコマンドは、2018-02-20T17:54:14 から 2018-02-22T17:54:17 までの間に成功、失敗、または調整された Microsoft.Compute API 呼び出しの集計された数を、操作名で集計された特定の SAS URI に格納します。

例 2: アプリケーション ID で集計されたレコードをエクスポートする

Export-AzLogAnalyticRequestRateByInterval -Location 'West Central US' -FromTime '2018-02-20T17:54:14.8806951-08:00' -ToTime '2018-02-22T17:54:17.5832413-08:00' -BlobContainerSasUri 'https://wkuotest1.blob.core.windows.net/mylogs?someSasUri' -IntervalLength ThirtyMins -GroupByApplicationId

This command downloads a .csv file to the provided container. The format of the file is:

TIMESTAMP             clientApplicationId   TotalRequests SuccessfulRequests ThrottledRequests
---------             -------------------   ------------- ------------------ -----------------
2/21/2018  7:00:00 PM <clientApplicationId> 10            10                 0
2/21/2018  7:30:00 PM <clientApplicationId> 8             8                  0
2/21/2018  9:00:00 PM <clientApplicationId> 9             9                  0

このコマンドは、2018-02-20T17:54:14 から 2018-02-22T17:54:17 の間に成功、失敗、または調整された Microsoft.Compute API 呼び出しの集計された数を、アプリケーション ID で集計された特定の SAS URI に格納します。

例 3: ユーザー エージェントによって集計されたレコードをエクスポートする

Export-AzLogAnalyticRequestRateByInterval -Location 'West Central US' -FromTime '2018-02-20T17:54:14.8806951-08:00' -ToTime '2018-02-22T17:54:17.5832413-08:00' -BlobContainerSasUri 'https://wkuotest1.blob.core.windows.net/mylogs?someSasUri' -IntervalLength ThirtyMins -GroupByUserAgent

This command downloads a .csv file to the provided container. The format of the file is:

TIMESTAMP             userAgent   TotalRequests SuccessfulRequests ThrottledRequests
---------             ---------   ------------- ------------------ -----------------
2/21/2018  7:00:00 PM <userAgent> 10            10                 0
2/21/2018  7:30:00 PM <userAgent> 8             8                  0
2/21/2018  9:00:00 PM <userAgent> 9             9                  0

このコマンドは、2018-02-20T17:54:14 から 2018-02-22T17:54:17 までの間に成功、失敗、または調整された Microsoft.Compute API 呼び出しの集計された数を、ユーザー エージェントによって集計された特定の SAS URI に格納します。

パラメーター

-AsJob

バックグラウンドでコマンドレットを実行する

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

-BlobContainerSasUri

LogAnalytics Api が出力ログを書き込むログ BLOB コンテナーの SAS URI。

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

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FromTime

クエリの時刻から

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

-GroupByApplicationId

アプリケーション ID でクエリ結果をグループ化します。

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

-GroupByOperationName

操作名でクエリ結果をグループ化します。

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

-GroupByResourceName

リソース名でクエリ結果をグループ化します。

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

-GroupByThrottlePolicy

スロットル ポリシーを適用してクエリ結果をグループ化します。

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

-GroupByUserAgent

UserAgent でクエリ結果をグループ化します。

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

-IntervalLength

LogAnalytics 呼び出しレート ログの作成に使用される間隔の値 (分)。

Type:IntervalInMins
Accepted values:ThreeMins, FiveMins, ThirtyMins, SixtyMins
Position:4
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Location

ログ分析のクエリを実行する場所。

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

-NoWait

操作を開始し、操作が完了する直前に戻ります。 操作が正常に完了したかどうかを判断するには、他のメカニズムを使用します。

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

-ToTime

クエリの時刻

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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

入力

String

出力

PSLogAnalyticsOperationResult