Visualizar dados do Azure Data Explorer no Grafana

Artigo
07/25/2023

O Grafana é uma plataforma de análise onde pode consultar e visualizar dados e, em seguida, criar e partilhar dashboards com base nas suas visualizações. O Grafana fornece um plug-in do Azure Data Explorer, que lhe permite ligar e visualizar dados do Azure Data Explorer. O plug-in funciona com o Azure Managed Grafana e o Grafana autoalojado.

Neste artigo, vai aprender a configurar o cluster como uma origem de dados para o Grafana e a visualizar dados no Grafana para o Managed Grafana do Azure e o Grafana autoalojado. Para acompanhar os exemplos neste artigo, ingera os dados de exemplo stormEvents. O conjunto de dados de exemplo StormEvents contém dados relacionados com as condições meteorológicas dos Centros Nacionais de Informação Ambiental.

Pré-requisitos

Para o Azure Managed Grafana, uma conta do Azure e uma instância do Azure Managed Grafana .
Para o Grafana autoalojado, o Grafana versão 5.3.0 ou posterior para o seu sistema operativo e o plug-in do Azure Data Explorer para o Grafana. Precisa da versão 3.0.5 ou posterior do plug-in para utilizar o construtor de consultas do Grafana.
Um cluster e uma base de dados do Azure Data Explorer. Pode criar um cluster gratuito ou criar um cluster completo. Para decidir qual é o melhor para si, verifique a comparação de funcionalidades.

Configurar a origem de dados

Para configurar o Azure Data Explorer como uma origem de dados, siga os passos para o seu ambiente do Grafana.

Azure Managed Grafana
Grafana autoalojado

Adicionar a identidade gerida à função visualizador

O Managed Grafana cria uma identidade gerida atribuída pelo sistema para cada nova área de trabalho, por predefinição. Pode utilizá-lo para aceder ao cluster do Azure Data Explorer.

No portal do Azure, aceda ao cluster do Azure Data Explorer.
Na secção Descrição geral , selecione a base de dados que tem os dados de exemplo stormEvents .
Selecione Permissões>Adicionar>Visualizador.
Na caixa de pesquisa, introduza o nome da área de trabalho Managed Grafana.
Nos resultados da pesquisa, selecione o resultado que corresponde ao nome da área de trabalho e, em seguida, selecione Selecionar.

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

As áreas de trabalho geridas do Grafana vêm com o plug-in do Azure Data Explorer pré-instalado.

No portal do Azure, aceda à área de trabalho do Managed Grafana.
Em Descrição geral, selecione a ligação Ponto final para abrir a IU do Grafana.
No Grafana, no menu esquerdo, selecione o ícone de engrenagem. Em seguida, selecione Origens de Dados.
Selecione Azure Data Explorer Datasource.
Em Detalhes da Ligação, introduza o URL do cluster do Azure Data Explorer.
Selecione Guardar & Teste.

Criar um principal de serviço

Pode criar o principal de serviço no portal do Azure ou com a experiência de linha de comandos da CLI do Azure. Depois de criar o principal de serviço, obtém valores para quatro propriedades de ligação que irá utilizar nos passos posteriores.

Portal do Azure

Siga as instruções na documentação do portal do Azure. Utilize estas informações específicas:
1. Na secção Atribuir a aplicação a uma função, atribua um tipo de função de Leitor ao cluster do Azure Data Explorer.
2. Na secção Obter valores para iniciar sessão , copie os valores das três propriedades abrangidas pelos passos: ID do Diretório (ID do inquilino), ID da Aplicação e Palavra-passe.
Na portal do Azure, selecione Subscrições. Em seguida, copie o ID da subscrição na qual criou o principal de serviço.

CLI do Azure

Utilize o seguinte comando para criar um principal de serviço. Defina um âmbito adequado e um tipo de função de reader.
```
az ad sp create-for-rbac --name "https://{UrlToYourDashboard}:{PortNumber}" --role "reader" \
                         --scopes /subscriptions/{SubID}/resourceGroups/{ResourceGroupName}
```
Para obter mais informações, veja Criar um principal de serviço do Azure com a CLI do Azure.

O comando devolve um conjunto de resultados como o seguinte exemplo. 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"
}

Obtenha uma lista das suas subscrições:
```
az account list --output table
```
Copie o ID de subscrição adequado.

Adicionar o principal de serviço à função visualizador

Agora que tem um principal de serviço, adicione-o à função Visualizador na base de dados Data Explorer do Azure. Pode efetuar esta tarefa em Permissões no portal do Azure ou em Consulta com um comando de gestão.

