Uso de Azure Application Insights en data API Builder

Azure Application Insights es un servicio de supervisión que captura telemetría, como detalles de solicitud, contadores de rendimiento, registros y excepciones. La integración con Data API Builder (DAB) le ayuda a diagnosticar problemas y supervisar el comportamiento en tiempo de ejecución en producción.

Advertencia Application Insights no se admite cuando DAB se hospeda mediante aplicaciones web de Azure App Service.

Configuración

Para configurar Application Insights en la configuración de DAB:

Ejemplo de la CLI

dab add-telemetry \
  --app-insights-enabled true \
  --app-insights-conn-string "@env('app-insights-connection-string')"

Ejemplo de JSON

"runtime": {
  ...
  "telemetry": {
    "application-insights": {
      "enabled": true,
      "connection-string": "@env('app-insights-connection-string')"
    }
  }
  ...
}

Esto supone app-insights-connection-string que se establece como una variable de entorno. Puede usar un .env archivo para definirlo.

¿Qué se captura?

Tipo	Descripción
Solicitud de telemetría	URL, código de estado, tiempo de respuesta
Telemetría de seguimiento	Registros de consola de DAB
Telemetría de excepciones	Errores y trazas de pila
Contadores de rendimiento	CPU, memoria, métricas de red

Visualización en Azure

1. Vaya al recurso de Application Insights en Azure Portal: https://portal.azure.com
2. Revise los registros mediante esta consulta:

traces
| order by timestamp

Asignación de LogLevel:

LogLevel	Severidad	Importancia
Seguimiento	Verbose	0
Depurar	Verbose	0
Información	Información	1
Advertencia	Advertencia	2
Error	Error	3
Crítico	Crítico	4

3. Verificar Métricas en Tiempo Real

4. Ejecute esta consulta para solicitudes:

requests
| order by timestamp

5. Ejecute esta consulta para ver las excepciones:

exceptions
| order by timestamp