Visualización de datos desde Azure Data Explorer en Grafana

Grafana es una plataforma de análisis en la que puede consultar y visualizar datos y, a continuación, crear y compartir paneles en función de las visualizaciones. Grafana proporciona un complemento de Azure Data Explorer, que permite conectarse a datos de Azure Data Explorer y visualizarlos. El complemento funciona con Azure Managed Grafana y Grafana autohospedado.

En este artículo, aprenderá a configurar el clúster como origen de datos para Grafana y a visualizar datos en Grafana para Azure Managed Grafana y Grafana autohospedado. Para seguir los ejemplos de este artículo, ingiere los datos de ejemplo de StormEvents. El conjunto de datos de ejemplo StormEvents contiene datos relacionados con el tiempo de los Centros Nacionales de Información Ambiental.

Requisitos previos

• Para Azure Managed Grafana, una cuenta de Azure y una instancia de Grafana administrada de Azure.
• Para Grafana autohospedado, Grafana versión 5.3.0 o posterior para el sistema operativo y el complemento azure Data Explorer para Grafana. Necesita el complemento versión 3.0.5 o posterior para usar el generador de consultas de Grafana.
• Un clúster y la base de datos de Azure Data Explorer. Puede crear un clúster gratuito o crear un clúster completo. Para decidir cuál es el mejor para usted, compruebe la comparación de características.

Configuración del origen de datos

Para configurar Azure Data Explorer como origen de datos, siga los pasos del entorno de Grafana.

Azure Managed Grafana

Adición de la identidad administrada al rol Visor

Managed Grafana crea una identidad administrada asignada por el sistema para cada área de trabajo nueva de forma predeterminada. Puede usarlo para acceder al clúster de Azure Data Explorer.

1. En Azure Portal, vaya al clúster de Azure Data Explorer.

2. En la sección Información general , seleccione la base de datos que tiene los datos de ejemplo de StormEvents .

   

3. Seleccione Permisos>Agregar>visor.

   

4. En el cuadro de búsqueda, escriba el nombre del área de trabajo de Grafana administrada.

5. En los resultados de la búsqueda, seleccione el resultado que coincida con el nombre del área de trabajo y, a continuación, elija Seleccionar.

   

Configuración de Azure Data Explorer como origen de datos de Grafana

Las áreas de trabajo de Grafana administradas incluyen el complemento Azure Data Explorer preinstalado.

1. En Azure Portal, vaya al área de trabajo de Grafana administrada.

2. En Información general, seleccione el vínculo Punto de conexión para abrir la interfaz de usuario de Grafana.

3. En Grafana, en el menú de la izquierda, seleccione el icono de engranaje. A continuación, seleccione Orígenes de datos.

   

4. Seleccione Origen de datos de Azure Data Explorer.

   

5. En Detalles de conexión, escriba la dirección URL del clúster de Azure Data Explorer.

   

6. Seleccione Guardar y probar.

Grafana autohospedado

Creación de una entidad de servicio

Puede crear la entidad de servicio en Azure Portal o mediante la experiencia de la línea de comandos de la CLI de Azure. Después de crear la entidad de servicio, obtendrá valores para cuatro propiedades de conexión que usará en pasos posteriores.

Azure portal

1. Siga las instrucciones de la documentación de Azure Portal. Use esta información específica:

   1. En la sección Asignación de la aplicación a un rol, asigne un tipo de rol de lector al clúster de Azure Data Explorer.

   2. En la sección Obtener valores para iniciar sesión , copie los valores de las tres propiedades que se describen en los pasos: Id. de directorio (id . de inquilino), Id. de aplicación y Contraseña.

2. En Azure Portal, seleccione Suscripciones. A continuación, copie el identificador de la suscripción en la que creó la entidad de servicio.

   

CLI de Azure

1. Use el siguiente comando para crear una entidad de servicio. Establezca un ámbito adecuado y un tipo de rol de reader.

   az ad sp create-for-rbac --name "https://{UrlToYourDashboard}:{PortNumber}" --role "reader" \
                            --scopes /subscriptions/{SubID}/resourceGroups/{ResourceGroupName}
   

   Para más información, consulte Creación de una entidad de servicio de Azure con la CLI de Azure.

2. El comando devuelve un conjunto de resultados como el ejemplo siguiente. Copie los valores de las appIdpropiedades , passwordy tenant .

   {
     "appId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
     "displayName": "{UrlToYourDashboard}:{PortNumber}",
     "name": "https://{UrlToYourDashboard}:{PortNumber}",
     "password": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
     "tenant": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
   }
   

