Compartir a través de

Configuración de OpenTelemetry de Azure Monitor

  • Artículo

En esta guía se explica cómo configurar OpenTelemetry (OTel) en Application Insights de Azure Monitor mediante la distribución OpenTelemetry de Azure Monitor. La configuración adecuada garantiza una recopilación de datos de telemetría coherente en aplicaciones de .NET, Java, Node.jsy Python, lo que permite una supervisión y diagnóstico más confiables.

Cadena de conexión

Una cadena de conexión en Application Insights define la ubicación de destino para enviar datos de telemetría.

Use una de las tres maneras siguientes para configurar la cadena de conexión:

  • Agregue UseAzureMonitor() al archivo de program.cs :

    var builder = WebApplication.CreateBuilder(args);

// Add the OpenTelemetry telemetry service to the application.
// This service will collect and send telemetry data to Azure Monitor.
builder.Services.AddOpenTelemetry().UseAzureMonitor(options => {
    options.ConnectionString = "<Your Connection String>";
});

var app = builder.Build();

app.Run();

  • Establezca una variable de entorno.

    APPLICATIONINSIGHTS_CONNECTION_STRING=<Your Connection String>

  • Agregue la siguiente sección al archivo de configuración appsettings.json.

    {
  "AzureMonitor": {
      "ConnectionString": "<Your Connection String>"
  }
}

Nota:

Si estableces la cadena de conexión en más de un lugar, se sigue la siguiente precedencia:

  1. Código
  2. Variable de entorno
  3. Archivo de configuración

Establecer el nombre de rol en la nube y la instancia de rol en la nube

Para idiomas admitidos, la distribución OpenTelemetry de Azure Monitor detecta automáticamente el contexto de recursos y proporciona valores predeterminados para el Nombre de rol en la nube y las propiedades de instancia de rol en la nube del componente. Sin embargo, es posible que desee reemplazar los valores predeterminados por algo que tenga sentido para el equipo. El valor del nombre del rol en la nube aparece en el mapa de aplicaciones como el nombre debajo de un nodo.

Puede establecer el nombre y la instancia de rol en la nube mediante los atributos de Recurso. El nombre de rol en la nube usa los atributos service.namespace y service.name, aunque recurre a service.name si no se establece service.namespace. La instancia de rol en la nube utiliza el valor del atributo service.instance.id. Para obtener información sobre los atributos estándar de recursos, consulte Convenciones semánticas de OpenTelemetry.

// Setting role name and role instance

// Create a dictionary of resource attributes.
var resourceAttributes = new Dictionary<string, object> {
    { "service.name", "my-service" },
    { "service.namespace", "my-namespace" },
    { "service.instance.id", "my-instance" }};

// Create a new ASP.NET Core web application builder.
var builder = WebApplication.CreateBuilder(args);

// Add the OpenTelemetry telemetry service to the application.
// This service will collect and send telemetry data to Azure Monitor.
builder.Services.AddOpenTelemetry()
    .UseAzureMonitor()
    // Configure the ResourceBuilder to add the custom resource attributes to all signals.
    // Custom resource attributes should be added AFTER AzureMonitor to override the default ResourceDetectors.
    .ConfigureResource(resourceBuilder => resourceBuilder.AddAttributes(_testResourceAttributes));

// Build the ASP.NET Core web application.
var app = builder.Build();

// Start the ASP.NET Core web application.
app.Run();

Habilitación del muestreo

Es posible que quiera habilitar el muestreo para reducir el volumen de ingesta de datos, lo que reduce el coste. Azure Monitor proporciona un muestreador personalizado de frecuencia fija que puebla los eventos con una relación de muestreo, que Application Insights convierte en ItemCount. El muestreo de frecuencia fija garantiza experiencias y recuentos de eventos precisos. El muestreador está diseñado para conservar tus rastros entre servicios y es interoperable con los kits de desarrollo de software (SDKs) más antiguos de Application Insights. Para más información, consulte Más información sobre el muestreo.

Nota:

Las métricas y los registros no se ven afectados por el 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.

