Visualizar dados do Azure Data Explorer em GrafanaVisualize data from Azure Data Explorer in Grafana

Grafana é uma plataforma de análise que lhe permite consultar e visualizar dados, em seguida, criar e partilhar dashboards com base nas suas visualizações.Grafana is an analytics platform that enables you to query and visualize data, then create and share dashboards based on your visualizations. Grafana fornece um pluginAzure Data Explorer, que lhe permite ligar e visualizar dados do Azure Data Explorer.Grafana provides an Azure Data Explorer plugin, which enables you to connect to and visualize data from Azure Data Explorer. Neste artigo, aprende-se a configurar o Azure Data Explorer como fonte de dados para grafana e, em seguida, visualizar dados de um cluster de amostras.In this article, you learn to set up Azure Data Explorer as a data source for Grafana, and then visualize data from a sample cluster.

Utilize o seguinte vídeo, para aprender a usar o plugin Azure Data Explorer da Grafana, configurar o Azure Data Explorer como fonte de dados para grafana e, em seguida, visualizar dados.Use the following video, to learn how to use Grafana's Azure Data Explorer plugin, set up Azure Data Explorer as a data source for Grafana, and then visualize data.

Em alternativa, pode configurar a fonte de dados e visualizar dados conforme detalhado no artigo abaixo.Alternatively you can configure the data source and visualize data as detailed in the article below.

Pré-requisitosPrerequisites

Precisa do seguinte para completar este artigo:You need the following to complete this article:

Configure a fonte de dadosConfigure the data source

Executa os seguintes passos para configurar o Azure Data Explorer como fonte de dados para a sua ferramenta de painel de instrumentos.You perform the following steps to configure Azure Data Explorer as a data source for your dashboard tool. Cobriremos estes passos mais detalhadamente nesta secção:We'll cover these steps in more detail in this section:

  1. Crie um diretor de serviço azure Ative Directory (Azure AD).Create an Azure Active Directory (Azure AD) service principal. O diretor de serviço é utilizado pela sua ferramenta de painel de instrumentos para aceder ao serviço Azure Data Explorer.The service principal is used by your dashboard tool to access the Azure Data Explorer service.

  2. Adicione o principal serviço azure AD ao papel dos espectadores na base de dados do Azure Data Explorer.Add the Azure AD service principal to the viewers role in the Azure Data Explorer database.

  3. Especifique as propriedades de ligação da ferramenta do painel de instrumentos com base em informações do diretor de serviço da AD Azure e, em seguida, teste a ligação.Specify your dashboard tool connection properties based on information from the Azure AD service principal, then test the connection.

Criar um principal de serviçoCreate a service principal

Pode criar o diretor de serviço no portal Azure ou utilizar a experiência da linha de comando Azure CLI.You can create the service principal in the Azure portal or using the Azure CLI command-line experience. Independentemente do método que utilizar, após a criação obtém valores para quatro propriedades de ligação que utilizará em etapas posteriores.Regardless of which method you use, after creation you get values for four connection properties that you'll use in later steps.

Portal do AzureAzure portal

  1. Para criar o diretor de serviço, siga as instruções na documentação do portal Azure.To create the service principal, follow the instructions in the Azure portal documentation.

    1. Na Atribuição da aplicação a uma secção de funções, atribua um tipo de papel de Leitor ao seu cluster Azure Data Explorer.In the Assign the application to a role section, assign a role type of Reader to your Azure Data Explorer cluster.

    2. Nos valores Get para a assinatura na secção, copie os três valores de propriedade abrangidos pelas etapas: ID do Diretório (ID do inquilino), ID de aplicaçãoe Palavra-passe.In the Get values for signing in section, copy the three property values covered in the steps: Directory ID (tenant ID), Application ID, and Password.

  2. No portal Azure, selecione Subscrições e, em seguida, copie o ID para a subscrição em que criou o diretor de serviço.In the Azure portal, select Subscriptions then copy the ID for the subscription in which you created the service principal.

    ID de subscrição - portal

