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.
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.
No portal do Azure, acesse o cluster do Azure Data Explorer.
Na seção Visão geral , selecione o banco de dados que tem os dados de exemplo stormEvents .
Selecione Permissões>Adicionar>Visualizador.
Na caixa de pesquisa, insira o nome do workspace do Espaço Gerenciado do Grafana.
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.
No portal do Azure, vá para o workspace do Espaço Gerenciado do Grafana.
Em Visão geral, selecione o link Ponto de extremidade para abrir a interface do usuário do Grafana.
No Grafana, no menu à esquerda, selecione o ícone de engrenagem. Em seguida, selecione Fontes de Dados.
Selecione Azure Data Explorer Datasource.
Em Detalhes da Conexão, insira a URL do cluster do Azure Data Explorer.
Selecione Salvar e Testar.
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.
No Grafana, no menu à esquerda, selecione o ícone de adição. Em seguida, selecione Painel.
Na guia Adicionar, selecione Grafo.
No painel de grafo, selecioneEditarTítulo> do Painel.
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.
Abaixo da fonte de dados, selecione Banco de dados e escolha seu banco de dados na lista suspensa.
Selecione De e escolha sua tabela na lista suspensa.
Agora que a tabela está definida, filtre os dados:
- Selecione + à direita de Onde (filtro) para selecionar uma ou mais colunas em sua tabela.
- 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.
Selecione os valores a serem apresentados na tabela:
Selecione + à direita das colunas Valor para selecionar as colunas de valor que aparecerão no painel.
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.
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 .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.
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.
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)
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.
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.
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
No Painel Inicial, selecione Alertas>Canais de notificação para criar um novo canal de notificação.
Insira um nome e digite em Novo Canal de Notificação e selecione Salvar.
No dashboard, selecione Editar na lista suspensa.
Selecione o ícone de sino de alerta para abrir o painel Alerta. Selecione Criar Alerta e conclua as propriedades do alerta.
Selecione o ícone Salvar painel para salvar suas alterações.