Executar trabalhos de pesquisa no Azure Monitor

Os trabalhos de pesquisa são consultas assíncronas que buscam registros em uma nova tabela de pesquisa em seu espaço de trabalho para análises adicionais. O trabalho de pesquisa utiliza o processamento paralelo e pode ser executado durante horas em grandes conjuntos de dados. Este artigo descreve como criar um trabalho de pesquisa e como consultar seus dados resultantes.

Nota

Atualmente, o recurso de pesquisa de vagas não é suportado para espaços de trabalho com chaves gerenciadas pelo cliente.

Permissões

Para executar um trabalho de pesquisa, você precisa de permissões para Microsoft.OperationalInsights/workspaces/searchJobs/write o espaço de Microsoft.OperationalInsights/workspaces/tables/write trabalho do Log Analytics, por exemplo, conforme fornecido pela função interna Colaborador do Log Analytics.

Quando utilizar trabalhos de pesquisa

Use um trabalho de pesquisa quando o tempo limite da consulta de log de 10 minutos não for suficiente para pesquisar grandes volumes de dados ou se você estiver executando uma consulta lenta.

Os trabalhos de pesquisa também permitem recuperar registros das tabelas Logs Arquivados e Logs Básicos em uma nova tabela de logs que você pode usar para consultas. Desta forma, executar uma procura de emprego pode ser uma alternativa para:

  • Restaurando dados de logs arquivados para um intervalo de tempo específico.
    Use a restauração quando tiver uma necessidade temporária de executar muitas consultas em um grande volume de dados.

  • Consultando logs básicos diretamente e pagando por cada consulta.
    Para determinar qual alternativa é mais econômica, compare o custo de consultar logs básicos com o custo de executar um trabalho de pesquisa e armazenar os resultados do trabalho de pesquisa.

O que faz um trabalho de pesquisa?

Um trabalho de pesquisa envia os resultados para uma nova tabela na mesma área de trabalho que os dados de origem. A tabela de resultados fica disponível assim que a vaga de pesquisa começa, mas pode levar algum tempo para que os resultados comecem a aparecer.

A tabela de resultados do trabalho de pesquisa é uma tabela do Google Analytics que está disponível para consultas de log e outros recursos do Azure Monitor que usam tabelas em um espaço de trabalho. A tabela usa o valor de retenção definido para o espaço de trabalho, mas você pode modificar esse valor depois que a tabela é criada.

O esquema da tabela de resultados da pesquisa é baseado no esquema da tabela de origem e na consulta especificada. As outras colunas a seguir ajudam a controlar os registros de origem:

Column valor
_OriginalType Digite o valor da tabela de origem.
_OriginalItemId _ItemID valor da tabela de origem.
_OriginalTimeGenerated Valor TimeGenerated da tabela de origem.
TimeGenerated Hora em que a procura de emprego correu.

As consultas na tabela de resultados aparecem na auditoria de consulta de log, mas não no trabalho de pesquisa inicial.

Executar um trabalho de pesquisa

Execute um trabalho de pesquisa para buscar registros de grandes conjuntos de dados em uma nova tabela de resultados de pesquisa em seu espaço de trabalho.

Gorjeta

Você incorre em encargos para executar uma vaga de pesquisa. Portanto, escreva e otimize sua consulta no modo de consulta interativo antes de executar o trabalho de pesquisa.

