Visualizar dados do Azure Data Explorer no Grafana

O Grafana é uma plataforma de análise em que você pode consultar e visualizar dados e, em seguida, criar e compartilhar painéis com base em suas visualizações. O Grafana fornece um plug-in Data Explorer do Azure, que permite que você se conecte e visualize dados do Azure Data Explorer. O plug-in funciona com o Espaço Gerenciado do Azure para Grafana e o Grafana auto-hospedado.

Neste artigo, você aprenderá a configurar seu cluster como uma fonte de dados para Grafana e visualizar dados no Grafana para Grafana Gerenciado do Azure e grafana auto-hospedado. Para acompanhar os exemplos neste artigo, ingera os dados de exemplo stormEvents. O conjunto de dados de exemplo StormEvents contém dados relacionados ao clima dos Centros Nacionais de Informações Ambientais.

Pré-requisitos

• Para o Espaço Gerenciado do Azure para Grafana, uma conta do Azure e uma instância do Espaço Gerenciado do Azure para Grafana .
• Para Grafana auto-hospedado, grafana versão 5.3.0 ou posterior para seu sistema operacional e o plug-in do Azure Data Explorer para Grafana. Você precisa do plug-in versão 3.0.5 ou posterior para usar o construtor de consultas grafana.
• Um cluster e um banco de dados do Azure Data Explorer. Você pode criar um cluster gratuito ou criar um cluster completo. Para decidir qual é o melhor para você, marcar a comparação de recursos.

Configurar a fonte de dados

Para configurar o Azure Data Explorer como uma fonte de dados, siga as etapas para seu ambiente do Grafana.

Espaço Gerenciado do Azure para Grafana

Adicionar a identidade gerenciada à função Visualizador

O Grafana Gerenciado cria uma identidade gerenciada atribuída pelo sistema para cada novo workspace, por padrão. Você pode usá-lo para acessar o cluster do Azure Data Explorer.

1. No portal do Azure, acesse o cluster do Azure Data Explorer.

2. Na seção Visão geral , selecione o banco de dados que tem os dados de exemplo stormEvents .

   

3. Selecione Permissões>Adicionar>Visualizador.

   

4. Na caixa de pesquisa, insira o nome do workspace do Espaço Gerenciado do Grafana.

5. Nos resultados da pesquisa, selecione o resultado que corresponde ao nome do workspace e escolha Selecionar.

   

Configurar o Azure Data Explorer como uma fonte de dados do Grafana

Os workspaces gerenciados do Grafana vêm com o plug-in do Azure Data Explorer pré-instalado.

1. No portal do Azure, vá para o workspace do Espaço Gerenciado do Grafana.

2. Em Visão geral, selecione o link Ponto de extremidade para abrir a interface do usuário do Grafana.

3. No Grafana, no menu à esquerda, selecione o ícone de engrenagem. Em seguida, selecione Fontes de Dados.

   

4. Selecione Azure Data Explorer Datasource.

   

5. Em Detalhes da Conexão, insira a URL do cluster do Azure Data Explorer.

   

6. Selecione Salvar e Testar.

Grafana auto-hospedado

Criar uma entidade de serviço

Você pode criar a entidade de serviço no portal do Azure ou usando a experiência de linha de comando da CLI do Azure. Depois de criar a entidade de serviço, você obtém valores para quatro propriedades de conexão que usará em etapas posteriores.

Portal do Azure

1. Siga as instruções na documentação do portal do Azure. Use estas informações específicas:

   1. Na seção Atribuir o aplicativo a uma função, atribua um tipo de função Leitor ao cluster do Azure Data Explorer.

   2. Na seção Obter valores para entrar , copie os valores das três propriedades abordadas nas etapas: ID do diretório (ID do locatário), ID do aplicativo e Senha.

2. No Portal do Azure, selecione Assinaturas. Em seguida, copie a ID da assinatura na qual você criou a entidade de serviço.

   

CLI do Azure

1. Use o comando a seguir para criar uma entidade de serviço. Defina um escopo apropriado e um tipo de função reader.

   az ad sp create-for-rbac --name "https://{UrlToYourDashboard}:{PortNumber}" --role "reader" \
                            --scopes /subscriptions/{SubID}/resourceGroups/{ResourceGroupName}
   

   Para obter mais informações, consulte Criar uma entidade de serviço do Azure com a CLI do Azure.

