/ /

Referencia de métricas para mongot

El proceso mongot expone métricas de Prometheus que describen su estado de tiempo de ejecución y rendimiento en las áreas principales de operación. Esta página de referencia describe las métricas clave que son relevantes para la supervisión y la resolución de problemas cotidianas. Para obtener el conjunto completo de métricas, raspe el endpoint de métricas de Prometheus mongot en http://<mongot-host>:9946/metrics.

Ver métricas

Para ver las métricas sin procesar que expone mongot, envíe una solicitud HTTP GET al siguiente endpoint de métricas de Prometheus mongot:

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

En este endpoint:

<mongot-host> es el nombre de host o la dirección IP del proceso mongot.
9946 es el puerto por defecto para el punto de conexión de métricas. Para configurar el puerto del punto de conexión de métricas, consulte la configuración metrics.address en el archivo de configuración mongot.
/metrics es la ruta para el punto final de métricas.

El punto final /metrics devuelve métricas en formato de texto sin formato de Prometheus. Para supervisar las métricas mongot a lo largo del tiempo, configure su instancia de Prometheus para extraer este punto final.

Importante

El endpoint /metrics no requiere autenticación por defecto. Para las implementaciones de producción, restringe el acceso en la capa de red.

Convenciones de nomenclatura de métricas

mongot los nombres de las métricas utilizan un patrón de nomenclatura coherente:

Todos los nombres de métricas comienzan con el prefijo mongot_.
Los nombres de las métricas generalmente siguen el patrón mongot_<area>_<measurement>[_<unit>], donde:
- <area> indica el subsistema o componente al que pertenece la métrica, como process, jvm, replication o index.
- <measurement> indica lo que se está midiendo, como cpu_usage, heap_memory o index_size.
- <unit> (opcional) indica la semántica de la unidad o del contador para la métrica. Este sufijo opcional indica la unidad en la que se mide la métrica, como seconds, bytes o ms, o el tipo de contador que representa la métrica, como total, events o operations.
  
  Nota
  Algunos sufijos de nombres de métricas no reflejan la unidad real informada para la métrica. Por ejemplo, mongot_index_stats_query_latency_seconds tiene el sufijo _seconds, pero mongot informa la métrica en milisegundos, como lo indica la etiqueta timeUnit=milliseconds en la salida de la métrica. Para confirmar la unidad de cada métrica, compruebe el valor Unit en las tablas de referencia de métricas a continuación.

Además del nombre de la métrica, las métricas mongot pueden incluir etiquetas (también llamadas dimensiones). Las etiquetas distinguen varias series de tiempo que comparten el mismo nombre de métrica base. Por ejemplo, una métrica podría usar etiquetas para identificar un state, status, index type, quantile o un index específico.

Para algunas métricas, debe interpretar la métrica como la combinación del nombre de la métrica y sus etiquetas, no solo por el nombre de la métrica. Por ejemplo, mongot_replication_mongodb_indexManagerState utiliza la etiqueta state para exponer una serie para cada estado de replicación, como STEADY_STATE o FAILED. Exactamente una de esas series etiquetadas tiene el valor 1 a la vez. Las métricas por índice utilizan de forma similar etiquetas como generationId_logString y indexId_logString para distinguir un índice de otro.

Para las métricas de distribución, el sufijo del nombre de la métrica indica el tipo de serie de Prometheus:

Los histogramas exponen _bucket, _count, _sum y _max.
Los resúmenes exponen _count, _sum y _max. Algunos resúmenes también incluyen etiquetas de cuantil como {quantile="0.5"}.

Etiquetas de métricas comunes

En la siguiente tabla se describen las etiquetas comunes que aparecen en las métricas de mongot.

Nombre de la etiqueta	Alcance de las métricas	Possible Values
`name`	Todos los grupos de ejecutores	`executorMetrics`
`Scope`	Transversal	`jvm`, `replication`, `lucene`
`generationId_logString`, `indexId_logString`	La mayoría de las series `mongot_index_stats_*`	Id opacos internos (el identificador por índice que utilizan los registros)
`indexFeatureVersion`	Muchas métricas de índice	`35`, `6` (el formato de índice en disco)
`indexType`	Métricas de indexación y sincronización inicial	`search`, `vector_search`, `vector_search_auto_embedding` (solo cuando configure la incrustación automatizada)
`numPartitions`	Tamaño del índice y métricas de documentos	`1` para autogestionado
`timeUnit`	Métricas de resumen de latencia	`seconds`, `milliseconds`, `microseconds`
`quantile`	Métricas de resumen	`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` (solo cuando la incrustación automatizada está habilitada)

Grupos de métricas clave

Métricas de proceso y JVM

Utilice las métricas de proceso y JVM para confirmar que mongot se está ejecutando normalmente y para identificar la presión de la pila o la recolección de elementos no utilizados.

Proceso

Métrica	Tipo	unidad	Descripción
`mongot_process_uptime_seconds`	Medidor	Segundos	El tiempo de actividad de la máquina virtual de Java.
`mongot_process_start_time_seconds`	Medidor	segundos unix	Hora de inicio del proceso desde Unix epoch.
`mongot_process_cpu_time_ns_total`	Contador	nanosegundos	El "tiempo de CPU" utilizado por el proceso de Java Virtual Machine. Utilice `rate()` para el consumo instantáneo de CPU.
`mongot_process_cpu_usage`	Medidor	0-1	El "uso reciente de CPU" para el proceso de Java Virtual Machine. El valor se normaliza a un rango de 0 a 1, donde 1 representa la utilización completa de la CPU.