Para executar um trabalho de pesquisa, no portal do Azure:

  1. No menu do espaço de trabalho do Log Analytics, selecione Logs.

  2. Selecione o menu de reticências no lado direito da tela e ative o modo Pesquisar trabalho.

    Screenshot of the Logs screen with the Search job mode switch highlighted.

    O intellisense de Logs do Azure Monitor dá suporte a limitações de consulta KQL no modo de trabalho de pesquisa para ajudá-lo a escrever sua consulta de trabalho de pesquisa.

  3. Especifique o intervalo de datas do trabalho de pesquisa usando o seletor de horas.

  4. Digite a consulta de vaga de pesquisa e selecione o botão Pesquisar vaga.

    Os Logs do Monitor do Azure solicitam que você forneça um nome para a tabela do conjunto de resultados e informam que o trabalho de pesquisa está sujeito a cobrança.

    Screenshot that shows the Azure Monitor Logs prompt to provide a name for the search job results table.

  5. Insira um nome para a tabela de resultados de trabalho de pesquisa e selecione Executar um trabalho de pesquisa.

    Os Logs do Azure Monitor executam o trabalho de pesquisa e criam uma nova tabela em seu espaço de trabalho para os resultados do trabalho de pesquisa.

    Screenshot that shows an Azure Monitor Logs message that the search job is running and the search job results table will be available shortly.

  6. Quando a nova tabela estiver pronta, selecione Exibir tablename_SRCH para exibir a tabela no Log Analytics.

    Screenshot that shows an Azure Monitor Logs message that the search job results table is available to view.

    Você pode ver os resultados do trabalho de pesquisa à medida que eles começam a fluir para a tabela de resultados de trabalho de pesquisa recém-criada.

    Screenshot that shows search job results table with data.

    Os Logs do Azure Monitor mostram uma mensagem de conclusão do trabalho de Pesquisa no final do trabalho de pesquisa. A tabela de resultados está agora pronta com todos os registos que correspondem à consulta de pesquisa.

    Screenshot that shows an Azure Monitor Logs message that the search job is done.

Obter status e detalhes da vaga de pesquisa

  1. No menu do espaço de trabalho do Log Analytics, selecione Logs.

  2. Na guia Tabelas, selecione Resultados da pesquisa para exibir todas as tabelas de resultados de trabalhos de pesquisa.

    O ícone na tabela de resultados da pesquisa de empregos exibe uma indicação de atualização até que a vaga de pesquisa seja concluída.

    Screenshot that shows the Tables tab on Logs screen in the Azure portal with the search results tables listed under Search results.

Excluir uma tabela de trabalho de pesquisa

Recomendamos que elimine a tabela de trabalhos de pesquisa quando terminar de consultar a tabela . Isso reduz a confusão do espaço de trabalho e as cobranças extras pela retenção de dados.

Limitações

As ofertas de emprego na pesquisa estão sujeitas às seguintes limitações:

  • Otimizado para consultar uma tabela de cada vez.
  • O intervalo de datas de pesquisa é de até um ano.
  • Suporta pesquisas de longa duração até um tempo limite de 24 horas.
  • Os resultados são limitados a um milhão de recordes no conjunto de recordes.
  • A execução simultânea é limitada a cinco trabalhos de pesquisa por espaço de trabalho.
  • Limitado a 100 tabelas de resultados de pesquisa por espaço de trabalho.
  • Limitado a 100 execuções de trabalho de pesquisa por dia, por espaço de trabalho.

Quando você atinge o limite de registros, o Azure anula o trabalho com um status de êxito parcial e a tabela conterá apenas registros ingeridos até esse ponto.

Limitações da consulta KQL

Os trabalhos de pesquisa destinam-se a analisar grandes volumes de dados numa tabela específica. Portanto, as consultas de trabalho de pesquisa devem sempre começar com um nome de tabela. Para habilitar a execução assíncrona usando distribuição e segmentação, a consulta suporta um subconjunto de KQL, incluindo os operadores:

Você pode usar todas as funções e operadores binários dentro desses operadores.

Modelo de preços

A taxa cobrada por uma procura de emprego baseia-se nos seguintes elementos:

  • Execução de trabalho de pesquisa - a quantidade de dados que o trabalho de pesquisa verifica.
  • Resultados do trabalho de pesquisa - a quantidade de dados que o trabalho de pesquisa encontra e é ingerido na tabela de resultados, com base nos preços regulares de ingestão de dados de log.

Por exemplo, se a sua tabela tiver 500 GB por dia, para uma pesquisa durante 30 dias, ser-lhe-ão cobrados 15.000 GB de dados digitalizados. Se o trabalho de pesquisa encontrar 1.000 registros que correspondam à consulta de pesquisa, você será cobrado por ingerir esses 1.000 registros na tabela de resultados.

Para obter mais informações, consulte Preços do Azure Monitor.

Próximos passos