OpenTelemetry のヘルプ、サポート、フィードバック

[アーティクル]
10/14/2024

この記事では、Azure Monitor Application Insights for .NET、Java、Node.js、Python アプリ上の OpenTelemetry に関するヘルプ、サポート、フィードバックのオプションについて説明します。

よく寄せられる質問を確認する
トラブルシューティング手順を実行する
サポートの利用
フィードバックを送信する

よく寄せられる質問

OpenTelemetry とは何ですか?

監視のための新しいオープンソース標準です。詳細については、「OpenTelemetry」を参照してください。

Microsoft Azure Monitor が OpenTelemetry に投資しているのはなぜですか?

Microsoft は次の理由から OpenTelemetry への投資を行っています。

ベンダーに依存せず、複数の言語にわたって一貫した API/SDK を提供する。
時間の経過とともに、Microsoft は、OpenTelemetry によって、Azure Monitor のお客様がサポートされている言語以外の言語で記述されたアプリケーションを監視できるようになると考えるようになりました。
インストルメンテーションライブラリのリッチなセットを通じて、利用者が収集できるデータの種類を拡大する。
OpenTelemetry ソフトウェア開発キット (SDK) は、先行製品である Application Insights SDK よりも大部分で良いパフォーマンスを示す傾向がある。
OpenTelemetry はオープンソースを推進するという Microsoft の戦略に沿うものである。

OpenTelemetry はどのような状況ですか?

OpenTelemetry の状態を参照してください。

Azure Monitor OpenTelemetry Distro とは

これは、Azure で最上級のエクスペリエンスが得られるように、すべての OpenTelemetry コンポーネントをバンドルするシンラッパーと考えることができます。このラッパーは、OpenTelemetry のディストリビューションとも呼ばれます。

Azure Monitor OpenTelemetry Distro を使用する必要がある理由

コミュニティのネイティブ OpenTelemetry よりも Azure Monitor OpenTelemetry Distro を使用することには、いくつかの利点があります。

有効化作業を減らす
Microsoft によってサポートされている
次のような Azure 固有の機能が導入されます。
- 従来の Application Insights SDK と互換性のあるサンプリング
- Microsoft Entra 認証
- オフラインストレージと自動再試行
- Statsbeat
- Application Insights 標準メトリック
- さまざまな Azure 環境でクラウドロール名とクラウドロールインスタンスを自動入力するためのリソースメタデータを検出する
- ライブメトリック

OpenTelemetry の精神に基づいて、ディストリビューションはオープンで拡張できるように設計されています。たとえば、次のようなものを追加できます。

OpenTelemetry Protocol (OTLP) エクスポーターと 2 番目の宛先に同時に送信する
ディストリビューションに含まれていない他のインストルメンテーションライブラリ

このディストリビューションは OpenTelemetry ディストリビューションを提供しているため、このディストリビューションは OpenTelemetry でサポートされているものすべてをサポートしています。たとえば、OpenTelemetry でサポートされている場合は、テレメトリプロセッサ、エクスポーター、インストルメンテーションライブラリをさらに追加できます。

Note

このディストリビューションは、サンプラーを Application Insights のカスタムの固定レートサンプラーに設定します。これを別のサンプラーに変更できますが、変更した場合、このディストリビューションに含まれる機能の一部が無効になる可能性があります。サポートされているサンプラーの詳細については、「Azure Monitor OpenTelemetry を構成する」の「サンプリングの有効化」セクションを参照してください。

サポートされているスタンドアロンの OpenTelemetry エクスポーターがない言語の場合、Azure Monitor OpenTelemetry Distro が、Azure Monitor で OpenTelemetry を使用するための現在サポートされている唯一の方法です。スタンドアロンの OpenTelemetry エクスポーターがサポートされている言語では、テレメトリシナリオに応じて、Azure Monitor OpenTelemetry Distro または適切なスタンドアロンの OpenTelemetry エクスポーターのいずれかを使用できます。詳細については、「どのようなときに Azure Monitor OpenTelemetry エクスポーターを使う必要がありますか?」を参照してください。