Memoria JVM

Métrica	Tipo	unidad	Descripción
`mongot_jvm_memory_used_bytes`	Medidor	bytes	La cantidad de memoria utilizada. Etiquetas: `area=heap\|nonheap`, `id=<pool>` (por ejemplo, G1 Eden Space, G1 Old Gen, G1 Survivor Space, Metaspace).
`mongot_jvm_memory_committed_bytes`	Medidor	bytes	La cantidad de memoria comprometida para que la utilice la máquina virtual Java.
`mongot_jvm_memory_max_bytes`	Medidor	bytes	La memoria máxima que se puede utilizar. Para el montón, `id="G1 Old Gen"` lleva `-Xmx`.
`mongot_jvm_buffer_count_buffers`	Medidor	count	Recuentos de grupos de búferes NIO. Etiquetas: `id=direct\|mapped`.
`mongot_jvm_buffer_memory_used_bytes`	Medidor	bytes	Memoria que la JVM utiliza para grupos de búfer NIO.
`mongot_jvm_buffer_total_capacity_bytes`	Medidor	bytes	Capacidad del grupo de búferes NIO.

Colección de basura de JVM

Métrica	Tipo	unidad	Descripción
`mongot_jvm_gc_pause_seconds`	Resumen	Segundos	Tiempo dedicado a la pausa de GC. Sin etiquetas de cuantil. Utiliza `mongot_jvm_gc_pause_seconds_max` para la pausa reciente más larga.
`mongot_jvm_gc_concurrent_phase_time_seconds`	Resumen	Segundos	Tiempo empleado en la fase de recolección de elementos no utilizados simultánea.
`mongot_jvm_gc_live_data_size_bytes`	Medidor	bytes	Tamaño del grupo de memoria dinámica de larga duración después de la recuperación. El "montón en vivo" para observar la presión de la memoria.
`mongot_jvm_gc_max_data_size_bytes`	Medidor	bytes	Tamaño máximo del pool de memoria heap de larga duración.
`mongot_jvm_gc_memory_allocated_bytes_total`	Contador	bytes	Aumento del tamaño del grupo de montones jóvenes entre GC.
`mongot_jvm_gc_memory_promoted_bytes_total`	Contador	bytes	Promociones de la generación joven a la antigua.

Métricas del sistema

Utilice métricas del sistema para supervisar las condiciones de CPU, disco, memoria, paginación y red a nivel de host que pueden afectar a mongot.

CPU

Métrica	Tipo	unidad	Descripción
`mongot_system_cpu_count`	Medidor	count	Procesadores disponibles para la JVM.
`mongot_system_cpu_usage`	Medidor	0-1	Uso reciente de la CPU del sistema. El valor se normaliza a un rango de 0 a 1, donde 1 representa la utilización completa de la CPU.
`mongot_system_load_average_1m`	Medidor	sin unidad	Promedio de carga de 1minutos del sistema operativo.

Disk

Métrica	Tipo	unidad	Descripción
`mongot_system_disk_space_data_path_free_bytes`	Medidor	bytes	Espacio libre en disco en el volumen `mongot` `dataPath`. Alerta sobre esta métrica.
`mongot_system_disk_space_data_path_total_bytes`	Medidor	bytes	Espacio total en disco en el volumen `dataPath`. Utilice para calcular el porcentaje libre.
`mongot_system_disk_space_free_bytes`, `mongot_system_disk_space_total_bytes`	Medidor	bytes	Espacio en disco libre y total en todo el sistema de archivos (alcance diferente al de `data_path`).
`mongot_system_disk_readBytes_bytes`	Medidor	bytes	Bytes leídos del disco por dispositivo. Etiqueta: `name=<device>` (por ejemplo, `/dev/vda`).
`mongot_system_disk_writeBytes_bytes`	Medidor	bytes	Bytes escritos por dispositivo.
`mongot_system_disk_reads_events`	Medidor	count	Recuento de E/S de lectura por dispositivo. Utilice `rate()` para IOPS de lectura.
`mongot_system_disk_writes_events`	Medidor	count	Guardar recuento de E/S por dispositivo.
`mongot_system_disk_currentQueueLength_tasks`	Medidor	count	Longitud de la cola de disco (E/S en curso) por dispositivo.
`mongot_system_disk_transferTime_ms`	Medidor	Milisegundos	Tiempo dedicado a leer o escribir por dispositivo.

Memoria

Métrica	Tipo	unidad	Descripción
`mongot_system_memory_phys_total_bytes`	Medidor	bytes	Memoria física total en el host.
`mongot_system_memory_phys_available_bytes`	Medidor	bytes	Memoria física disponible.
`mongot_system_memory_phys_inUse_bytes`	Medidor	bytes	Memoria física en uso.
`mongot_system_memory_virt_inUse_bytes`	Medidor	bytes	Memoria física y virtual total en uso.
`mongot_system_memory_virt_swap_inUse_bytes`, `mongot_system_memory_virt_swap_available_bytes`, `mongot_system_memory_virt_swap_total_bytes`	Medidor	bytes	Estado de swap.
`mongot_system_memory_virt_swap_pagesIn_operations`, `mongot_system_memory_virt_swap_pagesOut_operations`	Medidor	count	Actividad de intercambio de entrada/salida.
`mongot_system_memory_memoryMappings_objects`	Medidor	count	Número de asignaciones de memoria (relevante para los recuentos de mmap de Lucene).
`mongot_system_memory_pageSize_bytes`	Medidor	bytes	Tamaño de página del sistema.

Errores de página

