Compartilhar via


Consultar dados em uma tabela Básica e Auxiliar nos Logs do Azure Monitor

As tabelas de logs Básicas e Auxiliares reduzem o custo de ingestão de logs detalhados de grande volume e permitem consultar os dados que armazenam com algumas limitações. Este artigo explica como consultar dados das tabelas de registros Básicas e Auxiliares.

Para obter mais informações sobre os planos de tabela Básica e Auxiliar, confira Visão geral dos Logs do Azure Monitor: planos de tabela.

Observação

Outras ferramentas que usam a API do Azure para consulta – por exemplo, Grafana e Power BI – não podem acessar dados em tabelas Básicas e Auxiliares.

Permissões necessárias

Você deve ter permissões Microsoft.OperationalInsights/workspaces/query/*/read para os workspaces do Log Analytics que você consulta, conforme fornecido pela função interna Leitor do Log Analytics, por exemplo.

Limitações

As consultas sobre dados em tabelas Básicas e Auxiliares estão sujeitas às seguintes limitações:

Limitações da linguagem KQL (Linguagem de Consulta Kusto)

As consultas de dados em tabelas Básicas ou Auxiliares são compatíveis com todas as funções escalares e de agregação KQL. Entretanto, as consultas de tabela Básica ou Auxiliar são limitadas a uma única tabela. Portanto, essas limitações se aplicam a:

Intervalo de horas

Especifique o intervalo de tempo no cabeçalho de consulta no Log Analytics ou na chamada à API. Não é possível especificar o intervalo de tempo no corpo da consulta usando uma instrução where.

Escopo da consulta

Defina o workspace do Log Analytics como o escopo da consulta. Não é possível executar consultas usando outro recurso para o escopo. Para obter mais informações sobre o escopo da consulta, consulte Escopo e intervalo de tempo da consulta no Log Analytics do Azure Monitor.

Consultas simultâneas

Você pode executar duas consultas simultâneas por usuário.

Desempenho da consulta do registro auxiliar

As consultas de dados em tabelas Auxiliares não são otimizadas e podem levar mais tempo para retornar resultados do que as consultas executadas em tabelas de Análise e Básicas.

Limpar

Você não pode limpar dados pessoais de tabelas Básicas e Auxiliares.

Executar uma consulta em uma tabela Básica ou Auxiliar

Executar uma consulta em tabelas Básicas ou Auxiliares é o mesmo que consultar qualquer outra tabela no Log Analytics. Confira Introdução ou uso do Log Analytics do Azure Monitor se não estiver familiarizado com esse processo.

No portal do Azure, selecione Monitoramento>Logs>Tabelas.

Na lista de tabelas, você pode identificar tabelas Básicas e Auxiliares por seu ícone exclusivo:

Captura de tela do ícone da tabela Logs básicos na lista de tabelas.

Você também pode passar o mouse sobre um nome de tabela para a exibição de informações da tabela, que especifica que a tabela tem o plano de tabela Básico ou Auxiliar:

Captura de tela do indicador da tabela Logs básicos nos detalhes da tabela.

Quando você adicionar uma tabela à consulta, o Log Analytics identificará uma tabela Básica ou Auxiliar e alinha a experiência de criação adequadamente.

Captura de tela da consulta sobre as limitações de Logs Básicos.

Modelo de preços

A cobrança por uma consulta em tabelas Básicas e Auxiliares baseia-se na quantidade de dados que a consulta verifica, que depende do tamanho da tabela e do intervalo de tempo da consulta. Por exemplo, uma consulta que verifica três dias de dados em uma tabela que ingere 100 GB por dia seria cobrada por 300 GB.

Para saber mais, confira Preço do Azure Monitor.

Próximas etapas