Azure Monitor OpenTelemetry Distro をテストするにはどうすればよいですか?

.NET、Java、JavaScript (Node.js)、Python に関する Microsoft 提供のドキュメントを確認してください。

OpenTelemetry または Application Insights SDK を使用する必要がありますか?

Application Insights SDK の正式なサポートでのみ利用できる機能が必要な場合を除き、OpenTelemetry Distro を使うことをお勧めします。

OpenTelemetry を採用すると、後で移行する必要がなくなります。

どのようなときに Azure Monitor OpenTelemetry エクスポーターを使う必要がありますか?

ASP.NET Core、Java、Node.js、Python では、Azure Monitor OpenTelemetry Distro の使用をお勧めします。 1 行のコードで始められます。

他のすべての .NET シナリオ (従来の ASP.NET、コンソールアプリ、Windows フォーム (WinForms) など) では、.NET Azure Monitor OpenTelemetry エクスポーター (Azure.Monitor.OpenTelemetry.Exporter) の使用をお勧めします。

高度な構成を必要とするより複雑な Python テレメトリシナリオでは、Python Azure Monitor OpenTelemetry エクスポーターの使用をお勧めします。

Azure Monitor OpenTelemetry Distro 内の機能は、現在どのようなリリース状態ですか?

次のグラフは、各言語に対する OpenTelemetry 機能のサポートを示しています。

機能	.NET	Node.js	Python	Java
分散トレース	✅	✅	✅	✅
カスタムメトリック	✅	✅	✅	✅
標準メトリック	✅	✅	✅	✅
固定レートサンプリング	✅	✅	✅	✅
オフラインストレージと自動再試行	✅	✅	✅	✅
例外のレポート	✅	✅	✅	✅
ログの収集	✅	⚠️	✅	✅
[カスタムイベント]	⚠️	⚠️	⚠️	✅
Microsoft Entra 認証	✅	✅	✅	✅
ライブメトリック	✅	✅	✅	✅
Live Metrics のフィルター処理	✅	❌	❌	❌
VM/VMSS と App Service のリソースコンテキストを検出する	✅	❌	✅	✅
Azure Kubernetes Service (AKS) と関数のリソースコンテキストを検出する	❌	❌	❌	✅
Track Availability API を使って生成された可用性テストイベント	❌	❌	❌	✅
匿名ユーザー ID と合成ソースによる要求、依存関係、ログ、例外のフィルター処理	❌	❌	❌	✅
操作名による依存関係、ログ、例外のフィルター処理	❌	❌	❌	✅
アダプティブサンプリング	❌	❌	❌	✅
Profiler	❌	❌	❌	⚠️
スナップショットデバッガー	❌	❌	❌	❌

キー

✅ この機能は、正式なサポートを受けるすべてのお客様が利用できます。
⚠️ この機能は、パブリックプレビューとして利用できます。「Microsoft Azure プレビューの追加利用規約」を参照してください。
❌ この機能は利用できないか、適用されません。

OpenTelemetry は Web ブラウザーで使用できますか?

はい。ただし、お勧めしません。また、Azure ではサポートされていません。 OpenTelemetry JavaScript は、Node.js 用に非常に最適化されています。代わりに、Application Insights JavaScript SDK を使用することをお勧めします。

Web ブラウザーで OpenTelemetry SDK を使用できるようになるのはいつですか?

OpenTelemetry Web SDK が利用可能になるタイムラインはまだ決定されていません。 Application Insights JavaScript SDK の有効な代替手段となるブラウザー SDK が登場するのは、おそらく数年先です。

現在、Web ブラウザーで OpenTelemetry をテストできますか?

OpenTelemetry Web Sandbox は、ブラウザーで OpenTelemetry を動作させるために設計されたフォークです。 Application Insights にテレメトリを送信することはまだできません。この SDK では、一般的なクライアントイベントは定義されていません。