Métrica	Tipo	unidad	Descripción
`mongot_system_process_majorPageFaults_operations`	Medidor	count	Errores de página principales. Utilice esta métrica con el umbral de asesoramiento de clase de almacenamiento.
`mongot_system_process_minorPageFaults_operations`	Medidor	count	Errores de página menores.

Red

Métrica	Tipo	unidad	Descripción
`mongot_system_netstat_bytesRecv_bytes`, `mongot_system_netstat_bytesSent_bytes`	Medidor	bytes	Bytes recibidos y enviados por interfaz (`name=eth0`).
`mongot_system_netstat_packetsRecv_events`, `mongot_system_netstat_packetsSent_events`	Medidor	count	Paquetes recibidos y enviados.
`mongot_system_netstat_inErrors_events`, `mongot_system_netstat_outErrors_events`, `mongot_system_netstat_inDrops_events`, `mongot_system_netstat_collisions_events`	Medidor	count	Contadores de errores, descartes y colisiones.
`mongot_system_netstat_speed`	Medidor	bits/seg	Velocidad de interfaz negociada.

Métricas de replicación

Utilice métricas de replicación para determinar si mongot está en buen estado, sincronizando normalmente y manteniéndose al día con mongod.

Estado general

Métrica	Tipo	unidad	Descripción
`mongot_replication_manager`	Medidor	0/1	`1` cuando el administrador de replicación está activo.
`mongot_replication_mongodb_manager`	Medidor	0/1	`1` cuando el administrador de replicación respaldado por MongoDB está activo. Etiqueta: `type=normal`.
`mongot_replicationIndexManager_transitionState_total`	Contador	count	Transiciones de estado. Etiquetas: `fromState`, `toState`. Se utiliza para detectar resincronizaciones (transiciones de `INITIALIZING` a `STEADY_STATE`).

Actualizador de sesión

Métrica	Tipo	unidad	Descripción
`mongot_replication_sessionRefresher_sessions`	Medidor	count	Sesiones activas.
`mongot_replication_sessionRefresher_refreshes_total`	Contador	count	Actualizaciones totales de la sesión.
`mongot_replication_sessionRefresher_failedSessionRefreshes_total`	Contador	count	Actualizaciones fallidas.
`mongot_replication_sessionRefresher_sessionRefreshDurations_seconds`	Resumen	Segundos	Distribución de la duración de la actualización.

Actualizador de Optime

Métrica	Tipo	unidad	Descripción
`mongot_replicationOptimeUpdaterError_total`	Contador	count	Errores de actualización de Optime.
`mongot_replicationOptimeUpdater_executor_*`	varios	N/A	Métricas del ejecutor para el actualizador de optime.

Per-index Metrics

mongot emite las siguientes métricas por índice e incluye etiquetas generationId_logString y indexId_logString para identificar el índice específico. Filtre por esas etiquetas para inspeccionar un índice específico o agregue etiquetas para comprender el comportamiento de toda la flota.

Estado y tamaño del índice

Métrica	Tipo	unidad	Descripción
`mongot_index_stats_indexStatusCode`	Medidor	0/1	Estado por índice. Codificado en one-hot a través de los `status` valores de etiqueta: `STEADY`, `INITIAL_SYNC`, `FAILED`, `RECOVERING_NON_TRANSIENT`, `RECOVERING_TRANSIENT`, `STALE`, `NOT_STARTED`, `DOES_NOT_EXIST`, `UNKNOWN`.
`mongot_index_stats_indexFeatureVersion`	Medidor	Número	Versión del formato de índice en disco. Por ejemplo, `3`.
`mongot_index_stats_indexSizeBytes`	Medidor	bytes	Tamaño total en disco del índice.
`mongot_index_stats_largestIndexFileSizeBytes`	Medidor	bytes	El archivo único más grande del índice.
`mongot_index_stats_numFilesInIndex`	Medidor	count	Número de archivos de segmento de Lucene.
`mongot_index_stats_numLuceneDocs`	Medidor	count	Documentos de Lucene en el índice.
`mongot_index_stats_numLuceneMaxDocs`	Medidor	count	ID máximo de documento de Lucene (incluye eliminado-no-fusionado).
`mongot_index_stats_numLuceneFields`	Medidor	count	Número de campo Lucene indexados.
`mongot_index_stats_segment_count`	Medidor	count	Número de segmentos de Lucene.
`mongot_index_stats_requiredMemoryBytes`	Medidor	bytes	Memoria necesaria estimada para el índice.

Métricas de indexación

