Configurar uma fonte de dados do Azure Data Explorer

O Azure Data Explorer é um serviço de exploração de dados de telemetria e logs. Neste guia, você aprenderá a adicionar uma fonte de dados do Azure Data Explorer ao Grafana e aprenderá a configurar o Azure Data Explorer usando cada opção de autenticação disponível para essa fonte de dados.

Pré-requisitos

• Uma instância do Azure Managed Grafana no plano Standard.
• Um banco de dados do Azure Data Explorer

Adicionar uma fonte de dados do Azure Data Explorer

Adicione uma fonte de dados do Azure Data Explorer ao Grafana seguindo as etapas abaixo.

1. Abra uma instância do Azure Managed Grafana no portal do Azure.

2. Na seção Visão geral, abra a URL do ponto de extremidade.

3. No portal Grafana, implante o menu à esquerda e selecione Conexões>de dados Conectar.

   

4. Selecione Fonte de Dados do Azure Data Explorer na lista e adicione-a ao Grafana selecionando Criar uma fonte de dados da Fonte de Dados do Azure Data Explorer.

Configurar uma fonte de dados do Azure Data Explorer

Insira as definições de configuração do Azure Data Explorer.

1. Na guia Configurações, opcionalmente, edite o Nome da fonte de dados.

   

2. Em Detalhes da Conexão, insira a URL do Cluster do banco de dados do Azure Data Explorer.

3. Selecione sua opção de autenticação preferida entre Identidade gerenciada, Registro de aplicativo (entidade de serviço) ou Usuário atual (autenticação baseada no usuário).

   Identidade gerida

   Autentique-se com uma identidade gerenciada sem usar credenciais explícitas.

   Adicionar uma nova permissão

   1. No portal do Azure, abra o cluster do Azure Data Explorer.

   2. Na seção Visão geral, selecione o banco de dados que contém seus dados.

   3. Selecione Permissões > Adicionar > visualizador.

      

   4. Na caixa de pesquisa, insira o nome do espaço de trabalho do Azure Managed Grafana, selecione o espaço de trabalho e escolha Selecionar. É apresentada uma notificação de êxito.

   Configurar a fonte de dados no Grafana

   1. De volta ao Grafana, em Método de autenticação, selecione Identidade gerenciada.
   2. Selecione Save & test. A notificação "Sucesso" exibida indica que o Grafana é capaz de buscar dados do banco de dados.

   Registo de aplicações

   Autentique-se com o registro do aplicativo usando uma entidade de serviço do Microsoft Entra.

   Configuração inicial

   1. Siga as etapas em Registrar um aplicativo com o Microsoft Entra ID e crie uma entidade de serviço.
   2. Atribua a função Leitor ao aplicativo na próxima etapa do guia.
   3. Siga as três primeiras etapas do guia Recuperar detalhes do aplicativo para reunir o ID do diretório (locatário), o ID do aplicativo (cliente) e o ID do segredo do cliente necessários na próxima etapa.

   Configurar a fonte de dados no Grafana

   1. No Grafana, em Método de autenticação, selecione Registro do aplicativo.

   2. Para a Nuvem do Azure, selecione sua Nuvem do Azure. Por exemplo, Azure.

      

   3. Insira um ID de diretório (locatário), ID do aplicativo (cliente) e Segredo do cliente

   4. Opcionalmente, edite também as seções Otimizações de consulta, Configurações de esquema de banco de dados e Acompanhamento .

   5. Selecione Salvar teste & para validar a conexão. A notificação "Sucesso" exibida indica que o Grafana é capaz de se conectar ao banco de dados.

   Usuário atual

   Use o método de autenticação baseado no usuário, aproveitando as credenciais do Microsoft Entra ID do usuário atual do Grafana na fonte de dados configurada.

   Quando você configura uma fonte de dados do Azure Data Explorer com o método de autenticação Usuário Atual, o Grafana consulta o Azure Data Explorer usando as credenciais do usuário.

   Atenção

   A autenticação baseada no usuário em fontes de dados Grafana é experimental.

   Atenção

   Esse recurso é incompatível com casos de uso que exigem acesso sempre ativo da máquina aos dados consultados, incluindo alertas, relatórios, cache de consultas e painéis públicos. O método de autenticação Usuário Atual depende de um usuário estar conectado, em uma sessão interativa, para que o Grafana alcance o banco de dados. Quando a autenticação baseada no usuário é usada e nenhum usuário está conectado, as tarefas automatizadas não podem ser executadas em segundo plano. Para aproveitar tarefas automatizadas para o Azure Data Explorer, recomendamos configurar outra fonte de dados do Azure Data Explorer usando outro método de autenticação.

   Adicionar uma nova permissão

   Adicione uma nova permissão para sua conta de usuário acessar o banco de dados.

   1. No portal do Azure, abra o recurso Banco de Dados do Azure Data Explorer e selecione Permissões>Adicionar>Visualizador.

   2. Digite seu nome ou endereço de e-mail na barra de pesquisa, selecione sua conta de usuário e escolha Selecionar.

      

   3. Uma notificação confirma que a permissão foi adicionada ao banco de dados.

   Configurar a fonte de dados no Grafana

   1. Em Grafana, em Método de autenticação, selecione Usuário atual.
   2. Selecione Save & test. A notificação "Sucesso" exibida indica que o Grafana é capaz de buscar dados do banco de dados.

