Invoke-AzOperationalInsightsQuery

Referência

Módulo:: Az.OperationalInsights

Retorna resultados de pesquisa com base nos parâmetros especificados.

Sintaxe

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>]

Description

O cmdlet Invoke-AzOperationalInsightsQuery retorna os resultados da pesquisa com base nos parâmetros especificados. Você pode acessar o status da pesquisa na propriedade Metadata do objeto retornado. Se o status for Pendente, a pesquisa não foi concluída e os resultados serão do arquivo. Você pode recuperar os resultados da pesquisa da propriedade Value do objeto retornado. Verifique os detalhes dos limites gerais de consulta aqui: https://learn.microsoft.com/azure/azure-monitor/service-limits#log-queries-and-language.

Observação: tente definir -Wait um valor maior se ocorrer o erro 'A solicitação foi cancelada devido ao HttpClient.Timeout configurado de 100 segundos'.

Exemplos

Exemplo 1: Obter resultados da pesquisa usando uma consulta

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

Depois de invocado, $queryResults.Results conterá todas as linhas resultantes da consulta.

Exemplo 2: Converter $results. Resultado: IEnumerable para uma matriz

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

Algumas consultas podem resultar no retorno de conjuntos de dados muito grandes. Por isso, o comportamento padrão do cmdlet é retornar um IEnumerable para reduzir os custos de memória. Se preferir ter uma matriz de resultados, você pode usar o método de extensão LINQ Enumerable.ToArray() para converter o IEnumerable em uma matriz.

Exemplo 3: Obter resultados da pesquisa usando uma consulta em um período de tempo específico

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

Os resultados dessa consulta serão limitados às últimas 24 horas.

Exemplo 4: Incluir renderização e estatísticas no resultado da consulta

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

$queryResults.Render

$queryResults.Statistics

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DefaultProfile

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

Tipo:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-IncludeRender

Se especificado, as informações de renderização para consultas de métrica serão incluídas na resposta.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-IncludeStatistics

Se especificado, as estatísticas de consulta serão incluídas na resposta.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Query

A consulta a ser executada.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Timespan

O intervalo de tempo para associar a consulta.

Tipo:	Nullable<T>[TimeSpan]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Wait

Coloca um limite superior na quantidade de tempo que o servidor gastará processando a consulta. Confira: https://learn.microsoft.com/azure/azure-monitor/logs/api/timeouts

Tipo:	Nullable<T>[Int32]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Workspace

O espaço de trabalho

Tipo:	PSWorkspace
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-WorkspaceId

A ID do workspace.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

PSWorkspace

Saídas

PSQueryResponse

Compartilhar via