Recopilación automática de datos y detectores de recursos para Azure Monitor OpenTelemetry

En este artículo se explica cómo Azure Monitor OpenTelemetry recopila datos de telemetría automáticamente y cómo los detectores de recursos enriquecen la telemetría con metadatos coherentes. Aprenderá qué señales se recopilan de forma predeterminada y cómo los detectores de recursos rellenan atributos como la identidad de servicio y los detalles del entorno para que los datos de Application Insights sean más fáciles de filtrar, correlacionar y solucionar problemas entre .NET, Java, Node.jsy Python aplicaciones.

Para más información sobre los conceptos de OpenTelemetry, consulte la introducción a OpenTelemetry.

Nota:

Para aplicaciones de función de Azure, ver Usar OpenTelemetry con Azure Functions.

Bibliotecas de instrumentación incluidas

Las distribuciones de Azure Monitor recopilan automáticamente datos mediante la inclusión de bibliotecas de instrumentación de OpenTelemetry.

Solicitudes

ASP.NET Core ¹²

Dependencias

Registro

ILogger

Para obtener más información sobre ILogger, consulte Logging in C# and .NET and code examples.

El Azure Monitor Exportador no incluye ninguna biblioteca de instrumentación.

Para recopilar dependencias de kits de desarrollo de software (SDK) de Azure, utilice el siguiente ejemplo de código para suscribirse manualmente a la fuente.

// Create an OpenTelemetry tracer provider builder.
// It is important to keep the TracerProvider instance active throughout the process lifetime.
using var tracerProvider = Sdk.CreateTracerProviderBuilder()
	// The following line subscribes to dependencies emitted from Azure SDKs
    .AddSource("Azure.*")
    .AddAzureMonitorTraceExporter()
    .AddHttpClientInstrumentation(o => o.FilterHttpRequestMessage = (_) =>
	{
    	// Azure SDKs create their own client span before calling the service using HttpClient
		// In this case, we would see two spans corresponding to the same operation
		// 1) created by Azure SDK 2) created by HttpClient
		// To prevent this duplication we are filtering the span from HttpClient
		// as span from Azure SDK contains all relevant information needed.
		var parentActivity = Activity.Current?.Parent;
		if (parentActivity != null && parentActivity.Source.Name.Equals("Azure.Core.Http"))
		{
		    return false;
		}
		return true;
	})
    .Build();

Solicitudes

consumidores de Java Message Service (JMS)
Consumidores de Kafka
Netty
Cuarzo
RabbitMQ
Servlets
Programación de Spring

Nota:

Servlet y Netty autoinstrumentation cubren la mayoría de los servicios HTTP Java, incluidos Java EE, Jakarta EE, Spring Boot, Quarkus y Micronaut.

Dependencias (más la propagación de trazas distribuidas a nivel descendente)

Apache HttpClient
Apache HttpAsyncClient
AsyncHttpClient
Google HttpClient
gRPC
java.net.HttpURLConnection
Java 11 HttpClient
Cliente de JAX-RS
Cliente HTTP de Jetty
JMS
Kafka
Cliente Netty
OkHttp
RabbitMQ

Dependencias (sin la propagación de trazas distribuidas descendentes)

Admite Cassandra
Admite conectividad de base de datos Java (JDBC)
Admite MongoDB (asíncrono y sincrónico)
Soporte para Redis (Lettuce y Jedis)

Métricas

Métricas de Micrometer, incluidas las métricas del accionador de Spring Boot
Métricas de Java Management Extensions (JMX)

Registros

Logback (incluidas las propiedades de MDC) ¹
Log4j (incluidas las propiedades MDC/Thread Context) ¹
Registro de JBoss (incluidas las propiedades de MDC) ¹
java.util.logging ¹

Recopilación predeterminada

La telemetría emitida por el siguiente SDK de Azure se recopila automáticamente de forma predeterminada:

Azure App Configuration 1.1.10+
Búsqueda de Azure AI 11.3.0+
Chat de Comunicación de Azure 1.0.0+
Azure Communication Common 1.0.0+
Azure Communication Identity 1.0.0+
Números de teléfono de Comunicación de Azure 1.0.0+
Azure Communication SMS (Servicio de Mensajes Cortos) 1.0.0+
Azure Cosmos DB 4.22.0+
Azure Digital Twins- Core 1.1.0+
Azure Event Grid 4.0.0+
Azure Event Hubs 5.6.0+
Azure Event Hubs - Almacén de puntos de control de Azure Blob Storage 1.5.1+
Documento de inteligencia de Azure AI 3.0.6+
Azure Identity 1.2.4+
Azure Key Vault: certificados 4.1.6+
Azure Key Vault: Claves 4.2.6+
Azure Key Vault - Secrets 4.2.6+
Azure Service Bus 7.1.0+
Azure Storage: blobs 12.11.0+
Azure Storage: Blobs Batch 12.9.0+
Azure Storage: criptografía de blobs 12.11.0+
Azure Storage: Common 12.11.0+
Azure Storage - Files Data Lake 12.5.0+
Azure Storage: recursos compartidos de archivos 12.9.0+
Azure Storage: colas 12.9.0+
Azure Text Analytics 5.0.4+

Sugerencia

Ejemplos de TypeScript para Azure Monitor OpenTelemetry (fuente de paridad autoritativa): https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/monitor/monitor-opentelemetry/samples-dev

La distribución de Azure Monitor Application Insights incluye las siguientes bibliotecas de instrumentación de OpenTelemetry. Para obtener más información, consulte SDK de Azure para JavaScript.

