Docs » Splunk Observability Cloud でサポートされているインテグレーション » バックエンドアプリケーションをインストルメンテーションして、スパンを Splunk APM に送信する » Splunk Observability Cloud 用 Java アプリケーションのインストルメンテーション » Splunk Distribution of OpenTelemetry Java 1.x (非推奨) » Javaエージェント1.xを使用してJavaアプリケーションを手動でインストルメンテーションする(非推奨)

注意

Splunk Distribution of OpenTelemetry Javaは、2024年6月25日をもって非推奨となり、2025年6月30日にサポート終了となります。それまでは、重要なセキュリティ修正とバグ修正のみが提供されます。

新規のお客様は、Splunk Distribution of OpenTelemetry Java の最新バージョンをご利用ください。既存のお客様は、2.5.0以上への移行をご検討ください。移行方法については、OpenTelemetry Java 2.xメトリクスの移行ガイド を参照してください。

Javaエージェント1.xを使用してJavaアプリケーションを手動でインストルメンテーションする(非推奨) 🔗

Java アプリケーションを手動でインストルメンテーションする方法については、https://opentelemetry.io/docs/java/manual_instrumentation の OpenTelemetry Java Instrumentation リポジトリの Manual instrumentation docs を参照してください。

注釈

手動 OTel インストルメンテーションは Splunk 自動 JVM インストルメンテーションと完全に互換性があり、Splunk によって完全にサポートされています。

カスタムJavaアプリケーションメトリクス (1.x)の送信 🔗

Splunk Distribution of OpenTelemetry Java エージェントは、インストルメンテーションされたアプリケーションが Micrometer を使用しているかどうかを検出し、エージェントがユーザー定義のメーターを収集できるようにする特別な MeterRegistry 実装を注入します。

カスタムアプリケーション・メトリクスを有効にするには、以下の手順に従います:

マイクロメーター・コアの依存関係を追加 🔗

Java エージェントを通じてカスタムメトリクスをエクスポートするには、バージョン 1.5 以上の micrometer-core ライブラリに依存関係を追加します:

<dependency>
  <groupId>io.micrometer</groupId>
  <artifactId>micrometer-core</artifactId>
  <version>1.7.5</version>
</dependency>

各カスタムメーターを登録する 🔗

各カスタム・メーターは、Micrometer ライブラリが提供するグローバルな Metrics.globalRegistry インスタンスに登録する必要があります。次の例のように、Metrics クラスが提供するメーター・ファクトリー・メソッドのいずれかを使用するか、メーター・ビルダーを使用して Metrics.globalRegistry を直接参照することができます:

class MyClass {
Counter myCounter = Metrics.counter("my_custom_counter");
  Timer myTimer = Timer.builder("my_custom_timer").register(Metrics.globalRegistry);

  int foo() {
    myCounter.increment();
    return myTimer.record(this::fooImpl);
  }

  private int fooImpl() {
     // ...
  }
}

Micrometer APIの詳細については、Micrometerの公式ドキュメントを参照してください。

このページは 2024年06月25日 に最終更新されました。