> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectando o Grafana ao Insights

> Conecte o Grafana ao PlayFab Insights herdado, adicione uma fonte de dados e crie painéis que executam consultas Kusto na telemetria do seu jogo para monitoramento e alertas.

# Tutorial: Conectando o Grafana ao Insights

Este guia ajuda você a começar a usar o Grafana com o Insights. Após a conexão, você pode usar o Grafana para executar sistemas de análise e monitoramento nos dados do seu jogo provenientes do Insights. Para saber mais sobre outras ferramentas às quais você pode conectar o Insights, confira [Conectando ferramentas externas ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity).

Neste tutorial, você aprenderá a:

<Note>
  \[!div class="checklist"] \* Configurar o Grafana para o Insights \* Criar uma fonte de dados no Grafana \* Criar um painel no Grafana \* Executar consultas e comandos Kusto usando o painel
</Note>

<Note>
  O PlayFab Insights Management foi desativado em 31/03/2026. Recomendamos usar as [Conexões do Azure Data Explorer (ADX)](/pt-BR/services/playfab/data-analytics/export-data/data-connection-adx) para gerenciar seu desempenho e custo daqui em diante. Se o seu título ainda estiver usando o **Insights**, continue consultando este artigo para obter detalhes de implementação. Para obter mais informações, confira [PlayFab Digest: March feature updates](https://developer.microsoft.com/en-us/games/articles/2026/04/playfab-digest-march-feature-updates/).
</Note>

## Pré-requisitos

### Conta do PlayFab autenticada com o Microsoft Entra ID

Você precisa de uma conta ou usuário do PlayFab cujo provedor de autenticação esteja definido como Microsoft. O provedor de autenticação da Microsoft usa o Microsoft Entra ID (anteriormente Azure Active Directory (AAD)) para autenticação, o que é necessário para usar os serviços do Azure. Confira [Autenticação do Azure Active Directory para o Game Manager](/pt-BR/services/playfab/identity/dev-identity/authentication/aad-authentication) para obter instruções sobre como criar uma conta ou usuário autenticado pelo Microsoft Entra ID.

Para verificar se a conta, ou o usuário, está definida para usar o provedor de autenticação da Microsoft:

* Acesse [developer.playfab.com](https://developer.playfab.com).
* Selecione **Entrar com a Microsoft** para acessar sua conta do PlayFab.

Se você conseguir entrar, a conta está definida para usar o provedor de autenticação da Microsoft.

### Permissões do Game Manager para o Insights

Você precisa atribuir à sua conta uma [função de usuário](/pt-BR/services/playfab/identity/dev-identity/permissions/playfab-user-roles) com as seguintes permissões do Game Manager habilitadas:

* Status de administrador.
* Acesso à guia Explorer e aos dados associados.
* Acesso de leitura e gravação aos dados de Analytics.

Você pode criar uma nova função de usuário ou adicionar essas permissões a uma função existente.

### Outros pré-requisitos

* [Criar um aplicativo do Microsoft Entra ID e conectá-lo ao banco de dados do seu título](/pt-BR/services/playfab/data-analytics/legacy/connectivity/creating-AAD-app-for-insights)

## Configurar o Grafana

1. Há duas maneiras de obter o Grafana. Você pode [criar uma conta gratuita](https://grafana.com/login) e baixar o Grafana para executá-lo no seu computador. Ou, se você tiver uma assinatura paga do Grafana Cloud, poderá usar sua instância hospedada online.
2. Instale o plug-in [Azure Data Explorer](https://grafana.com/grafana/plugins/grafana-azure-data-explorer-datasource) para o Grafana.

## Criar uma nova fonte de dados no Grafana

Agora que o banco de dados do seu título está vinculado a um aplicativo do Azure, você pode usar o aplicativo para se conectar com o Grafana. Para criar uma nova fonte de dados:

1. Faça login no Grafana.
2. Na página **Welcome to Grafana**, selecione **Add data source**.
3. Na página **Add Datasource**, selecione **Azure Data Explorer Datasource**. Você pode pesquisá-la com a barra de pesquisa ou encontrá-la listada na seção **Others**. Se você não vir a opção **Azure Data Explorer Datasource**, precisará instalar o plug-in Azure Data Explorer Datasource For Grafana. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-add-datasource.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=308a78625124cecfa0190ffa2a6d902f" alt="Grafana Adicionar fonte de dados" width="1465" height="615" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-add-datasource.png" />
   


4. Na página de configuração **Azure Data Explorer Datasource**:
   * Em **Cluster URL**, insira o ponto de extremidade da API do PlayFab, que é `https://insights.playfab.com`.
   * Insira o **Tenant Id**, o **Client Id** e o **Client secret** do seu aplicativo do Microsoft Entra ID nos respectivos campos.
   * Selecione **Save & Test**. Você deverá ver uma mensagem de retorno **Connection Successful**.
   * Em **Default Database**, selecione a ID do título ou o nome do banco de dados. Esse campo é preenchido automaticamente depois que você salva e testa a fonte de dados com êxito. Se ele não aparecer após uma conexão bem-sucedida, tente sair e reabrir a página de configuração. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-datasource-configuration.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=7fe6afaa1c39f94ac85d74cddaab1fb3" alt="Grafana Configuração da fonte de dados" width="1586" height="707" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-datasource-configuration.png" />

## Criar um painel

Na página inicial do Grafana, criaremos um novo painel. Para criar um painel:

1. Selecione **New dashboard**. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-new-dashboard.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=ee1ccd38c312c481a7e6d1e3853814e3" alt="Grafana Novo painel" width="1534" height="333" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-new-dashboard.png" />
2. Na caixa de diálogo **New Panel**, selecione **Add Query**. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-new-panel.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=0ce9eb2fe67f337040ec2ec4d003d3c5" alt="Grafana Novo painel de visualização" width="829" height="503" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-new-panel.png" />
3. No painel **Query**, ao lado de **Database**, selecione seu banco de dados no menu suspenso. Neste exemplo, o nome do banco de dados é **Unicorn Battle**. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-new-query.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=6e1cc311d6f82ec40188249d889ac2f2" alt="Grafana Nova consulta" width="1623" height="549" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-new-query.png" />

## Executar consultas e comandos Kusto

Agora você usará o painel recém-criado para executar consultas e comandos Kusto no seu banco de dados. Para executar uma consulta:

1. No painel **Query**, ao lado de **Format As**, selecione **Table** no menu suspenso. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-table-format.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=15b7b1dc9f43ee66429f41189838af0e" alt="Grafana Formato de tabela" width="2200" height="751" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-table-format.png" />
2. Use os ícones à esquerda para alternar para o painel Visualization. Selecione o menu suspenso à direita de **Visualization** e, em seguida, selecione a opção **Table**. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-table-visualization.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=3de1502c1bf2f8673833c3a2345be6e7" alt="Grafana Visualização de tabela" width="2011" height="672" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-table-visualization.png" />
3. Volte para a guia **Query**. Insira uma consulta e selecione **Run**. Os resultados aparecem na tabela acima da guia **Query**. Neste exemplo, executamos a consulta `['events.all'] | limit 100`. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-run-query.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=fd1c90e47b834a11c7d7cb4c6e9c0540" alt="Grafana Executar consulta" width="2253" height="1005" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-run-query.png" /> A execução de um comando Kusto segue o mesmo processo. Insira seu comando na guia **Query** e selecione **Run**. Os resultados são exibidos acima. Neste exemplo, executamos o comando `.show tables`. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-run-command.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=8aa9b399068f41b749546d148fead7bc" alt="Grafana Executar comando" width="2254" height="1057" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-run-command.png" />

## Mais recursos

* [Documentação do Grafana](https://grafana.com/docs/grafana/latest/)
* Para saber mais sobre outras ferramentas para se conectar ao Insights, confira  [Conectando ferramentas externas ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity).


## Related topics

- [Conectando ferramentas externas ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/index.md)
- [Conectando o Python ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-python-to-insights.md)
- [Conectando o Kusto Explorer ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-kusto-explorer-to-insights.md)
- [Conectando o Power BI ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-power-bi-to-insights.md)
- [Conectando o Azure Data Explorer ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-azure-data-explorer-to-insights.md)