你当前正在访问 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

输入

String

输出

PSLogAnalyticsOperationResult