すべてのプロダクト
Search
ドキュメントセンター

Application Real-Time Monitoring Service:スタートガイド

最終更新日:Jun 27, 2025

Managed Service for OpenTelemetry を使用する前に、Alibaba Cloud アカウントを作成し、Managed Service for OpenTelemetry を有効化し、エンドポイント情報を取得する必要があります。このトピックでは、OpenTelemetry Java エージェントを使用して Java アプリケーションで自動インストゥルメンテーションを実行し、アプリケーションのデータをレポートする方法について説明します。これは、Managed Service for OpenTelemetry を使い始めるのに役立ちます。

前提条件

  • Alibaba Cloud アカウントが作成されている。

  • Managed Service for OpenTelemetry が有効化されている。

  • エンドポイントを取得する

    1. ARMS コンソール にログインします。左側のナビゲーションウィンドウで、[統合センター] をクリックします。

    2. 統合センターページで、[サーバーサイドアプリケーション] セクションの [OpenTelemetry] カードをクリックします。

    3. [OpenTelemetry] パネルで、[統合の開始] タブをクリックし、データをレポートするリージョンを選択します。

      説明

      初めてリージョンにアクセスすると、リソースが自動的に初期化されます。

    4. 接続タイプ パラメーターと エクスポートプロトコル パラメーターを構成し、エンドポイントをコピーします。

      • 接続タイプ:サービスが Alibaba Cloud にデプロイされていて、選択したリージョンにある場合は、このパラメーターを Alibaba Cloud VPC ネットワークに設定することをお勧めします。それ以外の場合は、このパラメーターをパブリックネットワークに設定します。

      • エクスポートプロトコル:クライアントでサポートされているプロトコルに基づいて、このパラメーターを HTTP(推奨)または gRPC に設定します。

      3-新版-中文-otgrpc.jpg

概要

6-新版-调用链详情-中文.jpg

この例では、OpenTelemetry Java エージェントを使用して Java アプリケーションで自動インストゥルメンテーションを実行し、アプリケーションのデータをレポートします。次の手順を実行します。

  1. デモをダウンロードする:OpenTelemetry Java エージェントのデモをダウンロードして、Managed Service for OpenTelemetry を体験できます。また、OpenTelemetry Java エージェントを使用してビジネスアプリケーションで自動インストゥルメンテーションを実行し、モニタリングデータを表示することもできます。

  2. OpenTelemetry Java エージェントを使用してアプリケーションで自動インストゥルメンテーションを実行する:OpenTelemetry Java エージェント をダウンロードする必要があります。OpenTelemetry Java エージェントを使用すると、非侵入的な方法でアプリケーションのデータを Managed Service for OpenTelemetry にレポートできます。また、何百もの Java フレームワークのトレースデータを自動的にアップロードするために使用できます。また、トレースデータをレポートするために、Java 起動構成で Java 仮想マシン(JVM)パラメーターを変更する必要があります。

  3. モニタリングデータを表示する:Managed Service for OpenTelemetry コンソールARMS コンソール にログインして、OpenTelemetry を使用して生成されたモニタリングデータを表示します。

ステップ 1:デモをダウンロードする

OpenTelemetry Java エージェントのデモまたは独自の Java ビジネスコードを使用できます。

OpenTelemetry Java エージェントのデモ をダウンロードします。

説明

デモパッケージには、次のフォルダーが含まれています。

  • java-agent-usage:OpenTelemetry Java エージェントを使用してアプリケーションで自動インストゥルメンテーションを実行します。この例では、この方法を使用します。

  • otel-sdk-usage:OpenTelemetry SDK for Java を使用してアプリケーションを手動でインストゥルメントします。

  • agent-sdk-usage:OpenTelemetry Java エージェントと OpenTelemetry SDK for Java を使用してアプリケーションをインストゥルメントします。

ステップ 2:OpenTelemetry Java エージェントを使用してアプリケーションで自動インストゥルメンテーションを実行する

