Introducción a Application Insights: observabilidad de OpenTelemetry

Application Insights de Azure Monitor es una característica de supervisión del rendimiento de aplicaciones (APM) de Azure Monitor. En escenarios admitidos, puede usar OpenTelemetry (OTel), un marco de observabilidad neutral del proveedor, para instrumentar las aplicaciones y recopilar datos de telemetría y, a continuación, analizar esa telemetría en Application Insights.

Experiencias de Application Insights

Application Insights es compatible con OpenTelemetry (OTel) para recopilar datos de telemetría en un formato estándar en todas las plataformas. La integración con los servicios de Azure permite una supervisión y diagnóstico eficaces, lo que mejora la observabilidad y el rendimiento de las aplicaciones.

Investigación

Use estas herramientas para diagnosticar problemas y comprender el comportamiento en tiempo de ejecución de la aplicación.

• Panel de la aplicación: una valoración rápida del estado y el rendimiento de su aplicación.
• Mapa de aplicación: una visión general de la arquitectura de la aplicación y de las interacciones de sus componentes.
• Métricas en directo: un panel de análisis que ofrece datos en tiempo real para obtener información sobre la actividad y el rendimiento de la aplicación.
• Vista de búsqueda: seguimiento y diagnóstico de transacciones para identificar problemas y optimizar el rendimiento.
• Vista de disponibilidad: supervise y pruebe proactivamente la disponibilidad y la capacidad de respuesta de los puntos de conexión de aplicación.
• Vista Errores: identifique y analice los errores de la aplicación para minimizar el tiempo de inactividad.
• Vista de rendimiento: revise las métricas de rendimiento de la aplicación y los posibles cuellos de botella.
• Detalles de los agentes: una vista unificada para supervisar los agentes de IA en Microsoft Foundry, Copilot Studio y agentes de terceros.

Supervisión

Use estas herramientas para realizar un seguimiento continuo del estado de la aplicación y configurar notificaciones proactivas.

• Alertas: supervise una amplia gama de aspectos de la aplicación y desencadene diversas acciones.
• Métricas: profundice en los datos de métricas para reconocer los patrones de uso y las tendencias.
• Configuración de diagnóstico: configure la exportación de streaming de registros de plataforma y métricas al destino que prefiera.
• Registros: recupere, consolide y analice todos los datos recopilados en los registros de supervisión de Azure.
• Cuadernos: Crear informes interactivos y paneles que visualicen los datos de supervisión de aplicaciones.
• Paneles con Grafana: cree, personalice y comparta paneles de Grafana para datos de Application Insights directamente en Azure Portal.
• Estadísticas del SDK: visualice el éxito del exportador, los recuentos descartados, los recuentos de reintentos y las razones de descarte de los SDK y agentes de Application Insights.

Uso

Use estas herramientas para comprender cómo interactúan los usuarios con la aplicación.

• Usuarios, sesiones y eventos: determine cuándo, dónde y cómo interactúan los usuarios con la aplicación web.
• Embudos: analice las tasas de conversión para identificar dónde progresan o anulan los usuarios en el embudo.
• Flujos: Visualice y analice las trayectorias de los usuarios en su sitio web para identificar áreas de alta interacción y puntos de salida.
• Cohortes: agrupa a los usuarios por características compartidas para simplificar la identificación de tendencias, la segmentación y la solución de problemas de rendimiento.

Análisis de código

Use estas herramientas para generar perfiles y depurar el código de la aplicación.

• .NET Profiler: captura, identificación y visualización de seguimientos de rendimiento de la aplicación.
• Optimizaciones de código: aproveche la IA para crear aplicaciones mejores y más eficientes.
• Depurador de instantáneas: recopila automáticamente instantáneas de depuración cuando se producen excepciones en la aplicación .NET

Modelo lógico

El diagrama del modelo lógico visualiza los componentes de Application Insights y cómo interactúan.

Nota:

La configuración del firewall debe modificarse para que los datos lleguen a los puntos de conexión de ingestión. Para más información, consulte Configuración de firewall y acceso a puntos de conexión de Azure Monitor.

Cómo empezar

En esta sección se describe la introducción a la recopilación de datos basada en OpenTelemetry en Azure Monitor Application Insights.

Entre los puntos de entrada se incluyen:

