Export-AzLogAnalyticRequestRateByInterval

模組:: Az.Compute Module

匯出記錄，顯示此訂用帳戶在指定時間範圍內提出的 API 要求，以顯示節流活動。

語法

Default (預設值)

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

此命令會將 Microsoft.Compute API 呼叫的彙總數目儲存在指定的 SAS URI 中，以 2018-02-20T17：54：14 和 2018-02-22T17：54：17 之間的 Success、Failure 或 Throttled 分隔，並依作業名稱彙總。

範例 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

此命令會將 Microsoft.Compute API 呼叫的彙總數目儲存在指定的 SAS URI 中，以 2018-02-20T17：54：14 和 2018-02-22T17：54：17 之間以 Success、Failure 或 Throttled 分隔，並依應用程式識別碼彙總。

範例 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

此命令會將 Microsoft.Compute API 呼叫的匯總數目儲存在指定的 SAS URI 中，以 2018-02-20T17：54：14 和 2018-02-22T17：54：17 之間的 Success、Failure 或 Throttled 分隔，並依使用者代理程式彙總。

參數

-AsJob

在背景執行 Cmdlet

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-BlobContainerSasUri

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

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	3
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	參見

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DefaultProfile

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

參數屬性

類型:	IAzureContextContainer
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	AzContext, AzureRmContext, AzureCredential

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-FromTime

從查詢時間開始

參數屬性

類型:	DateTime
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	1
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-GroupByApplicationId

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

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-GroupByOperationName

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

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-GroupByResourceName

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

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-GroupByThrottlePolicy

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

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-GroupByUserAgent

依 UserAgent 將查詢結果分組。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-IntervalLength

用來建立 LogAnalytics 通話速率記錄的間隔值（以分鐘為單位）。

參數屬性

類型:	IntervalInMins
預設值:	None
接受的值:	ThreeMins, FiveMins, ThirtyMins, SixtyMins
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	4
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Location

查詢對數分析的位置。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	0
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-NoWait

在作業完成之前啟動作業並立即傳回。為了確定操作是否已成功完成，請使用其他一些機制。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ToTime

查詢時間

參數屬性

類型:	DateTime
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	2
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。指令未執行。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	威斯康辛

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

共用方式為

Export-AzLogAnalyticRequestRateByInterval

語法

Default (預設值)

Description

範例

範例 1：匯出依作業名稱彙總的記錄

範例 2：匯出依應用程式 ID 彙總的記錄

範例 3：匯出依使用者代理彙總的記錄

參數

-AsJob

參數屬性

參數集

-BlobContainerSasUri

參數屬性

參數集

-Confirm

參數屬性

參數集

-DefaultProfile

參數屬性

參數集

-FromTime

參數屬性

參數集

-GroupByApplicationId

參數屬性

參數集

-GroupByOperationName

參數屬性

參數集

-GroupByResourceName

參數屬性

參數集

-GroupByThrottlePolicy

參數屬性

參數集

-GroupByUserAgent

參數屬性

參數集

-IntervalLength

參數屬性

參數集

-Location

參數屬性

參數集

-NoWait

參數屬性

參數集

-ToTime

參數屬性

參數集

-WhatIf

參數屬性

參數集

CommonParameters

輸入

String

輸出

PSLogAnalyticsOperationResult

意見反應