CLI do AzureAzure CLI

  1. Crie um diretor de serviço.Create a service principal. Definir um âmbito adequado e readerum tipo de função de .Set an appropriate scope and a role type of reader.

    az ad sp create-for-rbac --name "https://{UrlToYourDashboard}:{PortNumber}" --role "reader" \
                             --scopes /subscriptions/{SubID}/resourceGroups/{ResourceGroupName}
    

    Para mais informações, consulte Criar um diretor de serviço Azure com o Azure CLI.For more information, see Create an Azure service principal with Azure CLI.

  2. O comando devolve um resultado definido como o seguinte.The command returns a result set like the following. Copie os três valores de propriedade: appID, password, e inquilino.Copy the three property values: appID, password, and tenant.

    {
      "appId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
      "displayName": "{UrlToYourDashboard}:{PortNumber}",
      "name": "https://{UrlToYourDashboard}:{PortNumber}",
      "password": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
      "tenant": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
    }
    
  3. Obtenha uma lista das suas assinaturas.Get a list of your subscriptions.

    az account list --output table
    

    Copie o ID de subscrição apropriado.Copy the appropriate subscription ID.

    ID de subscrição - CLI

Adicione o principal de serviço ao papel dos espectadoresAdd the service principal to the viewers role

Agora que tem um diretor de serviço, adicione-o ao papel dos espectadores na base de dados do Azure Data Explorer.Now that you have a service principal, you add it to the viewers role in the Azure Data Explorer database. Pode executar esta tarefa sob Permissões no portal Azure, ou sob consulta utilizando um comando de gestão.You can perform this task under Permissions in the Azure portal, or under Query by using a management command.

Portal Azure - PermissõesAzure portal - Permissions

  1. No portal Azure, vá ao seu cluster Azure Data Explorer.In the Azure portal, go to your Azure Data Explorer cluster.

  2. Na secção Visão Geral, selecione a base de dados com os dados da amostra StormEvents.In the Overview section, select the database with the StormEvents sample data.

    Selecionar base de dados

  3. Selecione Permissões e, em seguida, adicionar .Select Permissions then Add.

    Permissões de base de dados

  4. Em adicionar permissõesde base de dados, selecione a função 'Visualizar' e, em seguida, selecione os principais.Under Add database permissions, select the Viewer role then Select principals.

    Adicionar permissões de base de dados

  5. Procure o diretor de serviço que criou.Search for the service principal you created. Selecione o comitente e, em seguida, selecione.Select the principal, then Select.

    Gerir permissões no portal Azure

  6. Selecione Guardar.Select Save.

    Gerir permissões no portal Azure

Comando de gestão - ConsultaManagement command - Query

  1. No portal Azure, vá ao seu cluster Azure Data Explorer e selecione Query.In the Azure portal, go to your Azure Data Explorer cluster, and select Query.

    Consulta

  2. Executar o seguinte comando na janela de consulta.Run the following command in the query window. Utilize o ID de inscrição e identificação do inquilino do portal Azure ou CLI.Use the application ID and tenant ID from the Azure portal or CLI.

    .add database {TestDatabase} viewers ('aadapp={ApplicationID};{TenantID}')
    

    O comando devolve um resultado definido como o seguinte.The command returns a result set like the following. Neste exemplo, a primeira linha é para um utilizador existente na base de dados, e a segunda linha é para o diretor de serviço que acabou de ser adicionado.In this example, the first row is for an existing user in the database, and the second row is for the service principal that was just added.

    Conjunto de resultados

Especificar propriedades e testar a ligaçãoSpecify properties and test the connection

Com o principal de serviço atribuído à função de espectadores, agora especifica propriedades no seu caso de Grafana, e testa a ligação ao Azure Data Explorer.With the service principal assigned to the viewers role, you now specify properties in your instance of Grafana, and test the connection to Azure Data Explorer.

  1. Em Grafana, no menu esquerdo, selecione o ícone da engrenagem e depois fontesde dados .In Grafana, on the left menu, select the gear icon then Data Sources.

    Origens de dados

  2. Selecione Adicionar fonte de dados.Select Add data source.

  3. Na página Fontes de Dados / Nova página, introduza um nome para a fonte de dados e, em seguida, selecione o tipo Azure Datasourcedo Explorador de Dados .On the Data Sources / New page, enter a name for the data source, then select the type Azure Data Explorer Datasource.

    Nome e tipo de ligação

  4. Introduza o nome do seu cluster no formulário https://{ClusterName}. {Região}.kusto.windows.net.Enter the name of your cluster in the form https://{ClusterName}.{Region}.kusto.windows.net. Introduza os outros valores do portal Azure ou CLI.Enter the other values from the Azure portal or CLI. Consulte a tabela abaixo da seguinte imagem para um mapeamento.See the table below the following image for a mapping.

    Propriedades de ligação

    Grafana UIGrafana UI Portal do AzureAzure portal CLI do AzureAzure CLI
    ID da SubscriçãoSubscription Id ID DA SUBSCRIÇÃOSUBSCRIPTION ID SubscriptionIdSubscriptionId
    Id inquilinoTenant Id ID do diretórioDirectory ID inquilinotenant
    Id do clienteClient Id ID da aplicaçãoApplication ID appIdappId
    Segredo do clienteClient secret Palavra-passePassword palavra-passepassword
  5. Selecione Guardar & Teste.Select Save & Test.

    Se o teste for bem sucedido, vá para a próxima secção.If the test is successful, go to the next section. Se encontrar algum problema, verifique os valores especificados em Grafana e reveja os passos anteriores.If you come across any issues, check the values you specified in Grafana, and review previous steps.

