OpenTelemetry ランタイムメトリクス

Docs > Datadog の OpenTelemetry > インテグレーション > OpenTelemetry ランタイムメトリクス

概要

ランタイムメトリクスは、メモリ使用量、ガーベジコレクション、並列化を含むアプリケーションパフォーマンスに関するインサイトを提供します。Datadog トレースライブラリは、サポートされている各言語向けにランタイムメトリクス収集を提供します。また、OpenTelemetry (OTel) でも、OpenTelemetry SDK を介して Datadog に送信できる互換のランタイムメトリクスを収集します。

互換性

Datadog は、以下の言語に対する OpenTelemetry ランタイムメトリクスをサポートします。

Java
.NET
Go

ホストおよびコンテナのメトリクスマッピングの詳細は、OpenTelemetry メトリクスマッピングを参照してください。

Setup instructions

1. 前提条件

OpenTelemetry メトリクスを Datadog に送信するよう構成済みであること。
Datadog で対応する言語インテグレーションをインストールしていること。

2. アプリケーションを構成する

OpenTelemetry SDK がランタイムメトリクスを送信するように構成する手順を見るには、言語を選択してください:

自動インスツルメンテーション

Java アプリケーションで OpenTelemetry 自動インスツルメンテーションを使用する場合、ランタイムメトリクスはデフォルトで有効です。

手動インスツルメンテーション

OpenTelemetry 手動インスツルメンテーションを使用する場合は、利用している Java バージョン向けのガイドに従ってください:

OpenTelemetry Go アプリケーションは手動でインスツルメントされています。ランタイムメトリクスを有効にするには、runtime パッケージのドキュメントを参照してください。

.NET OpenTelemetry SDK のサポートされる最小バージョンは 1.5.0 です

自動インスツルメンテーション

.NET アプリケーションで OpenTelemetry 自動インスツルメンテーションを使用する場合、ランタイムメトリクスはデフォルトで有効です。

手動インスツルメンテーション

OpenTelemetry 手動インスツルメンテーションを使用する場合は、OpenTelemetry.Instrumentation.Runtime ライブラリのドキュメントを参照してください。

メトリクスのエクスポート間隔

.NET OTel SDK のデフォルトのメトリクスのエクスポート間隔は、Datadog .NET SDK のデフォルトとは異なります。Datadog は、.NET サービスで OTEL_METRIC_EXPORT_INTERVAL 環境変数を設定し、Datadog のデフォルトのメトリクスエクスポート間隔に合わせることを推奨します:

OTEL_METRIC_EXPORT_INTERVAL=10000

ランタイムメトリクスのダッシュボードを表示

セットアップ完了後は、次の場所でランタイムメトリクスを表示できます:

サービスの詳細ページ (下記の Java の例を参照)
Flame Graph metrics タブ
既定のランタイムダッシュボード

サービスページにある JVM Metrics タブに OpenTelemetry のランタイムメトリクスが表示されている様子

収集されたデータ

Datadog で OpenTelemetry ランタイムメトリクスを使用する場合、次の両方を受け取ります:

OpenTelemetry オリジナルのランタイムメトリクス
同等のメトリクスに対応する Datadog マッピング済みランタイムメトリクス

OpenTelemetry ランタイムメトリクスには、ソースに応じて次のプレフィックスが付きます:

ソース	プレフィックス
OTel Collector Datadog Exporter	`otel.process.runtime.*`
Datadog Agent OTLP Ingest	`process.runtime.*`

以下の表は、OpenTelemetry マッピングでサポートされる Datadog ランタイムメトリクスを示します。「N/A」は、対応する OpenTelemetry メトリクスが存在しないことを示します。

OpenTelemetry ランタイムメトリクスは、メトリクス名により Datadog へマッピングされます。OpenTelemetry ランタイムメトリクスのためにホストメトリクスの名前を変更しないでください。マッピングが壊れます。

