> ## 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 Kusto Explorer ao Insights

> Configure o Kusto Explorer com a autenticação do Microsoft Entra ID para executar consultas KQL e explorar a telemetria de jogos do PlayFab Insights herdado em um cliente de desktop.

# Tutorial: Conectando o Kusto Explorer ao Insights

Este guia ajuda você a começar a usar o Kusto Explorer com o Insights. Após a conexão, você pode usar o Kusto Explorer para consultar e explorar os dados do seu jogo. 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).

<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 AAD

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 Azure Active Directory (AAD) para autenticação, o que é necessário para usar os serviços do Azure. Para obter instruções sobre como criar uma conta ou usuário autenticado pelo AAD, confira [Autenticação do Azure Active Directory para o Game Manager](/pt-BR/services/playfab/identity/dev-identity/authentication/aad-authentication).

Verifique se a conta ou o usuário está definido para usar o provedor de autenticação da Microsoft.

* Navegue até [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

* [Kusto.Explorer](https://learn.microsoft.com/en-us/azure/data-explorer/kusto/tools/kusto-explorer)

<Info>
  O Insights só é compatível com o esquema de resposta de consulta V1. Você pode atualizar o esquema de resposta no Kusto Explorer usando as etapas abaixo.
</Info>

No seu computador local, abra o Kusto.Explorer.

1. Selecione a guia **Tools** e, em seguida, selecione **Options...**
2. Na categoria **Connections**, altere as duas propriedades a seguir.
   * Defina **Query results protocol** como **V1** nas opções da lista suspensa.
   * Defina **KQL Parser version** como **V1** nas opções da lista suspensa. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/kusto-explorer-settings-v1.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=a077b69a92ed2988a31fc2121bcef523" alt="Kusto.Explorer usar o esquema de consulta V1" width="1224" height="798" data-path="images/playfab/data-analytics/legacy/connectivity/kusto-explorer-settings-v1.png" />

## Conectar com o Kusto Explorer

No seu computador local, abra o Kusto.Explorer.

1. Adicione uma conexão. Você pode fazer isso de duas maneiras diferentes:
   * Selecione a guia **Connections** e, em seguida, selecione **Add connection**.
   * Clique com o botão direito do mouse na pasta **Connections** no painel de navegação à esquerda e, em seguida, selecione **Add connection**.
2. Na caixa de diálogo **Add connection**:
   * Em **Cluster connection**, insira o ponto de extremidade da API do PlayFab, que é `https://insights.playfab.com`.
   * Em **Security**, verifique se **AAD Federated** está selecionado.
   * Expanda a caixa **Advanced: Connection String** e altere o valor de **Initial Catalog** de **NetDefaultDB** para `<titleID>`. Observe que `<titleID>` deve estar todo em letras maiúsculas aqui. No exemplo abaixo, essa alteração está realçada na cadeia de caracteres. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/kusto-explorer.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=feb4b0a0263962b659ef2436ac7d174e" alt="Kusto.Explorer adicionar conexão" width="844" height="598" data-path="images/playfab/data-analytics/legacy/connectivity/kusto-explorer.png" />
3. Selecione **OK**. Agora você deverá conseguir visualizar os resultados da consulta.

## Recursos adicionais

* [Documentação do Kusto Explorer](https://learn.microsoft.com/en-us/azure/kusto/tools/kusto-explorer)
* [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 Azure Data Explorer ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-azure-data-explorer-to-insights.md)
- [Conectando o SDK do Kusto para C# ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-kusto-csharp-to-insights.md)
- [Conectando o Python ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-python-to-insights.md)
- [Conectando o Grafana ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-grafana-to-insights.md)
