Sdílet prostřednictvím


Export-AzLogAnalyticRequestRateByInterval

Exportujte protokoly, které zobrazují požadavky rozhraní API provedené tímto předplatným v daném časovém intervalu, aby se zobrazily aktivity omezování.

Syntaxe

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

Exportuje statistická data o voláních předplatného do rozhraní Microsoft.Compute API podle stavu Success, Failure nebo Throttled v předdefinovaných časových intervalech. Protokoly je možné dále seskupit podle pěti parametrů: GroupByOperationName, GroupByThrottlePolicy, GroupByResourceName, GroupByUserAgent nebo GroupByApplicationId. Všimněte si, že tato rutina shromažďuje pouze protokoly poskytovatele výpočetních prostředků; kromě toho data o typech prostředků Disk a Snapshot ještě nejsou k dispozici.

Přehled omezování rozhraní API poskytovatele výpočetních prostředků najdete v tématu https://learn.microsoft.com/azure/azure-resource-manager/resource-manager-request-limits.

Příklady

Příklad 1: Export záznamů agregovaných podle názvu operace

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

Tento příkaz ukládá agregovaná čísla volání rozhraní Microsoft.Compute API oddělená podle počtu úspěšných, neúspěšných nebo omezených mezi 2018-02-20T17:54:14 a 2018-02-22T17:54:17 v daném identifikátoru URI SAS agregovaného podle názvu operace.

Příklad 2: Export záznamů agregovaných podle ID aplikace

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

Tento příkaz ukládá agregovaná čísla volání rozhraní Microsoft.Compute API oddělená podle počtu úspěšných, neúspěšných nebo omezených mezi 2018-02-20T17:54:14 a 2018-02-22T17:54:17 v daném identifikátoru URI SAS agregovaného podle ID aplikace.

Příklad 3: Export záznamů agregovaných podle uživatelského agenta

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

Tento příkaz ukládá agregovaná čísla volání rozhraní Microsoft.Compute API oddělená podle počtu úspěšných, neúspěšných nebo omezených mezi 2018-02-20T17:54:14 a 2018-02-22T17:54:17 v daném identifikátoru URI SAS agregovaného uživatelským agentem.

Parametry

-AsJob

Spuštění rutiny na pozadí

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-BlobContainerSasUri

Identifikátor URI SAS kontejneru objektů blob protokolování, do kterého rozhraní LogAnalytics Api zapisuje výstupní protokoly.

Typ:String
Position:3
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-FromTime

Z času dotazu

Typ:DateTime
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-GroupByApplicationId

Seskupte výsledek dotazu podle ID aplikace.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-GroupByOperationName

Seskupte výsledek dotazu podle názvu operace.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-GroupByResourceName

Seskupte výsledek dotazu podle názvu prostředku.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-GroupByThrottlePolicy

Seskupte výsledek dotazu podle použitých zásad omezení.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-GroupByUserAgent

Seskupte výsledek dotazu podle UserAgent.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-IntervalLength

Hodnota intervalu v minutách použitá k vytvoření protokolů četnosti volání LogAnalytics

Typ:IntervalInMins
Přípustné hodnoty:ThreeMins, FiveMins, ThirtyMins, SixtyMins
Position:4
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Location

Umístění, na které se dotazuje analýza protokolů.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-NoWait

Spustí operaci a vrátí se okamžitě před dokončením operace. Pokud chcete zjistit, jestli se operace úspěšně dokončila, použijte jiný mechanismus.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ToTime

Čas dotazu

Typ:DateTime
Position:2
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

Výstupy

PSLogAnalyticsOperationResult