/ /

mongotのメトリクス参照

mongot プロセスは、操作のコア領域におけるランタイムの状態とパフォーマンスを説明する Prometheus メトリクスを公開します。このリファレンスページでは、日常のモニタリングとトラブルシューティングに関連する主なメトリクスについて説明します。メトリクスの完全なセットについては、http://<mongot-host>:9946/metrics の mongot Prometheus メトリクスエンドポイントをスクレイプしてください。

メトリクスを表示

mongotが公開する未加工のメトリクスを表示するには、次のmongot Prometheusメトリクスエンドポイントとなる接続されたデバイスにHTTP GETリクエストを送信します。

http://<mongot-host>:9946/metrics

このエンドポイントでは、

<mongot-host> mongot プロセスのホスト名または IP アドレスです。
9946 は、メトリクスエンドポイントのデフォルトポートです。メトリクスエンドポイントポートを構成するには、mongot 構成ファイルの metrics.address 設定を参照してください。
/metrics はメトリクスエンドポイントのパスです。

/metrics エンドポイントは、メトリクスを純粋な Prometheus テキスト形式で返します。時間の経過による mongot メトリクスをモニターするには、Prometheus インスタンスを構成してこのエンドポイントとなる接続されたデバイスをスクレイピングする必要があります。

重要

/metrics エンドポイントとなる接続されたデバイスは、デフォルトでは認証を必要としません。本番環境配置の場合は、ネットワーク階層でアクセスを制限します。

メトリクス命名規約

mongot メトリク名には、コンシステントな命名パターンを使用します。

すべてのメトリク名は mongot_ プレフィックスで始まります。
メトリクス名は一般的にmongot_<area>_<measurement>[_<unit>]のパターンに従います。ここで、
- <area> メトリクスが属するサブシステムまたはコンポーネントを示します。例：process、jvm、replication、index。
- <measurement> cpu_usage、heap_memory、index_sizeなど、何が測定されているかを示します。
- <unit> (任意)メトリクスの単位またはカウンターの意味を示します。この任意の接尾辞は、seconds、bytes、ms などのメトリクスの測定単位、または total、events、operations などのメトリクスが表すカウンターの種類を示します。
  
  注意
  メトリクス名の接尾の中には、メトリクスの実際の報告単位を反映していないものがあります。例えば、mongot_index_stats_query_latency_seconds には接尾 _seconds が付いていますが、mongot はメトリクス出力の timeUnit=milliseconds ラベルに示されているように、メトリクスをミリ秒単位で報告します。各メトリクスの単位を確認するには、以下のメトリクス参照テーブルで Unit 値を確認してください。

メトリクス名に加えて、mongot メトリクスにはラベル（ディメンションとも呼ばれる）を含めることができます。ラベルは同じベースメトリクス名を共有する複数の時系列を区別します。例えば、メトリクスではラベルを使用して、state、status、index type、quantile、または特定の index を識別できます。

メトリクスによっては、メトリクス名だけではなく、メトリクス名とラベルの組み合わせとして解釈する必要があります。例えば、mongot_replication_mongodb_indexManagerStateはstateラベルを使用して、STEADY_STATEやFAILEDなどのレプリケーション状態ごとに1つのシリーズを公開します。ラベル付きシリーズのうちちょうど1つの値が1になります。インデックスごとのメトリクスでも同様に、generationId_logStringやindexId_logStringなどのラベルを使用してインデックスを区別します。

ディストリビューションメトリクスの場合、メトリクス名の接尾は Prometheus シリーズタイプを示します。

ヒストグラムには、_bucket、_count、_sum、_maxが表示されます。
要約には、_count、_sum、_maxが公開されます。要約には、{quantile="0.5"}のような分位数ラベルが含まれるものもあります。

一般的なメトリクスラベル

以下の表は、mongot メトリクスに表示される一般的なラベルを説明します。

ラベル名	メトリクスコープ	Possible Values
`name`	すべての実行プール	`executorMetrics`
`Scope`	クロスカット	`jvm`, `replication`, `lucene`
`generationId_logString`, `indexId_logString`	ほとんどの`mongot_index_stats_*`シリーズ	内部の不透明なID (ログで使用されるインデックスごとの識別子)
`indexFeatureVersion`	多くのインデックスメトリクス	`3`, `5`、`6` (オンディスクインデックス形式)
`indexType`	インデックスの作成と最初の同期メトリクス	`search`, `vector_search`、`vector_search_auto_embedding` (自動埋め込みを構成した場合のみ)
`numPartitions`	インデックスサイズとドキュメントのメトリクス	`1` 自己管理型の場合
`timeUnit`	レイテンシの概要メトリクス	`seconds`, `milliseconds`, `microseconds`
`quantile`	概要メトリクス	`0.5`, `0.75`, `0.9`, `0.99`
`state`	`indexManagerState`	`STEADY_STATE`, `INITIAL_SYNC`, `INITIAL_SYNC_BACKOFF`, `INITIALIZING`, `FAILED`, `FAILED_EXCEEDED`, `SHUT_DOWN`, `STEADY_STATE_SHUT_DOWN`
`status`	`indexStatusCode`	`STEADY`, `INITIAL_SYNC`, `FAILED`, `RECOVERING_NON_TRANSIENT`, `RECOVERING_TRANSIENT`, `STALE`, `NOT_STARTED`, `DOES_NOT_EXIST`, `UNKNOWN`
`clientName`	`mongot_mongoClient_connectionPool_*`	`mongot steady state sync`, `mongot initial sync and session refresh`, `mongot metadata service`, `mongot periodic optime fetcher`, `mongot database metadata resolver`, `mongot server info resolver`, `mongot Lease Manager mongo client`, `mongot AutoEmbedding Materialized View Writer` (自動埋め込みが有効になっている場合のみ)

主要メトリクグループ

プロセスと JVM メトリクス