Visualizar os dadosVisualize data

Agora que terminou de configurar o Azure Data Explorer como fonte de dados para grafana, é hora de visualizar dados.Now you've finished configuring Azure Data Explorer as a data source for Grafana, it's time to visualize data. Vamos dar um exemplo básico aqui, mas há muito mais que pode fazer.We'll show a basic example here, but there's a lot more you can do. Recomendamos que se analise as consultas de Escrita para o Azure Data Explorer, por exemplo, outras consultas para correr contra o conjunto de dados da amostra.We recommend looking at Write queries for Azure Data Explorer for examples of other queries to run against the sample data set.

  1. Em Grafana, no menu esquerdo, selecione o ícone plus em seguida Dashboard.In Grafana, on the left menu, select the plus icon then Dashboard.

    Criar painel de instrumentos

  2. Sob o separador Adicionar, selecione Graph.Under the Add tab, select Graph.

    Adicionar gráfico

  3. No painel de gráficos, selecione Título do Painel e, em seguida, editar .On the graph panel, select Panel Title then Edit.

    Painel de edição

  4. Na parte inferior do painel, selecione Data Source e, em seguida, selecione a fonte de dados que configura.At the bottom of the panel, select Data Source then select the data source that you configured.

    Selecionar origem de dados

  5. No painel de consulta, copie na seguinte consulta e, em seguida, selecione Executar.In the query pane, copy in the following query then select Run. A consulta baldea a contagem de eventos por dia para o conjunto de dados da amostra.The query buckets the count of events by day for the sample data set.

    StormEvents
    | summarize event_count=count() by bin(StartTime, 1d)
    

    Executar consulta

  6. O gráfico não mostra resultados porque é examinado por padrão aos dados das últimas seis horas.The graph doesn't show any results because it's scoped by default to data from the last six hours. No menu superior, selecione Last 6 horas.On the top menu, select Last 6 hours.

    Últimas seis horas

  7. Especifique uma gama personalizada que cubra 2007, o ano incluído no nosso conjunto de dados de amostrastormEvents.Specify a custom range that covers 2007, the year included in our StormEvents sample data set. Selecione Aplicar.Select Apply.

    Gama de datas personalizada

    Agora o gráfico mostra os dados de 2007, baldeados de dia.Now the graph shows the data from 2007, bucketed by day.

    Gráfico acabado

  8. No menu superior, selecione o ícone de guardar:On the top menu, select the save icon: Salvar o ícone..

Criar AlertasCreate Alerts

  1. No Home Dashboard, selecionecanais de notificação de > alerta para criar um novo canal de notificaçãoIn Home Dashboard, select Alerting > Notification channels to create a new notification channel

    criar canal de notificação

  2. Crie um novo canal de Notificação, em seguida, guardar.Create a new Notification channel, then Save.

    Criar novo canal de notificação

  3. No Dashboard, selecione Editar a partir da queda.On the Dashboard, select Edit from the dropdown.

    selecionar editar no painel de instrumentos

  4. Selecione o ícone do sino de alerta para abrir o painel alerta.Select the alert bell icon to open the Alert pane. Selecione Criar Alerta.Select Create Alert. Complete as seguintes propriedades no painel alerta.Complete the following properties in the Alert pane.

    propriedades de alerta

  5. Selecione o ícone do painel de dados Save para guardar as suas alterações.Select the Save dashboard icon to save your changes.

Passos seguintesNext steps