portal do Azure: Permissões

No portal do Azure, aceda ao cluster do Azure Data Explorer.
Na secção Descrição geral , selecione a base de dados que tem os dados de exemplo stormEvents.
Selecione Permissões>Adicionar.
Em Adicionar Permissões de Base de Dados, selecione a função Visualizador e, em seguida, selecione Selecionar principais.
Procure o principal de serviço que criou. Selecione o principal e, em seguida, selecione Selecionar.
Selecione Guardar.

Comando de gestão: Consulta

No portal do Azure, aceda ao cluster do Azure Data Explorer e, em seguida, selecione Consulta.
Execute o seguinte comando na janela de consulta. Utilize o ID da aplicação e o ID do inquilino do portal do Azure ou da CLI do Azure.
```
.add database {TestDatabase} viewers ('aadapp={ApplicationID};{TenantID}')
```
O comando devolve um conjunto de resultados. No exemplo seguinte, a primeira linha destina-se a um utilizador existente na base de dados. A segunda linha destina-se ao principal de serviço que acabou de adicionar.

Especificar propriedades e testar a ligação

Com o principal de serviço atribuído à função visualizador, agora especifica propriedades na sua instância do Grafana e testa a ligação ao Azure Data Explorer.

No Grafana, no menu esquerdo, selecione o ícone de engrenagem. Em seguida, selecione Origens de Dados.
Selecione Adicionar origem de dados.
Na página Origens de Dados/Nova, introduza um nome para a origem de dados e, em seguida, selecione o tipo Azure Data Explorer Datasource.

Em Definições>Detalhes da ligação, introduza o nome do cluster no formulário https://{ClusterName}.{Region}.kusto.windows.net. Introduza os outros valores da portal do Azure ou da CLI do Azure. Utilize as seguintes informações de mapeamento como guia.

IU do Grafana	Portal do Azure	CLI do Azure
ID da Subscrição	ID DA SUBSCRIÇÃO	`SubscriptionId`
ID do Inquilino	ID do Diretório	`tenant`
ID do Cliente	ID da Aplicação	`appId`
Segredo do cliente	Palavra-passe	`password`

Captura de ecrã das caixas das propriedades de ligação da origem de dados.

Selecione Guardar & Teste.

Se o teste for bem-sucedido, aceda à secção seguinte. Se tiver problemas, verifique os valores que especificou no Grafana e reveja os passos anteriores.

Otimizar consultas

Pode utilizar duas funcionalidades para otimização de consultas:

Otimizar o desempenho da composição de consultas do dashboard
Ativar a consistência fraca

Para efetuar a otimização, emOtimizações de Consultas deDefinições de Origens>> de Dados, faça as alterações necessárias.

Captura de ecrã que mostra as propriedades que podem ser configuradas no painel de otimização de consultas.

Otimizar o desempenho da composição de consultas do dashboard

Quando um dashboard ou elemento visual é composto mais de uma vez por um ou mais utilizadores, o Grafana envia pelo menos uma consulta para o Azure Data Explorer por predefinição. Ative a colocação em cache dos resultados da Consulta para melhorar o desempenho da composição do dashboard e reduzir a carga no cluster de Data Explorer do Azure.

Durante o intervalo de tempo especificado, o Azure Data Explorer utilizará a cache de resultados para obter os resultados anteriores e não executará uma consulta desnecessária. Esta capacidade é especialmente eficaz na redução da carga nos recursos e na melhoria do desempenho quando vários utilizadores estão a utilizar o mesmo dashboard.

Para ativar a composição da cache de resultados, faça o seguinte no painel Otimizações de Consultas :

Desative Utilizar colocação em cache dinâmica.
Em Idade Máxima da Cache, introduza o número de minutos durante os quais pretende utilizar os resultados em cache.

Ativar a consistência fraca

Os clusters são configurados com uma consistência forte. Esta configuração predefinida garante que os resultados da consulta estão atualizados com todas as alterações no cluster.

Quando ativa 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 composição visual. Se a consistência imediata não for crítica e o desempenho for marginal, ative a consistência fraca para melhorar o desempenho. Para obter mais informações, veja Consistência de consultas.

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

Visualizar os dados

Concluiu a configuração do Azure Data Explorer como uma origem de dados para o Grafana. Agora está na altura de visualizar os dados.

O exemplo básico seguinte utiliza o modo de construtor de consultas e o modo não processado do editor de consultas. Recomendamos que veja consultas de escrita para o Azure Data Explorer para obter exemplos de outras consultas a executar no conjunto de dados.