プロセスと JVM メトリクスを使用して、mongot が正常に実行されていることを確認し、ヒープまたはガーベージコレクションの負荷を識別します。

プロセス

メトリクス	タイプ	単位	説明
`mongot_process_uptime_seconds`	ゲージ	秒	Java 仮想マシンのアップタイム。
`mongot_process_start_time_seconds`	ゲージ	unix 秒	UNIXエポック以降のプロセスの開始時間。
`mongot_process_cpu_time_ns_total`	カウンター	ナノ秒	Java 處理で使用される "クエリ時間"。瞬時的な CPU 消費には `rate()` を使用します。
`mongot_process_cpu_usage`	ゲージ	0-1	Java 仮想マシンプロセスの「最近の CPU 使用率」。値は 0 から 1 の範囲に正規化されます。1 は CPU の完全な使用率を表します。

JVM メモリ

メトリクス	タイプ	単位	説明
`mongot_jvm_memory_used_bytes`	ゲージ	バイト	使用されているメモリの量。ラベル: `area=heap\|nonheap`、`id=<pool>` (例: G1 Eden Space、G1 Old Gen、G1 Survivor Space、Metaspace)。
`mongot_jvm_memory_committed_bytes`	ゲージ	バイト	The amount of memory committed for the Java virtual machine to use.
`mongot_jvm_memory_max_bytes`	ゲージ	バイト	使用できるメモリの最大値。ヒープの場合、`id="G1 Old Gen"`は`-Xmx`を持っています。
`mongot_jvm_buffer_count_buffers`	ゲージ	count	NIO バッファプールカウント。ラベル: `id=direct\|mapped`。
`mongot_jvm_buffer_memory_used_bytes`	ゲージ	バイト	NIO バッファプールに JVM が使用するメモリ。
`mongot_jvm_buffer_total_capacity_bytes`	ゲージ	バイト	NIO バッファプールのキャパシティー。

JVMガベージコレクション

メトリクス	タイプ	単位	説明
`mongot_jvm_gc_pause_seconds`	概要	秒	GC 一時停止に要した時間。分位数ラベルはありません。最近の最長の一時停止に `mongot_jvm_gc_pause_seconds_max` を使用します。
`mongot_jvm_gc_concurrent_phase_time_seconds`	概要	秒	同時 GC フェーズで花費された時間。
`mongot_jvm_gc_live_data_size_bytes`	ゲージ	バイト	回収後の長寿命ヒープメモリプールのサイズ。メモリの負荷を監視する「ライブヒープ」。
`mongot_jvm_gc_max_data_size_bytes`	ゲージ	バイト	長寿命ヒープメモリプールの最大サイズ。
`mongot_jvm_gc_memory_allocated_bytes_total`	カウンター	バイト	GC 間の若いヒーププールサイズの増加。
`mongot_jvm_gc_memory_promoted_bytes_total`	カウンター	バイト	若い世代から古い世代へのプロモーション。

システムメトリクス

システムメトリクスを使用して、mongot に影響を与える可能性のあるホストレベルの CPU、ディスク、メモリ、ページング、およびネットワークの状況をモニターします。

CPU

メトリクス	タイプ	単位	説明
`mongot_system_cpu_count`	ゲージ	count	JVM で使用可能なプロセッサー。
`mongot_system_cpu_usage`	ゲージ	0-1	最近のシステム CPU 使用率。値は 0 から 1 の範囲に正規化されます。1 は CPU の完全な使用率を表します。
`mongot_system_load_average_1m`	ゲージ	単位なし	OS 1 分間のロード平均。

Disk

メトリクス	タイプ	単位	説明
`mongot_system_disk_space_data_path_free_bytes`	ゲージ	バイト	`mongot` `dataPath` ボリュームの空きディスク容量。このメトリクスについてアラートを設定します。
`mongot_system_disk_space_data_path_total_bytes`	ゲージ	バイト	`dataPath` ボリューム上の総ディスクスペース。空き容量の割合の計算に使用します。
`mongot_system_disk_space_free_bytes`, `mongot_system_disk_space_total_bytes`	ゲージ	バイト	ファイルシステム全体の空き容量と合計容量（`data_path`とは範囲が異なります）。
`mongot_system_disk_readBytes_bytes`	ゲージ	バイト	デバイバイスごとにディスクから読み取られたバイト数。ラベル: `name=<device>` (例: `/dev/vda`)。
`mongot_system_disk_writeBytes_bytes`	ゲージ	バイト	デバイスごとの書き込みバイト数。
`mongot_system_disk_reads_events`	ゲージ	count	デバイスごとの読み取り I/O カウント。読み取り IOPS には `rate()` を使用します。
`mongot_system_disk_writes_events`	ゲージ	count	デバイスごとの書き込み I/O カウント。
`mongot_system_disk_currentQueueLength_tasks`	ゲージ	count	デバイスごとのディスクキュー長（実行中の I/O）。
`mongot_system_disk_transferTime_ms`	ゲージ	ミリ秒	デバイスごとの読み取りまたは書き込みに要する時間。

メモリ

メトリクス	タイプ	単位	説明
`mongot_system_memory_phys_total_bytes`	ゲージ	バイト	ホストの総物理メモリ。
`mongot_system_memory_phys_available_bytes`	ゲージ	バイト	利用可能な物理メモリ。
`mongot_system_memory_phys_inUse_bytes`	ゲージ	バイト	使用中の物理メモリ。
`mongot_system_memory_virt_inUse_bytes`	ゲージ	バイト	使用中の物理メモリと仮想記憶の合計。
`mongot_system_memory_virt_swap_inUse_bytes`, `mongot_system_memory_virt_swap_available_bytes`, `mongot_system_memory_virt_swap_total_bytes`	ゲージ	バイト	スワップ状態。
`mongot_system_memory_virt_swap_pagesIn_operations`, `mongot_system_memory_virt_swap_pagesOut_operations`	ゲージ	count	スワップイン/アウトのアクティビティ。
`mongot_system_memory_memoryMappings_objects`	ゲージ	count	メモリマッピングの数 (Lucene mmap カウントに関連)。
`mongot_system_memory_pageSize_bytes`	ゲージ	バイト	システムページサイズ。

