Habilitación de Azure Monitor OpenTelemetry para aplicaciones de .NET, Node.js, Python y Java

Artículo
28/01/2025

En este artículo, se describe cómo habilitar y configurar la recopilación de datos basada en OpenTelemetry en Application Insights. Distribución de OpenTelemetry de Azure Monitor:

Proporciona una distribución de OpenTelemetry que incluye compatibilidad con características específicas de Azure Monitor.
Habilita la telemetría automática 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 más datos de telemetría de aplicaciones web activas en producción.

Para más información sobre las ventajas de usar la distribución de OpenTelemetry de Azure Monitor, consulte ¿Por qué debo usar la distribución de OpenTelemetry de Azure Monitor?.

Para más información sobre la recopilación de datos mediante OpenTelemetry, consulte Conceptos básicos de recopilación de datos o Preguntas más frecuentes sobre OpenTelemetry.

Estado de la versión de OpenTelemetry

Las ofertas de OpenTelemetry están disponibles para aplicaciones .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.

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 lenguaje.

Nota

.NET cubre varios escenarios, incluido ASP.NET clásico, las aplicaciones de consola, Windows Forms (WinForms) y mucho más.

Requisitos previos

Una suscripción de Azure: Creación de una suscripción de Azure gratis
Recurso de Application Insights: Creación de un recurso de Application Insights.

Aplicación que usa una versión compatible oficialmente del runtime de Node.js:
• Runtimes compatibles de OpenTelemetry
• Runtimes compatibles con Azure Monitor OpenTelemetry Exporter

Nota

Si no confía en ninguna de las propiedades enumeradas en la tabla no compatible, las correcciones de compatibilidad (shim) de ApplicationInsights serán su ruta de acceso más fácil una vez fuera de la versión beta.

Si confía en cualquiera de esas propiedades, continúe con la distribución de OpenTelemetry de Azure Monitor. Pronto proporcionaremos una guía de migración.

Sugerencia

Si va a migrar desde la API clásica de Application Insights, consulte nuestra documentación de migración.

Instalación de la biblioteca cliente

Instale el paquete NuGetAzure.Monitor.OpenTelemetry.AspNetCore más reciente:

CLI de .NET

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore

Instale el paquete NuGetAzure.Monitor.OpenTelemetry.Exporter más reciente:

CLI de .NET

dotnet add package Azure.Monitor.OpenTelemetry.Exporter

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

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 la 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 Azure Monitor Exporter a cada señal de 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 más información, consulte el Tutorial de introducción 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 Java (JVM) al archivo jar agregando -javaagent:"path/to/applicationinsights-agent-3.7.0.jar" a los argumentos de JVM de la aplicación.

Nota

El muestreo está habilitado de forma predeterminada a una velocidad de 5 solicitudes por segundo, lo que ayuda a la administración de costes. Es posible que falten datos de telemetría 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.

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 más información, consulte Uso de Application Insights de Azure Monitor con Spring Boot.

TypeScript

// 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();

Python

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.

Copie la cadena de conexión de su recurso de Application Insights

La cadena de conexión es única y especifica donde la distribución de OpenTelemetry de Azure Monitor envía la telemetría que recopila.

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 la cadena de conexión, seleccione entre las opciones siguientes:

Importante

Se recomienda establecer la cadena de conexión a través del código solo en entornos de prueba y desarrollo locales.

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

Establecer a través de la variable de entorno - recomendado

Sustituya <Your connection string> en el siguiente comando por su cadena de conexión.

Consola
```
APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
```
Establecer mediante el archivo de configuración - solo Java

Cree un archivo de configuración denominado applicationinsights.json y colóquelo en el mismo directorio que applicationinsights-agent-3.7.0.jar, con el siguiente contenido:

JSON
```
{
  "connectionString": "<Your connection string>"
}
```
Sustituya <Your connection string> en el JSON anterior por su cadena de conexión única.
Establecer mediante código - solo ASP.NET Core, Node.js y Python

Consulte configuración de cadena de conexión para ver un ejemplo de configuración de la cadena de conexión mediante código.

Nota

Si establece la cadena de conexión en varios lugares, la variable de entorno se priorizará en el orden siguiente:

Código
Variable del entorno
Archivo de configuración

Confirmación de que los datos fluyen

Ejecute la aplicación y abra Application Insights en Azure Portal. 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.

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.

Como parte del uso de la instrumentación de Application Insights, se recopilan y envían datos de diagnóstico a Microsoft. Estos datos ayudan a ejecutar y mejorar Application Insights. Para obtener más información, consulte Statsbeat en Azure Application Insights.

Aplicaciones de ejemplo

Las aplicaciones de ejemplo de OpenTelemetry de Azure Monitor están disponibles para todos los lenguajes admitidos:

Pasos siguientes

Para más información sobre cómo agregar y modificar OpenTelemetry de Azure Monitor, consulte Agregar y modificar OpenTelemetry de Azure Monitor.
Para revisar el código fuente, consulte el repositorio de GitHub de Azure Monitor OpenTelemetry.
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 familiarizarse con Azure Monitor Application Insights y OpenTelemetry, consulte la aplicación de ejemplo de Azure Monitor.
Para obtener más información sobre OpenTelemetry y su comunidad, visite el repositorio de GitHub de JavaScript para OpenTelemetry.
Habilite la supervisión de usuarios web o de explorador para habilitar las experiencias de uso.
Para revisar las preguntas frecuentes, los pasos de solución de problemas, las opciones de soporte técnico o para proporcionar comentarios sobre OpenTelemetry, consulte Ayuda, soporte técnico y comentarios sobre Azure Monitor Application Insights.

Compartir a través de

Habilitación de 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

Copie la cadena de conexión de su recurso de Application Insights

Pegue la cadena de conexión en su entorno

Confirmación de que los datos fluyen

Aplicaciones de ejemplo

Pasos siguientes

Comentarios

Recursos adicionales