El muestreador espera una frecuencia de muestreo de entre 0 y 1, inclusive. Una tasa de 0,1 significa que se envía aproximadamente el 10 % de los seguimientos.

// Create a new ASP.NET Core web application builder.
var builder = WebApplication.CreateBuilder(args);

// Add the OpenTelemetry telemetry service to the application.
// This service will collect and send telemetry data to Azure Monitor.
builder.Services.AddOpenTelemetry().UseAzureMonitor(options =>
{
    // Set the sampling ratio to 10%. This means that 10% of all traces will be sampled and sent to Azure Monitor.
    options.SamplingRatio = 0.1F;
});

// Build the ASP.NET Core web application.
var app = builder.Build();

// Start the ASP.NET Core web application.
app.Run();

Sugerencia

Al usar el muestreo con tasa fija o porcentaje y no está seguro de qué establecer la tasa de muestreo, comience en el 5 %. (Proporción de muestreo de 0,05) Ajuste la velocidad en función de la precisión de las operaciones mostradas en los paneles de rendimiento y errores. Una tasa más alta suele dar como resultado una mayor precisión. Sin embargo, cualquier muestreo afecta a la precisión, por lo que se recomienda alertar sobre Métricas de OpenTelemetry, que no se ven afectadas por el muestreo.

Métricas en vivo

Métricas en directo proporciona un panel de análisis en tiempo real para obtener información sobre la actividad y el rendimiento de las aplicaciones.

Importante

Consulte Términos de uso complementarios para las versiones preliminares de Microsoft Azure para conocer los términos legales que se aplican a las características de Azure que se encuentran en la versión beta, en versión preliminar o que todavía no se han publicado para que estén disponibles con carácter general.

Esta característica está habilitada de forma predeterminada.

Los usuarios pueden deshabilitar Métricas en Vivo al configurar la Distro.

builder.Services.AddOpenTelemetry().UseAzureMonitor(options => {
	// Disable the Live Metrics feature.
    options.EnableLiveMetrics = false;
});

Habilitación de la autenticación de Microsoft Entra ID (anteriormente Azure AD)

Es posible que quiera habilitar la autenticación de Microsoft Entra para una conexión más segura a Azure, lo que impide que se ingieran datos de telemetría no autorizados en la suscripción.

Para obtener más información, consulte nuestra página dedicada de autenticación de Microsoft Entra vinculada para cada idioma admitido.

Para obtener información sobre cómo configurar la autenticación de Entra ID, consulte Autenticación de Microsoft Entra para Application Insights

Almacenamiento sin conexión y reintentos automáticos

Las ofertas basadas en OpenTelemetry de Azure Monitor almacenan datos de telemetría en caché cuando una aplicación se desconecta de Application Insights y vuelve a intentar enviar hasta 48 horas. Para obtener recomendaciones de control de datos, consulte Exportación y eliminación de datos privados. Las aplicaciones de alta carga ocasionalmente omiten la telemetría por dos motivos: exceder el tiempo máximo permitido o exceder el tamaño máximo de archivo. Cuando sea necesario, el producto da prioridad a los eventos recientes sobre los antiguos.

El paquete de la distribución incluye AzureMonitorExporter que, de manera predeterminada, usa una de las siguientes ubicaciones para el almacenamiento sin conexión (se muestra en orden de prioridad):

  • Windows
    • %LOCALAPPDATA%\Microsoft\AzureMonitor
    • %TEMP%\Microsoft\AzureMonitor
  • Distinta de Windows
    • %TMPDIR%/Microsoft/AzureMonitor
    • /var/tmp/Microsoft/AzureMonitor
    • /tmp/Microsoft/AzureMonitor

Para invalidar el directorio predeterminado, debe establecer AzureMonitorOptions.StorageDirectory.

// Create a new ASP.NET Core web application builder.
var builder = WebApplication.CreateBuilder(args);

// Add the OpenTelemetry telemetry service to the application.
// This service will collect and send telemetry data to Azure Monitor.
builder.Services.AddOpenTelemetry().UseAzureMonitor(options =>
{
    // Set the Azure Monitor storage directory to "C:\\SomeDirectory".
    // This is the directory where the OpenTelemetry SDK will store any telemetry data that cannot be sent to Azure Monitor immediately.
    options.StorageDirectory = "C:\\SomeDirectory";
});