ページフォールト

メトリクス	タイプ	単位	説明
`mongot_system_process_majorPageFaults_operations`	ゲージ	count	主なページフォールト。このメトリクスをストレージクラスのアドバイザリースレッショルと併用します。
`mongot_system_process_minorPageFaults_operations`	ゲージ	count	マイナーページフォールト。

ネットワーク

メトリクス	タイプ	単位	説明
`mongot_system_netstat_bytesRecv_bytes`, `mongot_system_netstat_bytesSent_bytes`	ゲージ	バイト	インターフェース（`name=eth0`）ごとの受信バイトと送信バイト。
`mongot_system_netstat_packetsRecv_events`, `mongot_system_netstat_packetsSent_events`	ゲージ	count	受信および送信されたパケット。
`mongot_system_netstat_inErrors_events`, `mongot_system_netstat_outErrors_events`, `mongot_system_netstat_inDrops_events`, `mongot_system_netstat_collisions_events`	ゲージ	count	エラー、削除、コリジョンカウンター。
`mongot_system_netstat_speed`	ゲージ	bits/sec	交渉されたインターフェース速度。

レプリケーションメトリクス

レプリケーションメトリクスを使用して、mongot が正常に同期されているか、健康であるか、mongod に追いついているかを判定します。

全体状態

メトリクス	タイプ	単位	説明
`mongot_replication_manager`	ゲージ	0/1	`1` レプリケーションマネージャーがアクティブな場合。
`mongot_replication_mongodb_manager`	ゲージ	0/1	`1` MongoDB によってバックアップされたレプリケーションマネージャーがアクティブな場合。ラベル: `type=normal`
`mongot_replicationIndexManager_transitionState_total`	カウンター	count	状態遷移。ラベル: `fromState`、`toState`。再同期を検出するために使用します (`INITIALIZING` から `STEADY_STATE` への遷移)。

セッションの更新

メトリクス	タイプ	単位	説明
`mongot_replication_sessionRefresher_sessions`	ゲージ	count	アクティブセッション。
`mongot_replication_sessionRefresher_refreshes_total`	カウンター	count	セッションの全体の更新。
`mongot_replication_sessionRefresher_failedSessionRefreshes_total`	カウンター	count	更新に失敗しました。
`mongot_replication_sessionRefresher_sessionRefreshDurations_seconds`	概要	秒	更新期間分布。

Optime Updater

メトリクス	タイプ	単位	説明
`mongot_replicationOptimeUpdaterError_total`	カウンター	count	Optime-更新エラー。
`mongot_replicationOptimeUpdater_executor_*`	さまざまな	該当なし	optime アップデーターのエキゼキューターメトリクス。

Per-index Metrics

mongot インデックスごとに次のメトリクスを出力し、特定のインデックスを識別するために generationId_logString と indexId_logString ラベルが含まれます。これらのラベルでフィルターして特定のインデックスを調査するか、ラベルをまとめてフリート全体の動作を理解します。

インデックスのステータスとサイズ

メトリクス	タイプ	単位	説明
`mongot_index_stats_indexStatusCode`	ゲージ	0/1	インデックスごとのステータス。`status` ラベル値：`STEADY`、`INITIAL_SYNC`、`FAILED`、`RECOVERING_NON_TRANSIENT`、`RECOVERING_TRANSIENT`、`STALE`、`NOT_STARTED`、`DOES_NOT_EXIST`、`UNKNOWN` にわたってワンホットエンコードされます。
`mongot_index_stats_indexFeatureVersion`	ゲージ	数値	オンディスクのインデックス形式のバージョン。例: `3`
`mongot_index_stats_indexSizeBytes`	ゲージ	バイト	インデックスのオンディスク上の合計サイズ。
`mongot_index_stats_largestIndexFileSizeBytes`	ゲージ	バイト	インデックス内の最大の単一ファイル。
`mongot_index_stats_numFilesInIndex`	ゲージ	count	Lucene セグメントファイルの数。
`mongot_index_stats_numLuceneDocs`	ゲージ	count	インデックス内の Lucene ドキュメント。
`mongot_index_stats_numLuceneMaxDocs`	ゲージ	count	最大 Lucene ドキュメント ID（削除されているがマージされていないものを含む）。
`mongot_index_stats_numLuceneFields`	ゲージ	count	インデックスされた Lucene フィールドの数。
`mongot_index_stats_segment_count`	ゲージ	count	Lucene セグメントの数。
`mongot_index_stats_requiredMemoryBytes`	ゲージ	バイト	インデックスに必要なメモリの要件を見積もります。

インデックスの作成メトリクス