Métrica	Tipo	unidad	Descripción
`mongot_index_stats_indexing_replicationLagMs`	Medidor	Milisegundos	Atraso de la replicación por índice, en milisegundos. La unidad está en el nombre de la métrica (`Ms`). No divida por 1000 en PromQL a menos que desee convertir a segundos.
`mongot_index_stats_indexing_replicationOpTime`	Medidor	Marca de tiempo BSON	Último optime de replicación aplicado (codificación numérica).
`mongot_index_stats_indexing_maxPossibleReplicationOpTime`	Medidor	Marca de tiempo BSON	Límite de avance, establecido por la sugerencia `mongod`.
`mongot_index_stats_indexing_insert_total`, `mongot_index_stats_indexing_update_total`, `mongot_index_stats_indexing_delete_total`	Contador	count	Recuentos de operaciones de indexación. Etiqueta: `indexType=search`.
`mongot_index_stats_indexing_totalBytesProcessed_total`	Contador	bytes	Total de bytes procesados por la indexación.
`mongot_index_stats_indexing_vectorFieldsIndexed_total`	Contador	count	Campos vectoriales indexados.
`mongot_index_stats_indexing_commitDurations_seconds`	Resumen	segundos (`timeUnit=milliseconds`)	Duraciones de confirmación por índice.
`mongot_index_stats_indexing_indexingBatchDurations_seconds`	Resumen	Segundos	Distribución de la duración del agrupar.
`mongot_index_stats_indexing_largeChangeStreamEvents_total`	Contador	count	Eventos de flujo de cambios de gran tamaño. Etiqueta: `threshold=10MiB\|12MiB\|14MiB\|15MiB`.
`mongot_index_stats_indexing_invalidGeometryField_total`	Contador	count	Documentos rechazados por geometría no válida.
`mongot_index_stats_indexing_sortableStringTruncated_total`	Contador	count	Cadenas truncadas que se pueden ordenar.
`mongot_index_stats_indexing_initialSyncExceptions_total`	Contador	count	Excepciones durante la sincronización inicial.
`mongot_index_stats_indexing_steadyStateExceptions_total`	Contador	count	Excepciones de estado estable.
`mongot_index_stats_indexing_consecutiveInitialSyncResyncExceptions`	Medidor	count	Excepciones consecutivas de resincronización de sincronización inicial para este índice.

Query Metrics

Métrica	Tipo	unidad	Descripción
`mongot_index_stats_query_totalQueries_total`	Contador	count	Total de queries emitidas contra el índice.
`mongot_index_stats_query_totalHitsCount_total`	Contador	count	Total de aciertos devueltos.
`mongot_index_stats_query_failedQueries_total`	Contador	count	Queries que fallaron.
`mongot_index_stats_query_internallyFailedQueries_total`, `mongot_index_stats_query_invalidQueries_total`, `mongot_index_stats_query_npeQueries_total`, `mongot_index_stats_query_lenientFailures_total`	Contador	count	Contadores específicos de clase de error.
`mongot_index_stats_query_searchResultBatchLatencies_seconds`	Resumen	segundos (`timeUnit=milliseconds`)	Latencia de agrupar de búsqueda. Esta es la métrica principal de latencia de query.
`mongot_index_stats_query_luceneTopDocsSearchLatencies_seconds`	Resumen	segundos (`timeUnit=milliseconds`)	Latencia dentro de la búsqueda TopDocs de Lucene. Utilice esta métrica para distinguir la latencia interna de Lucene de la latencia total.
`mongot_index_stats_query_vectorResultLatencies_seconds`	Resumen	segundos (`timeUnit=milliseconds`)	Latencia de resultados de búsqueda vectorial.
`mongot_index_stats_query_vectorSearchInitialTopDocsLatencyTimer_seconds`, `mongot_index_stats_query_vectorSearchGetMoreTopDocsLatencyTimer_seconds`	Resumen	segundos (`timeUnit=milliseconds`)	Fases de latencia de búsqueda vectorial.
`mongot_index_stats_query_tokenFacetsStateRefreshLatency_seconds`	Resumen	segundos (`timeUnit=milliseconds`)	Latencia de actualización del estado de las facetas.
`mongot_index_stats_query_batchDataSize`, `mongot_index_stats_query_batchDocumentCount`	Resumen	bytes / recuento	Tamaño de la carga útil por lote y recuento de documentos.
`mongot_index_stats_query_limitPerQuery`	histograma	count (`le=10\|50\|100\|200\|500\|1000\|+Inf`)	Distribución de los límites de `$search` y `$vectorSearch`.
`mongot_index_stats_query_numCandidatesPerQuery`	histograma	count	Candidatos vectoriales por query, agrupados por cuantificación.
`mongot_index_stats_query_getMoreCommandCalls_total`, `mongot_index_stats_query_getMoreCommandCallsPerQuery`	contador / resumen	count	`getMore` recuentos de llamadas.
`mongot_index_stats_query_batchWithTies_total`	Contador	count	Agrupar resultados con empates de puntuación.
`mongot_index_stats_query_benefitFromIndexSortCount_total`	Contador	count	Queries que se beneficiaron de la optimización de la ordenación indexada.
`mongot_index_stats_query_extractableLimitQueries_total`, `mongot_index_stats_query_extractableLimitSecondBatchQueries_total`	Contador	count	Optimizaciones de extracción de límites activadas.
`mongot_index_stats_query_phantomSearcherCleanupCount_total`	Contador	count	Limpieza de buscadores fantasma.
`mongot_index_stats_query_orphanedDeletedDocsRatio`	Resumen	ratio	Relación de documentos eliminados en los resultados devueltos.
`mongot_index_stats_query_noProgressBatches_total`	Contador	count	Agrupar que no avanzaron.
`mongot_index_stats_query_vectorCommandCalls_total`, `mongot_index_stats_query_vectorRescoringFailureCount_total`, `mongot_index_stats_query_vectorSearchQueriesOverSearchIndexes_total`	Contador	count	Contadores específicos de vectores.
`mongot_index_stats_query_feature_total`	Contador	count	Uso de funcionalidades por query. Etiqueta: `name=<feature>`. Por ejemplo, `compound`, `text`, `phrase`, `near`, `vectorSearch`, `knnBeta`, `autoEmbedding` (solo cuando la incrustación automatizada está habilitada).
`mongot_index_stats_query_failedExplainQueryAggregate_total`	Contador	count	Agregados de `$explain` fallidos.

Desglose de replicación por índice

