.NET、Node.js、Python、およびJava アプリケーションAzure Monitor OpenTelemetry を有効にする

この記事では、Azure Monitor Application Insights 内で OpenTelemetry ベースのデータ収集を有効にして構成する方法について説明します。 Azure Monitor OpenTelemetry Distro:

OpenTelemetry ディストリビューションを提供します。これには、Azure Monitor固有の機能のサポートが含まれます。
トレース、メトリック、ログ、例外を収集するための OpenTelemetry インストルメンテーションライブラリを含めることで、自動テレメトリを有効にします。
カスタムテレメトリの収集を許可します。
ライブメトリックをサポートし、ライブの運用中の Web アプリケーションからテレメトリを監視および収集します。

Azure Monitor OpenTelemetry Distro を使用する利点の詳細については、「Azure Monitor OpenTelemetry Distro を使用する必要があります>を参照してください。

OpenTelemetry を使用したデータ収集の詳細については、 Application Insights エクスペリエンスの OpenTelemetry (OTel) の収集または OpenTelemetry に関する FAQ を参照してください。

OpenTelemetry のリリースの状態

OpenTelemetry オファリングは、.NET、Node.js、Python、およびJavaアプリケーションで利用できます。機能ごとのリリースの状態については、 FAQ を参照してください。

注記

Azure 関数アプリについては、「Use OpenTelemetry with Azure Functions」を参照してください。

Application Insights で OpenTelemetry を有効にする

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

注記

.NETでは、クラシック ASP.NET、コンソールアプリ、Windows Forms (WinForms) など、複数のシナリオについて説明します。

前提条件

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

ASP.NET Core Application .NET

ヒント

Application Insights クラシック API から移行する場合は、移行に関するドキュメントを参照してください。

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

最新の NuGet パッケージ:

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore

最新の NuGet パッケージ:

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 Exporter を追加します。

// 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 引数に -javaagent:"path/to/applicationinsights-agent-3.7.5.jar" を追加して、Java仮想マシン (JVM) を jar ファイルにポイントします。

注記

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

ヒント

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

ヒント

Spring Boot アプリケーションを開発する場合は、必要に応じて JVM 引数をプログラムによる構成で置き換えることができます。詳細については、「 Spring Boot を使用した Application Insights 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をコピーする

connection stringは一意であり、Azure Monitor OpenTelemetry Distro が収集したテレメトリを送信する場所を指定します。

ヒント

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

connection stringをコピーするには:

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

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>をあなたの一意の接続文字列で置き換えます。
code - ASP.NET Core、Node.js、およびPythonのみを使用して設定

コードによるconnection stringの設定の例についてはconnection string構成を参照してください。

注記

connection stringを複数の場所に設定すると、環境変数は次の順序で優先されます。

Code
環境変数
構成ファイル

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

アプリケーションを実行し、Azure ポータルで Application Insights を開きます。データが表示されるまでに数分かかる場合があります。

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

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

注記

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

重要

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

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

ヒント

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

Troubleshooting

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

OpenTelemetry のフィードバック

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

OpenTelemetry コミュニティのカスタマーフィードバックアンケートに記入してください。
Microsoft の OpenTelemetry 早期導入者コミュニティに参加して、お客様自身のことをお知らせください。
Microsoft Tech Community で他の Azure Monitor ユーザーと交流してください。
Azure フィードバックフォーラムで機能に関する要求を行ってください。

サポート

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

Azure サポートの問題については、Azure サポートチケットを開いてください。
OpenTelemetry の問題については、OpenTelemetry .NET コミュニティに直接問い合わせてください。
Azure Monitor Exporter に関連する未解決の問題の一覧については、GitHub のイシューページを参照してください。

次のステップ

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

ソースコードを確認するには、 Azure Monitor OpenTelemetry for JavaScript リポジトリを参照してください。
サンプルアプリケーションを確認するには、 Node.jsの Azure Monitor OpenTelemetry に関するページを参照してください。
npm パッケージのインストールおよび更新プログラムの確認を行うには、@azure/monitor-opentelemetrynpm パッケージのページを参照してください。
OpenTelemetry とそのコミュニティの詳細については、OpenTelemetry JavaScript GitHub リポジトリを参照してください。
使用エクスペリエンスを有効にするには、Web またはブラウザーのユーザー監視を有効にします。

フィードバック

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

Last updated on 2026-03-13