Visualizar dados com painéis do Azure Data Explorer

Artigo
03/04/2024

O Azure Data Explorer é um serviço de exploração de dados rápido e altamente escalonável para dados de log e telemetria. Explore seus dados de ponta a ponta no aplicativo Web Data Explorer do Azure, começando com ingestão de dados, execução de consultas e, por fim, criação de painéis.

Um dashboard é uma coleção de blocos, opcionalmente organizados em páginas, em que cada bloco tem uma consulta subjacente e uma representação visual. Usando a interface do usuário da Web, você pode exportar nativamente consultas de Linguagem de Consulta Kusto (KQL) para um dashboard como visuais e modificar posteriormente suas consultas subjacentes e formatação visual, conforme necessário. Além da facilidade de exploração de dados, essa experiência de Data Explorer dashboard do Azure totalmente integrada fornece melhor desempenho de consulta e visualização.

Importante

Os dados estão seguros. Painéis e metadados relacionados a dashboard sobre usuários são criptografados em repouso usando chaves gerenciadas pela Microsoft.

A imagem a seguir mostra um exemplo de Data Explorer dashboard do Azure:

Para explorar interativamente painéis de exemplo, consulte Início Rápido: Visualizar painéis de dados de exemplo.

Pré-requisitos

Uma conta da Microsoft ou uma Microsoft Entra identidade do usuário. Uma assinatura do Azure não é necessária.
Crie um cluster e um banco de dados do Azure Data Explorer.
Entre na interface do usuário da Web do Azure Data Explorer e adicione uma conexão ao cluster.

Criar um painel

Na barra de navegação, selecione Painéis>Novos dashboard.
Insira um nome dashboard e selecione Criar.

Adicionar fonte de dados

Uma única dashboard pode mostrar visuais de um ou mais clusters.

Selecione o menu Mais [...] >Fontes de dados
No painel Fontes de dados, selecione + Nova fonte de dados.
No painel Criar fonte de dados:
1. Insira um Nome da fonte de dados.
2. Insira a região do URI do cluster e selecione Conectar.
3. Clique em Banco de Dados na lista suspensa.
4. Insira um valor para Idade máxima do cache de resultados da consulta para habilitar o cache de resultados da consulta em todas as consultas dessa fonte de dados. A idade máxima pode estar em unidades de segundos, horas ou dias.
5. Selecione Criar.

Adicionar bloco

Os blocos de painel usam snippets de Linguagem de Consulta Kusto para recuperar dados e renderizar visuais. Cada bloco/consulta pode dar suporte a apenas um visual.

Selecione Adicionar bloco na tela do painel ou na barra de menus superior.
No painel Consulta,
1. Selecione a fonte de dados no menu suspenso.
2. Digite a consulta e selecione Executar. Para obter mais informações sobre como gerar consultas que usam parâmetros, confira Usar parâmetros em sua consulta.
3. Selecione Visual.
Na guia visual, selecione Tipo visual para escolher o tipo de visual.
Selecione Aplicar alterações para fixar o visual no painel.
Você pode redimensionar o visual e, em seguida, selecionar o ícone Salvar .

Fixar bloco da consulta

Você também pode fixar uma consulta na guia consulta da interface do usuário da Web.

Para fixar uma consulta:

Crie e execute a consulta cuja saída você deseja visualizar no dashboard.
Selecione Compartilhar>Fixar para dashboard.
No painel Fixar no Painel:
1. Forneça um nome de bloco.
2. O nome da fonte de dados é preenchido automaticamente da fonte de dados de consulta.
3. Selecione Usar fonte de dados existente, se possível.
4. Selecione Criar novo.
5. Insira o nome do painel.
6. Marque a caixa de seleção Exibir painel após a criação (se for um novo painel).
7. Selecione Fixar

Usar parâmetros

Os parâmetros aprimoram significativamente o desempenho de renderização do painel e permitem que você use valores de filtro o mais cedo possível na consulta. A filtragem é habilitada quando o parâmetro é incluído na consulta associada aos blocos. Para obter mais informações sobre como configurar e usar diferentes tipos de parâmetros, confira Usar parâmetros nos painéis do Azure Data Explorer.

Exibir consulta

Você pode exibir a consulta no modo de edição ou exibição. A edição da consulta subjacente de um bloco só é possível no modo de edição. No modo de exibição, você pode modificar a consulta em uma nova guia de consulta, sem alterar a consulta subjacente do bloco dashboard.

Navegue até o dashboard.
No bloco que você deseja explorar, selecione o menu Mais [...]>Exibir consulta.

Um painel é aberto com a tabela de consulta e resultados.
Selecione a guia Nova consulta. Prossiga para editar a consulta no painel de consulta da interface do usuário da Web do Azure Data Explorer.

Captura de tela do painel exibir consulta com a consulta na metade superior da tela e resulta na metade inferior.

Observação

As edições feitas na consulta usando esse fluxo não serão refletidas no dashboard original.

Use o menu compartilhar para conceder permissões para um usuário Microsoft Entra ou grupo de Microsoft Entra acessar o dashboard, alterar o nível de permissão de um usuário e compartilhar o link dashboard.

Importante

Para acessar o painel, o visualizador de painel precisa do seguinte:

Link do painel para acesso
Permissões do painel
Acesso ao banco de dados subjacente no cluster do Azure Data Explorer

Gerenciar permissões

