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 |