Visualizar dados do Azure Data Explorer no Grafana

Adicionar a identidade gerenciada à função Visualizador

O Managed Grafana 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 do StormEvents.

   

3. Selecione Permissões>Adicionar>visualizador.

   

4. Na caixa de pesquisa, insira o nome do workspace do Managed 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, acesse o workspace do Managed 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 Fonte de dados do Azure Data Explorer.

   

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

   

6. Selecione Salvar e Testar.

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 serão usadas 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.

2. O comando retorna um conjunto de resultados como o exemplo a seguir. Copie os valores das 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 do StormEvents.

   

3. Escolha Permissões>Adicionar.

   

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

   

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

   

6. Selecione Salvar.

   

Comando de gerenciamento: Consulta

1. No portal do Azure, acesse 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 Fonte de Dados do Azure Data Explorer.

   

4. Em Configurações>Detalhes 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.

   Interface do Usuário 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 algum problema, verifique os valores especificados no Grafana e revise 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 painel 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 o desempenho de renderização do painel e reduzir a carga no cluster do Azure Data Explorer.

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 do cache de resultados, faça o seguinte no painel Otimizações de Consulta:

1. Desative 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 as alterações do 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 dados Fraca.