Condividi tramite

Invoke-AzOperationalInsightsQuery

  • Riferimento
Modulo:
Az.OperationalInsights

Restituisce i risultati della ricerca in base ai parametri specificati.

Sintassi

Invoke-AzOperationalInsightsQuery
      -WorkspaceId <String>
      -Query <String>
      [-Timespan <TimeSpan>]
      [-Wait <Int32>]
      [-IncludeRender]
      [-IncludeStatistics]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Invoke-AzOperationalInsightsQuery
      -Workspace <PSWorkspace>
      -Query <String>
      [-Timespan <TimeSpan>]
      [-Wait <Int32>]
      [-IncludeRender]
      [-IncludeStatistics]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Descrizione

Il cmdlet Invoke-AzOperationalInsightsQuery restituisce i risultati della ricerca in base ai parametri specificati. È possibile accedere allo stato della ricerca nella proprietà Metadata dell'oggetto restituito. Se lo stato è In sospeso, la ricerca non è stata completata e i risultati provengono dall'archivio. È possibile recuperare i risultati della ricerca dalla proprietà Value dell'oggetto restituito. Controllare i dettagli dei limiti generali delle query qui: https://learn.microsoft.com/azure/azure-monitor/service-limits#log-queries-and-language.

Nota: provare a impostare -Wait su un valore maggiore se si verifica l'errore "La richiesta è stata annullata a causa del timeout HttpClient.Timeout configurato di 100 secondi trascorsi".

Esempio

Esempio 1: Ottenere i risultati della ricerca usando una query

$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query
$queryResults.Results

Una volta richiamato, $queryResults.Results conterrà tutte le righe risultanti dalla query.

Esempio 2: Convertire $results. Risultato IEnumerable in una matrice

$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query
$resultsArray = [System.Linq.Enumerable]::ToArray($queryResults.Results)

Alcune query possono comportare la restituzione di set di dati di grandi dimensioni. Per questo motivo, il comportamento predefinito del cmdlet consiste nel restituire un IEnumerable per ridurre i costi di memoria. Se si preferisce avere una matrice di risultati, è possibile usare il metodo di estensione LINQ Enumerable.ToArray() per convertire IEnumerable in una matrice.

Esempio 3: Ottenere i risultati della ricerca usando una query in un intervallo di tempo specifico

$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query -Timespan (New-TimeSpan -Hours 24)
$queryResults.Results

I risultati di questa query saranno limitati alle ultime 24 ore.

Esempio 4: Includere le statistiche di rendering & nel risultato della query

$query = "union * | take 10"
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId "63613592-b6f7-4c3d-a390-22ba13102111" -Query $query -IncludeRender -IncludeStatistics
$queryResults.Results

$queryResults.Render

$queryResults.Statistics

Parametri

-AsJob

Eseguire il cmdlet in background

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IncludeRender

Se specificato, le informazioni di rendering per le query sulle metriche verranno incluse nella risposta.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IncludeStatistics

Se specificato, le statistiche delle query verranno incluse nella risposta.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Query

Query da eseguire.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Timespan

Intervallo di tempo in base al quale associare la query.

Tipo:Nullable<T>[TimeSpan]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Wait

Imposta un limite superiore sulla quantità di tempo che il server spenderà per l'elaborazione della query. Vedere: https://learn.microsoft.com/azure/azure-monitor/logs/api/timeouts

Tipo:Nullable<T>[Int32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Workspace

Area di lavoro

Tipo:PSWorkspace
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WorkspaceId

ID dell'area di lavoro.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Output