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. Neste tutorial, você aprenderá a:[!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
O PlayFab Insights Management foi desativado em 31/03/2026. Recomendamos usar as Conexões do Azure Data Explorer (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.
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 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.
- Selecione Entrar com a Microsoft para acessar sua conta do PlayFab.
Permissões do Game Manager para o Insights
Você precisa atribuir à sua conta uma função de usuário 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.
Outros pré-requisitos
Configurar o Grafana
- Há duas maneiras de obter o Grafana. Você pode criar uma conta gratuita 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.
- Instale o plug-in Azure Data Explorer 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:- Faça login no Grafana.
- Na página Welcome to Grafana, selecione Add data source.
- 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.
- 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.
- Em Cluster URL, insira o ponto de extremidade da API do PlayFab, que é
Criar um painel
Na página inicial do Grafana, criaremos um novo painel. Para criar um painel:- Selecione New dashboard.
- Na caixa de diálogo New Panel, selecione Add Query.
- 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.
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:- No painel Query, ao lado de Format As, selecione Table no menu suspenso.
- 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.
- 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.
.show tables.
Mais recursos
- Documentação do Grafana
- Para saber mais sobre outras ferramentas para se conectar ao Insights, confira Conectando ferramentas externas ao Insights.