AppDynamics、DataDog、NewRelic などの競合エージェントと共に Application Insights を実行することはサポートされていますか?

このような実行をテストまたはサポートする予定はありませんが、Distro では、Azure Monitor と共に同時に OTLP エンドポイントにエクスポートできます。

運用環境でプレビュー機能を使用できますか?

それは推奨されません。「Microsoft Azure プレビューの追加利用規約」を参照してください。

手動インストルメンテーションと自動インストルメンテーションの違いは何ですか?

「OpenTelemetry の概要」を参照してください。

OpenTelemetry Collector を使用できますか?

Microsoft がアプリケーション監視のためのエージェントベースのアプローチをまだ正式にサポートしていないにもかかわらず、一部のお客様は、エージェントの代替として OpenTelemetry-Collector を使い始めています。その間、オープンソースコミュニティは OpenTelemetry-Collector Azure Monitor エクスポーターを提供してきました。一部のお客様は、これを使ってデータを Azure Monitor Application Insights に送信しています。 これは、Microsoft ではサポートされません。

OpenCensus と OpenTelemetry の違いは何ですか?

OpenCensus は OpenTelemetry の前段階です。 Microsoft は、OpenTracing と OpenCensus を統合して、世界の単一の監視標準である OpenTelemetry の作成を支援しました。 Azure Monitor 用に現在の運用環境で推奨されている Python SDK は、OpenCensus に基づいています。 Microsoft は、Azure Monitor を OpenTelemetry に基づくものにすることに取り組んでいます。

Grafana で `Status: 500. Can't visualize trace events using the trace visualizer` が表示される理由

OpenTelemetry トレースでなく、生のテキストログを視覚化しようとしている可能性があります。

Application Insights の "トレース" テーブルには、診断目的で生のテキストログが格納されます。ユーザー要求、その他のイベント、および例外レポートに関連付けられているトレースを識別して関連付けるのに役立ちます。ただし、"トレース" テーブルは、Grafana などの視覚化ツールのエンドツーエンドのトランザクションビュー (ウォーターフォールチャート) に直接提供されるわけではありません。

クラウドネイティブの実践の導入が拡大するにつれて、テレメトリの収集と用語は進化しています。 OpenTelemetry は、テレメトリデータの収集とインストルメント化の標準となりました。このコンテキストでは、"トレース" という用語は新しい意味を持ちます。 OpenTelemetry の "トレース" は、生のログではなく、個々の作業単位を表すスパンを含む、より豊富で構造化された形式のテレメトリを意味します。これらの範囲の拡大は、詳細なトランザクションビューを構築し、クラウドネイティブアプリケーションの監視と診断を向上するうえで重要です。

トラブルシューティング

手順 1: 診断ログを有効にする

Azure Monitor エクスポーターでは、その内部ログのために EventSource を使用します。エクスポーターログは、OpenTelemetry-AzureMonitor-Exporter という名前のソースにオプトインすることで、EventListener で使用できます。トラブルシューティングの手順については、GitHub の OpenTelemetry のトラブルシューティングに関するページを参照してください。

手順 2: アプリケーションホストとインジェストサービスの間の接続をテストする

Application Insights ソフトウェア開発キット (SDK) とエージェントからテレメトリが送信され、インジェストエンドポイントで REST 呼び出しとして取り込まれます。 Web サーバーまたはアプリケーションホストコンピューターからインジェストサービスエンドポイントへの接続をテストするには、cURL コマンドまたは PowerShell の生の REST 要求を使用します。詳細については、「Azure Monitor Application Insights でアプリケーションテレメトリがない場合のトラブルシューティング」を参照してください。

既知の問題

Azure Monitor OpenTelemetry Exporter の既知の問題を次に示します。

依存関係テレメトリに操作名がない。操作名がないと、エラーが発生し、パフォーマンスタブのエクスペリエンスに悪影響を及ぼします。
要求と依存関係のテレメトリにデバイスモデルがない。デバイスモデルがないと、デバイスのコーホート分析に悪影響を及ぼします。

