Docs » Splunk Observability Cloud でサポートされているインテグレーション » バックエンドアプリケーションをインストルメンテーションして、スパンを Splunk APM に送信する » Splunk Observability Cloud 用 Java アプリケーションのインストルメンテーション » Splunk Distribution of OpenTelemetry Java 1.x (Deprecated) » Metrics collected by the Splunk OTel Java agent 1.x (Deprecated)

Edit this page
Learn how

---

注意

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.

Metrics collected by the Splunk OTel Java agent 1.x (Deprecated)

The agent of the Splunk Distribution of OpenTelemetry Java 1.x collects the following application metrics data and attributes in addition to all that the upstream OpenTelemetry agent collects. To learn about the different metric types, see メトリクスタイプ.

注釈

To migrate from OpenTelemetry native metrics, see Migration guide for OpenTelemetry Java 2.x metrics.

アプリケーション・メトリクス

The agent of the Splunk Distribution of OpenTelemetry Java 1.x collects the following application metrics.

デフォルトのメトリクス ディメンション

以下のディメンションは、エージェントによってエクスポートされるすべてのメトリクスに自動的に追加されます：

ディメンション	説明
deployment.environment	存在する場合は、deployment.environment リソース属性の値。
runtime	process.runtime.name リソース属性の値、例えば OpenJDK Runtime Environment 。
process.pid	Javaプロセス識別子（PID）。
container.id	該当する場合、コンテナの識別子。
host.name	ホストの名前。
service	service.name リソース属性の値。

対応ライブラリ

エージェントは、以下のライブラリを通じて以下のメトリクスを収集します：

ライブラリ/フレームワーク	インストルメンテーション	対応バージョン
JVMメトリクス	jvm-metrics-splunk	Javaランタイムバージョン8以上
Apache DBCP2 connection pool metrics	commons-dbcp2-splunk	バージョン2.0以上
c3p0 connection pool metrics	c3p0-splunk	バージョン0.9.5以上
HikariCP connection pool metrics	hikaricp-splunk	バージョン3.0以上
Oracle Universal Connection Pool metrics (UCP)	oracle-ucp-splunk	バージョン11.2.0.4以上
Tomcat JDBC connection pool metrics	tomcat-jdbc-splunk	バージョン8.5以上
Vibur DBCP connection pool metrics	vibur-dbcp-splunk	バージョン20.0以上
Tomcat thread pool metrics	tomcat	バージョン8.5以上
WebSphere Liberty thread pool metrics	liberty	バージョン20.0.0.12
WebLogic thread pool metrics	weblogic	バージョン12.xおよび14.x

JVMメトリクス

The Splunk OTel Java agent 1.x collects the following Java Virtual Machine (JVM) metrics when metric collection is activated.

クラスローダーのメトリクス

エージェントは、以下の ClassLoader メトリクスを収集します：

メトリクス	タイプ	説明
runtime.jvm.classes.loaded	ゲージ	ロードされたクラスの数。
runtime.jvm.classes.unloaded	カウンター	プロセスが開始してからアンロードされたクラスの総数。

ガベージコレクション・メトリクス

エージェントは、以下のガベージ・コレクション（GC）メトリクスを収集します：

メトリクス	タイプ	説明
runtime.jvm.gc.concurrent.phase.time	タイマー	コンカレント・フェーズに費やされた時間（ミリ秒単位）。
runtime.jvm.gc.live.data.size	ゲージ	再利用後の長寿命ヒープメモリプールのサイズ（バイト単位）。
runtime.jvm.gc.max.data.size	ゲージ	長寿命ヒープメモリプールの最大サイズ（バイト単位）。
runtime.jvm.gc.memory.allocated	カウンター	あるガベージコレクションの後、次のガベージコレクションの前に、若いヒープメモリプールのサイズが増加します。
runtime.jvm.gc.memory.promoted	カウンター	ガベージコレクション前からガベージコレクション後にかけて、旧世代のメモリプールのサイズが正方向に増加した数。
runtime.jvm.gc.pause	タイマー	ガベージコレクションの一時停止に費やされた時間、単位は秒。runtime.jvm.gc.pause.avg 、runtime.jvm.gc.pause.count 、runtime.jvm.gc.pause.max 、runtime.jvm.gc.pause.totalTime のような複数の集約を生成します。

ヒープ圧力メトリクス

エージェントは以下のヒープ圧のメトリクスを収集します：

メトリクス	タイプ	説明
runtime.jvm.gc.overhead	ゲージ	直近のルックバック期間またはモニタリング開始以降のいずれか短い期間において、GCP アクティビティが使用した CPU 時間の割合の近似値。[0..1] の範囲。
runtime.jvm.memory.usage.after.gc	ゲージ	直近の GC イベント後に使用された長寿命ヒーププールの割合。[0..1] の範囲。

メモリ・メトリクス

エージェントは以下のメモリ・メトリクスを収集します：