メトリクス	タイプ	単位	説明
`mongot_index_stats_indexing_replicationLagMs`	ゲージ	ミリ秒	インデックスごとのレプリケーションラグ (ミリ秒)。単位はメトリクス名 (`Ms`)に含まれます。秒に変換したい場合を除き、PromQL で 1000 で分割しないでください。
`mongot_index_stats_indexing_replicationOpTime`	ゲージ	BSON タイムスタンプ	最後に適用されたレプリケーション optime (数値エンコーディング)。
`mongot_index_stats_indexing_maxPossibleReplicationOpTime`	ゲージ	BSON タイムスタンプ	`mongod` チップによって設定される事前の上限。
`mongot_index_stats_indexing_insert_total`, `mongot_index_stats_indexing_update_total`, `mongot_index_stats_indexing_delete_total`	カウンター	count	インデックスの作成操作のカウント。ラベル: `indexType=search`
`mongot_index_stats_indexing_totalBytesProcessed_total`	カウンター	バイト	インデックスの作成によって処理された合計バイト数。
`mongot_index_stats_indexing_vectorFieldsIndexed_total`	カウンター	count	ベクトルフィールドがインデックスされました。
`mongot_index_stats_indexing_commitDurations_seconds`	概要	秒（`timeUnit=milliseconds`）	インデックスごとのコミット期間。
`mongot_index_stats_indexing_indexingBatchDurations_seconds`	概要	秒	バッチ実行時間分布。
`mongot_index_stats_indexing_largeChangeStreamEvents_total`	カウンター	count	サイズが大きすぎる変更ストリームイベント。ラベル: `threshold=10MiB\|12MiB\|14MiB\|15MiB`
`mongot_index_stats_indexing_invalidGeometryField_total`	カウンター	count	無効な図形のために拒否されたドキュメント。
`mongot_index_stats_indexing_sortableStringTruncated_total`	カウンター	count	切り捨てられたソータブルな文字列。
`mongot_index_stats_indexing_initialSyncExceptions_total`	カウンター	count	最初の同期中の例外。
`mongot_index_stats_indexing_steadyStateExceptions_total`	カウンター	count	定常状態の例外。
`mongot_index_stats_indexing_consecutiveInitialSyncResyncExceptions`	ゲージ	count	このインデックスの最初の同期再同期例外が続いています。

クエリメトリクス

メトリクス	タイプ	単位	説明
`mongot_index_stats_query_totalQueries_total`	カウンター	count	インデックスに対して発行されたクエリの合計。
`mongot_index_stats_query_totalHitsCount_total`	カウンター	count	返された合計ヒット数。
`mongot_index_stats_query_failedQueries_total`	カウンター	count	失敗したクエリ。
`mongot_index_stats_query_internallyFailedQueries_total`, `mongot_index_stats_query_invalidQueries_total`, `mongot_index_stats_query_npeQueries_total`, `mongot_index_stats_query_lenientFailures_total`	カウンター	count	特定の障害クラスカウンター。
`mongot_index_stats_query_searchResultBatchLatencies_seconds`	概要	秒（`timeUnit=milliseconds`）	バッチ検索のレイテンシ。これは、クエリのレイテンシのヘッドラインメトリクスです。
`mongot_index_stats_query_luceneTopDocsSearchLatencies_seconds`	概要	秒（`timeUnit=milliseconds`）	Lucene の TopDocs 検索内のレイテンシ。このメトリクスを使用して、Lucene 内部のレイテンシと合計レイテンシを区別します。
`mongot_index_stats_query_vectorResultLatencies_seconds`	概要	秒（`timeUnit=milliseconds`）	ベクトル検索結果のレイテンシ。
`mongot_index_stats_query_vectorSearchInitialTopDocsLatencyTimer_seconds`, `mongot_index_stats_query_vectorSearchGetMoreTopDocsLatencyTimer_seconds`	概要	秒（`timeUnit=milliseconds`）	ベクトル検索のレイテンシフェーズ。
`mongot_index_stats_query_tokenFacetsStateRefreshLatency_seconds`	概要	秒（`timeUnit=milliseconds`）	ファセット状態の更新のレイテンシ。
`mongot_index_stats_query_batchDataSize`, `mongot_index_stats_query_batchDocumentCount`	概要	バイト数 / カウント	バッチごとのペイロードサイズとドキュメント数。
`mongot_index_stats_query_limitPerQuery`	ヒストグラム	カウント (`le=10\|50\|100\|200\|500\|1000\|+Inf`)	`$search`と`$vectorSearch`制限の分布。
`mongot_index_stats_query_numCandidatesPerQuery`	ヒストグラム	count	クエリごとのベクトル候補、量子化によりバケット化されます。
`mongot_index_stats_query_getMoreCommandCalls_total`, `mongot_index_stats_query_getMoreCommandCallsPerQuery`	カウンター / サマリー	count	`getMore` 呼び出し回数。
`mongot_index_stats_query_batchWithTies_total`	カウンター	count	スコアが同点の結果バッチ。
`mongot_index_stats_query_benefitFromIndexSortCount_total`	カウンター	count	インデックスのソートの最適化の恩恵を受けたクエリ。
`mongot_index_stats_query_extractableLimitQueries_total`, `mongot_index_stats_query_extractableLimitSecondBatchQueries_total`	カウンター	count	制限抽出の最適化がトリガーされました。
`mongot_index_stats_query_phantomSearcherCleanupCount_total`	カウンター	count	ファントムサーチャーのクリーンアップ。
`mongot_index_stats_query_orphanedDeletedDocsRatio`	概要	比率	返された結果における削除されたドキュメントの比率。
`mongot_index_stats_query_noProgressBatches_total`	カウンター	count	前進しなかったバッチ。
`mongot_index_stats_query_vectorCommandCalls_total`, `mongot_index_stats_query_vectorRescoringFailureCount_total`, `mongot_index_stats_query_vectorSearchQueriesOverSearchIndexes_total`	カウンター	count	ベクトル固有のカウンター。
`mongot_index_stats_query_feature_total`	カウンター	count	クエリごとの機能使用状況。ラベル: `name=<feature>`。例: `compound`、`text`、`phrase`、`near`、`vectorSearch`、`knnBeta`、`autoEmbedding` (自動埋め込みが有効な場合のみ)。
`mongot_index_stats_query_failedExplainQueryAggregate_total`	カウンター	count	失敗した`$explain`集計。

インデックス単位のレプリケーションの内訳