手順 1: 診断ログを有効にする

手順 2: アプリケーションホストとインジェストサービスの間の接続をテストする

Application Insights SDK とエージェントからテレメトリが送信され、インジェストエンドポイントで REST 呼び出しとして取り込まれます。 Web サーバーまたはアプリケーションホストコンピューターからインジェストサービスエンドポイントへの接続をテストするには、cURL コマンドまたは PowerShell の生の REST 要求を使用します。詳細については、「Azure Monitor Application Insights でアプリケーションテレメトリがない場合のトラブルシューティング」を参照してください。

既知の問題

Azure Monitor OpenTelemetry Exporter の既知の問題を次に示します。

依存関係テレメトリに操作名がない。操作名がないと、エラーが発生し、パフォーマンスタブのエクスペリエンスに悪影響を及ぼします。
要求と依存関係のテレメトリにデバイスモデルがない。デバイスモデルがないと、デバイスのコーホート分析に悪影響を及ぼします。

手順 1: 診断ログを有効にする

既定では、診断ログは Azure Monitor Application Insights で有効になっています。詳細については、「トラブルシューティングガイド: Azure Monitor Application Insights for Java」を参照してください。

手順 2: アプリケーションホストとインジェストサービスの間の接続をテストする

既知の問題

ブラウザーから、インストール用の Application Insights クライアントライブラリをダウンロードすると、ダウンロードした JAR ファイルが破損し、ソースファイルの約半分のサイズになる場合があります。この問題が発生した場合は、次のコマンド呼び出し例に示すように、curl または wget コマンドを実行して JAR ファイルをダウンロードします。
```
curl --location --output applicationinsights-agent-3.6.2.jar https://github.com/microsoft/ApplicationInsights-Java/releases/download//applicationinsights-agent-3.6.2.jar
```
```
wget --output-document=applicationinsights-agent-3.6.2.jar https://github.com/microsoft/ApplicationInsights-Java/releases/download//applicationinsights-agent-3.6.2.jar
```
Note

コマンド呼び出しの例は、Application Insights for Java バージョン 3.4.11 に適用されます。 Application Insights for Java の現在のリリースのバージョン番号と URL アドレスについては、https://github.com/microsoft/ApplicationInsights-Java/releases を参照してください。

次の手順は、Spring Boot ネイティブアプリケーションに適用されます。

手順 1: OpenTelemetry のバージョンを確認する

アプリケーションのスタートアップ時に、次のメッセージが表示されることがあります。

WARN  c.a.m.a.s.OpenTelemetryVersionCheckRunner - The OpenTelemetry version is not compatible with the spring-cloud-azure-starter-monitor dependency.
The OpenTelemetry version should be <version>

この場合は、Spring Boot スターターの OpenTelemetry ドキュメントに従って、OpenTelemetry 部品表をインポートする必要があります。

手順 2: 自己診断を有効にする

想定どおりに動作しない場合は、DEBUG レベルで自己診断を有効にして、分析情報を取得できます。これを行うには、APPLICATIONINSIGHTS_SELF_DIAGNOSTICS_LEVEL 環境変数を使用して、自己診断レベルを ERROR、WARN、INFO、DEBUG、または TRACE に設定します。

docker コンテナーの実行時に DEBUG レベルで自己診断を有効にするには、次のコマンドを実行します。

docker run -e APPLICATIONINSIGHTS_SELF_DIAGNOSTICS_LEVEL=DEBUG <image-name>

Note

適宜、<image-name> を docker イメージ名に置き換えます。

サードパーティの情報に関する免責事項

Microsoft では、暗黙的またはそれ以外に関わらず、このようなサードパーティ製品のパフォーマンスや信頼性について何ら保証しません。

手順 1: 診断ログを有効にする

Azure Monitor Exporter では、内部ログに OpenTelemetry API ロガーが使用されます。ロガーを有効にするには、次のコードスニペットを実行します。

const { diag, DiagConsoleLogger, DiagLogLevel } = require("@opentelemetry/api");
const { NodeTracerProvider } = require("@opentelemetry/sdk-trace-node");

