.NET、Node.js、Python、Java アプリケーションの OpenTelemetry を有効にする

注記

.NET、Node.js、およびPython アプリケーションの場合:

新しいアプリまたは初めての OpenTelemetry の導入:Microsoft OpenTelemetry Distro を使用します。
Azure Monitor OpenTelemetry Distro を既に使用しています:アクションは必要ありません。
Application Insights .NET SDK 2.x を使用している場合:3.x にアップグレードして再インストルメンテーションを最小限に抑えるか、Microsoft OpenTelemetry Distro で新たに開始します。

Java アプリケーションの場合は、Azure Monitor OpenTelemetry Distro を使用します。

AI 支援インストルメンテーションガイダンスについては、 Application Insights インストルメンテーションスキルを参照してください。既存の Application Insights インストルメンテーションのガイド付きセットアップと分析については、Azure Monitor用の Azure MCP Server ツールを参照してください。

このガイダンスでは、Microsoft OpenTelemetry Distro を使用してアプリケーションに可観測性を追加する方法について説明します。 Distro は、組み込みのインストルメンテーションを使用してトレース、メトリック、ログを自動的に収集し、テレメトリを Azure Monitor、任意の OpenTelemetry Protocol (OTLP) エンドポイント、または Microsoft Agent 365 にエクスポートします。

その他のコレクションとエクスポートのオプションについては、「openTelemetry with Azure Monitor」を参照してください。

OpenTelemetry のリリースの状態

パッケージの詳細とリリースノートについては、「次の手順」を参照してください。

注記

Azure 関数アプリについては、「Azure Functions で OpenTelemetry を使用する」を参照してください。

Application Insights で OpenTelemetry を有効にする

このセクションの手順に従い、OpenTelemetry を使用してアプリケーションをインストルメント化します。言語固有の手順のタブを選択します。

Microsoft OpenTelemetry Distro パッケージ識別子とインストールコマンドは次のとおりです。

Language	Package	インストールコマンド
Python	`microsoft-opentelemetry`	`pip install microsoft-opentelemetry`
Node.js	`@microsoft/opentelemetry`	`npm install @microsoft/opentelemetry`
.NET	`Microsoft.OpenTelemetry`	`dotnet add package Microsoft.OpenTelemetry`

Java では、Java タブと Java native タブで説明されているエージェントまたは native-image 統合を使用します。

Web アプリケーションの場合は [ASP.NET Core] タブ、コンソールやその他のホストされていないアプリケーションの場合は [.NET] タブを使用します。

前提条件

Azure サブスクリプション: Azure サブスクリプションを無料で作成します
Application Insights リソース: Application Insights リソースを作成する

ASP.NET Core Application .NET

ヒント

Application Insights .NET SDK 2.x からアップグレードする場合は、SDK 3.x 移行ガイダンスに従ってください。このアップグレードでは、Microsoft OpenTelemetry Distro に切り替える必要はありません。

クライアントライブラリをインストールする

注記

これらのインストール手順は、Microsoft OpenTelemetry Distro を使用するアプリケーションを対象とします。これらは、既存の Azure Monitor OpenTelemetry Distro ユーザーにとってアップグレード要件ではありません。同じアプリケーションで両方のディストリビューションを初期化しないでください。スタンドアロン Azure Monitor エクスポーターパッケージは、既存の名前を保持します。

Microsoft.OpenTelemetry NuGet パッケージをインストールします。

dotnet add package Microsoft.OpenTelemetry

注記

これらのインストール手順は、Microsoft OpenTelemetry Distro を使用するアプリケーションを対象とします。これらは、既存の Azure Monitor OpenTelemetry Distro ユーザーにとってのアップグレード要件ではありません。同じアプリケーションで両方のディストリビューションを初期化しないでください。スタンドアロン Azure Monitor エクスポーターパッケージは、既存の名前を保持します。

Microsoft.OpenTelemetry NuGet パッケージをインストールします。

dotnet add package Microsoft.OpenTelemetry

注記

これらのインストール手順は、Microsoft OpenTelemetry Distro を使用するアプリケーションを対象とします。これらは、既存の Azure Monitor OpenTelemetry Distro ユーザーのアップグレード要件ではありません。同じアプリケーションで両方のディストリビューションを初期化しないでください。スタンドアロン Azure Monitor エクスポーターパッケージは、既存の名前を保持します。

