Habilite Azure Monitor OpenTelemetry para aplicaciones de .NET, Node.js, Python y Java

En este artículo se describe cómo habilitar y configurar la recopilación de datos basada en OpenTelemetry en Azure Monitor Application Insights mediante la distribución de OpenTelemetry de Azure Monitor. OpenTelemetry es el estándar de observabilidad de código abierto de la CNCF; Azure Monitor OpenTelemetry Distro es la distribución de Microsoft de ese estándar, optimizada para Azure Monitor. La distribución:

Proporciona una distribución OpenTelemetry, que incluye compatibilidad con características específicas de Azure Monitor.
Habilita la recopilación automática de telemetría mediante la inclusión de bibliotecas de instrumentación de OpenTelemetry para recopilar seguimientos, métricas, registros y excepciones.
Permite recopilar telemetría personalizada.
Admite Live Metrics para supervisar y recopilar datos de telemetría de aplicaciones web activas en producción.

Para obtener más información sobre las ventajas de usar la distribución de OpenTelemetry Azure Monitor, consulte Why should I use the Azure Monitor OpenTelemetry Distro.

Para más información sobre la recopilación de datos mediante OpenTelemetry, consulte la introducción a Application Insights o las preguntas más frecuentes sobre OpenTelemetry.

Siga los pasos de este artículo para instalar la distribución, conectarla al recurso de Application Insights y comprobar que los datos de telemetría fluyen a Azure Monitor.

Sugerencia

Para obtener información general conceptual sobre las opciones de OpenTelemetry en Azure Monitor : ingesta nativa de OTLP, la distribución de OpenTelemetry Microsoft y las experiencias de observabilidad de un extremo a otro, consulte OpenTelemetry con Azure Monitor.

Estado de la versión de OpenTelemetry

Las ofertas de OpenTelemetry están disponibles para aplicaciones de .NET, Node.js, Python y Java. Para obtener un estado de versión de característica por característica, consulte las preguntas más frecuentes.

Nota:

Para las aplicaciones de función de Azure, consulte Uso de OpenTelemetry con Azure Functions.

Habilitación de OpenTelemetry con Application Insights

Siga los pasos de esta sección para instrumentar la aplicación con OpenTelemetry. Seleccione una pestaña para obtener instrucciones específicas del idioma.

En la tabla siguiente se resumen los paquetes y los comandos de instalación de cada idioma admitido:

Language	Package	Comando Install
ASP.NET Core	`Azure.Monitor.OpenTelemetry.AspNetCore`	`dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore`
.NET	`Azure.Monitor.OpenTelemetry.Exporter`	`dotnet add package Azure.Monitor.OpenTelemetry.Exporter`
Java	`applicationinsights-agent-3.7.8.jar`	Download desde GitHub
Node.js	`@azure/monitor-opentelemetry`	`npm install @azure/monitor-opentelemetry`
Python	`azure-monitor-opentelemetry`	`pip install azure-monitor-opentelemetry`

Nota:

.NET trata varios escenarios, incluidos los ASP.NET clásicos, las aplicaciones de consola, Windows Forms (WinForms) y mucho más.

Requisitos previos

Azure suscripción: Crear una suscripción de Azure gratuita
Recurso de Application Insights: Creación de un recurso de Application Insights.

ASP.NET Core Application con una versión compatible oficialmente de .NET

Sugerencia

Si va a migrar desde SDK de Application Insights anteriores, consulte nuestra documentación de migración.

Instalación de la biblioteca cliente

Instale el paquete Azure.Monitor.OpenTelemetry.AspNetCoreNuGet más reciente:

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore

Instale el paquete Azure.Monitor.OpenTelemetry.ExporterNuGet más reciente:

dotnet add package Azure.Monitor.OpenTelemetry.Exporter

Instale el paquete más reciente @azure/monitor-opentelemetry :

npm install @azure/monitor-opentelemetry

Los siguientes paquetes también se usan para algunos escenarios específicos que se describen más adelante en este artículo:

npm install @opentelemetry/api
npm install @opentelemetry/sdk-metrics
npm install @opentelemetry/resources
npm install @opentelemetry/semantic-conventions
npm install @opentelemetry/sdk-trace-base

Instale el paquete PyPI azure-monitor-opentelemetry más reciente:

pip install azure-monitor-opentelemetry

Modifique su aplicación

Importe el espacio de nombres Azure.Monitor.OpenTelemetry.AspNetCore, agregue OpenTelemetry y configúrelo para usar Azure Monitor en su clase program.cs.

// Import the Azure.Monitor.OpenTelemetry.AspNetCore namespace.
using Azure.Monitor.OpenTelemetry.AspNetCore;

var builder = WebApplication.CreateBuilder(args);

// Add OpenTelemetry and configure it to use Azure Monitor.
builder.Services.AddOpenTelemetry().UseAzureMonitor();