const provider = new NodeTracerProvider();
diag.setLogger(new DiagConsoleLogger(), DiagLogLevel.ALL);
provider.register();

手順 2: アプリケーションホストとインジェストサービスの間の接続をテストする

既知の問題

Azure Monitor OpenTelemetry Exporter の既知の問題を次に示します。

依存関係テレメトリに操作名がない。操作名がないと、エラーが発生し、パフォーマンスタブのエクスペリエンスに悪影響を及ぼします。
要求と依存関係のテレメトリにデバイスモデルがない。デバイスモデルがないと、デバイスのコーホート分析に悪影響を及ぼします。
データベースサーバー名が依存関係名に含まれていない。データベースサーバー名が含まれていないため、OpenTelemetry Exporter は、同じ名前のテーブルを異なるサーバーに誤って集計します。

診断ログを有効にする

Microsoft Azure Monitor Exporter では、内部ログに Python 標準のログライブラリを使用します。 OpenTelemetry API と Azure Monitor Exporter のログには、不規則なアクティビティに対して重要度レベルの WARNING または ERROR が割り当てられます。 INFO 重要度レベルは、通常または正常なアクティビティに使用されます。

既定で、Python ログライブラリでは重要度レベルが WARNING に設定されます。そのため、この重要度設定を下回るログを表示するには重要度レベルを変更する必要があります。次のコード例では、すべての重要度レベルのログをコンソールとファイルに出力する方法を示しています。

...
import logging

logging.basicConfig(format = "%(asctime)s:%(levelname)s:%(message)s", level = logging.DEBUG)

logger = logging.getLogger(__name__)
file = logging.FileHandler("example.log")
stream = logging.StreamHandler()
logger.addHandler(file)
logger.addHandler(stream)
...

アプリケーションホストとインジェストサービスの間の接続をテストする

テレメトリの重複を回避する

多くの場合、プロセッサまたはエクスポーターの複数のインスタンスを作成すると、テレメトリの重複が発生します。テレメトリの柱 (ログ、メトリック、分散トレース) ごとに、一度に 1 つのエクスポーターとプロセッサのみを実行してください。

次のセクションでは、テレメトリの重複を引き起こす可能性があるシナリオについて説明します。

Azure Functions でトレースログを複製する

Application Insights 内のトレースログごとにエントリのペアが表示される場合は、次の種類のログインストルメンテーションが有効になっている可能性があります。

Azure Functions のネイティブログインストルメンテーション
ディストリビューション内の azure-monitor-opentelemetry ログインストルメンテーション

重複を防ぐために、ディストリビューションのログ記録を無効にできますが、Azure Functions のネイティブログインストルメンテーションは有効のままにしておきます。この目標を達成するには、OTEL_LOGS_EXPORTER 環境変数を None に設定します。

Azure Functions の "Always On" でテレメトリを複製する

Azure Functions の Always On 設定が On に設定されている場合、Azure Functions では、実行が完了するたびに一部のプロセスがバックグラウンドで実行され続けます。たとえば、毎回 configure_azure_monitor を呼び出す 5 分間のタイマー関数があるとします。 20 分後に、4 つのメトリックエクスポーターが同時に実行される場合があります。この状況が、重複するメトリックテレメトリの原因である可能性があります。

このような場合は、Always On 設定を Off に設定するか、各 configure_azure_monitor 呼び出しの間にプロバイダーを手動でシャットダウンしてみてください。各プロバイダーをシャットダウンするには、次のコードに示すように、現在のメーター、トレーサー、およびロガープロバイダーごとにシャットダウン呼び出しを実行します。

get_meter_provider().shutdown()
get_tracer_provider().shutdown()
get_logger_provider().shutdown()

Azure Workbooks と Jupyter Notebook

Azure Workbooks と Jupyter Notebook は、エクスポータープロセスをバックグラウンドで実行し続ける場合があります。テレメトリの重複を防ぐには、configure_azure_monitor に対してさらに呼び出しを行う前にキャッシュをクリアします。

