为 Azure Monitor OpenTelemetry 配置自动数据收集和资源检测器

请求

• ASP.NET Core

依赖

• HttpClient ¹²
• SqlClient ¹
• Azure SDK

日志记录

• ILogger

若要减少或增加发送到Azure Monitor的日志数，请配置日志记录以设置适当的日志级别或应用筛选器。 例如，可以选择仅将 Warning 和 Error 日志发送到 OpenTelemetry/Azure Monitor。 OpenTelemetry 不负责控制日志路由或筛选——这些决策由您的 ILogger 配置来决定。 有关配置 ILogger的详细信息，请参阅 “配置日志记录”。

有关 ILogger 的详细信息，请参阅 C# 和 .NET 中的记录 和 代码示例。

Azure Monitor导出程序不包含任何检测库。

可以使用以下代码示例，从 Azure 软件开发工具包 （SDK） 中收集依赖项，以手动订阅源。

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

若要减少或增加发送到Azure Monitor的日志数，请配置日志记录以设置适当的日志级别或应用筛选器。 例如，可以选择仅将 Warning 和 Error 日志发送到 OpenTelemetry/Azure Monitor。 OpenTelemetry 不负责控制日志路由或筛选——这些决策由您的 ILogger 配置来决定。 有关配置 ILogger的详细信息，请参阅 “配置日志记录”。

请求

• Java消息服务（JMS）使用者
• Kafka 使用者
• Netty
• 石英
• RabbitMQ
• Servlet
• 春季日程安排

依赖项（加上下游分布式跟踪传播）

• Apache HttpClient
• Apache HttpAsyncClient
• AsyncHttpClient
• Google HttpClient
• gRPC
• java.net.HttpURLConnection
• Java 11 HttpClient
• JAX-RS 客户端
• Jetty HttpClient (Jetty HTTP客户端)
• Java 消息服务 (JMS)
• Kafka
• Netty 客户端
• OkHttp
• RabbitMQ

依赖项（没有下游分布式跟踪传播）

• 支持 Cassandra
• 支持Java数据库连接（JDBC）
• 支持 MongoDB （异步和同步）
• 支持 Redis （Lettuce 和 Jedis）

指标

• Micrometer 指标，包括 Spring Boot Actuator 指标
• Java管理扩展 （JMX） 指标

日志

• Logback（包含 MDC 属性） ¹
• Log4j（包括 MDC/线程上下文属性） ¹
• JBoss 日志记录功能（包括 MDC 属性） ¹
• java.util.logging ¹

若要减少或增加Azure Monitor收集的日志数，请先在应用程序的日志记录库中设置所需的日志记录级别（如 WARNING 或 ERROR）。

默认集合

默认情况下，会自动收集以下Azure SDKs发出的遥测数据：

• Azure 应用配置 1.1.10+
• Azure AI Search 11.3.0+
• Azure 通信聊天 1.0.0+
• Azure 通信通用 1.0.0+
• Azure通信标识 1.0.0+
• Azure通信电话号码 1.0.0+
• Azure通信短信（短信服务） 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 - Azure Blob Storage 检查点存储库 1.5.1+
• Azure AI Document Intelligence 3.0.6+
• Azure 标识 1.2.4+
• Azure Key Vault - 证书 4.1.6+
• Azure Key Vault - 密钥 4.2.6+
• Azure Key Vault - 密钥 4.2.6+
• Azure Service Bus 7.1.0+
• Azure Storage - Blobs 12.11.0+
• Azure 存储 - Blob 批处理 12.9.0+
• Azure Storage - Blob 加密技术 12.11.0+
• Azure Storage - 通用 12.11.0+
• Azure Storage - 文件数据湖 12.5.0+
• Azure Storage - 文件共享 12.9.0+
• Azure Storage - 队列 12.9.0+
• Azure Text Analytics 5.0.4+