Datadog メトリクス	説明	OpenTelemetry メトリクス
`jvm.heap_memory`	使用されている Java ヒープメモリの合計。	`process.runtime.jvm.memory.usage` `jvm.memory.used`
`jvm.heap_memory_committed`	使用するためにコミットされた Java ヒープメモリの合計。	`process.runtime.jvm.memory.committed` `jvm.memory.committed`
`jvm.heap_memory_init`	最初に割り当てられた Java ヒープメモリ。	`process.runtime.jvm.memory.init` `jvm.memory.init`
`jvm.heap_memory_max`	利用可能な Java ヒープメモリの最大値。	`process.runtime.jvm.memory.limit` `jvm.memory.limit`
`jvm.non_heap_memory`	使用される Java 非ヒープメモリの合計。非ヒープメモリとは、`Metaspace + CompressedClassSpace + CodeCache`です。	`process.runtime.jvm.memory.usage` `jvm.memory.used`
`jvm.non_heap_memory_committed`	使用するためにコミットされた Java 非ヒープメモリの合計。	`process.runtime.jvm.memory.committed` `jvm.memory.committed`
`jvm.non_heap_memory_init`	最初に割り当てられた Java 非ヒープメモリ。	`process.runtime.jvm.memory.init` `jvm.memory.init`
`jvm.non_heap_memory_max`	利用可能な Java 非ヒープメモリの最大値。	`process.runtime.jvm.memory.limit` `jvm.memory.limit`
`jvm.gc.old_gen_size`	Old Generation メモリプールの現在の Java ヒープメモリ使用量	`process.runtime.jvm.memory.usage` `jvm.memory.used`
`jvm.gc.eden_size`	Eden メモリプールの現在の Java ヒープメモリ使用量	`process.runtime.jvm.memory.usage` `jvm.memory.used`
`jvm.gc.survivor_size`	Survivor メモリプールの現在の Java ヒープメモリ使用量	`process.runtime.jvm.memory.usage` `jvm.memory.used`
`jvm.gc.metaspace_size`	Metaspace メモリプールの現在の Java 非ヒープメモリ使用量	`process.runtime.jvm.memory.usage` `jvm.memory.used`
`jvm.thread_count`	ライブスレッドの数。	`process.runtime.jvm.threads.count` `jvm.thread.count`
`jvm.loaded_classes`	現在ロードされているクラスの数。	`process.runtime.jvm.classes.current_loaded` `jvm.class.count`
`jvm.cpu_load.system`	システム全体の最近の CPU 使用率。	`process.runtime.jvm.system.cpu.utilization` `jvm.system.cpu.utilization`
`jvm.cpu_load.process`	プロセスの最近の CPU 使用率。	`process.runtime.jvm.cpu.utilization` `jvm.cpu.recent_utilization`
`jvm.buffer_pool.direct.used`	ダイレクトバッファが使用するメモリの量。	`process.runtime.jvm.buffer.usage` `jvm.buffer.memory.usage`
`jvm.buffer_pool.direct.count`	プール内のダイレクトバッファの数。	`process.runtime.jvm.buffer.count` `jvm.buffer.count`
`jvm.buffer_pool.direct.limit`	ダイレクトバッファの総メモリ容量。	`process.runtime.jvm.buffer.limit` `jvm.buffer.memory.limit`
`jvm.buffer_pool.mapped.used`	マップされたバッファが使用するメモリの量。	`process.runtime.jvm.buffer.usage` `jvm.buffer.memory.usage`
`jvm.buffer_pool.mapped.count`	プール内のマップされたバッファの数。	`process.runtime.jvm.buffer.count` `jvm.buffer.count`
`jvm.buffer_pool.mapped.limit`	マップされたバッファの総メモリ容量。	`process.runtime.jvm.buffer.limit` `jvm.buffer.memory.limit`
`jvm.gc.parnew.time`	経過したガベージコレクションのおおよその累積時間。	N/A
`jvm.gc.cms.count`	発生したガベージコレクションの総数。	N/A
`jvm.gc.major_collection_count`	メジャーガベージコレクションの発生率。このメトリクスを受け取るには `new_gc_metrics: true` を設定します。	N/A
`jvm.gc.minor_collection_count`	マイナーガベージコレクションの発生率。このメトリクスを受け取るには `new_gc_metrics: true` を設定します。	N/A
`jvm.gc.major_collection_time`	メジャーガベージコレクションに費やされた時間の割合。このメトリクスを受け取るには `new_gc_metrics: true` を設定します。	N/A
`jvm.gc.minor_collection_time`	マイナーガベージコレクションに費やされた時間の割合。このメトリクスを受け取るには `new_gc_metrics: true` を設定します。	N/A
`jvm.os.open_file_descriptors`	オープンファイルディスクリプタの数。	N/A