Selecione o item de menu Compartilhar na barra superior do painel.
Selecione Gerenciar permissões na lista suspensa.

Conceder permissões

Para conceder permissões a um usuário no painel Permissões do painel:

Insira o usuário Microsoft Entra ou grupo de Microsoft Entra em Adicionar novos membros.
No nível de Permissão, selecione um dos seguintes valores: Pode visualizar ou Pode editar.
Selecione Adicionar.

Gerenciar permissões do painel.

Alterar o nível de permissões do usuário

Para alterar o nível de permissões do usuário no painel Permissões do painel:

Use a caixa de pesquisa ou role a lista de usuários para localizar o usuário.
Altere o nível de Permissões, conforme necessário.

Para compartilhar o link do painel, faça um dos seguintes:

Selecione Compartilhar e Copiar link
Na janela Permissões de painel, selecione Copiar link.

Exportar painéis

Use o menu Arquivo para exportar um painel para um arquivo JSON. A exportação do painel pode ser útil nos seguintes cenários:

Controle de versão: você pode usar o arquivo para restaurar o painel para uma versão anterior.
Modelo de painel: você pode usar o arquivo como modelo para criar painéis.
Edição manual: você pode editar o arquivo para modificar o painel. O arquivo pode ser importado de volta para o painel.

Para exportar um painel, no painel, selecione Arquivo>Exportar para arquivo.

Captura de tela do dashboard mostrando a opção Exportar para arquivo.

O arquivo contém os dados do painel no formato JSON, uma estrutura de tópicos da qual é mostrada no snippet a seguir.

{
  "id": "{GUID}",
  "eTag": "{TAG}",
  "title": "Dashboard title",
  "tiles": [
    {
      "id": "{GUID}",
      "title": "Tile title",
      "query": "{QUERY}",
      "layout": { "x": 0, "y": 7, "width": 6, "height": 5 },
      "pageId": "{GUID}",
      "visualType": "line",
      "dataSourceId": "{GUID}",
      "visualOptions": {
        "xColumn": { "type": "infer" },
        "yColumns": { "type": "infer" },
        "yAxisMinimumValue": { "type": "infer" },
        "yAxisMaximumValue": { "type": "infer" },
        "seriesColumns": { "type": "infer" },
        "hideLegend": false,
        "xColumnTitle": "",
        "yColumnTitle": "",
        "horizontalLine": "",
        "verticalLine": "",
        "xAxisScale": "linear",
        "yAxisScale": "linear",
        "crossFilterDisabled": false,
        "crossFilter": { "dimensionId": "dragX-timeRange", "parameterId": "{GUID}" },
        "multipleYAxes": {
          "base": { "id": "-1", "columns": [], "label": "", "yAxisMinimumValue": null, "yAxisMaximumValue": null, "yAxisScale": "linear", "horizontalLines": [] },
          "additional": []
        },
        "hideTileTitle": false
      },
      "usedParamVariables": [ "{PARAM}" ]
    }
  ],
  "dataSources": [ {} ],
  "$schema": "https://dataexplorer.azure.com/static/d/schema/20/dashboard.json",
  "autoRefresh": { "enabled": true, "defaultInterval": "15m", "minInterval": "5m" },
  "parameters": [ {} ],
  "pages": [ { "name": "Primary", "id": "{GUID}" } ],
  "schema_version": "20"
}

Para criar um painel de um arquivo

Você pode usar um arquivo de painel para criar um painel, da seguinte forma:

Na página do painel principal, selecione Novo painel>Importar do arquivo.
Selecione o arquivo a ser importado.
Insira um nome do painel e selecione Criar.

Para atualizar ou restaurar um painel existente de um arquivo

Você pode atualizar um painel existente ou restaurar uma versão anterior, da seguinte forma:

No painel, selecione Arquivo>Substituir pelo arquivo.
Selecione o arquivo para atualizar o painel.
Selecione Salvar alterações.

Adicionar página

As páginas são contêineres opcionais para blocos. Você pode usar páginas para organizar blocos em grupos lógicos, como por fonte de dados ou por área de assunto. Você também pode usar páginas para criar um dashboard com várias exibições, como um dashboard com um detalhamento de uma página de resumo para uma página de detalhes.

No painel Páginas à esquerda, selecione + Adicionar página.
Para nomear a página, selecione o menu Vertical Mais [...]>Renomear página.
Adicione blocos à página.

Habilitar atualização automática

A atualização automática é um recurso que permite atualizar automaticamente os dados em um dashboard sem recarregar manualmente a página ou clicar em um botão de atualização.

A taxa de atualização automática padrão pode ser definida por um editor de banco de dados. Editores e visualizadores podem alterar a taxa real de atualização automática ao exibir um dashboard.

Captura de tela dos diferentes intervalos de tempo disponíveis na atualização automática nos painéis.

No entanto, os editores de banco de dados podem querer limitar a taxa de atualização mínima que qualquer visualizador pode definir para reduzir a carga do cluster. Quando a taxa de atualização mínima é definida, os usuários do banco de dados não podem definir uma taxa de atualização inferior ao mínimo.

Selecione o menu Mais [...]>Atualização automática.
Alterne a opção para que a atualização automática fique habilitada.
Selecione valores para Intervalo de tempo mínimo e Taxa de atualização padrão.
Selecione Aplicar e Salvar para salvar o painel.