メトリクス	タイプ	単位	説明
`mongot_replication_mongodb_indexManagerState`	ゲージ	0/1	正規のレプリケーション状態シグナル。`mongot` はこのメトリクスをワンホットエンコードします。つまり、正確に 1 つの `state` ラベルが `1.0` になります。状態: `STEADY_STATE`、`INITIAL_SYNC`、`INITIAL_SYNC_BACKOFF`、`INITIALIZING`、`FAILED`、`FAILED_EXCEEDED`、`SHUT_DOWN`、`STEADY_STATE_SHUT_DOWN`。
`mongot_index_stats_replication_steadyState_batchTotalApplicableBytes`, `mongot_index_stats_replication_steadyState_batchTotalApplicableDocuments`	概要	バイト数 / カウント	定常状態のバッチサイズ。
`mongot_index_stats_replication_steadyState_decodingBatchDurations_seconds`	概要	秒	定常状態のデコーディング時間。
`mongot_index_stats_replication_steadyState_getMoreDurations_seconds`	概要	秒	定常状態 `getMore` 期間。
`mongot_index_stats_replication_initialSync_changeStream_*`	概要	—	初期同期変更ストリームフェーズメトリクス（安定状態をミラーリング）。
`mongot_index_stats_replication_initialSync_collScan_*`	概要	—	最初の同期コレクションスキャンフェーズのメトリクス。

Lucene 更新レイテンシ

メトリクス	タイプ	単位	説明
`mongot_index_stats_luceneIndexRefresher_refreshDurations_seconds`	概要	秒（`timeUnit=milliseconds`）	Lucene IndexReaderの更新レイテンシ。

コマンドメトリクス

mongot mongod からの名前付きコマンドの次のセットを受け入れます。

buildinfo
getMore
hello
isMaster
ismaster
killCursors
manageSearchIndex
ping
planShardedSearch
search
vectorSearch

コマンドごとに、mongot は次のメトリクスを公開します。ここで <name> はコマンド名のプレースホルダーです。

パターン	タイプ	説明
`mongot_command_<name>CommandFailure_total`	カウンター	コマンドの失敗回数。
`mongot_command_<name>CommandTotalLatency_seconds`	概要	直列化を含むエンドツーエンドのレイテンシ。
`mongot_command_<name>CommandSerializationLatency_seconds`	概要	直列化レイテンシ (サブセット。すべてのコマンドではありません)。

Tip

インデックス間の検索とベクトル検索のレイテンシのモニター

mongot_command_searchCommandTotalLatency_seconds および mongot_command_vectorSearchCommandTotalLatency_seconds は、$search と $vectorSearch のレイテンシー集計をモニターするためのプライマリメトリクスです。これらは、すべてのインデックスにおけるすべての search および vectorSearch コマンドのレイテンシ集計を公開します。

インデックスの作成スケジューラーとディスパッチャーメトリクス

インデックス作成スケジューラーおよびディスパッチャーのメトリクスを使用して、レプリケーションおよびインデックス作成パイプラインにおけるバックログ、飽和、および低速な作業を識別します。

定常状態の変更ストリームパイプライン

メトリクス	タイプ	単位	説明
`mongot_indexing_steadyStateChangeStream_batchesInProgressTotal`	ゲージ	count	現在適用中のバッチ。ラベル: `indexType=search\|vector_search\| vector_search_auto_embedding` （自動埋め込みを有効にした場合のみ）
`mongot_indexing_steadyStateChangeStream_batchesInProgressTotalDurations_seconds`	概要	秒	処理中のバッチの期間分布。
`mongot_indexing_steadyStateChangeStream_getMoreDurations_seconds`	概要	秒	`getMore` ラウンドトリップ分布。
`mongot_indexing_steadyStateChangeStream_getMoresInFlight`	ゲージ	count	`getMore` 実行中のリクエスト。
`mongot_indexing_steadyStateChangeStream_getMoresScheduled`	ゲージ	count	`indexType` によるスケジュールされた `getMore` リクエスト。
`mongot_indexing_steadyStateChangeStream_getMoresSchedulingDurations_seconds`	概要	秒	`getMore` スケジューリングのレイテンシ。
`mongot_indexing_steadyStateChangeStream_preprocessingBatchDurations_seconds`	概要	秒	バッチごとの事前プロセシング時間。
`mongot_indexing_steadyStateChangeStream_witnessedChangeStreamUpdates_total`	カウンター	count	観測された変更ストリームイベントの合計。ラベル: `Scope=replication`
`mongot_indexing_steadyStateChangeStream_applicableChangeStreamUpdates_total`	カウンター	count	`mongot` が適用であると見なされるイベント
`mongot_indexing_steadyStateChangeStream_dispatcher`	ゲージ	0/1	ディスパッチャーステータス。ラベル: `Scope=replication`、`client=synchronous-batch`。
`mongot_indexing_steadyStateChangeStream_skippedChangeStreamDocumentsWithoutMetadataNamespace_total`	カウンター	count	メタデータがないためスキップされたイベント。
`mongot_indexing_steadyStateChangeStream_unexpectedBatchFailures_total`	カウンター	count	予期せぬバッチ処理の失敗。
`mongot_indexing_steadyStateChangeStream_rescheduledEmbeddingGetMores_total`	カウンター	count	埋め込みのgetMoreを再スケジュールしました。このメトリクスは、自動埋め込みを構成した場合にのみ使用できます。
`mongot_indexing_changeStreamModeSelector_failedSamplingAttemptsCounter_total`	カウンター	count	失敗した変更ストリームモードのサンプリング試行。

インデックスの作成ワークスケジューラー

インデックスの作成作業スケジューラーメトリクスは、インデックスの作成バッチのキュー処理と実行をモニターします。