Criar uma fonte de dados do Azure Data Explorer

Na CLI do Azure, adicione e configure uma fonte de dados do Azure Data Explorer, executando o comando az grafana data-source create . Escolha o seu método de autenticação preferido e consulte a guia correspondente abaixo para obter detalhes.

Ao executar esses comandos, substitua todos os espaços reservados por suas próprias informações.

Identidade gerida

Autentique-se com uma identidade gerenciada sem usar credenciais explícitas.

az grafana data-source create --name <azure-managed-grafana-workspace> --definition '{
  "name": "<data-source-name>",
  "type": "grafana-azure-data-explorer-datasource",
  "access": "proxy",
  "jsonData": {
    "clusterUrl": "<cluster-url>",
    "dataConsistency": "strongconsistency",
    "azureCredentials": {
      "authType": "msi"
    }
  }
}'

Registo de aplicações

Autentique-se com o registro do aplicativo usando uma entidade de serviço do Microsoft Entra.

az grafana data-source create --name <azure-managed-grafana-workspace> --definition '{
  "name": "<data-source-name>",
  "type": "grafana-azure-data-explorer-datasource",
  "access": "proxy",
  "jsonData": {
    "clusterUrl": "<cluster-url>",
    "azureCredentials": {
      "authType": "clientsecret",
      "azureCloud": "AzureCloud",
      "tenantId": "<tenant-id>",
      "clientId": "<client-id>"
    }
  },
  "secureJsonData": { "azureClientSecret": "verySecret" }
}'

Usuário atual

Autentique-se com o método de usuário atual. Esse método aproveita as credenciais de ID do Microsoft Entra do usuário atual do Grafana na fonte de dados configurada.

Quando você configura uma fonte de dados do Azure Data Explorer com o método de autenticação Usuário Atual, o Grafana consulta o Azure Data Explorer usando as credenciais do usuário.

Nota

A implantação da autenticação baseada no usuário no Azure Managed Grafana está em andamento e será concluída em todas as regiões até o final de 2023.

Atenção

A autenticação baseada no usuário em fontes de dados Grafana é experimental.

Atenção

Esse recurso é incompatível com casos de uso que exigem acesso sempre ativo da máquina aos dados consultados, incluindo alertas, relatórios, cache de consultas e painéis públicos. O método de autenticação Usuário Atual depende de um usuário estar conectado, em uma sessão interativa, para que o Grafana alcance o banco de dados. Quando a autenticação baseada no usuário é usada e nenhum usuário está conectado, as tarefas automatizadas não podem ser executadas em segundo plano. Para aproveitar tarefas automatizadas para o Azure Data Explorer, recomendamos configurar outra fonte de dados do Azure Data Explorer usando outro método de autenticação.

az grafana data-source create --name <azure-managed-grafana-workspace> --definition '{
  "name": "<data-source-name>",
  "type": "grafana-azure-data-explorer-datasource",
  "access": "proxy",
  "jsonData": {
    "clusterUrl": "<cluster-url>",
    "dataConsistency": "strongconsistency",
    "azureCredentials": {
      "authType": "currentuser"
    }
  }
}'

Atualizar uma fonte de dados do Azure Data Explorer

Para atualizar uma fonte de dados do Azure Data Explorer, siga as etapas abaixo. Ao executar esses comandos, substitua todos os espaços reservados por suas próprias informações.

1. Obtenha a ID da fonte de dados do Azure Data Explorer para atualizar com a lista de fontes de dados az grafana.

   az grafana data-source list --resource-group <azure-managed-grafana-resource-group> --name <azure-managed-grafana-workspace> --query "[?type=='grafana-azure-data-explorer-datasource'].id"
   

2. Execute o comando az grafana data-source update para atualizar a fonte de dados.

   Por exemplo, atualize o nome e a URL do cluster da fonte de dados do Azure Data Explorer com o seguinte comando.

   az grafana data-source update --resource-group <azure-managed-grafana-workspace-resource-group> --name <azure-managed-grafana-workspace> --data-source-id <data-source-id> --set name="<new-name>" url="<new-url>
   

Próximo passo

Criar um dashboard