Splunk OTel Java エージェントが収集したメトリクスと属性 🔗
Splunk Distribution of OpenTelemetry Java のエージェントは、アップストリームの OpenTelemetry エージェントが収集するすべてのものに加えて、以下のアプリケーション・メトリクスのデータと属性を収集します。メトリクスの種類については、メトリクスタイプ を参照してください。
注意
OpenTelemetry Java Instrumentation 2.xは、最近のOpenTelemetry HTTPセマンティック規約の更新の一部として導入された、一連の変更を含んでいます。移行するには、OpenTelemetry Java 2.xメトリクスの移行ガイド を参照してください。
アプリケーション・メトリクス 🔗
Splunk Distribution of OpenTelemetry Java のエージェントは、以下のアプリケーション・メトリクスを収集します。
デフォルトのメトリクス ディメンション 🔗
以下のディメンションは、エージェントによってエクスポートされるすべてのメトリクスに自動的に追加されます:
ディメンション |
説明 |
---|---|
|
存在する場合は、 |
|
|
|
Javaプロセス識別子(PID)。 |
|
該当する場合、コンテナの識別子。 |
|
ホストの名前。 |
|
|
対応ライブラリ 🔗
エージェントは、以下のライブラリを通じて以下のメトリクスを収集します:
ライブラリ/フレームワーク |
インストルメンテーション |
対応バージョン |
---|---|---|
|
Javaランタイムバージョン8以上 |
|
|
バージョン2.0以上 |
|
|
バージョン0.9.5以上 |
|
|
バージョン3.0以上 |
|
|
バージョン11.2.0.4以上 |
|
|
バージョン8.5以上 |
|
|
バージョン20.0以上 |
JVMメトリクス 🔗
Splunk OTel Javaエージェントは、メトリクス収集が有効になっている場合、以下のJava仮想マシン(JVM)メトリクスを収集します:
クラスローダーのメトリクス 🔗
エージェントは、以下の ClassLoader メトリクスを収集します:
メトリクス |
タイプ |
説明 |
---|---|---|
|
UpDownカウンター |
ロードされたクラスの数。 |
|
カウンター |
プロセスが開始してからアンロードされたクラスの総数。 |
ガベージコレクション・メトリクス 🔗
エージェントは、以下のガベージ・コレクション(GC)メトリクスを収集します:
メトリクス |
タイプ |
説明 |
---|---|---|
|
ヒストグラム |
コンカレント・フェーズに費やされた時間(ミリ秒単位)。 |
|
カウンター |
あるガベージコレクションの後、次のガベージコレクションの前に、若いヒープメモリプールのサイズが増加します。 |
メモリ・メトリクス 🔗
エージェントは以下のメモリ・メトリクスを収集します:
メトリクス |
タイプ |
説明 |
---|---|---|
|
カウンター |
前のデータポイントが発行されてから、JVMスレッドによって割り当てられたバイト数の合計。1秒あたりのレートをロールアップします。 |
|
UpDownカウンター |
プール内のバッファ数の推定値。 |
|
UpDownカウンター |
JVMがこのバッファ・プールに使用しているメモリの推定値(バイト単位)。 |
|
UpDownカウンター |
このプール内のバッファの総容量の見積もり(バイト単位)。 |
|
UpDownカウンター |
JVMが利用可能なメモリ量(バイト単位)。 |
|
UpDownカウンター |
メモリ管理で使用可能なメモリの最大量(バイト単位)。 |
|
UpDownカウンター |
使用メモリ量(バイト)。 |
スレッドメトリクス 🔗
エージェントは、以下のスレッド・メトリクスを収集します:
メトリクス |
タイプ |
説明 |
---|---|---|
|
UpDownカウンター |
デーモンスレッドとノンデーモンスレッドを含む、ライブスレッド数。 |
接続プールのメトリクス 🔗
Splunk Distribution of OpenTelemetry Java は、いくつかの Java Database Connectivity (JDBC) 接続プールの実装をインストルメンテーションしています:
Apache DBCP2
c3p0
HikariCP
Oracle Universal Connection Pool (UCP)
Tomcat JDBC
Vibur DBCP
各接続プールでは、以下のメトリクスのサブセットがレポートされます:
メトリクス |
タイプ |
説明 |
---|---|---|
|
ゲージ |
使用中のオープン接続の数。 |
|
ゲージ |
アイドル状態のオープン接続の数。 |
|
ゲージ |
アイドルオープン接続の最大許容数。 |
|
ゲージ |
アイドルオープン接続の最小許容数。 |
|
ゲージ |
オープン接続の最大許容数。 |
|
ゲージ |
オープン接続を待機しているスレッド数。 |
|
カウンター |
アプリケーション起動後に発生した接続タイムアウトの数。 |
|
ヒストグラム |
新しい接続を作成するのにかかった時間(ミリ秒)。 |
|
ヒストグラム |
プールからオープン接続を取得するのにかかった時間(ミリ秒)。 |
|
ヒストグラム |
コネクションを借りてからプールに返すまでの時間(ミリ秒)。 |
WebEngine 属性 🔗
Splunk Distribution of OpenTelemetry Java は、アプリケーションサーバーに関するデータを取得し、SERVER のスパンに以下の属性を追加します:
スパン属性 |
説明 |
---|---|
|
アプリケーションサーバーの名前。例えば、 |
|
アプリケーションサーバーのバージョン。 |
サポートされるアプリケーションサービスのリストについては、サポートされているライブラリとフレームワーク を参照してください。
新しいメトリクス名 🔗
以下の表は、OpenTelemetry Java 2.0以降にデフォルトで生成されるメトリクスと、バージョン1.xの旧バージョンでの相当メトリクスを示しています。
OTel Java 2.0のメトリクス |
旧バージョン(1.x)のメトリクス |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* これは Splunk固有のメトリクスであり、アップストリームのセマンティック規約には存在しません。
注釈
前の表には、デフォルトで生成されるメトリクスが記載されています。アプリケーションサーバーのインスルトメンテーションなど、サポートされているメトリクスのインストルメンテーションによって、この他のメトリクスが生成される場合があります。
HTTPセマンティック規約の変更の詳細については、GitHubの HTTPセマンティック規約安定移行ガイド を参照してください。
メトリクスエクスポートを無効にする 🔗
Splunk Observability Cloudへのログのエクスポートをオフにするには、OTEL_METRICS_EXPORTER
環境変数または otel.metrics.exporter
システムプロパティを none
に設定します。