[//]: # "Azure Cosmos DB 4.22.0+ due to https://github.com/Azure/azure-sdk-for-java/pull/25571"
[//]: # "the remaining above names and links scraped from https://azure.github.io/azure-sdk/releases/latest/java.html"
[//]: # "and version synched manually against the oldest version in maven central built on azure-core 1.14.0"
[//]: # ""
[//]: # "var table = document.querySelector('#tg-sb-content > div > table')"
[//]: # "var str = ''"
[//]: # "for (var i = 1, row; row = table.rows[i]; i++) {"
[//]: # "  var name = row.cells[0].getElementsByTagName('div')[0].textContent.trim()"
[//]: # "  var stableRow = row.cells[1]"
[//]: # "  var versionBadge = stableRow.querySelector('.badge')"
[//]: # "  if (!versionBadge) {"
[//]: # "    continue"
[//]: # "  }"
[//]: # "  var version = versionBadge.textContent.trim()"
[//]: # "  var link = stableRow.querySelectorAll('a')[2].href"
[//]: # "  str += '* [' + name + '](' + link + ') ' + version + '\n'"
[//]: # "}"
[//]: # "console.log(str)"

Spring Boot 原生应用程序的请求

• Spring Web
• Spring Web MVC（模型-View-Controller）
• Spring WebFlux

Spring Boot 本机应用程序的依赖项

• JDBC
• R2DBC
• MongoDB
• Kafka
• Azure SDK

指标

• Micrometer 指标

Spring Boot 本机应用程序的日志

• Logback

若要减少或增加Azure Monitor收集的日志数，请先在应用程序的日志记录库中设置所需的日志记录级别（如 WARNING 或 ERROR）。

有关硅固有应用程序，请参阅 Quarkus 文档。

Azure Monitor Application Insights 发行版包含以下 OpenTelemetry Instrumentation 库。 有关详细信息，请参阅适用于 JavaScript 的 Azure SDK。

请求

• HTTP/HTTPS²

依赖

• 支持 MongoDB
• 支持 MySQL
• 支持 Postgres
• 支持 Redis
• 支持 Redis-4
• 支持 Azure SDK

日志

• 班扬
• 温斯顿

若要减少或增加Azure Monitor收集的日志数，请先在应用程序的日志记录库中设置所需的日志记录级别（如 WARNING 或 ERROR）。

可以使用 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");

请求

• Django ¹
• FastApi ¹
• Flask ¹

依赖

• Psycopg2
• 请求 ¹
• Urllib ¹
• Urllib3 ¹

日志

• Python日志记录库

若要减少或增加Azure Monitor收集的日志数，请先在应用程序的日志记录库中设置所需的日志记录级别（如 WARNING 或 ERROR）。

可以在 GitHub 上找到使用Python日志记录库的示例。

默认情况下，Azure软件开发工具包（SDK）发出的遥测会被自动收集。

若要添加社区库，请在为库添加 NuGet 包后使用 ConfigureOpenTelemetryMeterProvider 或 ConfigureOpenTelemetryTracerProvider 方法。

以下示例演示如何添加 运行时检测 以收集额外的指标：

dotnet add package OpenTelemetry.Instrumentation.Runtime 

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

// Configure the OpenTelemetry meter provider to add runtime instrumentation.
builder.Services.ConfigureOpenTelemetryMeterProvider((sp, builder) => builder.AddRuntimeInstrumentation());

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

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

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

以下示例演示如何添加 运行时检测 以收集额外的指标：

// Create a new OpenTelemetry meter provider and add runtime instrumentation and the Azure Monitor metric exporter.
// It is important to keep the MetricsProvider instance active throughout the process lifetime.
var metricsProvider = Sdk.CreateMeterProviderBuilder()
    .AddRuntimeInstrumentation()
    .AddAzureMonitorMetricExporter();

不能使用社区检测库扩展Java发行版。 若要请求我们包括另一个检测库，请在GitHub页面上提出问题。 可以在 Next Steps 中找到指向GitHub页面的链接。

GraalVM Java 本机应用程序无法使用社区提供的检测库。

export class RegisterExpressInstrumentationSample {
  static async run() {
    // Dynamically import Azure Monitor and Express instrumentation
    const { useAzureMonitor } = await import("@azure/monitor-opentelemetry");
    const { registerInstrumentations } = await import("@opentelemetry/instrumentation");
    const { ExpressInstrumentation } = await import("@opentelemetry/instrumentation-express");

    // Initialize Azure Monitor (uses env var if set)
    const monitor = useAzureMonitor();

    // Register the Express instrumentation
    registerInstrumentations({
      instrumentations: [new ExpressInstrumentation()],
    });

    console.log("Express instrumentation registered");
  }
}

若要添加社区检测工具库（未正式支持或包含在 Azure Monitor 发行版中），请直接使用相关工具进行监测。 可以在 GitHub 上找到社区检测库的列表。

# Import the `configure_azure_monitor()`, `SQLAlchemyInstrumentor`, `create_engine`, and `text` functions from the appropriate packages.
from azure.monitor.opentelemetry import configure_azure_monitor
from opentelemetry.instrumentation.sqlalchemy import SQLAlchemyInstrumentor
from sqlalchemy import create_engine, text

# Configure OpenTelemetry to use Azure Monitor.
configure_azure_monitor()

# Create a SQLAlchemy engine.
engine = create_engine("sqlite:///:memory:")

# SQLAlchemy instrumentation is not officially supported by this package, however, you can use the OpenTelemetry `instrument()` method manually in conjunction with `configure_azure_monitor()`.
SQLAlchemyInstrumentor().instrument(
    engine=engine,
)

# Database calls using the SQLAlchemy library will be automatically captured.
with engine.connect() as conn:
    result = conn.execute(text("select 'hello world'"))
    print(result.all())

有关故障排除的信息，请参阅 Troubleshoot OpenTelemetry issues in .NET 和 Troubleshoot missing application telemetry in Azure Monitor Application Insights。

有关故障排除的信息，请参阅 Troubleshoot OpenTelemetry issues in .NET 和 Troubleshoot missing application telemetry in Azure Monitor Application Insights。

有关故障排除的信息，请参阅 在 Java 中排查 OpenTelemetry 问题 和 排查 Azure Monitor Application Insights 中缺少的应用程序遥测数据。

有关故障排除的信息，请参阅解决 Spring Boot 原生镜像应用程序中的 OpenTelemetry 问题和解决 Azure Monitor 应用程序洞察中缺少的应用程序遥测问题。

有关故障排除信息，请参阅 在 Node.js 中排除 OpenTelemetry 问题 和 在 Azure Monitor Application Insights 中排除缺少的应用程序遥测问题。

有关故障排除的信息，请参阅 在 Python 中排查 OpenTelemetry 的问题 和 在 Azure Monitor Application Insights 中排查丢失的应用程序遥测数据。

• 对于 Azure 支持问题，请打开 Azure 支持票证。
• 对于 OpenTelemetry 问题，请直接联系 OpenTelemetry .NET 社区。
• 有关与Azure Monitor导出程序相关的开放问题列表，请参阅 GitHub 问题页。

• 对于 Azure 支持问题，请打开 Azure 支持票证。
• 对于 OpenTelemetry 问题，请直接联系 OpenTelemetry .NET 社区。
• 有关与Azure Monitor导出程序相关的开放问题列表，请参阅 GitHub 问题页。

• 对于 Azure 支持问题，请打开 Azure 支持票证。
• 有关疑难解答的帮助，请参阅疑难解答步骤。
• 有关 OpenTelemetry 问题，请直接与 OpenTelemetry 社区联系。
• 有关与 Azure Monitor Java 自动检测相关的开放问题列表，请参阅 GitHub 问题页。

• 对于 Azure 支持问题，请打开 Azure 支持票证。
• 有关 OpenTelemetry 问题，请直接与 OpenTelemetry 社区联系。
• 要查看 Spring Boot 原生应用程序的未解决问题，请访问 GitHub 问题页。
• 有关 Quarkus 本机应用程序的开放问题列表，请参阅 GitHub 问题页。

• 对于 Azure 支持问题，请打开 Azure 支持票证。
• 有关 OpenTelemetry 问题，请直接与 OpenTelemetry JavaScript 社区联系。
• 有关与Azure Monitor导出程序相关的开放问题列表，请参阅 GitHub 问题页。

• 对于 Azure 支持问题，请打开 Azure 支持票证。
• 对于 OpenTelemetry 问题，请直接联系 OpenTelemetry Python 社区。
• 有关与 Azure Monitor 发行版相关的开放问题列表，请参阅 GitHub 问题页。

• 若要查看源代码，请参阅 Azure Monitor ASP.NET Core GitHub 存储库。
• 若要查看示例应用程序，请参阅 Azure Monitor OpenTelemetry for ASP.NET Core。
• 若要安装 NuGet 包、检查更新或查看发行说明，请参阅 Azure Monitor AspNetCore NuGet 包页。
• 若要了解有关 OpenTelemetry 及其社区的详细信息，请参阅 OpenTelemetry .NET GitHub 存储库。
• 若要启用使用体验， 请启用 Web 或浏览器用户监视。

• 若要查看源代码，请参阅 Azure Monitor 导出程序GitHub存储库。
• 若要查看示例应用程序，请参阅 Azure Monitor OpenTelemetry for .NET。
• 若要安装 NuGet 包、检查更新或查看发行说明，请参阅 Azure Monitor 导出 NuGet 包页。
• 若要了解有关 OpenTelemetry 及其社区的详细信息，请参阅 OpenTelemetry .NET GitHub 存储库。
• 若要启用使用体验， 请启用 Web 或浏览器用户监视。

• 若要查看配置选项，请参阅 Java 自动探测配置选项。
• 若要查看源代码，请参阅 Azure Monitor Java autoinstrumentation GitHub 存储库。
• 若要查看示例应用程序，请参阅 Application Insights Java Samples。
• 查看GitHub上的 release 注释。
• 若要了解有关 OpenTelemetry 及其社区的详细信息，请查看 OpenTelemetry Java GitHub 存储库。
• 若要启用使用体验功能，请查看“启用网络或浏览器用户监视”。

• 若要查看源代码，请参阅 Spring Boot 本机映像 Java 应用程序中的 Azure Monitor OpenTelemetry 发行版和 Quarkus OpenTelemetry Exporter for Azure。
• 若要查看示例应用程序，请参阅 GraalVM 本地映像的遥测。
• 查看GitHub上的 release 注释。
• 在 OpenTelemetry SpringBoot 入门中详细了解 Spring Boot 原生映像应用程序的功能
• 在 Quarkus OpenTelemetry Exporter for Azure 中了解有关 Quarkus 本机应用程序的详细信息。
• 若要了解有关 OpenTelemetry 及其社区的详细信息，请查看 OpenTelemetry Java GitHub 存储库。

• 若要查看源代码，请参阅适用于 JavaScript 存储库的 Azure Monitor OpenTelemetry。
• 若要查看示例应用程序，请参阅 Azure Monitor OpenTelemetry for Node.js。
• 若要安装 npm 包并检查更新，请参阅 @azure/monitor-opentelemetry npm 包页面。
• 若要了解有关 OpenTelemetry 及其社区的详细信息，请参阅 OpenTelemetry JavaScript GitHub存储库。
• 若要启用使用体验， 请启用 Web 或浏览器用户监视。

• 若要查看源代码和额外文档，请参阅 Azure Monitor Python GitHub 存储库。
• 若要查看示例应用程序，请参阅 Azure Monitor OpenTelemetry for Python。
• 若要安装 PyPI 包并检查更新，请参阅 Azure Monitor Distro PyPI 包 页。
• 查看GitHub上的 release 注释。
• 若要查看可用的 OpenTelemetry 检测和组件，请参阅 OpenTelemetry 参与者Python GitHub存储库。
• 若要了解有关 OpenTelemetry 及其社区的详细信息，请查看 OpenTelemetry Python GitHub 存储库。
• 若要启用使用体验， 请启用 Web 或浏览器用户监视。