啟用Azure Monitor OpenTelemetry 支援 .NET、Node.js、Python 及 Java 應用程式

本文說明如何在 Azure Monitor Application Insights 中啟用並配置基於 OpenTelemetry 的資料收集。 Azure 監視器 OpenTelemetry Distro：

提供 OpenTelemetry 發行版，包含對 Azure Monitor 特定功能的支援。
藉由包含 OpenTelemetry 檢測程式庫來收集追蹤、計量、記錄和例外狀況，以啟用自動遙測。
允許收集自訂遙測。
支援即時度量，以監控並收集來自現場、正在生產的網頁應用程式的遙測數據。

欲了解更多使用 Azure Monitor OpenTelemetry 發行版的優點，請參閱為什麼應該使用 Azure Monitor OpenTelemetry 發行版。

想了解更多使用 OpenTelemetry 收集資料的資訊，請參閱 Collect OpenTelemetry（OTel）以獲得應用洞察體驗或 OpenTelemetry 常見問題。

OpenTelemetry 發行狀態

OpenTelemetry 提供.NET、Node.js、Python 及 Java 應用。如需逐個功能的發佈狀態，請參閱常見問題。

附註

關於 Azure 功能應用程式，請參見將 OpenTelemetry 用於 Azure Functions。

使用 Application Insights 啟用 OpenTelemetry

請遵循本節中的步驟，使用 OpenTelemetry 檢測您的應用程式。選取索引標籤以取得特定語言的指示。

附註

.NET 涵蓋多種情境，包括經典 ASP.NET、主控台應用程式、Windows Forms（WinForms ）等。

必要條件

Azure訂閱：免費建立Azure訂閱
Application Insights 資源：建立 Application Insights 資源

ASP.NET Core 應用程式使用官方支援版本的 .NET

秘訣

如果您正從 Application Insights Classic API 遷移，請參閱我們的移轉文件。

安裝用戶端程式庫

安裝最新的 Azure.Monitor.OpenTelemetry.AspNetCoreNuGet 套件：

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore

安裝最新的 Azure.Monitor.OpenTelemetry.ExporterNuGet 套件：

dotnet add package Azure.Monitor.OpenTelemetry.Exporter

安裝最新的 @azure/monitor-opentelemetry 套件：

npm install @azure/monitor-opentelemetry

本文稍後說明的一些特定案例還使用下列套件：

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

安裝最新的 azure-monitor-opentelemetry PyPI 套件：

pip install azure-monitor-opentelemetry

修改您的應用程式

匯入 Azure.Monitor.OpenTelemetry.AspNetCore 命名空間，新增 OpenTelemetry，並設定它在你的 program.cs 類別中使用 Azure Monitor：

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

在 program.cs 類別中，為每個 OpenTelemetry 訊號加入 Azure Monitor 匯出器：

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

附註

欲了解更多資訊，請參閱 OpenTelemetry .NET 的入門教學

會透過設定變更的方式來啟用自動檢測。 不需要變更程式碼。

透過在應用程式的 JVM arg 中加入 -javaagent:"path/to/applicationinsights-agent-3.7.5.jar"，將 Java 虛擬機（JVM）指向 jar 檔案。

附註

預設以每秒五次請求的速度啟用抽樣，有助於成本管理。在超過此速率的情況下，遙測資料可能會遺失。如需修改取樣組態的詳細資訊，請參閱覆寫範本。如果您在 Application Insights 中看到非預期的費用或高成本，本指南可協助您。它涵蓋常見的原因，例如高遙測數據量、數據匯入尖峰，以及錯誤配置的取樣。如果您要針對成本尖峰、遙測量、取樣無法運作、資料上限、高擷取量或非預期計費等相關問題進行疑難排解，此方式特別實用。若要開始使用，請參閱 Application Insights 中高資料匯入的疑難排解。

秘訣

如需情境特定指導，請參閱開始使用 (補充)。

秘訣

如果您開發 Spring Boot 應用程式，則可以選擇性地透過程式設計設定來取代 JVM 引數。更多資訊請參閱使用 Spring Boot 的 Azure Monitor 應用程式洞察。

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

從您的 Application Insights 資源複製連線字串

connection string 是唯一的，並指定 Azure Monitor OpenTelemetry 發行版將所收集的遙測資料傳送到哪裡。

秘訣