Datadog メトリクス	説明	OpenTelemetry メトリクス
`runtime.go.num_goroutine`	生成された goroutines の数。	`process.runtime.go.goroutines`
`runtime.go.num_cgo_call`	CGO コールの回数。	`process.runtime.go.cgo.calls`
`runtime.go.mem_stats.lookups`	ランタイムが実行したポインタールックアップの数。	`process.runtime.go.mem.lookups`
`runtime.go.mem_stats.heap_alloc`	割り当てられたヒープオブジェクトのバイト数。	`process.runtime.go.mem.heap_alloc`
`runtime.go.mem_stats.heap_sys`	オペレーティングシステムから取得したヒープメモリのバイト数。	`process.runtime.go.mem.heap_sys`
`runtime.go.mem_stats.heap_idle`	アイドル (未使用) スパンのバイト数。	`process.runtime.go.mem.heap_idle`
`runtime.go.mem_stats.heap_inuse`	使用中のスパンのバイト数。	`process.runtime.go.mem.heap_inuse`
`runtime.go.mem_stats.heap_released`	オペレーティングシステムに返される物理メモリのバイト数。	`process.runtime.go.mem.heap_released`
`runtime.go.mem_stats.heap_objects`	割り当てられたヒープオブジェクトの数。	`process.runtime.go.mem.heap_objects`
`runtime.go.mem_stats.pause_total_ns`	ガベージコレクション (GC) の累積ナノ秒。	`process.runtime.go.gc.pause_total_ns`
`runtime.go.mem_stats.num_gc`	完了した GC サイクルの数。	`process.runtime.go.gc.count`
`runtime.go.num_cpu`	ランタイムが検出した CPU の数。	N/A
`runtime.go.mem_stats.alloc`	割り当てられたヒープオブジェクトのバイト数。	N/A
`runtime.go.mem_stats.total_alloc`	ヒープオブジェクトに割り当てられた累積バイト数。	N/A
`runtime.go.mem_stats.sys`	オペレーティングシステムから取得したメモリの合計バイト数。	N/A
`runtime.go.mem_stats.mallocs`	割り当てられたヒープオブジェクトの累積数。	N/A
`runtime.go.mem_stats.frees`	解放されたヒープオブジェクトの累積数。	N/A
`runtime.go.mem_stats.stack_inuse`	スタックスパンのバイト数。	N/A
`runtime.go.mem_stats.stack_sys`	オペレーティングシステムから取得したスタックメモリのバイト数。	N/A
`runtime.go.mem_stats.m_span_inuse`	割り当てられた mspan 構造体のバイト数。	N/A
`runtime.go.mem_stats.m_span_sys`	mspan 構造体のためにオペレーティングシステムから取得したメモリのバイト数。	N/A
`runtime.go.mem_stats.m_cache_inuse`	割り当てられた mcache 構造体のバイト数。	N/A
`runtime.go.mem_stats.m_cache_sys`	mcache 構造体のためにオペレーティングシステムから取得したメモリのバイト数。	N/A
`runtime.go.mem_stats.buck_hash_sys`	プロファイリングバケットハッシュテーブルのメモリのバイト数。	N/A
`runtime.go.mem_stats.gc_sys`	ガベージコレクションのメタデータに含まれるメモリのバイト数。	N/A
`runtime.go.mem_stats.other_sys`	雑多なオフヒープにあるメモリのバイト数。	N/A
`runtime.go.mem_stats.next_gc`	次の GC サイクルのターゲットヒープサイズ。	N/A
`runtime.go.mem_stats.last_gc`	UNIX エポックからのナノ秒単位で、最後に終了したガベージコレクション。	N/A
`runtime.go.mem_stats.num_forced_gc`	GC 関数を呼び出したアプリケーションによって強制された GC サイクルの数。	N/A
`runtime.go.mem_stats.gc_cpu_fraction`	プログラムが開始してから GC によって使用された、このプログラムの利用可能な CPU 時間の割合。	N/A
`runtime.go.gc_stats.pause_quantiles.min`	GC 休止時間の分布: 最小値。	N/A
`runtime.go.gc_stats.pause_quantiles.25p`	GC 休止時間の分布: 25 パーセンタイル。	N/A
`runtime.go.gc_stats.pause_quantiles.50p`	GC 休止時間の分布: 50 パーセンタイル。	N/A
`runtime.go.gc_stats.pause_quantiles.75p`	GC 休止時間の分布: 75 パーセンタイル。	N/A
`runtime.go.gc_stats.pause_quantiles.max`	GC 休止時間の分布: 最大値。	N/A

