Configurar uma fonte de dados do Azure Data Explorer

O Azure Data Explorer é um serviço de exploração de dados de telemetria de logs 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

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>Conectar dados.

    Screenshot of the Grafana platform showing the Connect data option.

  4. Selecione Fonte de Dados do Azure Data Explorer na lista e adicione-a ao Grafana selecionando Criar uma fonte de dados de 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.

    Screenshot of the Grafana platform showing the basic configuration settings for Azure Data Explorer.

  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 em usuário).

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

    Adicionar uma nova permissão

    1. No portal do Azure, abra seu 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.

      Screenshot of the Azure platform showing a user adding a viewer permission in an Azure Data Explorer database.

    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. Uma notificação de êxito é 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 & teste. A notificação "Êxito" 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 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.

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

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 comando a seguir.

    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