Configurar uma fonte de dados do Azure Data Explorer
Artigo
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.
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 Espaço Gerenciado do Azure para Grafana no portal do Azure.
Na seção Visão geral, abra a URL do Ponto de extremidade.
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.
Na guia Configurações, edite opcionalmente 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 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
No portal do Azure, abra o cluster do Azure Data Explorer.
Selecione Dados>Bancos de dados no menu à esquerda e 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 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
De volta ao Grafana, em Método de autenticação, selecione Identidade Gerenciada.
Selecione Salvar e testar. A notificação "Êxito" exibida indica que o Grafana pode buscar dados do banco de dados.
Autenticar com registro de aplicativo usando uma entidade de serviço do Microsoft Entra.
Siga as três primeiras etapas do guia Recuperar detalhes do aplicativo para reunira ID do Diretório (locatário), ID do Aplicativo (cliente) e ID do Segredo do Cliente necessários na próxima etapa.
Configurar a fonte de dados no Grafana
No 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 do Diretório (locatário), ID do Aplicativo (cliente) e Segredo do Cliente
Opcionalmente, edite também as seções Otimizações de consulta, Configurações do esquema do banco de dados e Rastreamento.
Selecione Salvar e testar para validar a conexão. A notificação "Êxito" exibida indica que o Grafana pode se conectar ao banco de dados.
Use o método de autenticação baseado em usuário, aproveitando as credenciais de ID do Microsoft Entra do usuário atual do Grafana na fonte de dados configurada.
Ao configurar uma fonte de dados do Azure Data Explorer com o método de autenticação Usuário Atual, o Grafana consultará o Azure Data Explorer usando as credenciais do usuário.
Cuidado
A autenticação baseada em usuário em fontes de dados do Grafana é experimental.
Cuidado
Esse recurso é incompatível com casos de uso que exigem o acesso do computador sempre ativo 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 em usuário for usada e nenhum usuário estiver conectado, as tarefas automatizadas não poderão 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.
Insira seu nome ou endereço de email na barra de pesquisa, selecione sua conta de usuário e escolha Selecionar.
Uma notificação confirmará que a permissão foi adicionada ao banco de dados.
Configurar a fonte de dados no Grafana
No Grafana, em Método de autenticação, selecione Usuário Atual.
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 o método 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.
Ao configurar uma fonte de dados do Azure Data Explorer com o método de autenticação Usuário Atual, o Grafana consultará o Azure Data Explorer usando as credenciais do usuário.
Observação
A implementação da autenticação baseada em usuário no Espaço Gerenciado do Azure para 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 em fontes de dados do Grafana é experimental.
Cuidado
Esse recurso é incompatível com casos de uso que exigem o acesso do computador sempre ativo 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 em usuário for usada e nenhum usuário estiver conectado, as tarefas automatizadas não poderão 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 pelas suas próprias informações.
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"