注意
The Splunk Distribution of OpenTelemetry Java version 1.x is deprecated as of June 25, 2024 and will reach End of Support on June 30, 2025. Until then, only critical security fixes and bug fixes will be provided.
New customers should use the latest version of the Splunk Distribution of OpenTelemetry Java. Existing customers should consider migrating to version 2.5.0 or higher. To learn how to migrate, see Migration guide for OpenTelemetry Java 2.x metrics.
Manually instrument Java applications using the Java agent 1.x (Deprecated) 🔗
Java アプリケーションを手動でインストルメンテーションする方法については、https://opentelemetry.io/docs/java/manual_instrumentation の OpenTelemetry Java Instrumentation リポジトリの Manual instrumentation docs を参照してください。
注釈
手動 OTel インストルメンテーションは Splunk 自動 JVM インストルメンテーションと完全に互換性があり、Splunk によって完全にサポートされています。
Send custom Java application metrics (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の公式ドキュメントを参照してください。