Recopilación de OpenTelemetry (OTel) para experiencias de Application Insights

En este artículo se describe la introducción a la recopilación de datos de 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
• Azure Functions
• Agentes de IA

Cómo empezar

Elija la pestaña que mejor coincida con la carga de trabajo o el modelo de hospedaje.

La mayoría de los escenarios del lado servidor de este artículo usan Azure Monitor OpenTelemetry.

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. Incorpore la distribución de OpenTelemetry a su aplicación.
4. Configure la cadena de conexión.

Sugerencia

Algunas plataformas permiten la recopilación de datos automáticamente mediante la instrución automática. Cambie a instrumentación basada en código con la distribución de OpenTelemetry 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. Obtén la cadena de conexión del recurso.
3. Añade la distro de OpenTelemetry a tu aplicación.
4. Configure la cadena de conexión.

Sugerencia

Algunas plataformas permiten la recopilación de datos automáticamente mediante la instrución automática. Cambie a instrumentación basada en código con la distribución de OpenTelemetry 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. Configura 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 Application Insights cadena de conexión.
3. Completa la instrumentación específica del lenguaje y las configuraciones de trabajo necesarias en Use 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 la 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

  • Azure AI Foundry: 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 Azure Monitor OpenTelemetry con el SDK de Foundry.
  • Copilot Studio: Use la configuración integrada para emitir la telemetría a Azure Monitor. Para obtener más información, consulte Conecte el agente de Copilot Studio a Application Insights.

• 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 Azure AI Foundry. 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 la telemetría está en funcionamiento, 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 quiere ver sus agentes en Azure AI Foundry además de Azure Monitor, Conectar un recurso de Application Insights al proyecto Foundry.

También puede configurar evaluaciones de estas maneras:

• Evaluaciones por lotes
  • Evaluaciones locales con Azure SDK de evaluación de IA:Ejecutar evaluaciones en el equipo 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.

Pasos siguientes

Revise los siguientes recursos para familiarizarse con los conceptos de Application Insights.

Autenticación de Microsoft Entra para Application Insights

Seguimiento de dependencia en Application Insights

Métricas en Application Insights

Modelo de datos de telemetría de Application Insights

Información general del área de trabajo Log Analytics

Tutorial: use Log Analytics