@microsoft/opentelemetry npm パッケージをインストールします。

npm install @microsoft/opentelemetry

注記

microsoft-opentelemetry PyPI パッケージをインストールします:

pip install microsoft-opentelemetry

アプリケーションを変更する

アプリケーションが処理を開始する前に、Microsoft OpenTelemetry Distro を初期化します。次の例では、変換先としてAzure Monitorを選択し、APPLICATIONINSIGHTS_CONNECTION_STRING環境変数から接続文字列を読み取ります。この記事で後述するように、アプリケーションを開始する前にその変数を設定します。

コードで接続文字列を設定することもできます。 .NETの場合は、options.AzureMonitor.ConnectionString内でUseMicrosoftOpenTelemetry()を使用します。サポートされているすべての言語については、「接続文字列の構成」を参照してください。

Program.csで、Microsoft OpenTelemetry Distro を使用するようにアプリケーションビルダーを構成します。

// Import the distro API.
using Microsoft.OpenTelemetry;

// Create the application builder.
var builder = WebApplication.CreateBuilder(args);

// Initialize the Microsoft OpenTelemetry Distro with Azure Monitor export.
builder.UseMicrosoftOpenTelemetry(options =>
{
    options.Exporters = ExportTarget.AzureMonitor;
});

// Build and run the application.
var app = builder.Build();
app.Run();

コンソールやその他のホストされていないアプリケーションの場合は、アプリケーションコードを実行する前に OpenTelemetry SDK インスタンスを作成します。

// Import the distro and SDK APIs.
using Microsoft.OpenTelemetry;
using OpenTelemetry;

// Create the Microsoft OpenTelemetry Distro and keep the SDK alive until shutdown.
using var sdk = OpenTelemetrySdk.Create(telemetry =>
{
    // Select Azure Monitor as the export destination.
    telemetry.UseMicrosoftOpenTelemetry(options =>
    {
        options.Exporters = ExportTarget.AzureMonitor;
    });
});

sdk をアプリケーションの存続期間中有効なままにします。シャットダウン中にのみ破棄してください。そうすることで、保留中のテレメトリをフラッシュし、プロバイダーを停止できます。

自動インストルメンテーションは、構成の変更によって有効になります。 コードの変更は必要ありません。

アプリケーションの JVM 引数に -javaagent:"path/to/applicationinsights-agent-3.7.9.jar" を追加して、Java仮想マシン (JVM) を jar ファイルにポイントします。

注記

サンプリングは、コスト管理に役立つ 1 秒あたり 5 つの要求のレートで既定で有効になっています。このレートを超えるシナリオでは、テレメトリデータが見つからない可能性があります。サンプリング構成の変更の詳細については、サンプリングのオーバーライドに関するページを参照してください。 Application Insights で予期しない料金や高コストが表示される場合は、このガイドが役立ちます。テレメトリの量が多い、データインジェストの急増、サンプリングが正しく構成されていないなどの一般的な原因について説明します。コストの急増、テレメトリボリューム、サンプリングが機能しない、データ上限、高インジェスト、または予期しない課金に関連する問題をトラブルシューティングする場合に特に便利です。開始するには、「 Application Insights での高いデータインジェストのトラブルシューティング」を参照してください。

ヒント

シナリオ固有のガイダンスについては、「作業の開始 (補足)」を参照してください。

ヒント

Spring Boot アプリケーションを開発する場合は、必要に応じて JVM 引数をプログラムによる構成で置き換えることができます。詳細については、「 Spring Boot を使用した Application Insights Azure Monitorの使用を参照してください。

CommonJS アプリケーションの場合は、インストルメント化するライブラリを読み込む前に、Microsoft OpenTelemetry Distro を初期化します。

// Import the distro API.
const { useMicrosoftOpenTelemetry } = require("@microsoft/opentelemetry");

// Initialize the distro before loading application libraries.
useMicrosoftOpenTelemetry({
    azureMonitor: {
        azureMonitorExporterOptions: {
            // Read the Azure Monitor connection string from the environment.
            connectionString: process.env.APPLICATIONINSIGHTS_CONNECTION_STRING,
        },
    },
});

ECMAScript モジュール (ESM) の場合は、telemetry.mjs ブートストラップファイルを作成してください。

// Register instrumentation hooks before loading application modules.
import "@microsoft/opentelemetry/loader";
import { useMicrosoftOpenTelemetry } from "@microsoft/opentelemetry";