2. O comando retorna um conjunto de resultados como o exemplo a seguir. Copie os valores para as appIdpropriedades , passworde tenant .

   {
     "appId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
     "displayName": "{UrlToYourDashboard}:{PortNumber}",
     "name": "https://{UrlToYourDashboard}:{PortNumber}",
     "password": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
     "tenant": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
   }
   

3. Obtenha uma lista de suas assinaturas:

   az account list --output table
   

   Copie a ID de assinatura apropriado.

   

Adicionar a entidade de serviço à função Visualizador

Agora que você tem uma entidade de serviço, adicione-a à função Visualizador no banco de dados do Azure Data Explorer. É possível executar essa tarefa em Permissões no portal do Azure ou em Consultar, usando um comando de gerenciamento.

portal do Azure: permissões

1. No portal do Azure, acesse o cluster do Azure Data Explorer.

2. Na seção Visão geral , selecione o banco de dados que tem os dados de exemplo stormEvents.

   

3. Escolha Permissões>Adicionar.

   

4. Em Adicionar Permissões de Banco de Dados, selecione a função Visualizador e selecione Selecionar entidades de segurança.

   

5. Pesquise a entidade de serviço que você criou. Selecione a entidade de segurança e escolha Selecionar.

   

6. Clique em Salvar.

   

Comando de gerenciamento: Consulta

1. Na portal do Azure, vá para o cluster do Azure Data Explorer e selecione Consulta.

   

2. Execute o seguinte comando na janela de consulta. Use a ID do aplicativo e a ID do locatário do portal do Azure ou da CLI do Azure.

   .add database {TestDatabase} viewers ('aadapp={ApplicationID};{TenantID}')
   

   O comando retorna um conjunto de resultados. No exemplo a seguir, a primeira linha é para um usuário existente no banco de dados. A segunda linha é para a entidade de serviço que você acabou de adicionar.

   

Especificar propriedades e testar a conexão

Com a entidade de serviço atribuída à função Visualizador, agora você especifica propriedades em sua instância do Grafana e testa a conexão com o Azure Data Explorer.

1. No Grafana, no menu à esquerda, selecione o ícone de engrenagem. Em seguida, selecione Fontes de Dados.

   

2. Clique em Adicionar fonte de dados.

3. Na página Fontes de Dados/Novo, insira um nome para a fonte de dados e selecione o tipo Azure Data Explorer Datasource.

   

4. Em ConfiguraçõesDetalhes da conexão, insira> o nome do cluster no formulário https://{ClusterName}.{Region}.kusto.windows.net. Insira os outros valores do portal do Azure ou da CLI do Azure. Use as informações de mapeamento a seguir como guia.

   UI do Grafana	Portal do Azure	CLI do Azure
   ID da assinatura	ID DA ASSINATURA	SubscriptionId
   ID do locatário	ID do Diretório	tenant
   Id do Cliente	ID do Aplicativo	appId
   Segredo do cliente	Senha	password

   

5. Selecione Salvar e Testar.

   Se o teste for obtido com êxito, siga para a próxima seção. Se você tiver problemas, marcar os valores especificados no Grafana e examine as etapas anteriores.

Otimizar consultas

Você pode usar dois recursos para otimização de consulta:

• Otimizar o desempenho de renderização de consulta do painel
• Habilitar a consistência fraca

Para executar a otimização, em Fontes de Dados>Configurações>Otimizações de Consulta, faça as alterações necessárias.

Otimizar o desempenho de renderização de consulta do painel

Quando um dashboard ou visual é renderizado mais de uma vez por um ou mais usuários, o Grafana envia pelo menos uma consulta ao Azure Data Explorer por padrão. Habilite o cache de resultados da consulta para melhorar dashboard desempenho de renderização e reduzir a carga no cluster Data Explorer do Azure.

Durante o intervalo de tempo especificado, o Azure Data Explorer usará o cache de resultados para recuperar os resultados anteriores e não executará uma consulta desnecessária. Essa funcionalidade é especialmente eficaz na redução da carga de recursos e no aprimoramento do desempenho quando vários usuários estão usando o mesmo painel.

Para habilitar a renderização de cache de resultados, faça o seguinte no painel Otimizações de Consulta :

1. Desativar Usar cache dinâmico.
2. Em Idade máxima do cache, insira o número de minutos durante os quais você deseja usar os resultados armazenados em cache.

Habilitar a consistência fraca

