Visualización de datos desde Azure Data Explorer en Grafana

Artículo
11/20/2023

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 los 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, ingiera 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 de Azure Data Explorer para Grafana. Necesita la versión del complemento 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 lo 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 para el entorno de Grafana.

Azure Managed Grafana
Grafana autohospedado

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.

En Azure Portal, vaya al clúster de Azure Data Explorer.
En la sección Información general , seleccione la base de datos que tiene los datos de ejemplo de StormEvents .
Seleccione Permisos>Agregar>visor.
En el cuadro de búsqueda, escriba el nombre del área de trabajo de Grafana administrada.
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 vienen con el complemento azure Data Explorer preinstalado.

En el Azure Portal, vaya al área de trabajo de Grafana administrada.
En Información general, seleccione el vínculo Punto de conexión para abrir la interfaz de usuario de Grafana.
En Grafana, en el menú izquierdo, seleccione el icono de engranaje. A continuación, seleccione Orígenes de datos.
Seleccione Azure Data Explorer Datasource.
En Detalles de conexión, escriba la dirección URL del clúster de Azure Data Explorer.
Seleccione Guardar y probar.

Creación de una entidad de servicio

Puede crear la entidad de servicio en el 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

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.
En Azure Portal, seleccione Suscripciones. A continuación, copie el identificador de la suscripción en la que creó la entidad de servicio.

Azure CLI

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.

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"
}

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

En Azure Portal, vaya al clúster de Azure Data Explorer.
En la sección Información general , seleccione la base de datos que tiene los datos de ejemplo de StormEvents.
Seleccione Permisos>Agregar.
En Agregar permisos de base de datos, seleccione el rol Visor y, a continuación, elija Seleccionar entidades de seguridad.
Busque la entidad de servicio que ha creado. Seleccione la entidad de seguridad y, después, seleccione Seleccionar.
Seleccione Guardar.

Comando de administración: Consulta

En el Azure Portal, vaya al clúster de Azure Data Explorer y seleccione Consulta.
Ejecute el comando siguiente en la ventana de consulta. Use el identificador de aplicación y el identificador de inquilino de la 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 se especifican propiedades en la instancia de Grafana y se prueba la conexión a Azure Data Explorer.

En Grafana, en el menú izquierdo, seleccione el icono de engranaje. A continuación, seleccione Orígenes de datos.
Seleccione Add data source(Agregar origen de datos).
En la página Orígenes de datos/Nuevo, escriba un nombre para el origen de datos y, a continuación, seleccione el tipo Azure Data Explorer Datasource.

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

UI de Grafana	Azure portal	Azure CLI
Id. de suscripción	IDENTIFICADOR DE SUSCRIPCIÓN	`SubscriptionId`
Id. de inquilino	Identificador de directorio	`tenant`
Id. de cliente	Identificador de la aplicación	`appId`
Secreto de cliente	Contraseña	`password`

Captura de pantalla de los cuadros de las propiedades de conexión del origen de datos.

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

Captura de pantalla que muestra las propiedades que se pueden configurar en el panel de optimización de consultas.

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

Cuando uno o varios usuarios representan un panel o un objeto visual, 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:

Desactive Usar almacenamiento en caché dinámico.
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> datosdé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 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.

En Grafana, en el menú izquierdo, seleccione el icono más. A continuación, seleccione Panel.
En la pestaña Add (Agregar), seleccione Graph (Gráfico).
En el panel de gráficos, seleccionePanel Title Edit (Editartítulo> del panel).
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 del generador de consultas para definir la consulta.

Debajo del origen de datos, seleccione Base de datos y elija la base de datos en la lista desplegable.
Seleccione Desde y elija la tabla en la lista desplegable.
Ahora que se define la tabla, filtre los datos:
1. Seleccione + a la derecha de Where (filtro) 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.
Seleccione los valores que se van a presentar en la tabla:
1. Seleccione + a la derecha de 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).
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 .
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 construyó mediante el editor gráfico de consultas.
Seleccione Editar KQL para pasar al modo sin formato. Edite la consulta mediante la flexibilidad y la eficacia del Lenguaje de consulta Kusto.

Captura de pantalla de una consulta sin procesar en el generador de consultas.

Modo Raw

Use el modo Raw para editar la consulta.

En el panel de consulta, pegue la consulta siguiente y, a continuación, seleccione Ejecutar. La consulta buckets el recuento de eventos por día para el conjunto de datos de ejemplo.
```
StormEvents
| summarize event_count=count() by bin(StartTime, 1d)
```
El gráfico no muestra ningún resultado porque tiene como ámbito (de forma predeterminada) los datos de las últimas seis horas. En el menú superior, seleccione Last 6 hours (Últimas 6 horas).
Especifique un intervalo personalizado que abarque 2007, el año incluido en el conjunto de datos de ejemplo StormEvents. Luego, seleccione Aplicar.

Ahora el gráfico muestra los datos de 2007, desglosados por días.
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 está limitada, por lo que puede perder los cambios manuales realizados en la consulta.

Captura de pantalla de la ventana de consulta, con el botón para cambiar al generador resaltado.

Creación de alertas

En el panel principal, seleccione Canales de notificación de> alertaspara crear un nuevo canal de notificación.
Escriba un nombre y escriba en Nuevo canal de notificación y, a continuación, seleccione Guardar.
En el panel, seleccione Editar en la lista desplegable.
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.
Seleccione el icono Save dashboard (Guardar panel) para guardar los cambios.

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

Compartir a través de

Visualización de datos desde Azure Data Explorer en Grafana

Requisitos previos

Configuración del origen de datos

Adición de la identidad administrada al rol Visor

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

Creación de una entidad de servicio

Azure portal

Azure CLI

Adición de la entidad de servicio al rol Visor

Azure Portal: permisos

Comando de administración: Consulta

Especificar propiedades y probar la conexión

Optimización de consultas

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

Habilitación de la coherencia débil

Visualización de datos

Modo Generador de consultas

Modo Raw

Creación de alertas

Comentarios

Recursos adicionales

Compartir a través de

Visualización de datos desde Azure Data Explorer en Grafana

Requisitos previos

Configuración del origen de datos

Adición de la identidad administrada al rol Visor

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

Visualización de datos

Modo Generador de consultas

Modo Raw

Creación de alertas

Contenido relacionado

Comentarios

Recursos adicionales