Métrica	Tipo	unidad	Descripción
`mongot_replication_mongodb_indexManagerState`	Medidor	0/1	La señal canónica de estado de replicación. `mongot` codifica esta métrica en un solo punto, lo que significa que exactamente una etiqueta `state` es `1.0`. Estados: `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`	Resumen	bytes / recuento	Tamaños de agrupar de estado estable.
`mongot_index_stats_replication_steadyState_decodingBatchDurations_seconds`	Resumen	Segundos	Duración de decodificación de estado estable.
`mongot_index_stats_replication_steadyState_getMoreDurations_seconds`	Resumen	Segundos	Duración del estado estable `getMore`.
`mongot_index_stats_replication_initialSync_changeStream_*`	Resumen	—	Métricas de fase de flujo de cambios de sincronización inicial (refleja el estado estable).
`mongot_index_stats_replication_initialSync_collScan_*`	Resumen	—	Métricas de la fase de escaneo de colección de sincronización inicial.

Latencia de actualización de Lucene

Métrica	Tipo	unidad	Descripción
`mongot_index_stats_luceneIndexRefresher_refreshDurations_seconds`	Resumen	segundos (`timeUnit=milliseconds`)	Latencia de actualización del IndexReader de Lucene.

Métricas de comandos

mongot acepta el siguiente conjunto de comandos con nombre de mongod:

buildinfo
getMore
hello
isMaster
ismaster
killCursors
manageSearchIndex
ping
planShardedSearch
search
vectorSearch

Para cada comando, mongot expone las siguientes métricas, donde <name> es un marcador de posición para el nombre del comando:

Patrón	Tipo	Descripción
`mongot_command_<name>CommandFailure_total`	Contador	Recuento de fallos para el comando.
`mongot_command_<name>CommandTotalLatency_seconds`	Resumen	Latencia de extremo a extremo, incluida la serialización.
`mongot_command_<name>CommandSerializationLatency_seconds`	Resumen	Latencia de serialización (subconjunto; no todos los comandos).

Tip

Supervise la latencia de búsqueda y búsqueda vectorial en todos los índices

mongot_command_searchCommandTotalLatency_seconds y mongot_command_vectorSearchCommandTotalLatency_seconds son las métricas principales que se deben supervisar para los agregados de latencia de $search y $vectorSearch. Estos exponen agregados de latencia para todos los comandos search y vectorSearch en todos los índices.

Métricas del programador y distribuidor de indexación

Utilice las métricas del programador de indexación y del distribuidor para identificar retrasos, saturación y trabajo lento en los pipeline de replicación y indexación.

Pipeline de flujo de cambios de estado estable

Métrica	Tipo	unidad	Descripción
`mongot_indexing_steadyStateChangeStream_batchesInProgressTotal`	Medidor	count	Agrupar actualmente en aplicación. Etiqueta: `indexType=search\|vector_search\| vector_search_auto_embedding` (solo cuando habilita la incrustación automatizada).
`mongot_indexing_steadyStateChangeStream_batchesInProgressTotalDurations_seconds`	Resumen	Segundos	Distribución de duración para lotes en curso.
`mongot_indexing_steadyStateChangeStream_getMoreDurations_seconds`	Resumen	Segundos	`getMore` distribución de ida y vuelta.
`mongot_indexing_steadyStateChangeStream_getMoresInFlight`	Medidor	count	`getMore` solicitudes en curso.
`mongot_indexing_steadyStateChangeStream_getMoresScheduled`	Medidor	count	Solicitudes `getMore` programadas por `indexType`.
`mongot_indexing_steadyStateChangeStream_getMoresSchedulingDurations_seconds`	Resumen	Segundos	`getMore` latencia de programación.
`mongot_indexing_steadyStateChangeStream_preprocessingBatchDurations_seconds`	Resumen	Segundos	Duración del pre-procesamiento por agrupar.
`mongot_indexing_steadyStateChangeStream_witnessedChangeStreamUpdates_total`	Contador	count	Total de eventos de flujo de cambios observados. Etiqueta: `Scope=replication`.
`mongot_indexing_steadyStateChangeStream_applicableChangeStreamUpdates_total`	Contador	count	Eventos que `mongot` consideró aplicables.
`mongot_indexing_steadyStateChangeStream_dispatcher`	Medidor	0/1	Estado del despachador. Etiquetas: `Scope=replication`, `client=synchronous-batch`.
`mongot_indexing_steadyStateChangeStream_skippedChangeStreamDocumentsWithoutMetadataNamespace_total`	Contador	count	Eventos omitidos debido a la falta de metadatos.
`mongot_indexing_steadyStateChangeStream_unexpectedBatchFailures_total`	Contador	count	Fallos inesperados de agrupación.
`mongot_indexing_steadyStateChangeStream_rescheduledEmbeddingGetMores_total`	Contador	count	getMores de incrustación reprogramados. Esta métrica solo está disponible cuando configura la incrustación automatizada.
`mongot_indexing_changeStreamModeSelector_failedSamplingAttemptsCounter_total`	Contador	count	Intentos fallidos de muestreo del modo de flujo de cambios.

Programador de trabajos de indexación

Las métricas del programador de trabajos de indexación supervisan la puesta en cola y la ejecución de agrupar de indexación.

Métrica	Tipo	unidad	Descripción
`mongot_indexingWorkScheduler_queuedBatchesTotal`, `mongot_indexingWorkScheduler_queuedEventsTotal`	Medidor	count	Profundidad de la cola del programador.
`mongot_indexingWorkScheduler_enqueueCalls_total`, `mongot_indexingWorkScheduler_dequeueCalls_total`	Contador	count	Recuentos de cola y de cola.
`mongot_indexingWorkScheduler_indexingBatchDistribution`	Resumen	count	Distribución de tamaños de agrupar. Etiqueta: `Scope=replication`.
`mongot_indexingWorkScheduler_indexingBatchDurations_seconds`	Resumen	Segundos	Duraciones de los lotes.
`mongot_indexingWorkScheduler_indexingBatchSchedulingDurations_seconds`	Resumen	Segundos	Gastos generales del cronograma.

