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

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.

  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 .

    Captura de tela da página de visão geral do Azure Data Explorer e a seleção de um banco de dados de exemplo.

  3. Selecione Permissões>Adicionar>Visualizador.

    Captura de tela da página de permissões com o botão Adicionar realçado.

  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.

    Captura de tela do painel para novas entidades de segurança e um nome de workspace selecionado.

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.

    Captura de tela do menu de configurações do Grafana e da opção para fontes de dados.

  4. Selecione Azure Data Explorer Datasource.

    Captura de tela da página de fontes de dados com a fonte de Data Explorer do Azure realçada.

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

    Captura de tela do painel para obter detalhes da conexão com a caixa da URL do cluster realçada.

  6. 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.

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

    Captura de tela do menu de configurações do Grafana com a opção dashboard realçada.

  2. Na guia Adicionar, selecione Grafo.

    Captura de tela da página para adicionar um painel, com a opção de grafo realçada.

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

    Captura de tela do menu do painel do Grafana, com a opção editar realçada.

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

    Captura de tela do menu para selecionar uma fonte de dados.

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.

    Captura de tela do construtor de consultas que mostra a escolha de uma tabela em uma lista de exemplos.

  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.

    Captura de tela do construtor de consultas com todos os valores concluídos.

    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.

Captura de tela de uma consulta bruta no construtor de consultas.

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)
    

    Captura de tela da janela de consulta, com o botão para executar uma consulta realçado.

  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.

    Captura de tela do filtro de tempo padrão das últimas seis horas.

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

    Captura de tela do controle de intervalo personalizado, com um intervalo de datas personalizado selecionado.

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

    Captura de tela de um grafo concluído no painel de grafo.

  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.

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

Criar alertas

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

    Captura de tela do dashboard, com a opção de criar um canal de notificação realçada.

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

    Captura de tela da janela para criar um novo canal de notificação.

  3. No dashboard, selecione Editar na lista suspensa.

    Captura de tela do painel dashboard, com o comando de menu Editar realçado.

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

    Captura de tela do painel para selecionar as propriedades do alerta.

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