Visualizar dados com painéis do Azure Data Explorer

Artigo
08/12/2024

O Azure Data Explorer é um serviço de exploração de dados rápido e altamente escalonável para dados telemétricos e de log. Explore seus dados de ponta a ponta no aplicativo web do Azure Data Explorer, começando com a ingestão de dados, executando consultas e, em última instância, criando painéis de controle.

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

Importante

Os dados estão seguros. Os dashboards e os metadados relacionados ao dashboard sobre os usuários são criptografados em repouso usando as chaves gerenciadas pela Microsoft.

A imagem a seguir mostra uma amostra de painel de controle do Azure Data Explorer:

Para explorar interativamente as amostras de painel de controle, confira Início Rápido: Visualizar amostras de painel de controle.

Pré-requisitos

Uma conta Microsoft ou uma identidade de usuário do Microsoft Entra. 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 de controle>Novo painel de controle.
Insira um nome do dashboard e selecione Criar.

Adicionar fonte de dados

Um único painel de controle pode mostrar elementos 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 do dashboard usam trechos da 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 elemento visual, selecione Tipo de elemento visual para escolher o tipo de visual.
Selecione Aplicar alterações para fixar o visual no painel.
Você pode redimensionar o elemento visual e, em seguida, selecionar o ícone Salvar.

Fixar o bloco da consulta

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

Para fixar uma consulta:

Crie e execute a consulta cujo resultado você quer visualizar no painel de controle.
Selecione Compartilhar>Fixar no painel de controle.
No painel Fixar no Painel:
1. Forneça um Nome de bloco.
2. O Nome da fonte de dados é preenchido automaticamente a partir da fonte de dados da consulta.
3. Selecione Usar a fonte de dados existente, se possível.
4. Selecione Criar novo.
5. Digite o Nome do painel de controle.
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 a um bloco. 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.

Legenda do bloco

Você pode alterar a posição da legenda em seus blocos e usar a legenda para interagir com os dados.

Alterar o local da legenda

Se você tiver direitos de edição em um painel, poderá alterar o local da legenda em seu bloco. Alterne para o modo Editar e selecione o ícone de lápis do bloco Editar. No painel Formatação virtual, em Legenda, você pode selecionar sua preferência de localização.

Interaja com os dados

Você pode usar a legenda para interagir com os dados em seu bloco. Você pode alterar quais dados exibir selecionando o item específico na legenda. Use Ctrl para adicionar ou remover itens da seleção, mantenha shift pressionado para selecionar um intervalo. Os itens não selecionados são esmaecidos.

O botão Pesquisar permite que você pesquise e filtre itens.

Use o botão Inverter para inverter sua seleção.

As setas Para cima e Para baixo navegam pela lista das seguintes maneiras:

Quando um item é selecionado, as setas para cima e para baixo selecionam o item anterior ou próximo.
Quando mais de um item é selecionado, as setas para cima e para baixo alteram qual item está realçado no bloco.

Captura de tela mostrando os botões para usar a legenda para interagir com seus dados.

Exibir consulta

Você pode visualizar 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 do painel de controle.

Navegue até o seu painel de controle.
No bloco que 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

Observação

Todas as edições feitas na consulta usando esse fluxo não serão refletidas no painel de controle original.

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

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 do Microsoft Entra ou o grupo do 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 entidade. Você também pode usar páginas para criar um dashboard com vários modos de exibição, como um dashboard com o detalhamento de uma página de resumo para uma página de detalhes.

No painel Páginas do lado esquerdo, selecione + Adicionar página.
Para dar um nome à página, selecione o menu vertical Mais [...]>Renomear página.
Adicione blocos à página.

Habilitar atualização automática

A renovaçã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. Tanto os editores quanto os espectadores podem alterar a taxa real de atualização automática durante a visualização de um dashboard.

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

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 à mínima.

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.