> ## 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.

# Conexión de Python a Insights

> Consulte la versión heredada de PlayFab Insights desde Python y Jupyter Notebooks con el SDK de Python de Azure Kusto, usando autenticación de Microsoft Entra ID para los datos de su juego.

# Tutorial: Conexión de Python a Insights

Esta guía le ayuda a empezar a usar Python con Insights. Usa el SDK de Python de Azure Kusto. Después de conectarse, puede consultar los datos de su juego con Python y usar la biblioteca desde Jupyter Notebooks. Para obtener más información sobre otras herramientas que puede conectar a Insights, consulte [Conexión de herramientas externas a Insights](/services/playfab/data-analytics/legacy/connectivity).

<Note>
  PlayFab Insights Management se retiró el 31/03/2026. Le recomendamos usar las [conexiones de Azure Data Explorer (ADX)](/services/playfab/data-analytics/export-data/data-connection-adx) para administrar su rendimiento y costos de ahora en adelante. Si su título todavía usa **Insights**, siga consultando este artículo para conocer los detalles de implementación. Para obtener más información, consulte [PlayFab Digest: March feature updates](https://developer.microsoft.com/en-us/games/articles/2026/04/playfab-digest-march-feature-updates/).
</Note>

## Requisitos previos

### Cuenta de PlayFab autenticada con Azure AD

Necesita una cuenta o un usuario de PlayFab cuyo proveedor de autenticación esté establecido en Microsoft. El proveedor de autenticación de Microsoft usa Azure Active Directory (Azure AD) para la autenticación, lo cual es obligatorio para usar los servicios de Azure. Consulte [Autenticación de Azure Active Directory para Game Manager](/services/playfab/identity/dev-identity/authentication/aad-authentication) para obtener instrucciones sobre cómo crear una cuenta o un usuario autenticado con Azure AD.

Para comprobar que la cuenta, o el usuario, está configurado para usar el proveedor de autenticación de Microsoft:

* Visite la [página de inicio de sesión](https://developer.playfab.com) de PlayFab.
* Seleccione **Sign in with Microsoft** para acceder a su cuenta de PlayFab.

Si puede iniciar sesión, la cuenta está configurada para usar el proveedor de autenticación de Microsoft.

### Permisos de Game Manager para Insights

Debe asignar a su cuenta un [rol de usuario](/services/playfab/identity/dev-identity/permissions/playfab-user-roles) con los siguientes permisos de Game Manager habilitados:

* Estado de administrador.
* Acceso a la pestaña Explorer y a los datos asociados.
* Acceso de lectura y escritura a los datos de Analytics.

Puede crear un rol de usuario nuevo o agregar estos permisos a un rol existente.

### Otros requisitos previos

* [Crear una aplicación de Azure Active Directory (AAD) y conectarla a la base de datos de su título](/services/playfab/data-analytics/legacy/connectivity/creating-AAD-app-for-insights)

## Instalar los paquetes de Python

1. Instale los siguientes paquetes de Python mediante [pip](https://pypi.org/project/pip/):
   * azure-kusto-data
   * azure-kusto-ingest
   * adal
2. A continuación se muestra un script de ejemplo para empezar.

```python theme={null}
from azure.kusto.data.exceptions import KustoServiceError
from azure.kusto.data.request import KustoClient, KustoConnectionStringBuilder, ClientRequestProperties

from msal import ConfidentialClientApplication

cluster = "https://insights.playfab.com"

# These parameters are taken from your Azure app
client_id = "<Azure app client id>"
client_secret = "<Azure app client secret>" 
tenant = "<Azure app tenant id>"

authority_url = "https://login.microsoftonline.com/" + tenant

client_instance = ConfidentialClientApplication(
  client_id=client_id,
  client_credential=client_secret,
  authority=authority_url,
)

# Acquire a token from AAD to pass to PlayFab
_scopes = ["https://help.kusto.windows.net"]
token_response = client_instance.acquire_token_for_client(scopes=_scopes)

token = None
if token_response:
    if token_response['access_token']:
        token = token_response['access_token']

kcsb = KustoConnectionStringBuilder.with_aad_application_token_authentication(cluster, token)
client = KustoClient(kcsb)

db = "<title id>"
query = "['events.all'] | count"

# Force Kusto to use the v1 query endpoint
client._query_endpoint = cluster + "/v1/rest/query"

crp = ClientRequestProperties()
crp.application = "KustoPythonSDK"
response = client.execute(db, query)

# Response processing
print(response)
```

## Recursos adicionales

* [Documentación del SDK de Python de Azure Kusto](https://learn.microsoft.com/en-us/azure/data-explorer/kusto/api/python/kusto-python-client-library)
* Para obtener información sobre otras herramientas para conectarse a Insights, consulte [Conexión de herramientas externas a Insights](/services/playfab/data-analytics/legacy/connectivity)


## Related topics

- [Conexión de herramientas externas con Insights](/es/services/playfab/data-analytics/legacy/connectivity/index.md)
- [Conexión de Grafana a Insights](/es/services/playfab/data-analytics/legacy/connectivity/connecting-grafana-to-insights.md)
- [Conexión de Power BI a Insights](/es/services/playfab/data-analytics/legacy/connectivity/connecting-power-bi-to-insights.md)
- [Conexión de Kusto Explorer a Insights](/es/services/playfab/data-analytics/legacy/connectivity/connecting-kusto-explorer-to-insights.md)
- [Conexión del SDK de C# de Kusto a Insights](/es/services/playfab/data-analytics/legacy/connectivity/connecting-kusto-csharp-to-insights.md)