Configurar un origen de datos de Azure Data Explorer

Azure Data Explorer es un servicio de exploración de datos de telemetría y registros. En esta guía, aprenderá a agregar un origen de datos de Azure Data Explorer a Grafana y aprenderá a configurar Azure Data Explorer mediante cada opción de autenticación disponible para este origen de datos.

Requisitos previos

• Una instancia de Azure Managed Grafana en el plan Estándar.
• Una base de datos de Azure Data Explorer

Adición de un origen de datos de Azure Data Explorer

Agregue un origen de datos de Azure Data Explorer a Grafana siguiendo estos pasos.

1. Abra una instancia de Azure Managed Grafana en Azure Portal.
2. En la sección Información general, abra la dirección URL del Punto de conexión.
3. En el portal de Grafana, vaya a Conexiones>Orígenes de datos>Agregar nuevo origen de datos y, a continuación, busque y seleccione Origen de datos de Azure Data Explorer.

Configuración un origen de datos de Azure Data Explorer

Escriba las opciones de configuración de Azure Data Explorer.

1. En la pestaña Configuración, edite opcionalmente el Nombre del origen de datos.

   

2. En Detalles de conexión, escriba la dirección URL del clúster dela base de datos de Azure Data Explorer.

3. Seleccione la opción de autenticación que prefiera entre Identidad administrada, Registro de aplicaciones (entidad de servicio) o Usuario actual (autenticación basada en el usuario).

   Identidad administrada

   Autentíquese con una identidad administrada sin usar credenciales explícitas.

   Adición de un nuevo permiso

   1. En Azure Portal, abra el clúster de Azure Data Explorer.
   2. Seleccione Datos>Bases de datos en el menú de la izquierda y, a continuación, seleccione la base de datos que contiene los datos.
   3. Seleccione Permisos > Agregar > Visor.
   4. En el cuadro de búsqueda, escriba el nombre del área de trabajo de Azure Managed Grafana, seleccione el área de trabajo y, después, elija Seleccionar. Aparece una notificación correcta.

   Configuración del origen de datos en Grafana

   1. De nuevo en Grafana, en Método de autenticación, seleccione Identidad administrada.
   2. Seleccione Guardar y probar. La notificación "Correcto" que se muestra indica que Grafana puede capturar datos de la base de datos.

   Registro de aplicación

   Autentíquese con el registro de aplicaciones mediante una entidad de servicio de Microsoft Entra.

   Configuración inicial

   1. Siga los pasos sobre cómo registrar una aplicación con Microsoft Entra ID y crear una entidad de servicio.
   2. Asigne el rol Lector a la aplicación en el paso siguiente de la guía.
   3. Siga los tres primeros pasos de la guía Recuperar detalles de la aplicación para recopilar el identificador de directorio (inquilino), el identificador de aplicación (cliente) y el identificador de secreto de cliente necesarios en el paso siguiente.

   Configuración del origen de datos en Grafana

   1. En Grafana, en Método de autenticación, seleccione Registro de aplicaciones.

   2. Para Azure Cloud, seleccione la nube de Azure. Por ejemplo, Azure.

      

   3. Escriba un id. de directorio (inquilino), id. de aplicación (cliente) y secreto de cliente

   4. También puede editar las secciones Optimizaciones de consultas, Configuración del esquema de base de datos y Seguimiento.

   5. Seleccione Guardar y probar para validar la conexión. La notificación "Correcto" que se muestra indica que Grafana puede conectarse a la base de datos.

   Usuario actual

   Use el método de autenticación basado en el usuario, aprovechando las credenciales actuales del identificador de Microsoft Entra del usuario de Grafana en el origen de datos configurado.

   Al configurar un origen de datos de Azure Data Explorer con el método de autenticación Usuario actual, Grafana consulta Azure Data Explorer mediante las credenciales del usuario.

   Precaución

   La autenticación basada en el usuario en orígenes de datos de Grafana es experimental.

   Precaución

   Esta característica no es compatible con los casos de uso que requieren acceso siempre en la máquina a los datos consultados, incluidos alertas, informes, almacenamiento en caché de consultas y paneles públicos. El método de autenticación de usuario actual depende de que un usuario esté conectado, en una sesión interactiva, para que Grafana llegue a la base de datos. Cuando se usa la autenticación basada en el usuario y no se inicia sesión, las tareas automatizadas no se pueden ejecutar en segundo plano. Para aprovechar las tareas automatizadas para Azure Data Explorer, se recomienda configurar otro origen de datos de Azure Data Explorer mediante otro método de autenticación.

   Adición de un nuevo permiso

   Agregue un nuevo permiso para que la cuenta de usuario acceda a la base de datos.

   1. En Azure Portal, abra el recurso Base de datos de Azure Data Explorer y seleccione Permisos>Agregar>Visor.

   2. Escriba su nombre o dirección de correo electrónico en la barra de búsqueda, seleccione su cuenta de usuario y elija Seleccionar.

      

   3. Una notificación confirma que el permiso se ha agregado a la base de datos.

   Configuración del origen de datos en Grafana

   1. En Grafana, en Método de autenticación, seleccione Usuario actual.
   2. Seleccione Guardar y probar. La notificación "Correcto" que se muestra indica que Grafana puede capturar datos de la base de datos.