• Aplicaciones web del lado servidor
• Aplicaciones web del lado servidor hospedadas en una máquina virtual (VM)
• Aplicaciones javaScript del lado cliente
• Funciones de Azure
• Agentes de IA

Sugerencia

• Para la mayoría de los escenarios del lado servidor basados en código, la configuración recomendada usa la distribución openTelemetry de Azure Monitor.
• Los escenarios en los que OpenTelemetry no está disponible se identifican claramente.

Elija la pestaña que mejor coincida con la carga de trabajo o el modelo de hospedaje. Cada pestaña muestra la ruta recomendada para la recopilación de datos para ese escenario.

Configuración de la recopilación de datos

Aplicaciones web

Utilice esta ruta de acceso para las aplicaciones web del lado del servidor que instrumente mediante código.

1. Cree un recurso de Application Insights.
2. Obtenga la cadena de conexión del recurso.
3. Agrega el Azure Monitor OpenTelemetry Distro a tu aplicación.
4. Configure la cadena de conexión.

Sugerencia

Algunas plataformas permiten la recopilación de datos automáticamente a través de la instrumentación automática. Pase a la instrumentación basada en código con la Distribución de OpenTelemetry de Azure Monitor si desea más opciones de configuración y extensibilidad.

VM

Utilice esta ruta cuando su aplicación se ejecute en una máquina virtual o en un conjunto de escalado de máquinas virtuales. El flujo basado en código es el mismo que para otras aplicaciones del lado servidor.

1. Cree un recurso de Application Insights.
2. Obtenga la cadena de conexión del recurso.
3. Agrega el Azure Monitor OpenTelemetry Distro a tu aplicación.
4. Configure la cadena de conexión.

Sugerencia

Algunas plataformas permiten la recopilación de datos automáticamente a través de la instrumentación automática. Pase a la instrumentación basada en código con la Distribución de OpenTelemetry de Azure Monitor si desea más opciones de configuración y extensibilidad.

JavaScript

Use esta ruta de acceso para la telemetría del explorador, como las vistas de página y las interacciones del usuario. Las aplicaciones del explorador usan el SDK de JavaScript de Application Insights, no OpenTelemetry.

1. Cree un recurso de Application Insights.
2. Obtenga la cadena de conexión del recurso.
3. Agregue el SDK de JavaScript a la aplicación.
4. Configure la cadena de conexión.

Nota:

El SDK de JavaScript de Application Insights no usa OpenTelemetry. Para obtener más información, consulte ¿Se puede usar OpenTelemetry para exploradores web?

Funciones

Use esta ruta de acceso para Azure Functions. Comience con la configuración de la aplicación de funciones y, a continuación, siga el artículo Funciones para conocer los pasos específicos del lenguaje.

1. Active OpenTelemetry en el archivo host.json de su aplicación de funciones configurando "telemetryMode": "OpenTelemetry".
2. Agregue la APPLICATIONINSIGHTS_CONNECTION_STRINGconfiguración de aplicación mediante la cadena de conexión de Application Insights.
3. Complete la instrumentación específica del lenguaje y las configuraciones de trabajo necesarias en Uso de OpenTelemetry con Azure Functions.

Nota:

OpenTelemetry no se admite actualmente para aplicaciones en proceso de C#.

Kubernetes

Use esta ruta de acceso para las aplicaciones que se ejecutan en Azure Kubernetes Service (AKS). El flujo basado en código es el mismo que para otras aplicaciones del lado servidor.

1. Cree un recurso de Application Insights.
2. Obtenga la cadena de conexión del recurso.
3. Agregue la distribución de OpenTelemetry a su aplicación.
4. Configure la cadena de conexión.

Nota:

Instrumentación automática para Azure Kubernetes Service (AKS) está disponible como versión preliminar pública.

Agentes

Use esta ruta de acceso para los agentes de IA. Elija la configuración que coincida con el modelo de hospedaje.

• Hospedaje administrado

  • Fundición de IA de Azure: Para los flujos de trabajo y los agentes administrados por Foundry, comience con tracing setup in Foundry. Para la instrumentación en el lado de la aplicación, también puede usar la distribución de OpenTelemetry de Azure Monitor con el SDK de Foundry.