Programador de trabajo de decodificación

Las métricas del programador de trabajos de decodificación supervisan la puesta en cola y la ejecución de la decodificación por lotes del flujo de cambios.

Métrica	Tipo	unidad	Descripción
`mongot_decodingWorkScheduler_queuedBatchesTotal`, `mongot_decodingWorkScheduler_queuedEventsTotal`	Medidor	count	Profundidad de la cola del programador.
`mongot_decodingWorkScheduler_enqueueCalls_total`, `mongot_decodingWorkScheduler_dequeueCalls_total`	Contador	count	Recuentos de cola y de cola.
`mongot_decodingWorkScheduler_decodingBatchDistribution`	Resumen	count	Distribución de tamaños de agrupar. Etiqueta: `Scope=replication`.
`mongot_decodingWorkScheduler_decodingBatchDurations_seconds`	Resumen	Segundos	Duraciones de los lotes.
`mongot_decodingWorkScheduler_decodingBatchSchedulingDurations_seconds`	Resumen	Segundos	Gastos generales del cronograma.

Sincronización inicial, ciclo de vida y métricas de configuración

Utilice estas métricas para rastrear el trabajo de inicio del índice, la recuperación y el estado del catálogo.

Sincronización inicial

Nota

Algunas métricas de mongot son específicas de la fase y solo se rellenan cuando la ruta de código correspondiente está activa. Por ejemplo, las métricas de replicación de estado estable, como mongot_index_stats_indexing_replicationLagMs y la serie mongot_index_stats_replication_steadyState_*, no se rellenan mientras un índice está en sincronización inicial. Por el contrario, las métricas específicas de sincronización inicial, como mongot_initialsync_* y mongot_index_stats_replication_initialSync_*, solo son relevantes mientras la sincronización inicial se está ejecutando o se ha ejecutado.

Métrica	Tipo	unidad	Descripción
`mongot_initialsync_queue_queuedSyncs`	Medidor	count	Sincronizaciones iniciales en cola. Etiqueta: `indexType`.
`mongot_initialsync_queue_requeuedEmbeddingInitialSyncs_total`	Contador	count	Incrustación de sincronizaciones iniciales que se volvieron a poner en cola. Esta métrica solo está disponible cuando configura la incrustación automatizada.
`mongot_initialsync_dispatcher_inProgressSyncs`	Medidor	count	Sincronización inicial en curso. Etiqueta: `indexType`.
`mongot_initialsync_dispatcher_queuedSyncs`	Medidor	count	Sincronización inicial en cola en el distribuidor.
`mongot_initialsync_dispatcher_inProgressResumedSyncs`	Medidor	count	Sincronizaciones en curso que se reanudaron desde un punto de control.
`mongot_initialsync_dispatcher_collectionScan`	Medidor	0/1	Modo de escaneo de colección activo. Etiqueta: `scan_type=id_order\|natural_order`.
`mongot_initialsync_dispatcher_completedSyncDuration_seconds`	Resumen	Segundos	Distribución de la duración de la sincronización completada.
`mongot_initialsync_dispatcher_syncDuration_seconds`	Resumen	Segundos	Duración de la sincronización en curso.
`mongot_initialsync_dispatcher_inProgressInitialSyncDurationMin_seconds`, `mongot_initialsync_dispatcher_inProgressInitialSyncDurationMax_seconds`, `mongot_initialsync_dispatcher_inProgressInitialSyncDurationSum_seconds`	Medidor	Segundos	Mínimo, máximo y suma de las duraciones de sincronización inicial en curso.
`mongot_initialsync_dispatcher_unreadableDroppedIndexes_total`	Contador	count	Descartado porque sus segmentos en disco no se pudieron leer.
`mongot_initialsync_dispatcher_unreadableIndexRecoveries_total`	Contador	count	Recuperado después de segmentos ilegibles. Etiqueta: `unreadableIndexCause=corruptIndex\|incompatibleCodec\| incompatibleIndexFormat`.

Ciclo de vida

Métrica	Tipo	unidad	Descripción
`mongot_lifecycle_indexesInInitializedState`	Medidor	count	Índices actualmente en estado inicializado.
`mongot_lifecycle_indexInitializationDuration_seconds`	Resumen	Segundos	Duraciones de inicialización.
`mongot_lifecycle_failedDownloadIndexes_total`	Contador	count	Descargas de índices que fallaron.
`mongot_lifecycle_failedDropIndexes_total`	Contador	count	Descartes de índice que fallaron.
`mongot_lifecycle_failedInitializationIndexes_total`	Contador	count	Inicializaciones de índices que fallaron.

Estado de configuración

Métrica	Tipo	unidad	Descripción
`mongot_configState_indexesInCatalog`	Medidor	count	Índices actualmente en el catálogo. Etiquetas: `Scope=replication`, `indexFormatVersion`.
`mongot_configState_indexesPhasingOut`	Medidor	count	Índice que se están eliminando gradualmente.
`mongot_configState_stagedIndexes`	Medidor	count	Índices organizados pero aún no activos.
`mongot_configState_indexesInCatalogFeatureVersionFour`, `mongot_configState_indexesPhasingOutFeatureVersionFour`, `mongot_configState_stagedIndexesFeatureVersionFour`	Medidor	count	Equivalentes específicos de la versión de la funcionalidad4.

