Configurar uma fonte de dados do Azure Data Explorer
Artigo
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
Uma instância do Azure Managed Grafana no plano Standard.
Adicionar uma fonte de dados do Azure Data Explorer
Adicione uma fonte de dados do Azure Data Explorer ao Grafana seguindo as etapas abaixo.
Abra uma instância do Azure Managed Grafana no portal do Azure.
Na seção Visão geral, abra a URL do ponto de extremidade.
No portal Grafana, implante o menu à esquerda e selecione Conexões>Conectar dados.
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.
Na guia Configurações, opcionalmente, edite o Nome da fonte de dados.
Em Detalhes da Conexão, insira a URL do Cluster do banco de dados do Azure Data Explorer.
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
No portal do Azure, abra seu cluster do Azure Data Explorer.
Na seção Visão geral, selecione o banco de dados que contém seus dados.
Selecione Permissões > Adicionar > Visualizador.
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
De volta ao Grafana, em Método de Autenticação, selecione Identidade Gerenciada.
Selecione Salvar & teste. A notificação "Êxito" exibida indica que o Grafana é capaz de buscar dados do banco de dados.
Autentique-se com o registro do aplicativo usando uma entidade de serviço do Microsoft Entra.
Em Grafana, em Método de Autenticação, selecione Registro de Aplicativo.
Para Nuvem do Azure, selecione sua Nuvem do Azure. Por exemplo, Azure.
Insira uma ID de diretório (locatário), ID de aplicativo (cliente) e segredo do cliente
Opcionalmente, edite também as seções Otimizações de Consulta, Configurações de esquema de banco de dados e Controle .
Selecione Salvar teste de & para validar a conexão. A notificação "Êxito" exibida indica que o Grafana é capaz de se conectar ao banco de dados.
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.
Cuidado
A autenticação baseada em usuário nas fontes de dados do Grafana é experimental.
Cuidado
Esse recurso é incompatível com casos de uso que exigem acesso de máquina sempre ativo aos dados consultados, incluindo Alertas, Relatórios, Cache de consultas e Painéis públicos. O método de autenticação de usuário atual depende de um usuário estar conectado, em uma sessão interativa, para que o Grafana acesse o banco de dados. Quando a autenticação baseada em usuário é usada e nenhum usuário está conectado, as tarefas automatizadas não podem ser executadas em segundo plano. Para aproveitar as tarefas automatizadas do 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.
No portal do Azure, abra o recurso Banco de Dados do Azure Data Explorer e selecione Permissões>Adicionar>Visualizador.
Digite seu nome ou endereço de e-mail na barra de pesquisa, selecione sua conta de usuário e escolha Selecionar.
Uma notificação confirma que a permissão foi adicionada ao banco de dados.
Configurar a fonte de dados no Grafana
Em Grafana, em Método de Autenticação, selecione Usuário Atual.
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.
Autenticar com o método de usuário atual. Esse método aproveita 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.
Observação
A implantação da autenticação baseada em usuário no Azure Managed Grafana está em andamento e será concluída em todas as regiões até o final de 2023.
Cuidado
A autenticação baseada em usuário nas fontes de dados do Grafana é experimental.
Cuidado
Esse recurso é incompatível com casos de uso que exigem acesso de máquina sempre ativo aos dados consultados, incluindo Alertas, Relatórios, Cache de consultas e Painéis públicos. O método de autenticação de usuário atual depende de um usuário estar conectado, em uma sessão interativa, para que o Grafana acesse o banco de dados. Quando a autenticação baseada em usuário é usada e nenhum usuário está conectado, as tarefas automatizadas não podem ser executadas em segundo plano. Para aproveitar as tarefas automatizadas do Azure Data Explorer, recomendamos configurar outra fonte de dados do Azure Data Explorer usando outro método de autenticação.
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.
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"