メトリクス	タイプ	単位	説明
`mongot_indexingWorkScheduler_queuedBatchesTotal`, `mongot_indexingWorkScheduler_queuedEventsTotal`	ゲージ	count	スケジューラーキューの深さ。
`mongot_indexingWorkScheduler_enqueueCalls_total`, `mongot_indexingWorkScheduler_dequeueCalls_total`	カウンター	count	キューの追加と削除のカウント。
`mongot_indexingWorkScheduler_indexingBatchDistribution`	概要	count	バッチサイズの分布。ラベル: `Scope=replication`
`mongot_indexingWorkScheduler_indexingBatchDurations_seconds`	概要	秒	バッチする期間。
`mongot_indexingWorkScheduler_indexingBatchSchedulingDurations_seconds`	概要	秒	スケジューリングのオーバーヘッド。

スケジューラーの解読

デコーディング作業スケジューラーメトリクスは、変更ストリームバッチデコーディングのキュー入りと実行をモニターします。

メトリクス	タイプ	単位	説明
`mongot_decodingWorkScheduler_queuedBatchesTotal`, `mongot_decodingWorkScheduler_queuedEventsTotal`	ゲージ	count	スケジューラーキューの深さ。
`mongot_decodingWorkScheduler_enqueueCalls_total`, `mongot_decodingWorkScheduler_dequeueCalls_total`	カウンター	count	キューの追加と削除のカウント。
`mongot_decodingWorkScheduler_decodingBatchDistribution`	概要	count	バッチサイズの分布。ラベル: `Scope=replication`
`mongot_decodingWorkScheduler_decodingBatchDurations_seconds`	概要	秒	バッチする期間。
`mongot_decodingWorkScheduler_decodingBatchSchedulingDurations_seconds`	概要	秒	スケジューリングのオーバーヘッド。

最初の同期、ライフサイクル、および構成メトリクス

これらのメトリクスを使用して、インデックスのスタートアップ作業、リカバリ、カタログの状態を追跡します。

最初の同期

注意

mongot の一部のメトリクスはフェーズ固有であり、対応するコードパスがアクティブな場合にのみ移入されます。例えば、mongot_index_stats_indexing_replicationLagMs や mongot_index_stats_replication_steadyState_* シリーズのような安定状態のレプリケーションメトリクスは、インデックスが最初の同期中である間は移入されません。逆に、mongot_initialsync_* や mongot_index_stats_replication_initialSync_* のような初期同期固有のメトリクスは、初期同期が実行中または実行済みの場合にのみ関連します。

メトリクス	タイプ	単位	説明
`mongot_initialsync_queue_queuedSyncs`	ゲージ	count	キューに入った最初の同期。ラベル: `indexType`
`mongot_initialsync_queue_requeuedEmbeddingInitialSyncs_total`	カウンター	count	再キューされた最初の同期を埋め込みました。このメトリクスは、自動埋め込みを構成した場合にのみ使用できます。
`mongot_initialsync_dispatcher_inProgressSyncs`	ゲージ	count	最初の同期が現在進行中です。ラベル: `indexType`
`mongot_initialsync_dispatcher_queuedSyncs`	ゲージ	count	ディスパッチャーでキューに入った最初の同期。
`mongot_initialsync_dispatcher_inProgressResumedSyncs`	ゲージ	count	チェックポイントから再開された進行中の同期。
`mongot_initialsync_dispatcher_collectionScan`	ゲージ	0/1	アクティブなコレクションスキャンモード。ラベル: `scan_type=id_order\|natural_order`
`mongot_initialsync_dispatcher_completedSyncDuration_seconds`	概要	秒	完了した同期期間の分布。
`mongot_initialsync_dispatcher_syncDuration_seconds`	概要	秒	同期の続続時間。
`mongot_initialsync_dispatcher_inProgressInitialSyncDurationMin_seconds`, `mongot_initialsync_dispatcher_inProgressInitialSyncDurationMax_seconds`, `mongot_initialsync_dispatcher_inProgressInitialSyncDurationSum_seconds`	ゲージ	秒	実行中の最初の同期期間の最小値、最大値、および合計。
`mongot_initialsync_dispatcher_unreadableDroppedIndexes_total`	カウンター	count	オンディスクセグメントを読み取れないため、削除されました。
`mongot_initialsync_dispatcher_unreadableIndexRecoveries_total`	カウンター	count	読み取り不可能なセグメントの後に復元されました。ラベル: `unreadableIndexCause=corruptIndex\|incompatibleCodec\| incompatibleIndexFormat`

ライフサイクル

メトリクス	タイプ	単位	説明
`mongot_lifecycle_indexesInInitializedState`	ゲージ	count	現在初期化状態のインデックス。
`mongot_lifecycle_indexInitializationDuration_seconds`	概要	秒	初期化期間。
`mongot_lifecycle_failedDownloadIndexes_total`	カウンター	count	失敗したインデックスのダウンロード。
`mongot_lifecycle_failedDropIndexes_total`	カウンター	count	失敗したインデックスの削除。
`mongot_lifecycle_failedInitializationIndexes_total`	カウンター	count	失敗したインデックスの初期化。

構成状態

メトリクス	タイプ	単位	説明
`mongot_configState_indexesInCatalog`	ゲージ	count	現在カタログにあるインデックス。ラベル: `Scope=replication`、`indexFormatVersion`。
`mongot_configState_indexesPhasingOut`	ゲージ	count	廃止されるインデックス
`mongot_configState_stagedIndexes`	ゲージ	count	ステージングされているが、まだアクティブではないインデックス。
`mongot_configState_indexesInCatalogFeatureVersionFour`, `mongot_configState_indexesPhasingOutFeatureVersionFour`, `mongot_configState_stagedIndexesFeatureVersionFour`	ゲージ	count	機能バージョン 4 固有の同等のもの。

カーソルとインデックスファクトリー

これらのメトリクスを使用して、オープンカーソルの状態をモニターし、オンディスクセグメントが読み取り不可能であったために mongot が削除または復元されたインデックスを検出します。