Creación de una base de datos Azure Data Explorer

En la CLI de Azure, agregue y configure un origen de datos de Azure Data Explorer mediante la ejecución del comando az grafana data-source create. Elija su método de autenticación preferido y consulte la pestaña correspondiente a continuación para obtener más información.

Al ejecutar estos comandos, reemplace todos los marcadores de posición por su propia información.

Identidad administrada

Autentíquese con una identidad administrada sin usar credenciales explícitas.

az grafana data-source create --name <azure-managed-grafana-workspace> --definition '{
  "name": "<data-source-name>",
  "type": "grafana-azure-data-explorer-datasource",
  "access": "proxy",
  "jsonData": {
    "clusterUrl": "<cluster-url>",
    "dataConsistency": "strongconsistency",
    "azureCredentials": {
      "authType": "msi"
    }
  }
}'

Registro de aplicación

Autentíquese con el registro de aplicaciones mediante una entidad de servicio de Microsoft Entra.

az grafana data-source create --name <azure-managed-grafana-workspace> --definition '{
  "name": "<data-source-name>",
  "type": "grafana-azure-data-explorer-datasource",
  "access": "proxy",
  "jsonData": {
    "clusterUrl": "<cluster-url>",
    "azureCredentials": {
      "authType": "clientsecret",
      "azureCloud": "AzureCloud",
      "tenantId": "<tenant-id>",
      "clientId": "<client-id>"
    }
  },
  "secureJsonData": { "azureClientSecret": "verySecret" }
}'

Usuario actual

Autentíquese con el método de usuario actual. Este método aprovecha las credenciales actuales de Microsoft Entra ID del usuario de Grafana en el origen de datos configurado.

Al configurar un origen de datos de Azure Data Explorer con el método de autenticación Usuario actual, Grafana consulta Azure Data Explorer mediante las credenciales del usuario.

Nota:

La implementación de la autenticación basada en el usuario en Azure Managed Grafana está en curso y se completará en todas las regiones a finales de 2023.

Precaución

La autenticación basada en el usuario en orígenes de datos de Grafana es experimental.

Precaución

Esta característica no es compatible con los casos de uso que requieren acceso siempre en la máquina a los datos consultados, incluidos alertas, informes, almacenamiento en caché de consultas y paneles públicos. El método de autenticación de usuario actual depende de que un usuario esté conectado, en una sesión interactiva, para que Grafana llegue a la base de datos. Cuando se usa la autenticación basada en el usuario y no se inicia sesión, las tareas automatizadas no se pueden ejecutar en segundo plano. Para aprovechar las tareas automatizadas para Azure Data Explorer, se recomienda configurar otro origen de datos de Azure Data Explorer mediante otro método de autenticación.

az grafana data-source create --name <azure-managed-grafana-workspace> --definition '{
  "name": "<data-source-name>",
  "type": "grafana-azure-data-explorer-datasource",
  "access": "proxy",
  "jsonData": {
    "clusterUrl": "<cluster-url>",
    "dataConsistency": "strongconsistency",
    "azureCredentials": {
      "authType": "currentuser"
    }
  }
}'

Actualización de un origen de datos de Azure Data Explorer

Para actualizar un origen de datos de Azure Data Explorer, siga estos pasos. Al ejecutar estos comandos, reemplace todos los marcadores de posición por su propia información.

1. Obtenga el identificador del origen de datos de Azure Data Explorer para actualizar con az grafana data-source list.

   az grafana data-source list --resource-group <azure-managed-grafana-resource-group> --name <azure-managed-grafana-workspace> --query "[?type=='grafana-azure-data-explorer-datasource'].id"
   

2. Ejecute el comando az grafana data-source update para actualizar el origen de datos.

   Por ejemplo, actualice el nombre y la dirección URL del clúster del origen de datos de Azure Data Explorer con el comando siguiente.

   az grafana data-source update --resource-group <azure-managed-grafana-workspace-resource-group> --name <azure-managed-grafana-workspace> --data-source-id <data-source-id> --set name="<new-name>" url="<new-url>
   

Paso siguiente

Creación de un panel