Solicitudes

HTTP/HTTPS²

Dependencias

Registros

Importante

Bunyan y Winston no están habilitados de forma predeterminada. Puede habilitar las bibliotecas de instrumentación estableciendo enabled: true en las opciones de instrumentación.

Expanda para ver un ejemplo de código que muestra cómo configurar instrumentaciones mediante AzureMonitorOpenTelemetryOptions.

import { useAzureMonitor, AzureMonitorOpenTelemetryOptions } from "@azure/monitor-opentelemetry";
import bunyan from "bunyan";

// Call useAzureMonitor before importing other libraries
const options: AzureMonitorOpenTelemetryOptions = {
  azureMonitorExporterOptions: {
    connectionString:
      process.env.APPLICATIONINSIGHTS_CONNECTION_STRING ||
      "<your-connection-string>",
  },
  // Bunyan is disabled by default — explicitly enable it
  instrumentationOptions: {
    bunyan: { enabled: true },
  },
};

useAzureMonitor(options);

// Create a bunyan logger as usual logs are automatically captured
const logger = bunyan.createLogger({ name: "my-app" });

logger.info("Application started");
logger.warn({ requestId: "abc-123" }, "Slow response detected");
logger.error(new Error("Something failed"), "Unhandled error");

Solicitudes

Django ¹
FastApi ¹
Flask ¹

Dependencias

Registros

biblioteca de registro de Python

Puede encontrar ejemplos de uso de la biblioteca de registro de Python en GitHub.

La telemetría emitida por los kits de desarrollo de software de Azure (SDKs) es recopilada de forma predeterminada.

Notas al pie

¹: Admite informes automáticos de excepciones no controladas/no detectadas
²: Admite métricas de OpenTelemetry

Nota:

Las distribuciones de OpenTelemetry de Azure Monitor incluyen mapeo personalizado y lógica para emitir automáticamente métricas estándar de Application Insights. Con fines de facturación, todas las métricas de OpenTelemetry, ya sean recopiladas automáticamente de bibliotecas de instrumentación o recopiladas manualmente de codificación personalizada, se consideran métricas personalizadas de Application Insights. Más información.

Sugerencia

Para reducir o aumentar el número de registros enviados a Azure Monitor, configure el registro para establecer el nivel de registro adecuado o aplicar filtros. Por ejemplo, puede optar por enviar solo registros de WARNING y ERROR a Azure Monitor.

Detectores de recursos

Los detectores de recursos detectan metadatos de entorno al iniciar y rellenan atributos de recursos de OpenTelemetry, como service.name, cloud.providery cloud.resource_id. Estos metadatos potencian experiencias en Application Insights, como Application Map y la vinculación computacional, y mejoran la correlación entre seguimientos, métricas y registros.

Sugerencia

Los atributos de recursos describen el proceso y su entorno. Los atributos span describen una sola operación. Use atributos de recursos para propiedades de nivel de aplicación como service.name.

Entornos soportados

Medio ambiente	Funcionamiento de la detección	Notas
Azure App Service	El SDK de lenguajes o la distribución de Azure Monitor lee variables de App Service Environment conocidas y metadatos de host	Funciona con .NET, Java, Node.jsy Python al usar las instrucciones de este artículo.
Azure Functions	Consulte la guía de cómo de Azure Functions OpenTelemetry	Todas las guías de Azure Functions se encuentran ahí.
Azure Virtual Machines	El SDK de lenguaje o la distribución consulta el servicio de metadatos de instancia de Azure	Asegúrese de que la máquina virtual tiene access al punto de conexión de Instance Metadata Service.
Azure Kubernetes Service (AKS)	Uso del procesador OpenTelemetry Collector `k8sattributes` para agregar metadatos de Kubernetes	Se recomienda para todos los lenguajes que se ejecutan en AKS.
Azure Container Apps	Los detectores asignan variables de entorno e identificadores de recursos cuando están disponibles	También puede establecer `OTEL_RESOURCE_ATTRIBUTES` para rellenar espacios.

Consideraciones de ingesta de OTLP

cloud.resource_id mejora la conexión de computación con recursos de Azure. Si falta este atributo, es posible que algunas experiencias no muestren el recurso Azure que generó los datos.
Application Insights usa service.name para derivar el nombre del rol en la nube. Elija un nombre estable por servicio para evitar nodos fragmentados en mapa de aplicaciones.
cloud.resource_id mejora la vinculación de recursos computacionales con los recursos de Azure. Si falta este atributo, es posible que algunas experiencias no muestren el recurso Azure que generó los datos.

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 faltantes en Azure Monitor Application Insights.

Comentarios de OpenTelemetry

Para proporcionar comentarios:

Rellene la encuesta de comentarios de los clientes de la comunidad de OpenTelemetry.
Infórmale a Microsoft sobre ti uniéndote 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.

En caso de problemas de Soporte técnico de Azure, abra una incidencia de Soporte técnico 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, vea las notas de la versión o busque actualizaciones, visite la página Paquete NuGet 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 y comprobar si hay actualizaciones, consulte 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 resultó útil esta página?

Last updated on 2026-04-15

Compartir vía

Recopilación automática de datos y detectores de recursos para Azure Monitor OpenTelemetry

Bibliotecas de instrumentación incluidas

Detectores de recursos

Entornos soportados

Consideraciones de ingesta de OTLP

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

Solución de problemas

Comentarios de OpenTelemetry

Apoyo

Pasos siguientes

Comentarios

Recursos adicionales