メトリクス	タイプ	単位	説明
`mongot_cursorManager_trackedCursors`	ゲージ	count	現在追跡されている開いているカーソル。
`mongot_indexFactory_unreadableDroppedIndexes_total`	カウンター	count	セグメントが読み取り不可であるため、インデックスが削除されました。
`mongot_indexFactory_unreadableIndexRecoveries_total`	カウンター	count	読み取り不可能なセグメントの復旧。ラベル: `unreadableIndexCause`

Lucene マージ

これらのメトリクスを使用して、実行中のマージの数とサイズ、マージの入力と出力のサイズ、マージの持続時間、およびディスク使用マージポリシーによって破棄されたマージなど、Lucene セグメントのマージアクティビティをモニターします。

メトリクス	タイプ	単位	説明
`mongot_mergeScheduler_currentlyRunningMerges`	ゲージ	count	アクティブなマージ。ラベル: `Scope=lucene`
`mongot_mergeScheduler_currentlyMergingDocs`	ゲージ	count	現在マージされているドキュメント。
`mongot_mergeScheduler_numMerges_total`	カウンター	count	スタートアップ以降に実行されたマージの合計数。
`mongot_mergeScheduler_numSegmentsMerged_total`	カウンター	count	マージによって折りたたまれたセグメント。
`mongot_mergeScheduler_mergeSize`	概要	バイト	マージ入力サイズの分布。
`mongot_mergeScheduler_mergeResultSize`	概要	バイト	マージ出力サイズの分布。
`mongot_mergeScheduler_mergedDocs`	概要	count	マージごとのドキュメント分布。
`mongot_mergeScheduler_mergeTime_seconds`	概要	秒	統合期間分布。
`mongot_diskUtilizationAwarenessMergePolicy_discardedMerge_total`	カウンター	count	ディスク使用状況を考慮したポリシーにより破棄されたマージ。

MongoDBクライアント接続プールのメトリクス

mongot mongodに対して複数の名前付き接続プールを開き、各プールにプールのロールを識別するclientNameラベルを付けます。次の表に、可能なclientNameラベル値と対応するロールを示します。

clientName	目的
`mongot steady state sync`	安定状態の変更ストリームレプリケーション。
`mongot initial sync and session refresh`	最初の同期とセッションの更新。`mongod` `currentOp` で見られる `appName`。
`mongot metadata service`	内部メタデータサービス。
`mongot periodic optime fetcher`	optime ポーリング。
`mongot database metadata resolver`	データベースのメタデータの検索。
`mongot server info resolver`	サーバー情報の検索。
`mongot Lease Manager mongo client`	リースマネージャー。
`mongot AutoEmbedding Materialized View Writer`	自動埋め込み書き込み。この接続プールは、自動埋め込みを構成した場合にのみ表示されます。

次の表に、mongot 接続プールで使用できるメトリクスを示します。

メトリクス	タイプ	単位	説明
`mongot_mongoClient_connectionPool_connections`	ゲージ	count	プール内で現在開いている接続。
`mongot_mongoClient_connectionPool_connectionsCheckedOut`	ゲージ	count	現在チェックアウトされている接続。
`mongot_mongoClient_connectionPool_maxSize`	ゲージ	count	設定された最大プールサイズ。
`mongot_mongoClient_connectionPool_minSize`	ゲージ	count	構成された最小プールサイズ。
`mongot_mongoClientBuilder_successfulOpenSSLDynamicLinking_total`	カウンター	count	ネイティブ OpenSSL リンクの試行に成功しました。
`mongot_mongoClientBuilder_failedOpenSSLDynamicLinking_total`	カウンター	count	ネイティブ OpenSSL リンクの試行に失敗しました。

シノニム

これらのメトリクスを使用して、コレクションスキャン、スキャンと同期の持続時間、キューの深さ、同義語の同期中に発生した例外などの同義語同期アクティビティをモニターします。

メトリクス	タイプ	単位	説明
`mongot_synonymSync_collScans_total`	カウンター	count	シノニムに対して実行されたコレクションスキャンの合計。
`mongot_synonymSync_collScansTriggeredByChangeStream_total`	カウンター	count	変更ストリームイベントによってトリガーされる同義語スキャン。
`mongot_synonymSync_collScanDurations_seconds`	概要	秒	スキャン期間の分布。
`mongot_synonymSync_syncDurations_seconds`	概要	秒	同期期間の分布。
`mongot_synonymSync_queueDepth`	ゲージ	count	現在の同義語同期キューの深さ。
`mongot_synonymSync_exceptions_total`	カウンター	count	同義語同期の例外

実行プール

mongot がバックグラウンド作業の実行に使用する名前付きのエキスキュータプールをモニターするために、これらのメトリクスを使用します。各プールは、プール名が接頭に付いた同じサブメトリクスセットを公開します。これにより、すべてのプールでスレッドのアクティビティ、プールのサイズ設定、キューの深さ、タスクのスループット、タスクごとの実行時間を追跡できます。

次の表に、各エキゼキュータープールが公開するサブメトリクスが示されています。ここで、<pool> はプール名の接頭辞です。すべてのエキゼキュータープールのサブメトリクスには、ラベル name="executorMetrics" が付けられています。

サブメトリクスの接尾辞	タイプ	説明
`<pool>_active_threads`	ゲージ	現在タスクを実行しているスレッド。
`<pool>_pool_core_threads`, `<pool>_pool_max_threads`, `<pool>_pool_size_threads`	ゲージ	プールのサイズ設定。
`<pool>_queued_tasks`	ゲージ	スレッドを待機しているタスク。これは、サチュレーションシグナルです。
`<pool>_queue_remaining_tasks`	ゲージ	残りのキューキャパシティ。
`<pool>_completed_tasks_total`	カウンター	スタートアップ以降に完了したタスク。
`<pool>_idle_seconds`	概要	タスク間のアイドルに費やされた時間スレッド。
`<pool>_seconds`	概要	タスクごとの実行時間。
`<pool>_scheduled_once_total`, `<pool>_scheduled_repetitively_total`	カウンター	予定プールのタスクカウント。