この例では、OpenTelemetry Java エージェントを使用して Java アプリケーションで自動インストゥルメンテーションを実行し、アプリケーションのデータをレポートします。サポートされている Java フレームワークの詳細については、「サポートされているライブラリ、フレームワーク、アプリケーションサーバー、および JVM」をご参照ください。

  1. OpenTelemetry Java エージェント をダウンロードします。

    ダウンロードページで、最新バージョンを見つけて [アセット] をクリックします。opentelemetry-javaagent.jar パッケージを見つけてダウンロードします。

  2. トレースデータをレポートするために、Java 起動構成で JVM パラメーターを変更します。

    -javaagent:/{user.workspace}/opentelemetry-javaagent.jar    // {user.workspace} を、opentelemetry-javaagent.jar パッケージがダウンロードされたディレクトリに置き換えます。
    -Dotel.resource.attributes=service.name=<appName>     // <appName> を、Managed Service for OpenTelemetry にデータをレポートするアプリケーションの名前に置き換えます。
    -Dotel.exporter.otlp.headers=Authentication=<token>    // 「前提条件」で取得したエンドポイント情報。
    -Dotel.exporter.otlp.endpoint=<endpoint>  // 「前提条件」で取得したエンドポイント情報。

    たとえば、次のコマンドを使用してアプリケーションを起動します。

    java -jar /{user.workspace}/java-agent-usage-0.0.1-SNAPSHOT.jar

    Managed Service for OpenTelemetry にデータをレポートする場合は、次のコマンドを使用してアプリケーションを起動します。

    java -Dotel.resource.attributes=service.name=java-agent-usage-0.0.1-SNAPSHOT -Dotel.exporter.otlp.headers=Authentication=ggxw4l****@7323a5caae30263_ggxw4l****@53df7ad2afe**** -Dotel.exporter.otlp.endpoint=http://tracing-analysis-dc-hz.aliyuncs.com:8090 -javaagent:/{user.workspace}/opentelemetry-javaagent.jar -jar /{user.workspace}/java-agent-usage-0.0.1-SNAPSHOT.jar

ステップ 3:モニタリングデータを表示する

  1. 次の URL を使用してデモ アプリケーションにアクセスします: localhost:8081/user/async。OpenTelemetry Java エージェントは、デモ アプリケーションからデータを収集し、Managed Service for OpenTelemetry にレポートします。

  2. ARMS コンソール にログインします。左側のナビゲーションウィンドウで、[アプリケーションモニタリング] > [アプリケーション] を選択します。[アプリケーション] ページで、アプリケーションの名前をクリックします。表示されるページで、トレースデータを表示します。

    説明

    image アイコンが [言語] 列に表示されている場合は、アプリケーションが Application Monitoring に接続されています。ハイフン(-)が表示されている場合は、アプリケーションが Managed Service for OpenTelemetry に接続されています。

    9.jpg

次のステップ

アプリケーションデータが Managed Service for OpenTelemetry コンソールにレポートされた後、ARMS コンソールで次の操作を実行できます。

Java、Go、Python、JavaScript、.NET、C ++ など、さまざまなプログラミング言語を使用して開発されたアプリケーションのデータを Managed Service for OpenTelemetry コンソールにレポートできます。データのレポートに使用できるクライアントには、OpenTelemetry、Jaeger、Zipkin、SkyWalking などがあります。

詳細情報を表示する

プログラミング言語

参照

Java

PHP

OpenTelemetry を使用して PHP アプリケーションのトレースデータをレポートする

Go

Python

Node.js

.NET

C++

Ruby

OpenTelemetry を使用して Ruby アプリケーションのデータをレポートする

Swift

Managed Service for OpenTelemetry を使用して Swift アプリケーションデータをレポートする

Android

OpenTelemetry を使用して Android アプリケーションのトレースデータをレポートする

Rust

SkyWalking を使用して Rust アプリケーションデータをレポートする