Compartilhar via


Usar consultas no Log Analytics

Ao abrir o Log Analytics, você pode acessar consultas de log existentes. Você pode executar essas consultas sem modificação ou usá-las como ponto de partida para suas próprias. As consultas disponíveis incluem exemplos fornecidos pelo Azure Monitor e consultas salvas por sua organização. Este artigo descreve as consultas disponíveis e como você pode descobri-las e usá-las.

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.

Interface de consulta

Selecione consultas na interface de consulta que está disponível em dois locais diferentes no Log Analytics.

Caixa de diálogo de consulta

Quando você abre o Log Analytics, a caixa de diálogo Consultas é exibida automaticamente. Para que essa caixa de diálogo não seja exibida automaticamente, desative a opção Sempre exibir consultas.

Captura de tela que mostra a tela Serviços.

Cada consulta é representada por um cartão. É possível analisar rapidamente as consultas para encontrar o que você precisa. Execute a consulta diretamente na caixa de diálogo ou carregue-a no editor de consultas para realizar modificações.

Você também pode acessar essa opção selecionando Consultas no canto superior direito.

Captura de tela mostrando o botão Consultas.

Barra lateral de consulta

Você pode acessar a mesma funcionalidade da experiência de diálogo no painel Consultas na barra lateral esquerda do Log Analytics. Focalize um nome de consulta para obter a descrição dela e mais funcionalidades.

Captura de tela que mostra a barra lateral Consultas.

Localizar e filtrar consultas

As opções nesta seção estão disponíveis nas experiências de consulta da caixa de diálogo e da barra lateral, mas com uma interface de usuário ligeiramente diferente.

Altere o agrupamento das consultas clicando na lista suspensa Agrupar por. Os valores de agrupamento também atuam como um índice ativo. Quando você seleciona um dos valores no lado esquerdo da tela, a visualização Consultas é posicionada diretamente no item clicado. Se a organização tiver criado pacotes de consulta com marcas, as marcas personalizadas serão incluídas nessa lista.

Captura de tela que mostra o grupo da tela Consultas de exemplo por lista suspensa.

Propriedades da consulta

Cada consulta tem várias propriedades que ajudam ao agrupá-las e encontrá-las. Essas propriedades estão disponíveis para classificação e filtragem. Para obter mais informações, confira Localizar e filtrar consultas.

Você pode definir várias delas ao salvar a própria consulta. Os tipos de propriedades são:

Propriedade da consulta Descrição
Tipo de recurso Um recurso conforme definido no Azure, como uma máquina virtual. Confira a Referência da tabela do Azure Monitor para obter um mapeamento completo dos logs do Azure Monitor ou das tabelas do Log Analytics para o tipo de recurso.
Categoria Um tipo de informação, como Segurança ou Auditoria. As categorias são idênticas às definidas no painel lateral Tabelas. Confira a referência de tabela do Azure Monitor para obter uma lista completa de categorias.
Solução Uma solução do Azure Monitor associada às consultas.
Tópico O tópico da consulta de exemplo, como logs de Atividade ou logs de Aplicativo. A propriedade de tópico é exclusiva dos exemplos de consulta e pode diferir de acordo com o tipo de recurso específico.
Tipo de consulta Define o tipo da consulta. O tipo de consulta pode ser Consultas de exemplo, Consultas de pacote de consultas ou Consultas herdadas.
Rótulos Rótulos personalizados que você pode definir e atribuir quando salva sua própria consulta.
Marcações Propriedades personalizadas que podem ser definidas quando você cria um pacote de consultas. Você pode usar marcas para criar as próprias taxonomias a fim de organizar consultas.

Exibir as propriedades da consulta

No painel Consultas na barra lateral esquerda do Log Analytics, posicione o cursor sobre um nome de consulta para ver as propriedades dela.

Captura de tela que mostra as propriedades de uma consulta.

Favoritos

Você pode identificar as consultas mais usadas como favoritas para acesso rápido. Clique na estrela ao lado da consulta para adicioná-la aos Favoritos. Exiba suas consultas favoritas na opção Favoritos da interface de consulta.

Tipos de consultas

A interface de consulta é preenchida com os seguintes tipos de consultas:

Tipo Descrição
Exemplos de consulta As consultas de exemplo podem fornecer informações instantâneas sobre um recurso e oferecer uma maneira de começar a aprender e usar a Linguagem de Consulta Kusto (KQL). Elas podem ajudar a reduzir o tempo necessário para começar a usar o Log Analytics. Coletamos e organizamos mais de 500 consultas de exemplo para fornecer valor instantâneo. O número de consultas de exemplo está sempre aumentando.
Pacotes de consulta Um pacote de consultas contém uma coleção de consultas de logs. As consultas salvas por você, o pacote de consultas padrão e os pacotes de consulta que a organização criou na assinatura estão incluídos. Para exibir e gerenciar pacotes de consultas, confira Exibir pacotes de consultas. Para adicionar pacotes de consulta ao workspace do Log Analytics. Confira Usar vários pacotes de consulta.
Consultas herdadas As consultas de logs salvas anteriormente na experiência do explorador de consultas são consultas herdadas. Além disso, as consultas associadas às soluções do Azure instaladas no workspace são consultas herdadas. Essas consultas são listadas no diálogo Consultas em Consultas herdadas.

Dica

As consultas herdadas só estão disponíveis em um workspace do Log Analytics.

Efeito do escopo de consulta

As consultas que estão disponíveis ao abrir o Log Analytics são determinadas pelo escopo de consulta atual. Por exemplo:

Escopo da consulta Descrição
Workspace Todos os exemplos de consultas e consultas de pacotes de consultas. Consultas herdados no espaço de trabalho.
Recurso único Exemplos de consultas e consultas de pacotes de consultas para o tipo de recurso.
Resource group Exemplos de consultas e consultas de pacotes de consultas para tipos de recursos no recurso.

Dica

Quanto mais recursos você tiver no escopo, maior será o tempo necessário para o portal filtrar e mostrar a caixa de diálogo Consulta.

Próximas etapas

Introdução às consultas do KQL