3. Obtenga una lista de las suscripciones:

   az account list --output table
   

   Copie el identificador de suscripción apropiado.

   

Adición de la entidad de servicio al rol Visor

Ahora que tiene una entidad de servicio, agréguela al rol Visor en la base de datos de Azure Data Explorer. Puede realizar esta tarea en Permisos en Azure Portal o en Consulta mediante un comando de administración.

Azure Portal: Permisos

1. En Azure Portal, vaya al clúster de Azure Data Explorer.

2. En la sección Información general , seleccione la base de datos que tiene los datos de ejemplo de StormEvents.

   

3. Seleccione Permisos>Agregar.

   

4. En Agregar permisos de base de datos, seleccione el rol Visor y, a continuación, elija Seleccionar entidades de seguridad.

   

5. Busque la entidad de servicio que creó. Seleccione la entidad de seguridad y, a continuación, elija Seleccionar.

   

6. Seleccione Guardar.

   

Comando de administración: Consulta

1. En Azure Portal, vaya al clúster de Azure Data Explorer y seleccione Consulta.

   

2. Ejecute el comando siguiente en la ventana de consulta. Use el identificador de aplicación y el identificador de inquilino desde Azure Portal o la CLI de Azure.

   .add database {TestDatabase} viewers ('aadapp={ApplicationID};{TenantID}')
   

   El comando devuelve un conjunto de resultados. En el ejemplo siguiente, la primera fila es para un usuario existente de la base de datos. La segunda fila es para la entidad de servicio que acaba de agregar.

   

Especificar propiedades y probar la conexión

Con la entidad de servicio asignada al rol Visor , ahora especifique las propiedades en la instancia de Grafana y pruebe la conexión a Azure Data Explorer.

1. En Grafana, en el menú de la izquierda, seleccione el icono de engranaje. A continuación, seleccione Orígenes de datos.

   

2. Seleccione Add data source(Agregar origen de datos).

3. En la página Orígenes de datos o Nuevo , escriba un nombre para el origen de datos y, a continuación, seleccione el tipo DataSource de Azure Data Explorer.

   

4. En Configuración>Detalles de conexión, escriba el nombre del clúster con el formato https://{ClusterName}.{Region}.kusto.windows.net. Escriba los demás valores de Azure Portal o la CLI de Azure. Use la siguiente información de asignación como guía.

   IU de Grafana	Portal de Azure	Azure CLI
   Id. de suscripción	IDENTIFICADOR DE SUSCRIPCIÓN	SubscriptionId
   Id. de inquilino	Id. de directorio	tenant
   Id. de cliente	Id. de aplicación	appId
   Secreto de cliente	Contraseña	password

   

5. Seleccione Guardar y probar.

   Si la prueba se realiza correctamente, vaya a la sección siguiente. Si tiene algún problema, compruebe los valores que especificó en Grafana y revise los pasos anteriores.

Optimización de consultas

Puede usar dos características para la optimización de consultas:

• Optimización del rendimiento de representación de las consultas en el panel
• Habilitación de la coherencia débil

Para realizar la optimización, realice los cambios necesarios en Data Sources>Settings>Query Optimizations (Orígenes de datos > Configuración > Optimizaciones de consultas).

Optimización del rendimiento de representación de las consultas en el panel

Cuando uno o varios usuarios representan un panel o objeto visual más de una vez, Grafana envía al menos una consulta a Azure Data Explorer de forma predeterminada. Habilite el almacenamiento en caché de resultados de la consulta para mejorar el rendimiento de la representación del panel y reducir la carga en el clúster de Azure Data Explorer.

Durante el intervalo de tiempo especificado, Azure Data Explorer usará la memoria caché de resultados para recuperar los resultados anteriores y no ejecutará una consulta innecesaria. Esta funcionalidad es especialmente eficaz para reducir la carga en los recursos y mejorar el rendimiento cuando varios usuarios usan el mismo panel.

Para habilitar la representación de la caché de resultados, haga lo siguiente en el panel Optimizaciones de consultas:

1. Desactive Usar almacenamiento en caché dinámico.
2. En Cache Max Age (Vigencia máxima de la memoria caché), especifique el número de minutos durante los cuales desea utilizar los resultados almacenados en caché.

Habilitación de la coherencia débil

Los clústeres están configurados con coherencia segura. Esta configuración predeterminada garantiza que los resultados de la consulta estén actualizados con todos los cambios en el clúster.

