> ## 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 Grafana a Insights

> Conecte Grafana a la versión heredada de PlayFab Insights, agregue un origen de datos y cree paneles que ejecuten consultas de Kusto sobre la telemetría del juego para supervisión y alertas.

# Tutorial: Conexión de Grafana a Insights

Esta guía le ayuda a empezar a usar Grafana junto con Insights. Después de conectarse, puede usar Grafana para ejecutar sistemas de análisis y supervisión sobre los datos de su juego procedentes de Insights. 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).

En este tutorial, aprenderá a:

<Note>
  \[!div class="checklist"] \* Configurar Grafana para Insights \* Crear un origen de datos en Grafana \* Crear un panel en Grafana \* Ejecutar consultas y comandos de Kusto mediante el panel
</Note>

<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 Microsoft Entra ID

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 Microsoft Entra ID (anteriormente Azure Active Directory (AAD)) para la autenticación, que es obligatoria 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 Microsoft Entra ID.

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

* Visite [developer.playfab.com](https://developer.playfab.com).
* 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 Microsoft Entra ID y conectarla a la base de datos de su título](/services/playfab/data-analytics/legacy/connectivity/creating-AAD-app-for-insights)

## Preparación con Grafana

1. Hay dos formas de obtener Grafana. Puede [crear una cuenta gratuita](https://grafana.com/login) y descargar Grafana para ejecutarlo en su equipo. O bien, si tiene una suscripción de pago a Grafana Cloud, puede usar su instancia hospedada en línea.
2. Instale el complemento [Azure Data Explorer](https://grafana.com/grafana/plugins/grafana-azure-data-explorer-datasource) para Grafana.

## Crear un origen de datos nuevo en Grafana

Ahora que la base de datos de su título está vinculada a una aplicación de Azure, puede usar la aplicación para conectarse con Grafana. Para crear un origen de datos nuevo:

1. Inicie sesión en Grafana.
2. En la página **Welcome to Grafana**, seleccione **Add data source**.
3. En la página **Add Datasource**, seleccione **Azure Data Explorer Datasource**. Puede buscarlo con la barra de búsqueda o encontrarlo en la sección **Others**. Si no ve la opción **Azure Data Explorer Datasource**, debe instalar el complemento 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="Agregar origen de datos en Grafana" width="1465" height="615" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-add-datasource.png" />
4. En la página de configuración de **Azure Data Explorer Datasource**:
   * En **Cluster URL**, escriba el punto de conexión de la API de PlayFab, que es `https://insights.playfab.com`.
   * Escriba su **Tenant Id**, **Client Id** y **Client secret** de su aplicación de Microsoft Entra ID en sus campos respectivos.
   * Seleccione **Save & Test**. Debería ver un mensaje de retorno **Connection Successful**.
   * En **Default Database**, seleccione el identificador de su título o el nombre de la base de datos. Este campo se rellena automáticamente después de guardar y probar correctamente el origen de datos. Si no aparece tras una conexión correcta, pruebe a salir y volver a abrir la página de configuración. <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="Configuración del origen de datos en Grafana" width="1586" height="707" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-datasource-configuration.png" />

## Crear un panel

Desde la página principal de Grafana crearemos un panel nuevo. Para crear un panel:

1. Seleccione **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="Nuevo panel en Grafana" width="1534" height="333" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-new-dashboard.png" />
2. En el cuadro de diálogo **New Panel**, seleccione **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="Nuevo panel de Grafana" width="829" height="503" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-new-panel.png" />
3. En el panel **Query**, junto a **Database**, seleccione su base de datos en el menú desplegable. En este ejemplo, el nombre de la base de datos es **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="Nueva consulta en Grafana" width="1623" height="549" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-new-query.png" />

## Ejecutar consultas y comandos de Kusto

Ahora va a usar el panel recién creado para ejecutar consultas y comandos de Kusto en su base de datos. Para ejecutar una consulta:

1. En el panel **Query**, junto a **Format As**, seleccione **Table** en el menú desplegable. <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="Formato de tabla en Grafana" width="2200" height="751" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-table-format.png" />
2. Use los iconos de la izquierda para cambiar al panel de visualización. Seleccione el menú desplegable situado a la derecha de **Visualization** y, a continuación, seleccione la opción **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="Visualización de tabla en Grafana" width="2011" height="672" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-table-visualization.png" />
3. Vuelva a la pestaña **Query**. Escriba una consulta y seleccione **Run**. Los resultados aparecen en la tabla situada encima de la pestaña **Query**. En este ejemplo, ejecutamos la 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="Ejecutar consulta en Grafana" width="2253" height="1005" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-run-query.png" /> La ejecución de un comando de Kusto sigue el mismo proceso. Escriba el comando en la pestaña **Query** y seleccione **Run**. Los resultados se muestran arriba. En este ejemplo, ejecutamos el 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="Ejecutar comando en Grafana" width="2254" height="1057" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-run-command.png" />

## Más recursos

* [Documentación de Grafana](https://grafana.com/docs/grafana/latest/)
* 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).