Cursores y fábrica de índices

Utilice estas métricas para supervisar el estado del cursor abierto y para detectar índices que mongot descartó o recuperó porque sus segmentos en disco no se podían leer.

Métrica	Tipo	unidad	Descripción
`mongot_cursorManager_trackedCursors`	Medidor	count	Cursores abiertos actualmente rastreados.
`mongot_indexFactory_unreadableDroppedIndexes_total`	Contador	count	Índices descartados porque sus segmentos no se podían leer.
`mongot_indexFactory_unreadableIndexRecoveries_total`	Contador	count	Recuperaciones después de segmentos ilegibles. Etiqueta: `unreadableIndexCause`.

Fusión de Lucene

Utilice estas métricas para supervisar la actividad de fusión de segmentos de Lucene, incluido el número y el tamaño de las fusiones en curso, los tamaños de entrada y salida de fusión, las duraciones de fusión y las fusiones descartadas por la política de fusión de utilización de disco.

Métrica	Tipo	unidad	Descripción
`mongot_mergeScheduler_currentlyRunningMerges`	Medidor	count	Fusiones activas. Etiqueta: `Scope=lucene`.
`mongot_mergeScheduler_currentlyMergingDocs`	Medidor	count	Documentos que se están fusionando actualmente.
`mongot_mergeScheduler_numMerges_total`	Contador	count	Total de fusiones ejecutadas desde el inicio.
`mongot_mergeScheduler_numSegmentsMerged_total`	Contador	count	Segmentos plegados por fusiones.
`mongot_mergeScheduler_mergeSize`	Resumen	bytes	Distribución de los tamaños de entrada de la fusión.
`mongot_mergeScheduler_mergeResultSize`	Resumen	bytes	Distribución de los tamaños de salida de la fusión.
`mongot_mergeScheduler_mergedDocs`	Resumen	count	Distribución de documentos por fusión.
`mongot_mergeScheduler_mergeTime_seconds`	Resumen	Segundos	Distribución de la duración de la fusión.
`mongot_diskUtilizationAwarenessMergePolicy_discardedMerge_total`	Contador	count	Las fusiones se descartaron debido a la política de utilización del disco.

Métricas del pool de conexiones del cliente de MongoDB

mongot abre varios pool de conexiones con nombre a mongod y etiqueta cada pool con una etiqueta clientName que identifica el rol de cada pool. En la siguiente tabla se enumeran los posibles valores de etiqueta clientName y su rol correspondiente:

clientName	Propósito
`mongot steady state sync`	Replicación de flujo de cambios en estado estable.
`mongot initial sync and session refresh`	Sincronización inicial y actualización de sesión. El `appName` visto en `mongod` `currentOp`.
`mongot metadata service`	Servicio de metadatos interno.
`mongot periodic optime fetcher`	Sondeo de Optime.
`mongot database metadata resolver`	Búsquedas de metadatos de la base de datos.
`mongot server info resolver`	Búsquedas de información del servidor.
`mongot Lease Manager mongo client`	Administrador de arrendamientos.
`mongot AutoEmbedding Materialized View Writer`	Incrustación automatizada guardados. Este pool de conexiones solo aparece cuando configura la incrustación automatizada.

En la siguiente tabla se enumeran las métricas disponibles para los pools de conexiones mongot:

Métrica	Tipo	unidad	Descripción
`mongot_mongoClient_connectionPool_connections`	Medidor	count	Conexiones actualmente abiertas en el grupo.
`mongot_mongoClient_connectionPool_connectionsCheckedOut`	Medidor	count	Conexiones actualmente extraídas.
`mongot_mongoClient_connectionPool_maxSize`	Medidor	count	Tamaño máximo de grupo configurado.
`mongot_mongoClient_connectionPool_minSize`	Medidor	count	Tamaño mínimo de grupo configurado.
`mongot_mongoClientBuilder_successfulOpenSSLDynamicLinking_total`	Contador	count	Intentos exitosos de enlace nativo de OpenSSL.
`mongot_mongoClientBuilder_failedOpenSSLDynamicLinking_total`	Contador	count	Intentos fallidos de enlace nativo de OpenSSL.

Sinónimos

Utilice estas métricas para supervisar la actividad de sincronización de sinónimos, incluidos los escaneos de colecciones, las duraciones de escaneo y sincronización, la profundidad de la cola y las excepciones encontradas durante la sincronización de sinónimos.

Métrica	Tipo	unidad	Descripción
`mongot_synonymSync_collScans_total`	Contador	count	Escaneo de colección total realizado para sinónimos.
`mongot_synonymSync_collScansTriggeredByChangeStream_total`	Contador	count	Análisis de sinónimos activados por eventos de flujo de cambios.
`mongot_synonymSync_collScanDurations_seconds`	Resumen	Segundos	Distribución de la duración del análisis.
`mongot_synonymSync_syncDurations_seconds`	Resumen	Segundos	Distribución de la duración de la sincronización.
`mongot_synonymSync_queueDepth`	Medidor	count	Profundidad actual de la cola de sincronización de sinónimos.
`mongot_synonymSync_exceptions_total`	Contador	count	Excepciones de sincronización de sinónimos.

Grupos de ejecutores

Utilice estas métricas para supervisar los grupos de ejecutores con nombre que utiliza mongot para ejecutar trabajos en segundo plano. Cada grupo expone el mismo conjunto de submétricas, con el prefijo del nombre del grupo, para que pueda rastrear la actividad de los subprocesos, el tamaño del grupo, la profundidad de la cola, el rendimiento de las tareas y el tiempo de ejecución por tarea en todos los grupos.