次の表に、使用可能なすべての名前付きエキスキュータープールの接頭辞とそれぞれの目的を示します。

エキゼキュータープールプレフィックス	実行内容
`mongot_blobstore_lifecycle_executor`	Blob ストアのライフサイクル作業。
`mongot_blocking_server_worker_executor`	ブロッキング gRPC サーバーのワーカースレッド。
`mongot_change_stream_mode_selector_executor`	チェンジストリームモード選択。
`mongot_change_stream_sync_dispatcher_executor`	変更ストリーム同期ディスパッチング (安定状態で最も忙しいものの 1 つ)。
`mongot_config_monitor_executor`	コンフィグモニターのポーリング。
`mongot_decoding_executor`	パイプラインワーカーの複号化
`mongot_disk_monitor_executor`	ディスクモニターのポーリング。
`mongot_grpc_health_check_executor`	gRPC ヘルスチェックタイマー。
`mongot_idle_cursor_killer_executor`	アイドルカーソルの回収。
`mongot_index_commit_executor`	インデックスのコミット操作。
`mongot_index_lifecycle_executor`	インデックスごとのライフサイクル作業。
`mongot_index_refresh_executor`	Lucene IndexReader の更新。
`mongot_indexing_work_executor`	インデックスの作成パイプラインの作業員 (安定状態で最も忙しいインデックスプール)。
`mongot_indexing_lifecycle_executor`	インデックスの作成ライフサイクル作業。
`mongot_indexing_auto_embedding_executor`	自動埋め込みインデックスの作成パス。このエキゼキュータープールは、自動埋め込みを構成した場合にのみ表示されます。
`mongot_init_lifecycle_executor`	初期化時のライフサイクル作業。
`mongot_mat_view_commit_executor`, `mongot_mat_view_leader_heartbeat_executor`, `mongot_mat_view_optime_updater_executor`, `mongot_mat_view_status_refresh_executor`, `mongot_materialized_view_lifecycle_executor`	マテリアライズドビューのトラッキングとライフサイクル。これらのメトリクスは、自動埋め込みまたはその他のマテリアライズドビューによる機能が構成されている場合にのみ利用できます。
`mongot_replicationOptimeUpdater_executor`	Optime アップデーター (バックグラウンド)。
`mongot_session_refresh_executor`	セッションリフレッシャー。
`mongot_system_metrics_updater_executor`	システムメトリクスアップデーター。

Tip

すべてのエキゼキュータープールの飽和を監視する

すべてのエキスキュータープールの飽和度をモニターするには、次の PromQL クエリを実行する。

max by (pool) (
  label_replace(
    {__name__=~"mongot_.+_executor_queued_tasks"},
    "pool", "$1", "__name__", "mongot_(.+)_executor_queued_tasks"
  )
)

このクエリは、各エキスキュータープールのキューに入っているタスクの数を返します。

Prometheus Server セルフメトリクス

次のメトリクスは、mongot の埋め込み Prometheus サーバーで利用できます。

メトリクス	タイプ	単位	説明
`mongot_prometheus_server_scraping_timer_seconds`	概要	秒（`timeUnit=milliseconds`）	`mongot` が `/metrics` 応答を構築するのにかかる時間。ここで持続的な成長が見られると、メトリクスの公開自体が遅くなっていることを意味します。

構成固有のメトリクス

次のメトリクスファミリは、特定の機能を有効にした場合にのみ/metrics出力に表示されます。

メトリクスファミリー	説明	自己管理型での利用可能性 `mongot`
`mongot_embedding`	自動埋め込みに関連するメトリクス。例: `mongot_initialsync_queue_requeuedEmbeddingInitialSyncs_total`、`mongot_materialized_view_lifecycle_executor`、`clientName="mongot AutoEmbedding Materialized View Writer"`を含む接続プールエントリ。	自動型埋め込みを構成した場合にのみ表示されます。
`mongot_mongot_ftdc_executor_failure_total`	FTDC実行者の失敗回数。	`ftdcExecutorMetricsToPrometheus` 機能フラグを有効にした場合にのみ表示されます。

PromQLの例

このカタログのレイテンシーメトリクスの多くはヒストグラムではなくサマリであるため、存在する場合は公開されている quantile ラベルを直接使用します。mongot_index_stats_query_limitPerQueryや mongot_index_stats_query_numCandidatesPerQuery などのメトリクスの数は少なく、ヒストグラムであり、_bucket シリーズを公開します。

# Replication state
max by (state) (mongot_replication_mongodb_indexManagerState)
# Number of search indexes at STEADY_STATE replication
mongot_replication_mongodb_indexManagerState{state="STEADY_STATE"}
# Maximum replication lag across all indexes, converted to seconds
max(mongot_index_stats_indexing_replicationLagMs) / 1000
# Index count by status
count by (status) (mongot_index_stats_indexStatusCode == 1)
# Search query p99 latency across all indexes
max(mongot_index_stats_query_searchResultBatchLatencies_seconds{quantile="0.99"})
# Worst recent GC pause
max(mongot_jvm_gc_pause_seconds_max)
# Average GC pause over 5 minutes
rate(mongot_jvm_gc_pause_seconds_sum[5m]) / rate(mongot_jvm_gc_pause_seconds_count[5m])
# Free disk percentage on dataPath
mongot_system_disk_space_data_path_free_bytes
  / mongot_system_disk_space_data_path_total_bytes
# Major page fault rate
rate(mongot_system_process_majorPageFaults_operations[5m])
# Steady-state and initial sync exceptions over 15 minutes
sum(rate(mongot_index_stats_indexing_steadyStateExceptions_total[15m]))
sum(rate(mongot_index_stats_indexing_initialSyncExceptions_total[15m]))

戻る

新しい配置のモニタリングを設定する

mongot ログと FTDC