Os clusters são configurados com a coerência forte. Essa configuração padrão garante que os resultados da consulta estejam atualizados com todas as alterações no cluster.

Quando você habilita a consistência fraca, os resultados da consulta podem ter um atraso de 1 a 2 minutos após alterações de cluster. No entanto, a consistência fraca pode aumentar o tempo de renderização visual. Se a consistência imediata não for crítica e o desempenho for marginal, habilite a consistência fraca para melhorar o desempenho. Para obter mais informações, consulte Consistência de consulta.

Para habilitar a consistência fraca, no painel Otimizações de Consulta, selecione Consistência de> dadosFraca.

Visualizar dados

Você terminou de configurar o Azure Data Explorer como uma fonte de dados para o Grafana. Agora é hora de visualizar dados.

O exemplo básico a seguir usa o modo construtor de consultas e o modo bruto do editor de consultas. Recomendamos que você exiba consultas de gravação para o Azure Data Explorer para exemplos de outras consultas a serem executadas no conjunto de dados.

1. No Grafana, no menu à esquerda, selecione o ícone de adição. Em seguida, selecione Painel.

   

2. Na guia Adicionar, selecione Grafo.

   

3. No painel de grafo, selecioneEditarTítulo> do Painel.

   

4. Na parte inferior do painel, selecione Fonte de Dados e, em seguida, selecione a fonte de dados que você configurou.

   

Modo do construtor de consultas

Use o modo construtor de consultas para definir sua consulta.

1. Abaixo da fonte de dados, selecione Banco de dados e escolha seu banco de dados na lista suspensa.

2. Selecione De e escolha sua tabela na lista suspensa.

   

3. Agora que a tabela está definida, filtre os dados:

   1. Selecione + à direita de Onde (filtro) para selecionar uma ou mais colunas em sua tabela.
   2. Para cada filtro, defina os valores usando o operador aplicável. Essa seleção é semelhante ao uso do operador where em Linguagem de Consulta Kusto.

4. Selecione os valores a serem apresentados na tabela:

   1. Selecione + à direita das colunas Valor para selecionar as colunas de valor que aparecerão no painel.

   2. Para cada coluna de valor, defina o tipo de agregação.

      Você pode definir uma ou mais colunas de valor. Essa seleção é equivalente a usar o operador resumir.

5. Selecione + à direita de Agrupar por (resumir) para selecionar uma ou mais colunas que serão usadas para organizar os valores em grupos. Essa seleção é equivalente à expressão de grupo no summarize operador .

6. Selecione Executar Consulta.

   

   Dica

   Enquanto você está finalizando as configurações no construtor de consultas, uma consulta Linguagem de Consulta Kusto é criada. Essa consulta mostra a lógica que você construiu usando o editor de consultas gráficas.

7. Selecione Editar KQL para ir para o modo bruto. Edite sua consulta usando a flexibilidade e o poder do Linguagem de Consulta Kusto.

Modo bruto

Use o modo bruto para editar a consulta.

1. No painel de consulta, cole a consulta a seguir e selecione Executar. A consulta buckets a contagem de eventos por dia para o conjunto de dados de exemplo.

   StormEvents
   | summarize event_count=count() by bin(StartTime, 1d)
   

   

2. O grafo não mostra nenhum resultado porque tem escopo (por padrão) para dados das últimas seis horas. No menu superior, selecione Últimas 6 horas.

   

3. Especifique um intervalo personalizado que abrange 2007, o ano incluído no conjunto de dados de exemplo StormEvents. Em seguida, selecione Aplicar.

   

   Agora, o grafo mostra os dados de 2007, classificados por dia.

   

4. No menu superior, selecione o ícone salvar: .

Para alternar para o modo do construtor de consultas, selecione Alternar para o construtor. O Grafana converterá a consulta na lógica disponível no construtor de consultas. A lógica do construtor de consultas é limitada, portanto, você pode perder as alterações manuais feitas na consulta.

Criar alertas

1. No Painel Inicial, selecione Alertas>Canais de notificação para criar um novo canal de notificação.

   

2. Insira um nome e digite em Novo Canal de Notificação e selecione Salvar.

   

3. No dashboard, selecione Editar na lista suspensa.

   

4. Selecione o ícone de sino de alerta para abrir o painel Alerta. Selecione Criar Alerta e conclua as propriedades do alerta.

   

5. Selecione o ícone Salvar painel para salvar suas alterações.

Conteúdo relacionado

• Gravar consultas para Azure Data Explorer