FastAPI または Flask アプリからの要求テレメトリが欠落している

Requests テーブルデータが欠落しているが、他のカテゴリではない場合は、http フレームワークがインストルメント化されていない可能性があります。これは、import 宣言を正しく構造化していない場合、Python 用 Azure Monitor OpenTelemetry Distro クライアントライブラリを使用する FastAPI と Flask アプリで発生する可能性があります。 configure_azure_monitor 関数を呼び出して FastAPI と Flask ライブラリをインストルメント化する前に、fastapi.FastAPI または flask.Flask をそれぞれインポートしている可能性があります。たとえば、次のコードでは FastAPI と Flask アプリが正常にインストルメント化されません。

# FastAPI

from azure.monitor.opentelemetry import configure_azure_monitor
from fastapi import FastAPI

configure_azure_monitor()

app = FastAPI()

# Flask

from azure.monitor.opentelemetry import configure_azure_monitor
from flask import Flask

configure_azure_monitor()

app = Flask(__name__)

代わりに、fastapi または flask モジュール全体をインポートし、fastapi.FastAPI または flask.Flask にアクセスする前に、configure_azure_monitor を呼び出して OpenTelemetry を構成して、Azure Monitor を使用することをお勧めします。

# FastAPI

from azure.monitor.opentelemetry import configure_azure_monitor
import fastapi

configure_azure_monitor()

app = fastapi.FastAPI(__name__)

# Flask

from azure.monitor.opentelemetry import configure_azure_monitor
import flask

configure_azure_monitor()

app = flask.Flask(__name__)

または、fastapi.FastAPI または flask.Flask をインポートする前に configure_azure_monitor を呼び出すことができます。

# FastAPI

from azure.monitor.opentelemetry import configure_azure_monitor

configure_azure_monitor()

from fastapi import FastAPI

app = FastAPI(__name__)

# Flask

from azure.monitor.opentelemetry import configure_azure_monitor

configure_azure_monitor()

from flask import Flask

app = Flask(__name__)

サポート

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

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

OpenTelemetry のフィードバック

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

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

次の方法で共有

OpenTelemetry のヘルプ、サポート、フィードバック

よく寄せられる質問

OpenTelemetry とは何ですか?

Microsoft Azure Monitor が OpenTelemetry に投資しているのはなぜですか?

OpenTelemetry はどのような状況ですか?

Azure Monitor OpenTelemetry Distro とは

Azure Monitor OpenTelemetry Distro を使用する必要がある理由

Azure Monitor OpenTelemetry Distro をテストするにはどうすればよいですか?

OpenTelemetry または Application Insights SDK を使用する必要がありますか?

どのようなときに Azure Monitor OpenTelemetry エクスポーターを使う必要がありますか?

Azure Monitor OpenTelemetry Distro 内の機能は、現在どのようなリリース状態ですか?

OpenTelemetry は Web ブラウザーで使用できますか?

Web ブラウザーで OpenTelemetry SDK を使用できるようになるのはいつですか?

現在、Web ブラウザーで OpenTelemetry をテストできますか?

AppDynamics、DataDog、NewRelic などの競合エージェントと共に Application Insights を実行することはサポートされていますか?

運用環境でプレビュー機能を使用できますか?

手動インストルメンテーションと自動インストルメンテーションの違いは何ですか?

OpenTelemetry Collector を使用できますか?

OpenCensus と OpenTelemetry の違いは何ですか?

Grafana で Status: 500. Can't visualize trace events using the trace visualizer が表示される理由

トラブルシューティング

手順 1: 診断ログを有効にする

手順 2: アプリケーション ホストとインジェスト サービスの間の接続をテストする

既知の問題

サポート

OpenTelemetry のフィードバック

フィードバック

その他のリソース

Grafana で `Status: 500. Can't visualize trace events using the trace visualizer` が表示される理由

手順 2: アプリケーションホストとインジェストサービスの間の接続をテストする