Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 Microsoft.OperationalInsights/workspaces/query/*/read permissões para os espaços de trabalho do Log Analytics que você consulta, conforme fornecido pela função interna do Log Analytics Reader, 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.
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.
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. Passe o mouse sobre um nome de consulta para ver a descrição e mais funcionalidades.
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 rola diretamente para o item selecionado. Se a organização tiver criado pacotes de consulta com marcas, as marcas personalizadas serão incluídas nessa lista.
Propriedades da consulta
Cada consulta tem várias propriedades que ajudam a 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. |
| Marcas | Propriedades personalizadas que podem ser definidas quando você cria um pacote de consultas. Você pode usar etiquetas para criar suas 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.
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 Consultas | 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 espaço de trabalho do Log Analytics. Confira Usar vários pacotes de consulta. |
| Consultas herdadas | As consultas de log salvas anteriormente na interface do explorador de consultas são consideradas consultas legadas. 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 espaço de trabalho 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 |
|---|---|
| Espaço de Trabalho | 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. |
| Grupo de recursos | 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.