// Build the ASP.NET Core web application.
var app = builder.Build();

// Start the ASP.NET Core web application.
app.Run();

Para deshabilitar esta característica, debe establecer AzureMonitorOptions.DisableOfflineStorage = true.

Habilitación del exportador de OTLP

Es posible que quiera habilitar el exportador de OpenTelemetry Protocol (OTLP) junto con Azure Monitor Exporter para enviar los datos de telemetría a dos ubicaciones.

Nota:

El exportador de OTLP solo se muestra por comodidad. De manera oficial, no proporcionamos soporte técnico con relación al exportador de OTLP ni componentes o experiencias de terceros de nivel inferior.

  1. Instale el paquete OpenTelemetry.Exporter.OpenTelemetryProtocol en el proyecto.

    dotnet add package OpenTelemetry.Exporter.OpenTelemetryProtocol

  2. Agregue el siguiente fragmento de código. En este ejemplo se da por hecho que tiene un recopilador de OpenTelemetry con un receptor de OTLP en ejecución. Para obtener más información, consulte el ejemplo en GitHub.

    // Create a new ASP.NET Core web application builder.
var builder = WebApplication.CreateBuilder(args);

// Add the OpenTelemetry telemetry service to the application.
// This service will collect and send telemetry data to Azure Monitor.
builder.Services.AddOpenTelemetry().UseAzureMonitor();

// Add the OpenTelemetry OTLP exporter to the application.
// This exporter will send telemetry data to an OTLP receiver, such as Prometheus
builder.Services.AddOpenTelemetry().WithTracing(builder => builder.AddOtlpExporter());
builder.Services.AddOpenTelemetry().WithMetrics(builder => builder.AddOtlpExporter());

// Build the ASP.NET Core web application.
var app = builder.Build();

// Start the ASP.NET Core web application.
app.Run();

Configuración de OpenTelemetry

Se puede acceder a las siguientes configuraciones de OpenTelemetry a través de variables de entorno al usar las distribuciones de OpenTelemetry de Azure Monitor.

Variable de entorno Descripción
APPLICATIONINSIGHTS_CONNECTION_STRING Establezca esto en la cadena de conexión del recurso de Application Insights.
APPLICATIONINSIGHTS_STATSBEAT_DISABLED Establézcalo en true para no participar en la recopilación de métricas internas.
OTEL_RESOURCE_ATTRIBUTES Pares clave-valor que se usarán como atributos de recursos. Para obtener más información sobre los atributos de recursos, consulte la especificación del SDK de recursos.
OTEL_SERVICE_NAME Establece el valor del atributo de recurso service.name. Si service.name también se proporciona en OTEL_RESOURCE_ATTRIBUTES, OTEL_SERVICE_NAME tendrá prioridad.

Redactar cadenas de consulta de URL

Para tachar las cadenas de consulta URL, desactive la recopilación de cadenas de consulta. Recomendamos esta configuración si realiza llamadas al almacenamiento de Azure usando un token SAS.

Al usar el paquete de distribución de Azure.Monitor.OpenTelemetry.AspNetCore, se incluyen las bibliotecas de ASP.NET Core y HttpClient Instrumentation. Nuestro paquete de distribución establece la acción de tachar cadenas de consulta como desactivada de forma predeterminada.

Para cambiar este comportamiento, debe establecer una variable de entorno en true o false.

  • Instrumentación de ASP.NET Core: la acción de tachar cadenas de consulta de OTEL_DOTNET_EXPERIMENTAL_ASPNETCORE_DISABLE_URL_QUERY_REDACTION está deshabilitada de manera predeterminada. Para habilitar, establezca esta variable de entorno en false.
  • Instrumentación de cliente Http: la acción de tachar cadenas de consulta de OTEL_DOTNET_EXPERIMENTAL_HTTPCLIENT_DISABLE_URL_QUERY_REDACTION está deshabilitada de manera predeterminada. Para habilitar, establezca esta variable de entorno en false.