• Autoalojamiento

  • Microsoft Agent Framework: Si estás desarrollando un agente desde cero y de forma autoalojada, usa el Microsoft Agent Framework para orquestar tu agente y emitir telemetría a Azure Monitor.
  • Agentes de terceros: Si creó un agente en otro lugar, use el Azure AI OpenTelemetry Tracer para emitir telemetría a Azure Monitor. Estos agentes también se pueden registrar en Fundición de IA de Azure. Para obtener instrucciones específicas del marco, consulte Habilitación del seguimiento de agentes basados en LangChain y LangGraph y Habilitación del seguimiento de agentes basados en el SDK de agentes de OpenAI.

Una vez que fluye la telemetría, está listo para explorar la vista de detalles del agente de Application Insights.

Si decide recopilar la información completa del mensaje, por ejemplo, mediante el indicador EnableSensitiveData en el Agent Framework, puede buscar a través de los mensajes en la vista Búsqueda y revisar las conversaciones, incluidos los mensajes del asistente, los mensajes del sistema y el uso de herramientas, en la vista Detalles de la Transacción.

Asigne a cada agente un nombre distinto para que pueda distinguirlos en la vista Detalles del agente. Si los componentes agente forman parte de una aplicación mayor, considere la posibilidad de enviarlos a un recurso de Application Insights existente.

Si también desea ver los agentes en Fundición de IA de Azure (además de Azure Monitor), conecte un recurso de Application Insights al proyecto de Foundry.

También puede configurar evaluaciones de estas maneras:

• Evaluaciones por lotes
  • Evaluaciones locales con el SDK de evaluación de Azure AI:ejecute evaluaciones en la máquina de desarrollo durante las pruebas.
  • Evaluaciones en la nube con Foundry SDK:Ejecuta evaluaciones en Azure para conjuntos de datos más grandes o colaboración en equipo.
  • Evaluaciones basadas en el portal de Foundry:Use el portal Foundry para flujos de trabajo sin código de evaluación.
• Evaluaciones continuas:configure evaluaciones automatizadas que se ejecutan en el tráfico de producción para detectar regresiones de calidad.

Después de completar la configuración del escenario, ejecute la aplicación y espere unos minutos para que la telemetría aparezca en Application Insights. A continuación, explore las experiencias de Application Insights.

Importante

Si estás migrando desde los SDK de Application Insights anteriores, consulta Migrar a Azure Monitor OpenTelemetry.

Otras integraciones de OpenTelemetry en Azure

Azure Monitor Application Insights se integra con otros servicios de Azure que usan OpenTelemetry. Use los siguientes recursos para Azure servicios, kits de desarrollo de software (SDK) y herramientas que usan OpenTelemetry:

Integration	Descripción
Convenciones semánticas del SDK de Azure	Convenciones de nomenclatura de atributos de OpenTelemetry utilizadas en todos los SDK de Azure.
Rastreo de Java en SDK de Azure	Soporte para el seguimiento distribuido en los clientes de SDK de Azure para Java.
Observabilidad del SDK de Azure Cosmos DB	Trazas y métricas de OpenTelemetry emitidas por el SDK de Azure Cosmos DB.
Observabilidad en .NET con OpenTelemetry	Guía de instrumentación de OpenTelemetry para aplicaciones .NET.
Canalización de Azure Monitor en el perímetro y multinube	Recopile y reenvíe datos de OpenTelemetry de entornos perimetrales y multinube a Azure Monitor.
Ingesta de OpenTelemetry en Azure Data Explorer	Ingerir datos de OpenTelemetry en Azure Data Explorer, Synapse Data Explorer y Real-Time Intelligence.
Agente de OpenTelemetry de Azure Container Apps	Agente de OpenTelemetry integrado para Azure Container Apps.
Panel de Aspire	Panel de desarrollo local para ver trazas y métricas de OpenTelemetry de las aplicaciones .NET Aspire.

Solución de problemas

Para obtener ayuda con la solución de problemas de Application Insights, consulte nuestra documentación de solución de problemas dedicada.

Ayuda y soporte técnico

Soporte técnico de Azure

En caso de problemas de Soporte técnico de Azure, abra una incidencia de Soporte técnico de Azure.

Preguntas generales

Publique preguntas generales en el foro de preguntas y respuestas de Microsoft.

Preguntas de codificación

Publique preguntas de codificación en Stack Overflow usando una etiqueta azure-application-insights.

Comunidad de comentarios

Deje comentarios sobre el producto para el equipo de ingeniería en la comunidad de comentarios.