如果您還沒有可以使用的 Application Insights 資源，請遵循本指南建立資源。建議您建立新的資源，而不是使用現有的資源。

要複製「connection string」：

移至 Application Insights 資源的 [概觀] 窗格。
尋找您的連接字串。
將滑鼠移到connection string上，選擇複製到剪貼板圖示。

把 connection string 貼到你的環境裡

要貼上你的 connection string，請從以下選項中選擇：

重要

我們建議僅在本地開發與測試環境中使用程式碼設置連線字串。

生產環境時，請使用環境變數或設定檔（僅限 Java）。

透過環境變數設定 - 建議

請將以下指令中的 <Your connection string> 替換成你的 connection string。
```
APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
```
透過設定檔設定 - 僅限 Java

建立名為 applicationinsights.json 的組態檔，並將其置於具有與 applicationinsights-agent-3.7.5.jar 下列內容的相同目錄下：
```
{
  "connectionString": "<Your connection string>"
}
```
將前面 JSON 中的 <Your connection string> 替換成您的唯一的連接字串。
透過代碼設定 - ASP.NET Core、Node.js，以及僅Python

請參見 connection string configuration 範例，說明如何透過程式碼設定connection string。

附註

如果你在多個地方設定 connection string，環境變數的優先順序如下：

Code
環境變數
組態檔

確認資料正在流動

執行你的應用程式，然後在 Azure 入口開啟 Application Insights。資料可能需要幾分鐘的時間才會顯示。

此螢幕擷取畫面顯示 Application Insights 的 [概觀] 索引標籤，其中醒目提示伺服器要求和伺服器回應時間。

Application Insights 現在已為您的應用程式啟用。下列步驟是選擇性的，並允許進一步自訂。

附註

在使用 Application Insights 檢測的過程中，我們會收集診斷資料並且傳送給 Microsoft。此資料可協助我們執行及改善 Application Insights。欲了解更多，請參閱應用洞察常見問題集。

重要

如果您有兩個或兩個以上服務將遙測發出至相同的 Application Insights 資源，則必須設定雲端角色名稱，才能在應用程式地圖上正確地代表服務。

故障排除、回饋與支援

秘訣

以下章節在所有 OpenTelemetry Distro 文章中皆可查閱。

Troubleshooting

如需疑難解答資訊，請參閱針對 .NET 中的 OpenTelemetry 問題進行疑難解答，以及針對 Azure 監視器 Application Insights 中遺漏的應用程式遙測進行疑難解答。

OpenTelemetry 意見反應

若要提供意見反應：

填寫 OpenTelemetry 社群的客戶意見反應問卷。
加入 OpenTelemetry 早期採用者社群，告知 Microsoft 有關您自己的資訊。
與 Microsoft Tech Community 中的其他 Azure 監視器使用者互動。
在 Azure 意見反應論壇中提出功能要求。

支援

選取您選擇的語言索引標籤，以探索支援選項。

對於 Azure 支援相關的問題，請開立 Azure 支援工單。
針對 OpenTelemetry 問題，請直接連絡 OpenTelemetry .NET 社群。
如需與 Azure 監視器匯出工具相關的未解決問題清單，請參閱 GitHub 問題頁面。

下一步

要檢視原始碼，請參閱 Azure Monitor ASP.NET Core GitHub 倉庫。
若要檢視範例應用程式，請參閱 Azure Monitor OpenTelemetry for ASP.NET Core。
若要安裝 NuGet 套件、檢查更新或查看發佈說明，請參閱 Azure Monitor AspNetCore NuGet Package 頁面。
欲了解更多關於 OpenTelemetry 及其社群的資訊，請參閱 OpenTelemetry .NET GitHub 資料庫。
若要啟用使用體驗，請啟用網頁或瀏覽器用戶監視。

欲檢視原始碼，請參閱 Azure Monitor OpenTelemetry for JavaScript 儲存庫。
欲檢視範例應用程式，請參閱 Azure Monitor OpenTelemetry for Node.js。
若要安裝 npm 套件並檢查更新，請參閱 @azure/monitor-opentelemetry npm 套件頁面。
欲了解更多 OpenTelemetry 及其社群資訊，請參閱 OpenTelemetry JavaScript GitHub repository。
若要啟用使用體驗，請啟用網頁或瀏覽器用戶監視。

意見反應

此頁面對您有幫助嗎？

Last updated on 2026-03-13