Managed Service for OpenTelemetry を使用する前に、Alibaba Cloud アカウントを作成し、Managed Service for OpenTelemetry を有効化し、エンドポイント情報を取得する必要があります。このトピックでは、OpenTelemetry Java エージェントを使用して Java アプリケーションで自動インストゥルメンテーションを実行し、アプリケーションのデータをレポートする方法について説明します。これは、Managed Service for OpenTelemetry を使い始めるのに役立ちます。
前提条件
Alibaba Cloud アカウントが作成されている。
Managed Service for OpenTelemetry が有効化されている。
概要
この例では、OpenTelemetry Java エージェントを使用して Java アプリケーションで自動インストゥルメンテーションを実行し、アプリケーションのデータをレポートします。次の手順を実行します。
デモをダウンロードする:OpenTelemetry Java エージェントのデモをダウンロードして、Managed Service for OpenTelemetry を体験できます。また、OpenTelemetry Java エージェントを使用してビジネスアプリケーションで自動インストゥルメンテーションを実行し、モニタリングデータを表示することもできます。
OpenTelemetry Java エージェントを使用してアプリケーションで自動インストゥルメンテーションを実行する:OpenTelemetry Java エージェント をダウンロードする必要があります。OpenTelemetry Java エージェントを使用すると、非侵入的な方法でアプリケーションのデータを Managed Service for OpenTelemetry にレポートできます。また、何百もの Java フレームワークのトレースデータを自動的にアップロードするために使用できます。また、トレースデータをレポートするために、Java 起動構成で Java 仮想マシン(JVM)パラメーターを変更する必要があります。
モニタリングデータを表示する: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」をご参照ください。
OpenTelemetry Java エージェント をダウンロードします。
ダウンロードページで、最新バージョンを見つけて [アセット] をクリックします。opentelemetry-javaagent.jar パッケージを見つけてダウンロードします。
トレースデータをレポートするために、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:モニタリングデータを表示する
次の URL を使用してデモ アプリケーションにアクセスします:
localhost:8081/user/async
。OpenTelemetry Java エージェントは、デモ アプリケーションからデータを収集し、Managed Service for OpenTelemetry にレポートします。ARMS コンソール にログインします。左側のナビゲーションウィンドウで、 を選択します。[アプリケーション] ページで、アプリケーションの名前をクリックします。表示されるページで、トレースデータを表示します。
説明アイコンが [言語] 列に表示されている場合は、アプリケーションが Application Monitoring に接続されています。ハイフン(-)が表示されている場合は、アプリケーションが Managed Service for OpenTelemetry に接続されています。
次のステップ
アプリケーションデータが Managed Service for OpenTelemetry コンソールにレポートされた後、ARMS コンソールで次の操作を実行できます。
Java、Go、Python、JavaScript、.NET、C ++ など、さまざまなプログラミング言語を使用して開発されたアプリケーションのデータを Managed Service for OpenTelemetry コンソールにレポートできます。データのレポートに使用できるクライアントには、OpenTelemetry、Jaeger、Zipkin、SkyWalking などがあります。