Partilhar via


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

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 do Grafana, vá para Connections>Data sources>Add new data source e, em seguida, pesquise e selecione Azure Data Explorer Datasource.

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.

    Captura de ecrã da plataforma Grafana a mostrar as definições de configuração básicas para o 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 no usuário).

    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. Selecione Bancos de Dados> no menu à esquerda e, em seguida, 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.

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.

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 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