var app = builder.Build();

app.Run();

Agregue el Azure Monitor Exporter a cada señal OpenTelemetry en la clase program.cs.

// Create a new tracer provider builder and add an Azure Monitor trace exporter to the tracer provider builder.
// It is important to keep the TracerProvider instance active throughout the process lifetime.
// See https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/trace#tracerprovider-management
var tracerProvider = Sdk.CreateTracerProviderBuilder()
    .AddAzureMonitorTraceExporter();

// Add an Azure Monitor metric exporter to the metrics provider builder.
// It is important to keep the MetricsProvider instance active throughout the process lifetime.
// See https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/metrics#meterprovider-management
var metricsProvider = Sdk.CreateMeterProviderBuilder()
    .AddAzureMonitorMetricExporter();

// Create a new logger factory.
// It is important to keep the LoggerFactory instance active throughout the process lifetime.
// See https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/logs#logger-management
var loggerFactory = LoggerFactory.Create(builder =>
{
    builder.AddOpenTelemetry(logging =>
    {
        logging.AddAzureMonitorLogExporter();
    });
});

Nota:

Para obtener más información, consulte el tutorial getting-started para OpenTelemetry .NET

La instrumentación automática está habilitada a través de cambios de configuración. No se requiere ningún cambio de código.

Apunte la máquina virtual de Java (JVM) al archivo jar mediante la adición de -javaagent:"path/to/applicationinsights-agent-3.7.8.jar" a los argumentos de JVM de la aplicación.

Nota:

El muestreo está habilitado de forma predeterminada a una velocidad de cinco solicitudes por segundo, lo que ayuda a la administración de costos. Los datos de telemetría podrían faltar en escenarios que superen esta tasa. Para obtener más información sobre cómo modificar la configuración de muestreo, consulte Invalidaciones de muestreo. Si ve cargos inesperados o costos elevados en Application Insights, esta guía puede ayudarle. Abarca causas comunes, como un gran volumen de telemetría, picos de ingesta de datos y muestreo mal configurado. Es especialmente útil si está solucionando problemas relacionados con los picos de costos, el volumen de telemetría, el muestreo no funciona, los límites de datos, la ingesta alta o la facturación inesperada. Para empezar, consulte Solución de problemas de ingesta de datos elevados en Application Insights.

Sugerencia

Para obtener instrucciones específicas de determinados escenarios, consulte Introducción (complementaria).

Sugerencia

Si desarrolla una aplicación de Spring Boot, puede reemplazar, si quiere, el argumento JVM por una configuración mediante programación. Para obtener más información, consulte Using Azure Monitor Application Insights with Spring Boot.

// Import the `useAzureMonitor()` function from the `@azure/monitor-opentelemetry` package.
const { useAzureMonitor } = require("@azure/monitor-opentelemetry");

// Call the `useAzureMonitor()` function to configure OpenTelemetry to use Azure Monitor.
useAzureMonitor();

import logging
# Import the `configure_azure_monitor()` function from the
# `azure.monitor.opentelemetry` package.
from azure.monitor.opentelemetry import configure_azure_monitor

# Configure OpenTelemetry to use Azure Monitor with the
# APPLICATIONINSIGHTS_CONNECTION_STRING environment variable.
configure_azure_monitor(
    logger_name="<your_logger_namespace>",  # Set the namespace for the logger in which you would like to collect telemetry for if you are collecting logging telemetry. This is imperative so you do not collect logging telemetry from the SDK itself.
)
logger = logging.getLogger("<your_logger_namespace>")  # Logging telemetry will be collected from logging calls made with this logger and all of it's children loggers.

Copia la cadena de conexión desde el recurso de Application Insights

La cadena de conexión es única e indica a dónde envía Azure Monitor OpenTelemetry Distro la telemetría que ha recopilado.

Sugerencia

Si aún no tiene un recurso de Application Insights, cree uno siguiendo esta guía. Se recomienda crear un nuevo recurso en lugar de usar uno existente.

Para copiar la cadena de conexión:

Vaya al panel de Información general del recurso de Application Insights.
Busque su cadena de conexión.
Mantenga el puntero sobre la cadena de conexión y seleccione el icono Copiar al portapapeles.

Pegue la cadena de conexión en su entorno.

Para pegar el cadena de conexión, use uno de los métodos siguientes:

Método	Idiomas compatibles	Recomendado para
Variable del entorno	Todos	Producción
Archivo de configuración (`applicationinsights.json`)	Solo para Java	Producción (Java)
Código	ASP.NET Core, Node.js, Python	Solo desarrollo/pruebas locales

Importante

Se recomienda establecer la cadena de conexión mediante el código únicamente en entornos locales de desarrollo y prueba.

Para producción, use una variable de entorno o un archivo de configuración (solo Java).

Configure la cadena de conexión de Application Insights como una variable de entorno (recomendado para producción)

