Início Rápido: Executar uma consulta do Resource Graph usando o portal do Azure

Este início rápido descreve como executar uma consulta do Azure Resource Graph no portal do Microsoft Azure usando o Azure Resource Graph Explorer. O Gerenciador do Resource Graph permite que você consulte informações sobre os tipos de recursos e propriedades do Azure Resource Manager. O Gerenciador do Resource Graph também fornece uma interface para trabalhar com várias consultas, avaliar os resultados e até mesmo converter os resultados de algumas consultas em um gráfico que pode ser fixado em um painel do Azure.

Pré-requisitos

Se você ainda não tiver uma conta do Azure, crie uma conta gratuita antes de começar.

Executar uma consulta

Execute uma consulta no portal do Microsoft Azure usando o Azure Resource Graph Explorer.

1. Entre no portal do Azure.

2. Pesquise pelo Resource Graph e selecione Gerenciador do Resource Graph.

   

3. Se precisar alterar o escopo, selecione Diretório. Em seguida, selecione o diretório, o grupo de gerenciamento ou a assinatura dos recursos que você deseja consultar.

   

4. Na parte Consulta 1 da janela, copie e cole a consulta a seguir. Em seguida, selecione Executar Consulta.

   resources
   | project name, type
   | limit 5
   

   

   Este exemplo de consulta não fornece um modificador de classificação como order by. Se você executar a consulta várias vezes, ela poderá gerar um conjunto diferente de recursos para cada solicitação.

5. Examine a resposta da consulta na guia Resultados e selecione a guia Mensagens para ver detalhes sobre a consulta, incluindo a contagem de resultados e a duração da consulta. Os erros, se houver, serão exibidos em Mensagens.

6. Atualize a consulta para order by a propriedade name. Em seguida, selecione Executar consulta

   resources
   | project name, type
   | limit 5
   | order by name asc
   

   Como na consulta anterior, a execução dessa consulta várias vezes pode gerar um conjunto diferente de recursos para cada solicitação. A ordem dos comandos de consulta é importante. Neste exemplo, o order by vem após o limit. A consulta limita os resultados a cinco recursos e, em seguida, ordena esses resultados por nome.

7. Atualize a consulta para order by a propriedade name e, em seguida, limit para os cinco principais resultados. Em seguida, selecione Executar Consulta.

   resources
   | project name, type
   | order by name asc
   | limit 5
   

   Se essa consulta for executada várias vezes sem alterações em seu ambiente, os resultados serão consistentes e ordenados pela propriedade name, mas ainda limitados a cinco resultados. A consulta ordena os resultados por nome e, em seguida, limita a saída a cinco recursos.

Navegador de esquema

O navegador de esquema está localizado no painel esquerdo do Resource Graph Explorer. Esta lista de recursos mostra todos os tipos de recursos dos recursos do Azure compatíveis com o Azure Resource Graph e que existem em seu locatário. Selecione um tipo de recurso ou propriedade para mostrar propriedades filho que podem ser usadas para criar uma consulta do Resource Graph.

Selecione um nome de tabela no navegador do esquema e ela será adicionada à consulta. Quando você seleciona um tipo de recurso, ele é adicionado à consulta, como where type =="<resource type>". Se você selecionar uma propriedade, ela será adicionada à próxima linha na consulta, como where <propertyName> == "INSERT_VALUE_HERE". Você pode usar o navegador de esquema para encontrar propriedades que podem ser usadas em consultas. Certifique-se de substituir INSERT_VALUE_HERE pelo seu próprio valor e ajustar a consulta com condições, operadores e funções.

Este exemplo mostra uma consulta criada a partir do navegador de esquema selecionando a tabela authorizationresources com o tipo de recurso microsoft.authorization/roledefinitions e a propriedade roleName.

authorizationresources
| where type == "microsoft.authorization/roledefinitions"
| where properties['roleName'] == "INSERT_VALUE_HERE"

Baixar os resultados da consulta como um arquivo CSV

Para baixar os resultados de valores separados por vírgulas (CSV) do portal do Azure, navegue até o Gerenciador do Azure Resource Graph e execute uma consulta. Na barra de ferramentas, selecione Baixar como CSV, conforme mostrado na seguinte captura de tela:

Quando você usa a funcionalidade de exportação Baixar como CSV do Azure Resource Graph Explorer, o conjunto de resultados é limitado a 55.000 registros. Esta limitação é um limite de plataforma que não pode ser substituído ao arquivar um tíquete de suporte do Azure.

Criar um gráfico a partir dos resultados da consulta

Você pode criar gráficos a partir de consultas que geram uma contagem para o número de recursos. As consultas que geram listas não podem ser transformadas em um gráfico. Se você tentar criar um gráfico a partir de uma lista, uma mensagem como o conjunto de resultados não é compatível com uma visualização de gráfico de rosca será exibida na guia Gráficos.

Para criar um gráfico a partir dos resultados da consulta, execute as seguintes etapas:

1. Na parte Consulta 1 da janela, insira a seguinte consulta e selecione Executar Consulta.

   resources
   | where type == "microsoft.compute/virtualmachines"
   | summarize count() by tostring(properties.storageProfile.osDisk.osType)
   

2. Selecione a guia Resultados e observe que a resposta a essa consulta fornece contagens.

3. Selecione a guia Gráficos. Altere o tipo em Selecionar tipo de gráfico... para Gráfico de barras ou Gráfico de rosca.

   

Fixar a visualização da consulta no painel

Quando você tem resultados de uma consulta que pode ser visualizada, essa visualização de dados pode ser fixada no painel do portal do Azure. Após executar a consulta anterior, siga estas etapas:

1. Selecione Salvar e utilize o nome Máquina virtual por tipo de SO e digite como Consultas privadas. Em seguida, selecione Salvar na parte inferior do painel direito.
2. Selecione Executar consulta para executar novamente a consulta salva.
3. Na guia Gráficos, selecione uma visualização de dados. Em seguida, selecione Fixar no painel.
4. Em Fixar ao painel, selecione o painel existente no qual você deseja que o gráfico apareça.
5. Selecione Painel no menu de opções (três linhas horizontais) no lado superior esquerdo de qualquer página do portal.

A consulta agora está disponível em seu painel com o título Máquina virtual por tipo de SO. Se a consulta não tiver sido salva antes de ser fixada, o nome será Consulta 1.

A consulta e a visualização de dados resultantes são executadas e atualizadas sempre que o painel é carregado, fornecendo insights dinâmicos e em tempo real para seu ambiente do Azure diretamente em seu fluxo de trabalho.

Consultas que resultam em uma lista também podem ser fixadas no painel. Esse recurso não está limitado a visualizações de dados das consultas.

Quando uma consulta é executada a partir do portal, você pode selecionar o Diretório para alterar o escopo da consulta para o diretório, grupo de gerenciamento ou assinatura dos recursos que deseja consultar. Quando Fixar no painel é selecionado, os resultados são adicionados ao seu painel do Azure com o escopo usado quando a consulta foi executada.

Para obter mais informações sobre como trabalhar com painéis, confira Criar um painel no portal do Azure.

Limpar os recursos

Se você quiser remover os painéis de exemplo do Resource Graph do seu ambiente do portal do Azure, execute as seguintes etapas:

1. Selecione Painel no menu de opções (três linhas horizontais) no lado superior esquerdo de qualquer página do portal.
2. Em seu painel, localize o gráfico Máquina virtual por tipo de SO e selecione as reticências (...) para exibir o menu.
3. Selecione Remover do painel e selecione Salvar para confirmar.

Se quiser excluir as consultas salvas, como Máquina virtual por tipo de SO, execute as seguintes etapas:

1. Vá para o Azure Resource Graph Explorer.
2. Selecione Abrir uma consulta.
3. Selecione Tipo Consultas particulares.
4. Em Nome da consulta, selecione o ícone da lixeira para Excluir esta consulta.
5. Selecione Sim para confirmar a exclusão.

Próximas etapas

Neste início rápido, você usou o Azure Resource Graph Explorer para executar uma consulta e analisou como usar gráficos e painéis. Para saber mais, acesse o artigo sobre os detalhes da linguagem de consulta.

Noções básicas sobre a linguagem de consulta do Azure Resource Graph