Cuando se habilita la coherencia débil, los resultados de la consulta pueden tener un retraso de 1 a 2 minutos después de las modificaciones del clúster. Sin embargo, la coherencia débil podría aumentar el tiempo de representación visual. Si la coherencia inmediata no es crítica y el rendimiento es marginal, habilite la coherencia débil para mejorar el rendimiento. Para obtener más información, consulte Coherencia de consultas.

Para habilitar la coherencia débil, en el panel Optimizaciones de consultas, seleccione Coherencia de>datos débil.

Visualización de datos

Ha terminado de configurar Azure Data Explorer como origen de datos para Grafana. Ahora es el momento de visualizar los datos.

En el ejemplo básico siguiente se usa el modo del generador de consultas y el modo sin formato del editor de consultas. Se recomienda ver las consultas de escritura de Azure Data Explorer para ver ejemplos de otras consultas que se ejecutarán en el conjunto de datos.

1. En Grafana, en el menú de la izquierda, seleccione el icono más. A continuación, seleccione Panel.

   

2. En la pestaña Add (Agregar), seleccione Graph (Gráfico).

   

3. En el panel del gráfico, seleccione Panel Title Edit (Editar título>del panel).

   

4. En la parte inferior del panel, seleccione Origen de datos y, a continuación, seleccione el origen de datos que configuró.

   

Modo Generador de consultas

Use el modo generador de consultas para definir la consulta.

1. Debajo del origen de datos, seleccione Base de datos y elija la base de datos en la lista desplegable.

2. Seleccione Desde y elija la tabla en la lista desplegable.

   

3. Ahora que se define la tabla, filtre los datos:

   1. Seleccione + a la derecha de Where (filter) para seleccionar una o varias columnas de la tabla.
   2. Para cada filtro, defina los valores mediante el operador aplicable. Esta selección es similar al uso del operador where en Lenguaje de consulta Kusto.

4. Seleccione los valores que se van a presentar en la tabla:

   1. Seleccione + a la derecha de las columnas Value para seleccionar las columnas de valor que aparecerán en el panel.

   2. Para cada columna de valores, establezca el tipo de agregación.

      Puede establecer una o varias columnas de valor. Esta selección es equivalente a usar el operador summarize (resumir).

5. Seleccione + a la derecha de Agrupar por (resumir) para seleccionar una o varias columnas que se usarán para organizar los valores en grupos. Esta selección es equivalente a la expresión de grupo en el summarize operador .

6. Seleccione Ejecutar consulta.

   

   Sugerencia

   Mientras finaliza la configuración en el generador de consultas, se crea una consulta de Lenguaje de consulta Kusto. Esta consulta muestra la lógica que ha construido mediante el editor gráfico de consultas.

7. Seleccione Editar KQL para pasar al modo sin formato. Edite la consulta mediante la flexibilidad y la eficacia del Lenguaje de consulta Kusto.

Modo Raw

Use el modo Raw para editar la consulta.

1. En el panel de consulta, pegue la consulta siguiente y, a continuación, seleccione Ejecutar. La consulta rellena el recuento de eventos por día para el conjunto de datos de ejemplo.

   StormEvents
   | summarize event_count=count() by bin(StartTime, 1d)
   

   

2. El gráfico no muestra ningún resultado porque está en el ámbito (de forma predeterminada) a los datos de las últimas seis horas. En el menú superior, seleccione Last 6 hours (Últimas 6 horas).

   

3. Especifique un intervalo personalizado que abarque 2007, el año incluido en el conjunto de datos de ejemplo StormEvents. Luego, selecciona Aplicar.

   

   Ahora el gráfico muestra los datos de 2007, desglosados por días.

   

4. En el menú superior, seleccione el icono guardar: .

Para cambiar al modo del generador de consultas, seleccione Switch to builder (Cambiar al generador de consultas). Grafana convertirá la consulta en la lógica disponible en el generador de consultas. La lógica del generador de consultas es limitada, por lo que puede perder los cambios manuales realizados en la consulta.

Creación de alertas

1. En Panel principal, seleccione Canales de notificación de>alertas para crear un nuevo canal de notificación.

   

2. Escriba un nombre y escriba en Nuevo canal de notificación y, a continuación, seleccione Guardar.

   

3. En el panel, seleccione Editar en la lista desplegable.

   

4. Seleccione el icono de campana de alerta para abrir el panel Alertar. Seleccione Crear alerta y, a continuación, complete las propiedades de la alerta.

   

5. Seleccione el icono Save dashboard (Guardar panel) para guardar los cambios.

Contenido relacionado

• Write queries for Azure Data Explorer (Escritura de consultas del Explorador de datos de Azure)