OpenTelemetry を使用して Java アプリケーションから ARMS にトレースデータをインポート - Application Real-Time Monitoring Service

Application Real-Time Monitoring Service (ARMS) は、Java アプリケーションからの OpenTelemetry ベースのトレース取り込みをサポートしています。OpenTelemetry SDK を使用してアプリケーションから直接トレースをエクスポートするか、OpenTelemetry Collector を介して転送することができます。

前提条件

開始する前に、以下が準備できていることを確認してください：

有効化された ARMS インスタンス
インストルメンテーションの準備ができている Java アプリケーション
ARMS のトレース取り込みエンドポイントと認証トークン (トークンは ACK コンソールから入手できます)

連携方法の選択

方法	最適なケース	機能
ARMS エージェント + OpenTelemetry SDK	特定のメソッドにカスタムスパンを追加し、共通コンポーネントを自動でインストルメンテーションする場合	ARMS エージェントが共通コンポーネントを自動で処理します。必要な箇所にのみ OTel SDK を使用してカスタムスパンを追加します。
OpenTelemetry SDK + Jaeger exporter	インストルメンテーションを完全に手動で制御する場合	各コンポーネントを明示的にインストルメンテーションし、Jaeger exporter を介してトレースをエクスポートします。ベンダー固有のエージェントは不要で、完全に標準の OTel を使用します。
OpenTelemetry Collector	複数のサービスからのトレースコレクションを一元化する場合	Collector を中央パイプラインとしてデプロイし、OTLP exporter を構成して ARMS にトレースを転送します。

アプリケーションからのトレースの直接エクスポート

ARMS エージェントと OpenTelemetry SDK for Java の使用

Java 用 ARMS エージェント (V2.7.1.3 以降) は、OpenTelemetry SDK 拡張をサポートしています。エージェントは共通コンポーネントを自動でインストルメンテーションします。エージェントがカバーしていないメソッドには、OpenTelemetry SDK を使用してカスタムスパンを追加してください。

設定手順については、「OpenTelemetry SDK for Java を使用したアプリケーションの手動インストルメンテーション」をご参照ください。

OpenTelemetry SDK と Jaeger exporter の使用

OpenTelemetry SDK for Java を使用してアプリケーションをインストルメンテーションし、Jaeger exporter を介してトレースデータをエクスポートします。このアプローチでは、どのコンポーネントをインストルメンテーションするかを完全に制御でき、ベンダー固有のエージェントなしで標準の OpenTelemetry API を使用します。

設定手順については、「OpenTelemetry を使用した Java アプリケーションのトレースデータの送信」をご参照ください。

OpenTelemetry Collector を介したトレースの転送

OpenTelemetry Collector を介してトレースをルーティングするには、Collector の構成ファイルで OTLP exporter を構成し、ARMS のエンドポイントと認証トークンを設定します。

Collector exporter の構成

次の内容を Collector 構成ファイル (otel-collector-config.yaml) に追加します：

exporters:
  otlp:
    endpoint: <endpoint>:8090
    tls:
      insecure: true
    headers:
      Authentication: <token>

構成パラメーター

プレースホルダーを実際の値に置き換えてください：

パラメーター	説明	例
`<endpoint>`	ご利用のリージョンに対応する ARMS のトレース取り込みエンドポイント	`http://tracing-analysis-dc-bj.aliyuncs.com:8090`
`<token>`	ACK コンソールで取得した認証トークン	`b590lhguqs@3a7*******9b_b590lhguqs@53d***8301`

ARMS でのトレースデータの確認と使用

アプリケーションがトレースの送信を開始すると、以下の機能を使用してアプリケーションのモニターやデバッグができます。

トレース詳細

トレース詳細ページの左側には各スパンの呼び出しシーケンスと持続時間が表示されます。右側には、SQL クエリ、JVM 統計、ホストレベルのメトリックなど、関連するメトリックが表示されます。

事前集計されたメトリックダッシュボード

ARMS はトレースデータから、アプリケーション概要、API 呼び出し、データベースクエリのダッシュボードなどを自動的に生成します。詳細については、「アプリケーション概要」をご参照ください。

Trace Explorer

アプリケーション、IP アドレス、API などの複数のディメンションでトレースをフィルタリングおよび集計します。Trace Explorer は、サービスをまたいだ異常なトレースのクエリもサポートしています。詳細については、「Trace Explorer」をご参照ください。

トレースとログの関連付け

ARMS はトレースをサービスログにリンクさせるため、例外のトラブルシューティング時にトレーススパンから関連するログエントリに直接ジャンプできます。詳細については、「トレースとログの分析によるビジネス例外の特定」をご参照ください。