En la siguiente tabla se enumeran las sub-métricas que expone cada grupo de ejecutores, donde <pool> es el prefijo del nombre del grupo. Todas las sub-métricas del grupo de ejecutores llevan la etiqueta name="executorMetrics".

Sufijo de submétrica	Tipo	Descripción
`<pool>_active_threads`	Medidor	Hilos que actualmente ejecutan tareas.
`<pool>_pool_core_threads`, `<pool>_pool_max_threads`, `<pool>_pool_size_threads`	Medidor	Dimensionamiento del pool.
`<pool>_queued_tasks`	Medidor	Tareas esperando un hilo — la señal de saturación.
`<pool>_queue_remaining_tasks`	Medidor	Capacidad de cola restante.
`<pool>_completed_tasks_total`	Contador	Tareas completadas desde el inicio.
`<pool>_idle_seconds`	Resumen	Tiempo que los subprocesos permanecieron inactivos entre tareas.
`<pool>_seconds`	Resumen	Tiempo de ejecución por tarea.
`<pool>_scheduled_once_total`, `<pool>_scheduled_repetitively_total`	Contador	Recuentos de tareas programadas (para grupos de programación).

La siguiente tabla enumera los prefijos de todos los grupos de ejecutores con nombre disponibles y sus respectivos propósitos:

Prefijo del grupo de ejecutores	Qué ejecuta
`mongot_blobstore_lifecycle_executor`	Trabajo del ciclo de vida del almacenamiento de blobs.
`mongot_blocking_server_worker_executor`	Bloqueo de subprocesos de trabajo del servidor gRPC.
`mongot_change_stream_mode_selector_executor`	Selección del modo de flujo de cambios.
`mongot_change_stream_sync_dispatcher_executor`	Envío de sincronizar de flujo de cambios (uno de los más ocupados en estado estable).
`mongot_config_monitor_executor`	Sondeo del monitor de configuración.
`mongot_decoding_executor`	Descodificación de trabajadores de pipeline.
`mongot_disk_monitor_executor`	Sondeo del monitor de disco.
`mongot_grpc_health_check_executor`	Temporizador de verificación de estado de gRPC.
`mongot_idle_cursor_killer_executor`	Recuperación de cursor inactivo.
`mongot_index_commit_executor`	Operaciones de confirmación de índices.
`mongot_index_lifecycle_executor`	Trabajo del ciclo de vida por índice.
`mongot_index_refresh_executor`	Actualizaciones de Lucene IndexReader.
`mongot_indexing_work_executor`	Trabajadores de pipeline de indexación (el grupo de indexación más ocupado en estado estable).
`mongot_indexing_lifecycle_executor`	Trabajo del ciclo de vida de la indexación.
`mongot_indexing_auto_embedding_executor`	Ruta de indexación de incrustaciones automatizado. Este grupo de ejecutores solo aparece cuando configura la incrustación automatizado.
`mongot_init_lifecycle_executor`	Trabajo del ciclo de vida en tiempo de inicialización.
`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`	Seguimiento y ciclo de vida de las vistas materializadas. Estas métricas solo están disponibles cuando se configura la incrustación automatizada u otras funcionalidades respaldadas por vistas materializadas.
`mongot_replicationOptimeUpdater_executor`	Actualizador de Optime (segundo plano).
`mongot_session_refresh_executor`	Actualizador de sesión.
`mongot_system_metrics_updater_executor`	Actualizador de métricas del sistema.

Tip

Vigile la saturación en todos los grupos de ejecutores

Para supervisar la saturación en todos los grupos de ejecutores, ejecute la siguiente query de PromQL:

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

Esta query devuelve el recuento de tareas en cola para cada grupo de ejecutores.

Métricas propias del servidor Prometheus

La siguiente métrica está disponible para el servidor Prometheus incrustado en mongot:

Métrica	Tipo	unidad	Descripción
`mongot_prometheus_server_scraping_timer_seconds`	Resumen	segundos (`timeUnit=milliseconds`)	Cuánto tiempo tarda `mongot` en ensamblar una respuesta `/metrics`. El crecimiento sostenido aquí significa que la exposición de métricas en sí se está ralentizando.

Métricas específicas de la configuración

Las siguientes familias de métricas aparecen en la salida /metrics solo cuando habilita funcionalidades específicas.

Familia de métricas	Descripción	Disponibilidad en autogestionado `mongot`
`mongot_embedding`	Métricas relacionadas con la incrustación automatizada. Por ejemplo, `mongot_initialsync_queue_requeuedEmbeddingInitialSyncs_total`, `mongot_materialized_view_lifecycle_executor` y entradas de pool de conexiones con `clientName="mongot AutoEmbedding Materialized View Writer"`.	Aparecen solo cuando configura la incrustación automatizada.
`mongot_mongot_ftdc_executor_failure_total`	Recuento de errores para el ejecutor de FTDC.	Aparece solo cuando habilita la funcionalidad `ftdcExecutorMetricsToPrometheus`.

Ejemplos de PromQL

La mayoría de las métricas de latencia de este catálogo son resúmenes, no histogramas, por lo que debe utilizar sus etiquetas quantile publicadas directamente cuando existan. Un número menor de métricas, como mongot_index_stats_query_limitPerQuery y mongot_index_stats_query_numCandidatesPerQuery, son histogramas y exponen series _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]))

Volver

Configurar la supervisión para una nueva implementación

Registros de mongot y FTDC