你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
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>]
说明
按预定义的时间间隔导出有关订阅调用 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-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-02-22T17:54:17 之间的Microsoft.Compute API 调用的聚合数存储在给定的 SAS URI 中(按应用程序 ID 聚合)。
示例 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-02-22T17:54:17 之间的 Microsoft.Compute API 调用的聚合数存储在给定 SAS URI 中,由用户代理聚合。
参数
-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
按应用程序 ID 对查询结果进行分组。
类型: | 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 |