No Grafana, no menu esquerdo, selecione o ícone de adição. Em seguida, selecione Dashboard.
No separador Adicionar , selecione Gráfico.
No painel de gráficos, selecione Edição do Título> do Painel.
Na parte inferior do painel, selecione Origem de Dados e, em seguida, selecione a origem de dados que configurou.

Modo de construtor de consultas

Utilize o modo de construtor de consultas para definir a consulta.

Por baixo da origem de dados, selecione Base de dados e escolha a base de dados na lista pendente.
Selecione De e escolha a sua tabela na lista pendente.
Agora que a tabela está definida, filtre os dados:
1. Selecione + à direita de Where (filter) para selecionar uma ou mais colunas na sua tabela.
2. Para cada filtro, defina os valores com o operador aplicável. Esta seleção é semelhante à utilização do operador where no Linguagem de Pesquisa Kusto.
Selecione os valores a apresentar na tabela:
1. Selecione + à direita das colunas Valor para selecionar as colunas de valor que serão apresentadas no painel.
2. Para cada coluna de valor, defina o tipo de agregação.
  
  Pode definir uma ou mais colunas de valor. Esta seleção é equivalente à utilização do operador de resumo.
Selecione + à direita de Agrupar por (resumir) para selecionar uma ou mais colunas que serão utilizadas para organizar os valores em grupos. Esta seleção é equivalente à expressão de grupo no summarize operador.
Selecione Executar Consulta.

Dica

Ao finalizar as definições no construtor de consultas, é criada uma consulta Linguagem de Pesquisa Kusto. Esta consulta mostra a lógica que construiu com o editor de consultas gráficas.
Selecione Editar KQL para mover para o modo não processado. Edite a consulta com a flexibilidade e o poder do Linguagem de Pesquisa Kusto.

Captura de ecrã de uma consulta não processada no construtor de consultas.

Modo não processado

Utilize o modo não processado para editar a consulta.

No painel de consulta, cole a seguinte consulta e, em seguida, selecione Executar. A consulta regista a contagem de eventos por dia para o conjunto de dados de exemplo.
```
StormEvents
| summarize event_count=count() by bin(StartTime, 1d)
```
O gráfico não mostra resultados porque está no âmbito (por predefinição) dos dados das últimas seis horas. No menu superior, selecione Últimas 6 horas.
Especifique um intervalo personalizado que abrange 2007, o ano incluído no conjunto de dados de exemplo StormEvents. Em seguida, selecione Aplicar.

Agora, o gráfico mostra os dados de 2007, registados por dia.
No menu superior, selecione o ícone guardar: .

Para mudar para o modo de construtor de consultas, selecione Mudar para construtor. O Grafana irá converter a consulta na lógica disponível no construtor de consultas. A lógica do construtor de consultas é limitada, pelo que poderá perder as alterações manuais que efetuou à consulta.

Captura de ecrã da janela de consulta, com o botão para mudar para o construtor realçado.

Criar alertas

No Dashboard Base, selecione AlertasCanais de >Notificação para criar um novo canal de notificação.
Introduza um nome e escreva em Novo Canal de Notificação e, em seguida, selecione Guardar.
No dashboard, selecione Editar na lista pendente.
Selecione o ícone de sino de alerta para abrir o painel Alerta . Selecione Criar Alerta e, em seguida, conclua as propriedades do alerta.
Selecione o ícone Guardar dashboard para guardar as alterações.

Escrever consultas para o Azure Data Explorer

Partilhar via

Visualizar dados do Azure Data Explorer no Grafana

Pré-requisitos

Configurar a origem de dados

Adicionar a identidade gerida à função visualizador

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

Criar um principal de serviço

Portal do Azure

CLI do Azure

Adicionar o principal de serviço à função visualizador

portal do Azure: Permissões

Comando de gestão: Consulta

Especificar propriedades e testar a ligação

Otimizar consultas

Otimizar o desempenho da composição de consultas do dashboard

Ativar a consistência fraca

Visualizar os dados

Modo de construtor de consultas

Modo não processado

Criar alertas

Comentários

Recursos adicionais

Partilhar via

Visualizar dados do Azure Data Explorer no Grafana

Pré-requisitos

Configurar a origem de dados

Adicionar a identidade gerida à função visualizador

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

Visualizar os dados

Modo de construtor de consultas

Modo não processado

Criar alertas

Conteúdo relacionado

Comentários

Recursos adicionais