Configurar uma fonte de dados do Azure Data Explorer
Artigo
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
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 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.
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 no usuário).
Autentique-se 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 Bancos de Dados> no menu à esquerda e, em seguida, 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. É apresentada uma notificação de êxito.
Configurar a fonte de dados no Grafana
De volta ao Grafana, em Método de autenticação, selecione Identidade gerenciada.
Selecione Save & test. A notificação "Sucesso" 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.
Siga as três primeiras etapas do guia Recuperar detalhes do aplicativo para reunir o ID do diretório (locatário), o ID do aplicativo (cliente) e o 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 do aplicativo.
Para a Nuvem do Azure, selecione sua Nuvem do Azure. Por exemplo, Azure.
Insira um ID de 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 de esquema de banco de dados e Acompanhamento .
Selecione Salvar teste & para validar a conexão. A notificação "Sucesso" 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.
Atenção
A autenticação baseada no usuário em fontes de dados Grafana é experimental.
Atenção
Esse recurso é incompatível com casos de uso que exigem acesso sempre ativo da máquina 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 no usuário é usada e nenhum usuário está conectado, as tarefas automatizadas não podem ser executadas em segundo plano. Para aproveitar tarefas automatizadas para o 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 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 o método de 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.
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.
Nota
A implantação da autenticação baseada no usuário no Azure Managed Grafana está em andamento e será concluída em todas as regiões até o final de 2023.
Atenção
A autenticação baseada no usuário em fontes de dados Grafana é experimental.
Atenção
Esse recurso é incompatível com casos de uso que exigem acesso sempre ativo da máquina 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 no usuário é usada e nenhum usuário está conectado, as tarefas automatizadas não podem ser executadas em segundo plano. Para aproveitar tarefas automatizadas para o 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"