共用方式為


Export-AzLogAnalyticRequestRateByInterval

匯出記錄,此訂用帳戶會在指定的時間範圍中顯示此訂用帳戶提出的 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>]

Description

在預先定義的時間間隔中,導出訂用帳戶呼叫 Microsoft.Compute API 的統計數據,其為成功、失敗或節流狀態。 記錄可以依五個參數進一步分組:GroupByOperationName、GroupByThrottlePolicy、GroupByResourceName、GroupByUserAgent 或 GroupByApplicationId。 請注意,此 Cmdlet 只會收集計算資源提供者記錄;此外,磁碟和快照集資源類型的相關數據尚無法使用。

如需計算資源提供者 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:22T17:54:17 之間,以成功、失敗或節流分隔的計算 API 呼叫 Microsoft總數,並依作業名稱匯總。

範例 2:匯出依應用程式標識碼匯總的記錄

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 呼叫總數。

範例 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:22T17:54:17 之間,以成功、失敗或節流分隔的計算 API 呼叫 Microsoft總數,由使用者代理程式匯總。

參數

-AsJob

在背景執行 Cmdlet

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-BlobContainerSasUri

LogAnalytics Api 將輸出記錄寫入其中之記錄 Blob 容器的 SAS URI。

類型:String
Position:3
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:IAzureContextContainer
別名:AzContext, AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-FromTime

查詢的時間

類型:DateTime
Position:1
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-GroupByApplicationId

依應用程式識別碼將查詢結果分組。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-GroupByOperationName

依作業名稱將查詢結果分組。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-GroupByResourceName

依資源名稱將查詢結果分組。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-GroupByThrottlePolicy

套用節流原則的群組查詢結果。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-GroupByUserAgent

依 UserAgent 將查詢結果分組。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-IntervalLength

用來建立LogAnalytics呼叫速率記錄的分鐘間隔值。

類型:IntervalInMins
接受的值:ThreeMins, FiveMins, ThirtyMins, SixtyMins
Position:4
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Location

查詢記錄分析的位置。

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-NoWait

啟動作業,並在作業完成之前立即傳回。 若要判斷作業是否已順利完成,請使用一些其他機制。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ToTime

查詢的時間

類型:DateTime
Position:2
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:SwitchParameter
別名:wi
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

String

輸出

PSLogAnalyticsOperationResult