Compartilhar via


Configurar uma fonte de dados do Azure Data Explorer

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

Pré-requisitos

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 Espaço Gerenciado do Azure para Grafana no portal do Azure.
  2. Na seção Visão geral, abra a URL do Ponto de extremidade.
  3. No portal do Grafana, acesse Conexões>Fontes de dados>Adicionar nova fonte de dados, pesquise e selecione 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, edite opcionalmente o Nome da fonte de dados.

    Captura de tela da plataforma Grafana mostrando as definições básicas de configuração do Azure Data Explorer.

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

  3. Selecione a opção de autenticação preferencial entre Identidade Gerenciada, Registro de Aplicativo (entidade de serviço) ou Usuário Atual (autenticação baseada em usuário).

    Autenticar 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. Selecione Dados>Bancos de dados no menu à esquerda e 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 Espaço Gerenciado do Azure para Grafana, selecione o espaço de trabalho e escolha Selecionar. Uma notificação de êxito será exibida.

    Configurar a fonte de dados no Grafana

    1. De volta ao Grafana, em Método de autenticação, selecione Identidade Gerenciada.
    2. Selecione Salvar e testar. A notificação "Êxito" exibida indica que o Grafana pode 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 seu método de autenticação preferencial e consulte a guia correspondente abaixo para obter detalhes.

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

Autenticar 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"
    }
  }
}'

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 pelas suas próprias informações.

  1. Obtenha a ID da fonte de dados do Azure Data Explorer a ser atualizada com az grafana data-source list.

    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óxima etapa