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 コンソール にログインして、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 にレポートします。Managed Service for OpenTelemetry コンソール にログインします。アプリケーションページで、デモアプリケーションの名前をクリックします。表示されるページで、トレースデータを表示します。
次のステップ
アプリケーションデータが Managed Service for OpenTelemetry コンソールにレポートされた後、Managed Service for OpenTelemetry コンソールで次の操作を実行できます。
Java、Go、Python、JavaScript、.NET、C++ など、さまざまなプログラミング言語を使用して開発されたアプリケーションのデータを Managed Service for OpenTelemetry コンソールにレポートできます。データのレポートに使用できるクライアントには、OpenTelemetry、Jaeger、Zipkin、SkyWalking などがあります。