Sustituya <Your cadena de conexión> en el siguiente comando por su cadena de conexión.
```
APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
```
Establezca la cadena de conexión de Application Insights en un archivo de configuración - Solo para Java

Cree un archivo de configuración denominado applicationinsights.json y colóquelo en el mismo directorio que applicationinsights-agent-3.7.8.jar, con el siguiente contenido:
```
{
  "connectionString": "<Your connection string>"
}
```
Reemplace <Your cadena de conexión> en el código JSON anterior por su cadena de conexión única.
Establecer la cadena de conexión de Application Insights en el código - Solo para ASP.NET Core, Node.js y Python

Consulte cadena de conexión configuration para obtener un ejemplo de configuración de cadena de conexión mediante código.

Nota:

Si establece la cadena de conexión en varios lugares, se resolverá en el siguiente orden de precedencia (de mayor a menor):

Código
Variable del entorno
Archivo de configuración

Confirmación de que los datos fluyen

Después de configurar la distribución de OpenTelemetry de Azure Monitor y establecer la cadena de conexión, ejecute su aplicación y abra el recurso de Application Insights en el portal de Azure para comprobar que aparecen trazas, métricas y registros. Los datos pueden tardar unos minutos en aparecer.

Captura de pantalla de la pestaña

Application Insights ahora está habilitado para su aplicación. Los pasos siguientes son opcionales y permiten una mayor personalización.

Nota:

Como parte del uso de la instrumentación de Application Insights, recopilamos y envíamos datos de diagnóstico a Microsoft. Estos datos ayudan a ejecutar y mejorar Application Insights. Obtenga más información en preguntas más frecuentes sobre Application Insights.

Importante

Si tiene dos o más servicios que emiten datos de telemetría al mismo recurso de Application Insights, es obligatorio establecer nombres de rol en la nube para representarlos correctamente en el mapa de aplicación.

Solución de problemas, comentarios y soporte técnico

Sugerencia

Las siguientes secciones están disponibles en todos los artículos de la distro de OpenTelemetry.

Solución de problemas

Para obtener información sobre la solución de problemas, consulte Solución de problemas de OpenTelemetry en .NET y Solución de problemas de telemetría de aplicaciones ausente en Application Insights de Azure Monitor.

Comentarios de OpenTelemetry

Para proporcionar comentarios:

Rellene la encuesta de comentarios de los clientes de la comunidad de OpenTelemetry.
Dile a Microsoft sobre ti al unirte a la OpenTelemetry Early Adopter Community.
Póngase en contacto con otros usuarios de Azure Monitor en el Microsoft Tech Community.
Realice una solicitud de característica en el Azure Foro de comentarios.

Apoyo

Seleccione una pestaña para el idioma que prefiera para detectar las opciones de soporte técnico.

Para problemas de soporte de Azure, abra un ticket de soporte de Azure.
Para problemas de OpenTelemetry, póngase en contacto directamente con el OpenTelemetry .NET community.
Para obtener una lista de problemas abiertos relacionados con Azure Monitor Exportador, consulte la página GitHub Problemas.

Pasos siguientes

Para revisar el código fuente, consulte el repositorio Azure Monitor ASP.NET Core GitHub.
Para revisar una aplicación de ejemplo, consulte Azure Monitor OpenTelemetry para ASP.NET Core.
Para instalar el paquete NuGet, buscar actualizaciones o ver las notas de la versión, consulte la página del paquete NuGet de Azure Monitor AspNetCore.
Para obtener más información sobre OpenTelemetry y su comunidad, consulte el repositorio OpenTelemetry .NET GitHub repositorio.
Habilite la supervisión de usuarios web o de explorador para habilitar las experiencias de uso.

Para revisar el código fuente, consulte el repositorio de Azure Monitor OpenTelemetry para JavaScript.
Para revisar una aplicación de ejemplo, consulte Azure Monitor OpenTelemetry para Node.js.
Para instalar el paquete npm, buscar actualizaciones o consultar las notas de la versión, visite la página @azure/monitor-opentelemetry npm Package.
Para obtener más información sobre OpenTelemetry y su comunidad, consulte el OpenTelemetry JavaScript GitHub repositorio.
Habilite la supervisión de usuarios web o de explorador para habilitar las experiencias de uso.

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2026-05-19

Habilite Azure Monitor OpenTelemetry para aplicaciones de .NET, Node.js, Python y Java

Estado de la versión de OpenTelemetry

Habilitación de OpenTelemetry con Application Insights

Requisitos previos

Instalación de la biblioteca cliente

Modifique su aplicación

Copia la cadena de conexión desde el recurso de Application Insights

Pegue la cadena de conexión en su entorno.

Confirmación de que los datos fluyen

Solución de problemas, comentarios y soporte técnico

Solución de problemas

Comentarios de OpenTelemetry

Apoyo

Pasos siguientes

Comentarios

Recursos adicionales