Configuración de variables de ambiente para OpenTelemetry en Azure

¿Por qué falló la conexión en GitHub Actions?

Cuando integras OpenTelemetry en tu proyecto y usas GitHub Actions, es posible que experimentes un error señalando la falta de una conexión. Este problema ocurre porque la aplicación intenta encontrar una cadena de conexión que aún no se ha configurado correctamente.

¿Cómo solucionar el error de conexión rápidamente?

La solución efectiva consiste en configurar correctamente una variable de ambiente llamada AzureMonitorConnectionString:

• Accede a Options > Run Test on Pull Request.
• Agrega una variable de ambiente llamada AzureMonitorConnectionString.
• Usa un valor seguro (Secret) llamado AzureMonitorKey.
• Copia la Instrumentation Key desde tu archivo JSON hacia AzureMonitorKey como valor de este secreto.

De este modo, la aplicación utilizará correctamente esta variable y solucionará el error.

¿Cómo configurar variables de ambiente en Azure Portal?

Para que esta configuración también funcione en Azure Container Apps:

• Dirígete a la sección Containers > Variables de Ambiente.
• Copia exactamente el mismo nombre que utilizaste en GitHub Actions.
• Ingresa nuevamente el valor de tu Instrumentation Key sin comillas.
• Guarda los cambios y espera unos segundos hasta la generación de una réplica nueva.

Tu aplicación estará comunicada correctamente con OpenTelemetry, permitiendo validar que las réplicas funcionan sin errores.

¿Cómo obtener métricas y trazabilidad con Application Insights?

Una vez realizadas estas configuraciones y generadas varias solicitudes a la aplicación:

• Dirígete al portal de Azure y abre Application Insights dentro de tu grupo de recursos.
• Espera unos minutos, pues los datos pueden tomar tiempo en aparecer.
• Utiliza la sección Application Map para visualizar solicitudes, respuestas y latencias en tu aplicación.
• En Búsqueda de Transacciones, tendrás acceso al histórico detallado de solicitudes.
• Puedes generar gráficas personalizadas de diversos indicadores (por ejemplo, solicitudes fallidas) en la sección Métricas.
• Usa también la sección Logs para realizar consultas específicas que te permitan ver detalles como nombres, direcciones, duración y Operation ID de tus operaciones.

Esta configuración permite un monitoreo exhaustivo que facilita la creación posterior de un panel personalizado para tu aplicación.