Export-AzLogAnalyticRequestRateByInterval

  • Referência
Módulo:
Az.Compute

Exporte logs que mostram solicitações de Api feitas por esta assinatura na janela de tempo especificada para mostrar atividades de limitação.

Syntax

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

Exporta dados estatísticos sobre as chamadas da assinatura para a API Microsoft.Compute por status Êxito, Falha ou Limitação, em intervalos de tempo predefinidos. Os logs podem ser agrupados por cinco parâmetros: GroupByOperationName, GroupByThrottlePolicy, GroupByResourceName, GroupByUserAgent ou GroupByApplicationId. Observe que esse cmdlet coleta somente logs do Provedor de Recursos de Computação; além disso, os dados sobre os tipos de recursos Disco e Instantâneo ainda não estão disponíveis.

Para obter uma visão geral da limitação de API do Provedor de Recursos de Computação, consulte https://learn.microsoft.com/azure/azure-resource-manager/resource-manager-request-limits.

Exemplos

Exemplo 1: Exportar registros agregados por nome de operação

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

Este comando armazena os números agregados de chamadas de API Microsoft.Compute separadas por Êxito, Falha ou Limitação entre 2018-02-20T17:54:14 e 2018-02-22T17:54:17 no URI SAS fornecido, agregado por nome de operação.

Exemplo 2: Exportar registros agregados por ID do aplicativo

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

Este comando armazena os números agregados de chamadas de API Microsoft.Compute separadas por Êxito, Falha ou Limitação entre 2018-02-20T17:54:14 e 2018-02-22T17:54:17 no URI SAS fornecido, agregado pela ID do aplicativo.

Exemplo 3: Exportar registros agregados pelo agente do usuário

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

Este comando armazena os números agregados de chamadas de API Microsoft.Compute separadas por Êxito, Falha ou Limitação entre 2018-02-20T17:54:14 e 2018-02-22T17:54:17 no URI SAS fornecido, agregado pelo agente do usuário.

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BlobContainerSasUri

Uri SAS do contêiner de blob de log no qual a Api do LogAnalytics grava logs de saída.

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FromTime

A partir do momento da consulta

Type:DateTime
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-GroupByApplicationId

Agrupe o resultado da consulta por ID do aplicativo.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GroupByOperationName

Agrupar o resultado da consulta por Nome da Operação.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GroupByResourceName

Agrupar o resultado da consulta por Nome do Recurso.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GroupByThrottlePolicy

Agrupar o resultado da consulta por Diretiva de Limitação aplicada.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GroupByUserAgent

Agrupar o resultado da consulta por UserAgent.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IntervalLength

Valor de intervalo em minutos usado para criar logs de taxa de chamada do LogAnalytics.

Type:IntervalInMins
Accepted values:ThreeMins, FiveMins, ThirtyMins, SixtyMins
Position:4
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Location

O local no qual o log analítico é consultado.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoWait

Inicia a operação e retorna imediatamente, antes que a operação seja concluída. Para determinar se a operação foi concluída com êxito, use algum outro mecanismo.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ToTime

Ao tempo da consulta

Type:DateTime
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Saídas

PSLogAnalyticsOperationResult