// Initialize the Microsoft OpenTelemetry Distro with Azure Monitor export.
useMicrosoftOpenTelemetry({
    azureMonitor: {
        azureMonitorExporterOptions: {
            // Read the connection string from the environment.
            connectionString: process.env.APPLICATIONINSIGHTS_CONNECTION_STRING,
        },
    },
});

アプリケーションモジュールが読み込まれる前にインストルメンテーションフックが登録されるように、ブートストラップファイルを事前に読み込みます。

node --import ./telemetry.mjs "<AppEntryPoint>"

Microsoft OpenTelemetry Distro を使用して、Azure Monitorエクスポートを有効にし、名前付きアプリケーションロガーを選択します。名前付きロガーを使用すると、SDK 独自のログメッセージの収集を回避できます。

# Import the logging and distro APIs.
import logging
from microsoft.opentelemetry import use_microsoft_opentelemetry

# Select an application logger to avoid collecting the SDK's own logs.
loggerName = "<LoggerName>"

# Enable Azure Monitor export using the connection string environment variable.
use_microsoft_opentelemetry(
    enable_azure_monitor=True,
    logger_name=loggerName,
)

# Collect application log records at INFO level and above.
logger = logging.getLogger(loggerName)
logger.setLevel(logging.INFO)

Application Insights リソースから接続文字列をコピーする

接続文字列は、テレメトリを受信する Application Insights リソースを識別します。

ヒント

Application Insights リソースがまだない場合は、このガイドに従って作成します。既存のリソースを使用するのではなく、新しいリソースを作成することをお勧めします。

接続文字列をコピーするには:

Application Insights リソースの [概要 ] ウィンドウに移動します。
Connection stringを見つけてください。
接続文字列にカーソルを合わせ、Copy to clipboard アイコンを選択します。

環境に接続文字列を貼り付ける

接続文字列を貼り付けるには、次のいずれかの方法を使用します。

メソッド	サポートされている言語	推奨対象
環境変数	All	生産
構成ファイル (`applicationinsights.json`)	Java のみ	運用 (Java)
Code	.NET、Node.js、Python	ローカル開発/テストのみ

重要

ローカルの開発環境とテスト環境でのみ、コードを使用して接続文字列を設定することをお勧めします。

運用環境では、環境変数または構成ファイルを使用します (Javaのみ)。

Application Insights 接続文字列を環境変数として設定します (運用環境に推奨)

Bash では次のとおりです。
```
export APPLICATIONINSIGHTS_CONNECTION_STRING="<ConnectionString>"
```
PowerShell では次のとおりです。
```
$env:APPLICATIONINSIGHTS_CONNECTION_STRING = "<ConnectionString>"
```
Application Insights 接続文字列を構成ファイルに設定します - Java のみ

次のコンテンツを使って、applicationinsights.json という名前の構成ファイルを作成し、applicationinsights-agent-3.7.9.jar と同じディレクトリに配置します。
```
    {
        "connectionString": "<ConnectionString>"
    }
```
- .NET、Node.js、Python のみ

Microsoft OpenTelemetry Distro のオプションについては、.NET、Node.js、またはPythonのドキュメントを参照してください。

データが流れていることを確認する

ディストリビューションを構成し、接続文字列を設定したら、アプリケーションを実行し、トラフィックまたはログメッセージを生成します。 Azure ポータルで Application Insights リソースを開き、テレメトリが表示されることを確認します。データが表示されるまでに数分かかる場合があります。

[Application Insights の概要] タブのスクリーンショット。サーバー要求とサーバーの応答時間が強調表示されています。

Application Insights がアプリケーションに対して有効になりました。次の手順は省略可能であり、さらにカスタマイズできます。

注記

Application Insights インストルメンテーションの使用の一環として、診断データを収集してMicrosoftに送信します。このデータは、Application Insights の実行と改善に役立ちます。詳細については、Application Insights に関する FAQ を参照してください。

重要

同じ Application Insights リソースにテレメトリを出力するサービスが 2 つ以上ある場合は、クラウドロール名をアプリケーションマップ上で適切に表す名前を設定する必要があります。

トラブルシューティング、フィードバック、サポート

ヒント

以下のセクションは、OpenTelemetry ディストリビューションのすべての記事で使用できます。

Troubleshooting

