Introducción a la API de Log Analytics de Azure Monitor

  • Artículo

La API de consulta de Log Analytics es una API REST que se puede usar para consultar el conjunto completo de datos recopilados por los registros de Azure Monitor. Puede usar el mismo lenguaje de consulta que se usa en todo el servicio. Use esta API para recuperar datos, crear nuevas visualizaciones de los datos y ampliar las funcionalidades de Log Analytics.

Autenticación de la API de Log Analytics

Debe autenticarse para acceder a la API de Log Analytics:

  • Para consultar las áreas de trabajo, debe usar la autenticación de Microsoft Entra.
  • Para explorar rápidamente la API sin usar la autenticación de Microsoft Entra, puede utilizar una clave de API para consultar datos de ejemplo en un entorno que no sea de producción.

Autenticación de Microsoft Entra para los datos del área de trabajo

La API de Log Analytics admite la autenticación de Microsoft Entra con tres flujos distintos de OAuth2 de Microsoft Entra ID:

  • Código de autorización
  • Implícita
  • Credenciales de cliente

Tanto el flujo de código de autorización como el flujo implícito requieren al menos un inicio de sesión interactivo del usuario en la aplicación. Si necesita un flujo no interactivo, use el flujo de credenciales de cliente.

Después de recibir un token, el proceso para llamar a la API de Log Analytics es el mismo para todos los flujos. Las solicitudes requieren el encabezado Authorization: Bearer, rellenado con el token recibido del flujo de OAuth2.

Autenticación de clave de API para datos de ejemplo

Para explorar rápidamente la API sin usar la autenticación de Microsoft Entra, proporcionamos un área de trabajo de demostración con datos de ejemplo. Puede autenticarse mediante una clave de API.

Nota:

Si se usa la autenticación de Microsoft Entra, la API REST de Application Insights podría tardar hasta 60 minutos en reconocer los nuevos permisos de control de acceso basado en roles. Mientras se propagan los permisos, las llamadas API REST pueden producir un error con el código de error 403.

Límites de consultas de la API de Log Analytics

Para obtener información sobre los límites de consulta, visite la sección API de consulta de esta página web.

Prueba de la API de Log Analytics

Para probar la API sin escribir código, puede usar:

  • Su cliente favorito, como Bruno o Insomniopara generar manualmente consultas con una interfaz de usuario.
  • cURL desde la línea de comandos. A continuación, canalice la salida a jsonlint para obtener JSON legible.

En lugar de llamar directamente a la API REST, puede usar las bibliotecas cliente de consultas de Azure Monitor:

Cada biblioteca cliente es un contenedor alrededor de la API de REST que permite recuperar datos de registro del área de trabajo.