Datadog メトリクス	説明	OpenTelemetry メトリクス
`runtime.dotnet.threads.contention_count`	スレッドがロック待ちのために停止した回数。	`process.runtime.dotnet.` `monitor.lock_contention.count`
`runtime.dotnet.exceptions.count`	ファーストチャンスの例外の数。	`process.runtime.dotnet.` `exceptions.count`
`runtime.dotnet.gc.size.gen0`	第 0 世代ヒープのサイズ。	`process.runtime.dotnet.` `gc.heap.size`
`runtime.dotnet.gc.size.gen1`	第 1 世代ヒープのサイズ。	`process.runtime.dotnet.` `gc.heap.size`
`runtime.dotnet.gc.size.gen2`	第 2 世代ヒープのサイズ。	`process.runtime.dotnet.` `gc.heap.size`
`runtime.dotnet.gc.size.loh`	ラージオブジェクトヒープのサイズ。	`process.runtime.dotnet.` `gc.heap.size`
`runtime.dotnet.gc.count.gen0`	第 0 世代ガベージコレクションの回数。	`process.runtime.dotnet.` `gc.collections.count`
`runtime.dotnet.gc.count.gen1`	第 1 世代ガベージコレクションの回数。	`process.runtime.dotnet.` `gc.collections.count`
`runtime.dotnet.gc.count.gen2`	第 2 世代ガベージコレクションの回数。	`process.runtime.dotnet.` `gc.collections.count`
`runtime.dotnet.cpu.system`	カーネル内で実行されているミリ秒数。	N/A
`runtime.dotnet.cpu.user`	カーネル外で実行されているミリ秒数。	N/A
`runtime.dotnet.cpu.percent`	アプリケーションが使用する総 CPU の割合。	N/A
`runtime.dotnet.mem.committed`	メモリ使用量。	N/A
`runtime.dotnet.threads.count`	スレッドの数。	N/A
`runtime.dotnet.threads.workers_count`	スレッドプールのワーカー数 (.NET Core のみ)。	N/A
`runtime.dotnet.threads.contention_time`	ロック待ちのスレッドが費やした累積時間。(.NET Core のみ)	N/A
`runtime.dotnet.gc.memory_load`	プロセスが使用する総メモリの割合。この値が 85 以上になると、ガベージコレクション (GC) の動作が変わります。(.NET Core のみ)	N/A
`runtime.dotnet.gc.pause_time`	GC がアプリケーションスレッドを一時停止した時間。(.NET Core のみ)	N/A
`runtime.dotnet.aspnetcore.` `requests.total`	サーバーが受信した HTTP リクエストの総数。(.NET Core のみ)	N/A
`runtime.dotnet.aspnetcore.` `requests.failed`	サーバーが受信した HTTP リクエストの失敗数。(.NET Core のみ)	N/A
`runtime.dotnet.aspnetcore.` `requests.current`	まだ停止していない HTTP リクエストの総数。(.NET Core のみ)	N/A
`runtime.dotnet.aspnetcore.` `requests.queue_length`	サーバーの HTTP リクエストキューの現在の長さ。(.NET Core のみ)	N/A
`runtime.dotnet.aspnetcore.` `connections.total`	サーバーに確立された HTTP 接続の総数。(.NET Core のみ)	N/A
`runtime.dotnet.aspnetcore.` `connections.current`	サーバーへの現在のアクティブな HTTP 接続数。(.NET Core のみ)	N/A
`runtime.dotnet.aspnetcore.` `connections.queue_length`	HTTP サーバー接続キューの現在の長さ。(.NET Core のみ)	N/A

参考資料

お役に立つドキュメント、リンクや記事:

APM ランタイムメトリクスドキュメント

OpenTelemetry メトリクスマッピングドキュメント