トラブルシューティングの情報については、「OpenTelemetry の問題のトラブルシューティング (.NET)」および「Azure Monitor Application Insights におけるアプリケーションテレメトリの欠落のトラブルシューティング」を参照してください。

OpenTelemetry のフィードバック

フィードバックを提供するには:

OpenTelemetry コミュニティのカスタマーフィードバックアンケートに記入してください。
OpenTelemetry 早期導入者コミュニティに参加して、自分についてMicrosoftに伝えます。
Microsoft Tech Community の他のAzure Monitor ユーザーと交流します。
Azureフィードバックフォーラムで機能要求を行います。

サポート

選択した言語のタブを選択して、サポートオプションを検出します。

Azure サポートの問題については、Azure サポートチケットを開きます。
OpenTelemetry の問題については、OpenTelemetry .NET コミュニティに直接お問い合わせください。
Azure Monitor エクスポーターに関連する未解決の問題の一覧については、「GitHub問題を参照してください。

次のステップ

ソースコードを確認するには、.NET 向け Microsoft OpenTelemetry Distro リポジトリを参照してください。
サンプルアプリケーションを確認するには、「Microsoft OpenTelemetry Distro for ASP.NET Core」を参照してください。
NuGet パッケージをインストールしたり、更新プログラムを確認したり、リリースノートを表示したりするには、Microsoft.OpenTelemetry packageを参照してください。
OpenTelemetryAzure.Monitor.OpenTelemetry.AspNetCoreを引き続き使用するアプリケーションについては、Azure Monitor ディストリビューションのドキュメントを参照してください。
OpenTelemetry とそのコミュニティの詳細については、OpenTelemetry .NET GitHub リポジトリを参照してください。
使用エクスペリエンスを有効にするには、Web またはブラウザーのユーザー監視を有効にします。

ソースコードを確認するには、.NET 向け Microsoft OpenTelemetry Distro リポジトリを参照してください。
ホストされていないセットアップについては、コンソールアプリとバックグラウンドツール用の Microsoft OpenTelemetry Distro の構成に関するページを参照してください。
NuGet パッケージをインストールしたり、更新プログラムを確認したり、リリースノートを表示したりするには、Microsoft.OpenTelemetry パッケージを参照してください。
スタンドアロン Azure.Monitor.OpenTelemetry.Exporter パッケージを使用するアプリケーションについては、Azure Monitor エクスポーターのドキュメントを参照してください。
OpenTelemetry とそのコミュニティの詳細については、OpenTelemetry .NET GitHub リポジトリを参照してください。
使用エクスペリエンスを有効にするには、Web またはブラウザーのユーザー監視を有効にします。

ソースコードを確認するには、Microsoft OpenTelemetry Distro repository for Node.jsを参照してください。
サンプルアプリケーションを確認するには、Node.js 用 Microsoft OpenTelemetry Distro のサンプルを参照してください。
npm パッケージをインストールして更新を確認するには、@microsoft/opentelemetry パッケージを参照してください。
@azure/monitor-opentelemetry を引き続き使用するアプリケーションについては、Azure Monitor ディストリビューションのドキュメントを参照してください。
OpenTelemetry とそのコミュニティの詳細については、OpenTelemetry JavaScript GitHub リポジトリを参照してください。
使用エクスペリエンスを有効にするには、Web またはブラウザーのユーザー監視を有効にします。

ソースコードと構成を確認するには、Python 用 Microsoft OpenTelemetry Distro リポジトリを参照してください。
サンプルアプリケーションを確認するには、Python 向け Microsoft OpenTelemetry Distro のサンプルを参照してください。
PyPI パッケージをインストールして更新を確認するには、microsoft-opentelemetry パッケージを参照してください。
GitHubのリリースノートを確認します。
azure-monitor-opentelemetry を引き続き使用するアプリケーションについては、Azure Monitor ディストリビューションのドキュメントを参照してください。
使用可能な OpenTelemetry のインストルメンテーションとコンポーネントを確認するには、OpenTelemetry Contributor Python GitHub リポジトリを参照してください。
OpenTelemetry とそのコミュニティの詳細については、OpenTelemetry Python GitHub リポジトリを確認してください。
使用エクスペリエンスを有効にするには、Web またはブラウザーのユーザー監視を有効にします。

フィードバック

このページはお役に立ちましたか?

最終更新: 2026-10-09