注意
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>
implementation("io.micrometer:micrometer-core:1.7.5")
各カスタムメーターを登録する 🔗
各カスタム・メーターは、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の公式ドキュメントを参照してください。