メトリクス	タイプ	説明
process.runtime.jvm.memory.allocated	カウンター	前のデータポイントが発行されてから、JVMスレッドによって割り当てられたバイト数の合計。 1秒あたりのレートをロールアップします。 メモリ・プロファイリングを有効にするか、splunk.metrics.experimental.enabled フラグを使用する必要があります。
process.runtime.jvm.memory.reclaimed	カウンター	前のデータポイントが発行されて以来、GC によって再生されたバイト数の合計。備考： このメトリクスは、ShenandoahやZGCのような同時実行ガベージコレクタでは不正確になる可能性があります。 1秒あたりのレートをロールアップします。 メモリ・プロファイリングを有効にするか、splunk.metrics.experimental.enabled フラグを使用する必要があります。
runtime.jvm.buffer.count	ゲージ	プール内のバッファ数の推定値。
runtime.jvm.buffer.memory.used	ゲージ	JVMがこのバッファ・プールに使用しているメモリの推定値（バイト単位）。
runtime.jvm.buffer.total.capacity	ゲージ	このプール内のバッファの総容量の見積もり（バイト単位）。
runtime.jvm.memory.committed	ゲージ	JVMが利用可能なメモリ量（バイト単位）。
runtime.jvm.memory.max	ゲージ	メモリ管理で使用可能なメモリの最大量（バイト単位）。
runtime.jvm.memory.used	ゲージ	使用メモリ量（バイト）。

すべてのメモリプールメトリクスは、以下のタグを共有しています：

タグ	値
area	heap または nonheap
id	メモリプールの名前。例えば Perm Gen

スレッドメトリクス

エージェントは、以下のスレッド・メトリクスを収集します：

メトリクス	タイプ	説明
runtime.jvm.threads.daemon	ゲージ	デーモンスレッドの数。
runtime.jvm.threads.live	ゲージ	デーモン・スレッドとノンデーモン・スレッドの両方を含む、ライブ・スレッド数。
runtime.jvm.threads.peak	ゲージ	JVMの開始またはピークがリセットされてからのピーク・ライブ・スレッド数。
runtime.jvm.threads.states	ゲージ	state 、メトリクスタグとしてのスレッド数。

接続プールのメトリクス

The Splunk Distribution of OpenTelemetry Java 1.x instruments several Java Database Connectivity (JDBC) connection pool implementations:

• Apache DBCP2

• c3p0

• HikariCP

• Oracle Universal Connection Pool (UCP)

• Tomcat JDBC

• Vibur DBCP

• WebSphere Liberty

• WebLogicスレッドプール

各接続プールでは、以下のメトリクスのサブセットがレポートされます：

メトリクス	タイプ	説明
db.pool.connections	ゲージ	オープン接続の数。
db.pool.connections.active	ゲージ	使用中のオープン接続の数。
db.pool.connections.idle	ゲージ	アイドル状態のオープン接続の数。
db.pool.connections.idle.max	ゲージ	アイドルオープン接続の最大許容数。
db.pool.connections.idle.min	ゲージ	アイドルオープン接続の最小許容数。
db.pool.connections.max	ゲージ	オープン接続の最大許容数。
db.pool.connections.pending_threads	ゲージ	オープン接続を待機しているスレッド数。
db.pool.connections.timeouts	カウンター	アプリケーション起動後に発生した接続タイムアウトの数。
db.pool.connections.create_time	タイマー	新しい接続を作成するのにかかった時間。
db.pool.connections.wait_time	タイマー	プールからオープン接続を取得するのにかかった時間。
db.pool.connections.use_time	タイマー	コネクションを借りてからプールに返すまでの時間。

すべての接続プール・メトリクスは、以下のタグを共有しています：

タグ	値
pool.name	接続プールの名前。Springを使用している場合はSpringビーン名、そうでない場合はJMXオブジェクト名。
pool.type	接続プールのタイプまたは実装。例えば、c3p0 、dbcp2 、または hikari 。

スレッドプールのメトリクス

The Splunk Distribution of OpenTelemetry Java 1.x instruments the following thread pool implementations:

• Tomcatコネクタのスレッドプール

• WebSphere Liberty Web リクエスト・スレッド・プール

• Weblogicスレッドプール

サポートされている各接続プールでは、以下のメトリクスのサブセットがレポートされます：

メトリクス	タイプ	説明
executor.threads	タイマー	プール内のスレッド数。
executor.threads.active	タイマー	コードを実行しているスレッドの数。
executor.threads.idle	タイマー	コードを実行していないスレッドの数。
executor.threads.core	タイマー	コアのスレッドプールサイズ。常にプールに保持されるスレッド数で表されます。
executor.threads.max	タイマー	プール内の最大スレッド数。
executor.tasks.submitted	カウンター	実行者に提出されたタスクの総数。
executor.tasks.completed	カウンター	実行者が完了したタスクの総数。

すべてのスレッド・プール・メトリクスには以下のタグがあります：

タグ	値
executor.name	スレッドプールの名前。
executor.type	接続プールのタイプ/実装。例えば、tomcat 、liberty 、または weblogic 。

WebEngine 属性

Splunk Distribution of OpenTelemetry Java は、アプリケーションサーバーに関するデータを取得し、SERVER のスパンに以下の属性を追加します：

スパン属性	説明
webengine.name	アプリケーションサーバーの名前。例えば、tomcat 。
webengine.version	アプリケーションサーバーのバージョン。

サポートされているアプリケーションサーバーのリストについては、OpenTelemetry のドキュメント（https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/supported-libraries.md#application-servers）を参照してください。

This page was last updated on 2024年06月25日.

---

❮

Previous

Splunk Distribution of OpenTelemetry Java 1.x (Deprecated)

Next

Configure the Java agent 1.x for Splunk Observability Cloud (Deprecated)

❯

---

• API docs
• Blog
• Training
• Free Trial