/ /

Referência de métricas para mongot

O processo mongot expõe métricas do Prometheus que descrevem sua integridade e desempenho em tempo de execução nas principais áreas de operação. Esta página de referência descreve as principais métricas relevantes para o monitoramento e a solução de problemas do dia a dia. Para o conjunto completo de métricas, raspe o ponto de extremidade de métricas mongot Prometheus em http://<mongot-host>:9946/metrics.

Ver métricas

Para visualizar as métricas brutas que o mongot expõe, envie uma solicitação HTTP GET para o seguinte ponto de extremidade de métricas do Prometheus mongot:

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

Neste ponto de extremidade:

<mongot-host> é o nome do host ou endereço IP do processo mongot.
9946 é a porta padrão para o ponto de extremidade de métricas. Para configurar a porta do ponto de extremidade de métricas, consulte a configuração metrics.address no arquivo de configuração mongot.
/metrics é o caminho para o ponto de extremidade de métricas.

O ponto de extremidade /metrics retorna métricas no formato de texto simples do Prometheus. Para monitorar as métricas mongot ao longo do tempo, configure sua instância do Prometheus para extrair esse ponto de extremidade.

Importante

O ponto de extremidade /metrics não requer autenticação por padrão. Para implantações de produção, restrinja o acesso na camada de rede.

Convenções de nomenclatura de métricas

mongot os nomes das métricas usam um padrão de nomenclatura consistente:

Todos os nomes de métricas começam com o prefixo mongot_.
Os nomes das métricas geralmente seguem o padrão mongot_<area>_<measurement>[_<unit>], onde:
- <area> indica o subsistema ou componente ao qual a métrica pertence, como process, jvm, replication ou index.
- <measurement> indica o que está sendo medido, como cpu_usage, heap_memory ou index_size.
- <unit> (opcional) indica a semântica da unidade ou do contador para a métrica. Este sufixo opcional indica a unidade em que a métrica é medida, como seconds, bytes ou ms, ou o tipo de contador que a métrica representa, como total, events ou operations.
  
  Observação
  Alguns sufixos de nome de métricas não refletem a unidade real relatada para a métrica. Por exemplo, o mongot_index_stats_query_latency_seconds tem o sufixo _seconds, mas o mongot relata a métrica em milissegundos, conforme indicado pelo rótulo timeUnit=milliseconds na saída da métrica. Para confirmar a unidade de cada métrica, verifique o valor Unit nas tabelas de referência de métricas abaixo.

Além do nome da métrica, as métricas mongot podem incluir rótulos (também chamados de dimensões). Os rótulos distinguem várias séries temporais que compartilham o mesmo nome de métrica base. Por exemplo, uma métrica pode usar rótulos para identificar um state, status, index type, quantile ou um index específico.

Para algumas métricas, você deve interpretar a métrica como a combinação do nome da métrica e seus rótulos, não apenas pelo nome da métrica. Por exemplo, mongot_replication_mongodb_indexManagerState usa o rótulo state para expor uma série para cada estado de replicação, como STEADY_STATE ou FAILED. Exatamente uma dessas séries rotuladas tem o valor 1 por vez. As métricas por índice usam rótulos como generationId_logString e indexId_logString para distinguir um índice do outro.

Para métricas de distribuição, o sufixo do nome da métrica indica o tipo de série Prometheus:

Os histogramas expõem _bucket, _count, _sum e _max.
Os resumos expõem _count, _sum e _max. Alguns resumos também incluem rótulos de quantil, como {quantile="0.5"}.

Rótulos de métricas comuns

A tabela a seguir descreve os rótulos comuns que aparecem nas métricas mongot.

Nome do rótulo	Escopo da métrica	Valores possíveis
`name`	Todos os pools de executores	`executorMetrics`
`Scope`	Transversal	`jvm`, `replication` , `lucene`
`generationId_logString`, `indexId_logString`	A maioria das séries `mongot_index_stats_*`	IDs opacos internos (o identificador por índice que os logs usam)
`indexFeatureVersion`	Muitas métricas de índice	`3`, `5`, `6` (o formato de índice em disco)
`indexType`	Métricas de indexação e sincronização inicial	`search`, `vector_search`, `vector_search_auto_embedding` (somente quando você configura o Automated Embedding)
`numPartitions`	Tamanho do índice e métricas do documento	`1` para autogerenciado
`timeUnit`	Métricas de resumo de latência	`seconds`, `milliseconds` , `microseconds`
`quantile`	Métricas de resumo	`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 syncmongot 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` (somente quando o embedding automatizado está habilitado)

Grupos de métricas principais

Métricas de processo e JVM

Use métricas de processo e JVM para confirmar se o mongot está sendo executado normalmente e para identificar a pressão de heap ou coleta de lixo.

Processo

Métrica	Tipo	unidade	Descrição
`mongot_process_uptime_seconds`	Medidor	Segundos	O tempo de atividade da Máquina Virtual Java.
`mongot_process_start_time_seconds`	Medidor	segundos unix	Hora de início do processo desde a Era UNIX.
`mongot_process_cpu_time_ns_total`	Contador	nanossegundos	O "tempo de CPU" usado pelo processo da Java Virtual Machine. Use `rate()` para consumo instantâneo de CPU.
`mongot_process_cpu_usage`	Medidor	0-1	O "uso recente da CPU" para o processo da Máquina Virtual Java. O valor é normalizado para uma faixa de 0 a 1, onde 1 representa a utilização total da CPU.

Memória JVM

Métrica	Tipo	unidade	Descrição
`mongot_jvm_memory_used_bytes`	Medidor	bytes	A quantidade de memória usada. Rótulos: `area=heap\|nonheap`, `id=<pool>` (por exemplo, G1 Eden Space, G1 Old Gen, G1 Survivor Space, Metaspace).
`mongot_jvm_memory_committed_bytes`	Medidor	bytes	A quantidade de memória confirmada para a máquina virtual Java usar.
`mongot_jvm_memory_max_bytes`	Medidor	bytes	A memória máxima que pode ser usada. Para heap, `id="G1 Old Gen"` carrega `-Xmx`.
`mongot_jvm_buffer_count_buffers`	Medidor	contar	Contagens do pool de buffer NIO. Rótulos: `id=direct\|mapped`.
`mongot_jvm_buffer_memory_used_bytes`	Medidor	bytes	Memória que a JVM usa para pools de buffer NIO.
`mongot_jvm_buffer_total_capacity_bytes`	Medidor	bytes	Capacidade do pool de buffer NIO.

JVM Coleção de lixo

Métrica	Tipo	unidade	Descrição
`mongot_jvm_gc_pause_seconds`	Resumo	Segundos	Tempo gasto na pausa do GC. Sem rótulos de quantil. Use `mongot_jvm_gc_pause_seconds_max` para a pausa recente mais longa.
`mongot_jvm_gc_concurrent_phase_time_seconds`	Resumo	Segundos	Tempo gasto na fase de GC simultâneo.
`mongot_jvm_gc_live_data_size_bytes`	Medidor	bytes	Tamanho do pool de memória heap de longa duração após a recuperação. O "heap ativo" para observar a pressão da memória.
`mongot_jvm_gc_max_data_size_bytes`	Medidor	bytes	Tamanho máximo do pool de memória heap de longa duração.
`mongot_jvm_gc_memory_allocated_bytes_total`	Contador	bytes	Aumento no tamanho do pool de heap jovem entre GCs.
`mongot_jvm_gc_memory_promoted_bytes_total`	Contador	bytes	Promoções da geração jovem para a geração antiga.

Métricas do sistema

Use métricas do sistema para monitorar as condições de CPU, disco, memória, paginação e rede no nível do host que podem afetar mongot.

CPU

Métrica	Tipo	unidade	Descrição
`mongot_system_cpu_count`	Medidor	contar	Processadores disponíveis para a JVM.
`mongot_system_cpu_usage`	Medidor	0-1	Uso recente da CPU do sistema. O valor é normalizado para uma faixa de 0 a 1, onde 1 representa a utilização total da CPU.
`mongot_system_load_average_1m`	Medidor	sem unidade	Média de carga do SO 1minutos.

Disk

Métrica	Tipo	unidade	Descrição
`mongot_system_disk_space_data_path_free_bytes`	Medidor	bytes	Libere espaço em disco no volume `mongot` `dataPath`. Alerta sobre esta métrica.
`mongot_system_disk_space_data_path_total_bytes`	Medidor	bytes	Espaço total em disco no volume `dataPath`. Use para calcular o % livre.
`mongot_system_disk_space_free_bytes`, `mongot_system_disk_space_total_bytes`	Medidor	bytes	Espaço em disco livre e total em todo o sistema de arquivos (escopo diferente de `data_path`).
`mongot_system_disk_readBytes_bytes`	Medidor	bytes	Bytes lidos do disco por dispositivo. Rótulo: `name=<device>` (por exemplo, `/dev/vda`).
`mongot_system_disk_writeBytes_bytes`	Medidor	bytes	Bytes gravados por dispositivo.
`mongot_system_disk_reads_events`	Medidor	contar	Contagem de E/S de leitura por dispositivo. Use `rate()` para IOPS de leitura.
`mongot_system_disk_writes_events`	Medidor	contar	Gravar contagem de E/S por dispositivo.
`mongot_system_disk_currentQueueLength_tasks`	Medidor	contar	Comprimento da fila de disco (E/S em andamento) por dispositivo.
`mongot_system_disk_transferTime_ms`	Medidor	Milissegundos	Tempo gasto lendo ou escrevendo por dispositivo.

Memória

Métrica	Tipo	unidade	Descrição
`mongot_system_memory_phys_total_bytes`	Medidor	bytes	Memória física total no host.
`mongot_system_memory_phys_available_bytes`	Medidor	bytes	Memória física disponível.
`mongot_system_memory_phys_inUse_bytes`	Medidor	bytes	Memória física em uso.
`mongot_system_memory_virt_inUse_bytes`	Medidor	bytes	Memória física e virtual total em 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 troca.
`mongot_system_memory_virt_swap_pagesIn_operations`, `mongot_system_memory_virt_swap_pagesOut_operations`	Medidor	contar	Atividade de troca de entrada/saída.
`mongot_system_memory_memoryMappings_objects`	Medidor	contar	Número de mapeamentos de memória (relevante para contagens de mmap do Lucene).
`mongot_system_memory_pageSize_bytes`	Medidor	bytes	Tamanho da página do sistema.

Falhas na página

Métrica	Tipo	unidade	Descrição
`mongot_system_process_majorPageFaults_operations`	Medidor	contar	Falhas de página principais. Use esta métrica com o limite consultivo da classe de armazenamento.
`mongot_system_process_minorPageFaults_operations`	Medidor	contar	Falhas de página menores.

Rede

Métrica	Tipo	unidade	Descrição
`mongot_system_netstat_bytesRecv_bytes`, `mongot_system_netstat_bytesSent_bytes`	Medidor	bytes	Bytes recebidos e enviados por interface (`name=eth0`).
`mongot_system_netstat_packetsRecv_events`, `mongot_system_netstat_packetsSent_events`	Medidor	contar	Pacotes recebidos e enviados.
`mongot_system_netstat_inErrors_events`, `mongot_system_netstat_outErrors_events`, `mongot_system_netstat_inDrops_events`, `mongot_system_netstat_collisions_events`	Medidor	contar	Contadores de erro, descarte e colisão.
`mongot_system_netstat_speed`	Medidor	bits/seg	Velocidade da interface negociada.

Métricas de replicação

Use métricas de replicação para determinar se mongot está saudável, sincronizando normalmente e acompanhando mongod.

Estado geral

Métrica	Tipo	unidade	Descrição
`mongot_replication_manager`	Medidor	0/1	`1` quando o gerente de replicação estiver ativo.
`mongot_replication_mongodb_manager`	Medidor	0/1	`1` quando o gerenciador de replicação com suporte do MongoDB estiver ativo. Rótulo: `type=normal`.
`mongot_replicationIndexManager_transitionState_total`	Contador	contar	Transições de estado. Rótulos: `fromState`, `toState`. Use para detectar ressincronizações (transições de `INITIALIZING` para `STEADY_STATE`).

Atualizador de sessão

Métrica	Tipo	unidade	Descrição
`mongot_replication_sessionRefresher_sessions`	Medidor	contar	Sessões ativas.
`mongot_replication_sessionRefresher_refreshes_total`	Contador	contar	Total de atualizações de sessão.
`mongot_replication_sessionRefresher_failedSessionRefreshes_total`	Contador	contar	Atualizações com falha.
`mongot_replication_sessionRefresher_sessionRefreshDurations_seconds`	Resumo	Segundos	Distribuição da duração da atualização.

Atualizador de optime

Métrica	Tipo	unidade	Descrição
`mongot_replicationOptimeUpdaterError_total`	Contador	contar	Erros de atualizar de optime.
`mongot_replicationOptimeUpdater_executor_*`	vários	N/A	Métricas do executor para o atualizador optime.

Per-index Metrics

mongot emite as seguintes métricas por índice e inclui rótulos generationId_logString e indexId_logString para identificar o índice específico. Filtre por esses rótulos para inspecionar um índice específico ou agregue rótulos para entender o comportamento de toda a frota.

Status e tamanho do índice

Métrica	Tipo	unidade	Descrição
`mongot_index_stats_indexStatusCode`	Medidor	0/1	Status por índice. Codificado em um único valor nos valores de rótulo `status`: `STEADY`, `INITIAL_SYNC`, `FAILED`, `RECOVERING_NON_TRANSIENT`, `RECOVERING_TRANSIENT`, `STALE`, `NOT_STARTED`, `DOES_NOT_EXIST`, `UNKNOWN`.
`mongot_index_stats_indexFeatureVersion`	Medidor	número	Versão do formato de índice em disco. Por exemplo, `3`.
`mongot_index_stats_indexSizeBytes`	Medidor	bytes	Tamanho total do índice em disco.
`mongot_index_stats_largestIndexFileSizeBytes`	Medidor	bytes	Maior arquivo único no índice.
`mongot_index_stats_numFilesInIndex`	Medidor	contar	Número de arquivos de segmento Lucene.
`mongot_index_stats_numLuceneDocs`	Medidor	contar	Documentos Lucene no índice.
`mongot_index_stats_numLuceneMaxDocs`	Medidor	contar	ID máximo do documento Lucene (inclui excluído-não-mesclado).
`mongot_index_stats_numLuceneFields`	Medidor	contar	Número de campos Lucene indexados.
`mongot_index_stats_segment_count`	Medidor	contar	Número de segmentos Lucene.
`mongot_index_stats_requiredMemoryBytes`	Medidor	bytes	Memória necessária estimada para o índice.

Métricas de indexação

Métrica	Tipo	unidade	Descrição
`mongot_index_stats_indexing_replicationLagMs`	Medidor	Milissegundos	Atraso de replicação por índice, em milissegundos. A unidade está no nome da métrica (`Ms`). Não divida por 1000 no PromQL, a menos que você queira converter para segundos.
`mongot_index_stats_indexing_replicationOpTime`	Medidor	Carimbo de data/hora BSON	Última replicação aplicada optime (codificação numérica).
`mongot_index_stats_indexing_maxPossibleReplicationOpTime`	Medidor	Carimbo de data/hora BSON	Limite de adiantamento, definido pela dica `mongod`.
`mongot_index_stats_indexing_insert_total`, `mongot_index_stats_indexing_update_total` , `mongot_index_stats_indexing_delete_total`	Contador	contar	Contagens de operações de indexação. Rótulo: `indexType=search`.
`mongot_index_stats_indexing_totalBytesProcessed_total`	Contador	bytes	Total de bytes processados pela indexação.
`mongot_index_stats_indexing_vectorFieldsIndexed_total`	Contador	contar	Campos de vetor indexados.
`mongot_index_stats_indexing_commitDurations_seconds`	Resumo	segundos (`timeUnit=milliseconds`)	Durações de confirmação por índice.
`mongot_index_stats_indexing_indexingBatchDurations_seconds`	Resumo	Segundos	Distribuição da duração do lote.
`mongot_index_stats_indexing_largeChangeStreamEvents_total`	Contador	contar	Eventos de fluxo de alterações superdimensionados. Rótulo: `threshold=10MiB\|12MiB\|14MiB\|15MiB`.
`mongot_index_stats_indexing_invalidGeometryField_total`	Contador	contar	Documentos rejeitados por geometria inválida.
`mongot_index_stats_indexing_sortableStringTruncated_total`	Contador	contar	Strings classificáveis truncadas.
`mongot_index_stats_indexing_initialSyncExceptions_total`	Contador	contar	Exceções durante a sincronização inicial.
`mongot_index_stats_indexing_steadyStateExceptions_total`	Contador	contar	Exceções de estado estacionário.
`mongot_index_stats_indexing_consecutiveInitialSyncResyncExceptions`	Medidor	contar	Exceções consecutivas de ressincronização de sincronização inicial para este índice.

Métricas de query

Métrica	Tipo	unidade	Descrição
`mongot_index_stats_query_totalQueries_total`	Contador	contar	Total de query emitidas contra o índice.
`mongot_index_stats_query_totalHitsCount_total`	Contador	contar	Total de hits retornados.
`mongot_index_stats_query_failedQueries_total`	Contador	contar	Consultas que falharam.
`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	contar	Contadores de classe de falha específicos.
`mongot_index_stats_query_searchResultBatchLatencies_seconds`	Resumo	segundos (`timeUnit=milliseconds`)	Latência de lote de pesquisa. Esta é a métrica de latência de query principal.
`mongot_index_stats_query_luceneTopDocsSearchLatencies_seconds`	Resumo	segundos (`timeUnit=milliseconds`)	Latência dentro da pesquisa TopDocs do Lucene. Use essa métrica para distinguir a latência interna do Lucene da latência total.
`mongot_index_stats_query_vectorResultLatencies_seconds`	Resumo	segundos (`timeUnit=milliseconds`)	Latência do resultado da pesquisa vetorial.
`mongot_index_stats_query_vectorSearchInitialTopDocsLatencyTimer_seconds`, `mongot_index_stats_query_vectorSearchGetMoreTopDocsLatencyTimer_seconds`	Resumo	segundos (`timeUnit=milliseconds`)	Fases de latência da pesquisa vetorial.
`mongot_index_stats_query_tokenFacetsStateRefreshLatency_seconds`	Resumo	segundos (`timeUnit=milliseconds`)	Latência de atualização de estado de facetas.
`mongot_index_stats_query_batchDataSize`, `mongot_index_stats_query_batchDocumentCount`	Resumo	bytes / contagem	Tamanho do payload por lote e contagem de documentos.
`mongot_index_stats_query_limitPerQuery`	histograma	contagem (`le=10\|50\|100\|200\|500\|1000\|+Inf`)	Distribuição de `$search` e `$vectorSearch` limites.
`mongot_index_stats_query_numCandidatesPerQuery`	histograma	contar	Candidatos vetoriais por query, agrupados por quantização.
`mongot_index_stats_query_getMoreCommandCalls_total`, `mongot_index_stats_query_getMoreCommandCallsPerQuery`	contador / resumo	contar	`getMore` contagens de chamadas.
`mongot_index_stats_query_batchWithTies_total`	Contador	contar	Lotes de resultados com empates de pontuação.
`mongot_index_stats_query_benefitFromIndexSortCount_total`	Contador	contar	Query que se beneficiaram da otimização de ordenação indexada.
`mongot_index_stats_query_extractableLimitQueries_total`, `mongot_index_stats_query_extractableLimitSecondBatchQueries_total`	Contador	contar	Otimizações de extração de limite acionadas.
`mongot_index_stats_query_phantomSearcherCleanupCount_total`	Contador	contar	Limpezas de pesquisadores fantasmas.
`mongot_index_stats_query_orphanedDeletedDocsRatio`	Resumo	proporção	Proporção de documentos excluídos nos resultados retornados.
`mongot_index_stats_query_noProgressBatches_total`	Contador	contar	Lotes que não fizeram progresso.
`mongot_index_stats_query_vectorCommandCalls_total`, `mongot_index_stats_query_vectorRescoringFailureCount_total` , `mongot_index_stats_query_vectorSearchQueriesOverSearchIndexes_total`	Contador	contar	Contadores específicos de vetor.
`mongot_index_stats_query_feature_total`	Contador	contar	Uso de recursos por query. Rótulo: `name=<feature>`. Por exemplo, `compound`, `text`, `phrase`, `near`, `vectorSearch`, `knnBeta`, `autoEmbedding` (somente quando o embedding automatizado está ativado).
`mongot_index_stats_query_failedExplainQueryAggregate_total`	Contador	contar	Agregados `$explain` com falha.

Detalhes da replicação por índice

Métrica	Tipo	unidade	Descrição
`mongot_replication_mongodb_indexManagerState`	Medidor	0/1	O sinal canônico de estado de replicação. `mongot` codifica essa métrica, o que significa que exatamente um rótulo `state` é `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`	Resumo	bytes / contagem	Tamanhos de lote de estado estacionário.
`mongot_index_stats_replication_steadyState_decodingBatchDurations_seconds`	Resumo	Segundos	Duração de decodificação de estado estacionário.
`mongot_index_stats_replication_steadyState_getMoreDurations_seconds`	Resumo	Segundos	Duração do `getMore` em estado estacionário.
`mongot_index_stats_replication_initialSync_changeStream_*`	Resumo	—	Métricas da fase de fluxo de alterações de sincronização inicial (espelha o estado estável).
`mongot_index_stats_replication_initialSync_collScan_*`	Resumo	—	Métricas da fase de varredura de coleção de sincronização inicial.

Latência de atualização do Lucene

Métrica	Tipo	unidade	Descrição
`mongot_index_stats_luceneIndexRefresher_refreshDurations_seconds`	Resumo	segundos (`timeUnit=milliseconds`)	Latência de atualização do Lucene IndexReader.

Métricas de comando

mongot aceita o seguinte conjunto de comandos nomeados de mongod:

buildinfo
getMore
hello
isMaster
ismaster
killCursors
manageSearchIndex
ping
planShardedSearch
search
vectorSearch

Para cada comando, o mongot expõe as seguintes métricas, onde <name> é um espaço reservado para o nome do comando:

Padrão	Tipo	Descrição
`mongot_command_<name>CommandFailure_total`	Contador	Contagem de falhas para o comando.
`mongot_command_<name>CommandTotalLatency_seconds`	Resumo	Latência de ponta a ponta, incluindo serialização.
`mongot_command_<name>CommandSerializationLatency_seconds`	Resumo	Latência de serialização (subconjunto; nem todos os comandos).

Dica

Monitorar a latência de pesquisa e a pesquisa vetorial entre índices

mongot_command_searchCommandTotalLatency_seconds e mongot_command_vectorSearchCommandTotalLatency_seconds são as métricas primárias a serem monitoradas para agregações de latência $search e $vectorSearch. Eles expõem agregações de latência para todos os comandos search e vectorSearch em todos os índices.

Métricas do agendador e do dispatcher de indexação

Use métricas de agendador e dispatcher de indexação para identificar atrasos, saturação e trabalho lento em pipelines de replicação e indexação.

Pipeline de fluxo de alterações em estado estacionário

Métrica	Tipo	unidade	Descrição
`mongot_indexing_steadyStateChangeStream_batchesInProgressTotal`	Medidor	contar	Lotes atualmente sendo aplicados. Rótulo: `indexType=search\|vector_search\| vector_search_auto_embedding` (somente quando você habilita o Automated Embedding).
`mongot_indexing_steadyStateChangeStream_batchesInProgressTotalDurations_seconds`	Resumo	Segundos	Distribuição de duração para lotes em andamento.
`mongot_indexing_steadyStateChangeStream_getMoreDurations_seconds`	Resumo	Segundos	`getMore` distribuição de ida e volta.
`mongot_indexing_steadyStateChangeStream_getMoresInFlight`	Medidor	contar	`getMore` solicitações em andamento.
`mongot_indexing_steadyStateChangeStream_getMoresScheduled`	Medidor	contar	Solicitações `getMore` agendadas por `indexType`.
`mongot_indexing_steadyStateChangeStream_getMoresSchedulingDurations_seconds`	Resumo	Segundos	`getMore` latência de agendamento.
`mongot_indexing_steadyStateChangeStream_preprocessingBatchDurations_seconds`	Resumo	Segundos	Duração de pré-processamento por lote.
`mongot_indexing_steadyStateChangeStream_witnessedChangeStreamUpdates_total`	Contador	contar	Total de eventos de fluxo de alterações observados. Rótulo: `Scope=replication`.
`mongot_indexing_steadyStateChangeStream_applicableChangeStreamUpdates_total`	Contador	contar	Eventos que `mongot` considerou aplicáveis.
`mongot_indexing_steadyStateChangeStream_dispatcher`	Medidor	0/1	Status do dispatcher. Rótulos: `Scope=replication`, `client=synchronous-batch`.
`mongot_indexing_steadyStateChangeStream_skippedChangeStreamDocumentsWithoutMetadataNamespace_total`	Contador	contar	Eventos ignorados devido a metadados ausentes.
`mongot_indexing_steadyStateChangeStream_unexpectedBatchFailures_total`	Contador	contar	Falhas inesperadas no lote.
`mongot_indexing_steadyStateChangeStream_rescheduledEmbeddingGetMores_total`	Contador	contar	getMores de embedding reprogramados. Essa métrica só está disponível quando você configura o Automated Embedding.
`mongot_indexing_changeStreamModeSelector_failedSamplingAttemptsCounter_total`	Contador	contar	Falha nas tentativas de amostragem do modo de fluxo de alterações.

Agendador de trabalho de indexação

As métricas do agendador de trabalho de indexação monitoram o enfileiramento e a execução de lotes de indexação.

Métrica	Tipo	unidade	Descrição
`mongot_indexingWorkScheduler_queuedBatchesTotal`, `mongot_indexingWorkScheduler_queuedEventsTotal`	Medidor	contar	Profundidade da fila do agendador.
`mongot_indexingWorkScheduler_enqueueCalls_total`, `mongot_indexingWorkScheduler_dequeueCalls_total`	Contador	contar	Contagens de enfileiramento e desenfileiramento.
`mongot_indexingWorkScheduler_indexingBatchDistribution`	Resumo	contar	Distribuição de tamanhos de lote. Rótulo: `Scope=replication`.
`mongot_indexingWorkScheduler_indexingBatchDurations_seconds`	Resumo	Segundos	Durações de lote.
`mongot_indexingWorkScheduler_indexingBatchSchedulingDurations_seconds`	Resumo	Segundos	Sobrecarga de agendamento.

Decodificando o agendador de trabalho

As métricas do agendador de trabalho de decodificação monitoram o enfileiramento e a execução da decodificação em lote do fluxo de alterações.

Métrica	Tipo	unidade	Descrição
`mongot_decodingWorkScheduler_queuedBatchesTotal`, `mongot_decodingWorkScheduler_queuedEventsTotal`	Medidor	contar	Profundidade da fila do agendador.
`mongot_decodingWorkScheduler_enqueueCalls_total`, `mongot_decodingWorkScheduler_dequeueCalls_total`	Contador	contar	Contagens de enfileiramento e desenfileiramento.
`mongot_decodingWorkScheduler_decodingBatchDistribution`	Resumo	contar	Distribuição de tamanhos de lote. Rótulo: `Scope=replication`.
`mongot_decodingWorkScheduler_decodingBatchDurations_seconds`	Resumo	Segundos	Durações de lote.
`mongot_decodingWorkScheduler_decodingBatchSchedulingDurations_seconds`	Resumo	Segundos	Sobrecarga de agendamento.

Sincronização inicial, ciclo de vida e métricas de configuração

Use essas métricas para acompanhar o trabalho de inicialização do índice, a recuperação e o estado do catálogo.

Sincronização inicial

Observação

Algumas métricas mongot são específicas da fase e só são preenchidas quando o caminho de código correspondente está ativo. Por exemplo, métricas de replicação de estado estável, como mongot_index_stats_indexing_replicationLagMs e a série mongot_index_stats_replication_steadyState_*, não são preenchidas enquanto um índice está em sincronização inicial. Por outro lado, as métricas específicas da sincronização inicial, como mongot_initialsync_* e mongot_index_stats_replication_initialSync_*, só são relevantes enquanto a sincronização inicial está em execução ou foi executada.

Métrica	Tipo	unidade	Descrição
`mongot_initialsync_queue_queuedSyncs`	Medidor	contar	Sincronização inicial na fila. Rótulo: `indexType`.
`mongot_initialsync_queue_requeuedEmbeddingInitialSyncs_total`	Contador	contar	Embedding sincronizações iniciais que foram requeued. Essa métrica só está disponível quando você configura o Automated Embedding.
`mongot_initialsync_dispatcher_inProgressSyncs`	Medidor	contar	Sincronizações iniciais em andamento. Rótulo: `indexType`.
`mongot_initialsync_dispatcher_queuedSyncs`	Medidor	contar	Sincronizações iniciais enfileiradas no dispatcher.
`mongot_initialsync_dispatcher_inProgressResumedSyncs`	Medidor	contar	Sincronizações em andamento que foram retomadas a partir de um checkpoint.
`mongot_initialsync_dispatcher_collectionScan`	Medidor	0/1	Modo de varredura de coleção ativo. Rótulo: `scan_type=id_order\|natural_order`.
`mongot_initialsync_dispatcher_completedSyncDuration_seconds`	Resumo	Segundos	Distribuição de duração de sincronização concluída.
`mongot_initialsync_dispatcher_syncDuration_seconds`	Resumo	Segundos	Duração da sincronização em andamento.
`mongot_initialsync_dispatcher_inProgressInitialSyncDurationMin_seconds`, `mongot_initialsync_dispatcher_inProgressInitialSyncDurationMax_seconds` , `mongot_initialsync_dispatcher_inProgressInitialSyncDurationSum_seconds`	Medidor	Segundos	Mínimo, máximo e soma das durações de sincronização inicial em andamento.
`mongot_initialsync_dispatcher_unreadableDroppedIndexes_total`	Contador	contar	Descartados porque seus segmentos em disco não puderam ser lidos.
`mongot_initialsync_dispatcher_unreadableIndexRecoveries_total`	Contador	contar	Recuperado após segmentos ilegíveis. Rótulo: `unreadableIndexCause=corruptIndex\|incompatibleCodec\| incompatibleIndexFormat`.

Ciclo de vida

Métrica	Tipo	unidade	Descrição
`mongot_lifecycle_indexesInInitializedState`	Medidor	contar	Índice atualmente no estado inicializado.
`mongot_lifecycle_indexInitializationDuration_seconds`	Resumo	Segundos	Durações de inicialização.
`mongot_lifecycle_failedDownloadIndexes_total`	Contador	contar	Índice baixares que falharam.
`mongot_lifecycle_failedDropIndexes_total`	Contador	contar	Descartar índices que falharam.
`mongot_lifecycle_failedInitializationIndexes_total`	Contador	contar	Inicializações de índice que falharam.

Estado da configuração

Métrica	Tipo	unidade	Descrição
`mongot_configState_indexesInCatalog`	Medidor	contar	Índices atualmente no catálogo. Rótulos: `Scope=replication`, `indexFormatVersion`.
`mongot_configState_indexesPhasingOut`	Medidor	contar	Índices sendo eliminados gradualmente.
`mongot_configState_stagedIndexes`	Medidor	contar	Índices preparados, mas ainda não ativos.
`mongot_configState_indexesInCatalogFeatureVersionFour`, `mongot_configState_indexesPhasingOutFeatureVersionFour` , `mongot_configState_stagedIndexesFeatureVersionFour`	Medidor	contar	Equivalentes específicos da versão do recurso4.

Cursores e fábrica de índices

Use essas métricas para monitorar o estado do cursor aberto e para detectar índices que mongot descartaram ou recuperaram porque seus segmentos em disco não puderam ser lidos.

Métrica	Tipo	unidade	Descrição
`mongot_cursorManager_trackedCursors`	Medidor	contar	cursor abertos atualmente rastreados.
`mongot_indexFactory_unreadableDroppedIndexes_total`	Contador	contar	Índices descartados porque seus segmentos não eram legíveis.
`mongot_indexFactory_unreadableIndexRecoveries_total`	Contador	contar	Recuperações após segmentos ilegíveis. Rótulo: `unreadableIndexCause`.

Mesclagem do Lucene

Use essas métricas para monitorar a atividade de mesclagem de segmentos do Lucene, incluindo o número e o tamanho das mesclagens em andamento, os tamanhos de entrada e saída de mesclagem, as durações de mesclagem e as mesclagens descartadas pela política de mesclagem de utilização de disco.

Métrica	Tipo	unidade	Descrição
`mongot_mergeScheduler_currentlyRunningMerges`	Medidor	contar	Mesclagens ativas. Rótulo: `Scope=lucene`.
`mongot_mergeScheduler_currentlyMergingDocs`	Medidor	contar	Documentos atualmente sendo mesclados.
`mongot_mergeScheduler_numMerges_total`	Contador	contar	Total de mesclagens executadas desde a inicialização.
`mongot_mergeScheduler_numSegmentsMerged_total`	Contador	contar	Segmentos dobrados por mesclagens.
`mongot_mergeScheduler_mergeSize`	Resumo	bytes	Distribuição dos tamanhos de entrada de mesclagem.
`mongot_mergeScheduler_mergeResultSize`	Resumo	bytes	Distribuição dos tamanhos de saída de mesclagem.
`mongot_mergeScheduler_mergedDocs`	Resumo	contar	Distribuição de documentos por mesclagem.
`mongot_mergeScheduler_mergeTime_seconds`	Resumo	Segundos	Distribuição da duração da mesclagem.
`mongot_diskUtilizationAwarenessMergePolicy_discardedMerge_total`	Contador	contar	Mesclagens descartadas pela política com reconhecimento de utilização de disco.

Métricas do pool de conexões do cliente MongoDB

mongot abre vários pools de conexões nomeados para mongod e rotula cada pool com um rótulo clientName que identifica a função de cada pool. A tabela a seguir lista os possíveis valores de rótulo clientName e sua função correspondente:

clientName	Propósito
`mongot steady state sync`	Replicação de fluxo de alterações de estado estacionário.
`mongot initial sync and session refresh`	Sincronização inicial e atualização da sessão. O `appName` visto em `mongod` `currentOp`.
`mongot metadata service`	Serviço de metadados interno.
`mongot periodic optime fetcher`	Pesquisa de optime.
`mongot database metadata resolver`	Pesquisas de metadados do banco de dados.
`mongot server info resolver`	Pesquisas de informações do servidor.
`mongot Lease Manager mongo client`	Gerente de aluguel.
`mongot AutoEmbedding Materialized View Writer`	Gravações de embedding automatizadas. Esse pool de conexões só aparece quando você configura o embedding automatizado.

A tabela a seguir lista as métricas disponíveis para pools de conexões mongot:

Métrica	Tipo	unidade	Descrição
`mongot_mongoClient_connectionPool_connections`	Medidor	contar	Conexões abertas atualmente no pool.
`mongot_mongoClient_connectionPool_connectionsCheckedOut`	Medidor	contar	Conexões atualmente verificadas.
`mongot_mongoClient_connectionPool_maxSize`	Medidor	contar	maxPoolSize configurado.
`mongot_mongoClient_connectionPool_minSize`	Medidor	contar	Tamanho mínimo do pool configurado.
`mongot_mongoClientBuilder_successfulOpenSSLDynamicLinking_total`	Contador	contar	Tentativas bem-sucedidas de link nativo do OpenSSL.
`mongot_mongoClientBuilder_failedOpenSSLDynamicLinking_total`	Contador	contar	Falha nas tentativas de link nativo do OpenSSL.

Sinônimos

Use essas métricas para monitorar a atividade de sincronização de sinônimos, incluindo varreduras de coleção, durações de varredura e sincronização, profundidade da fila e exceções encontradas durante a sincronização de sinônimos.

Métrica	Tipo	unidade	Descrição
`mongot_synonymSync_collScans_total`	Contador	contar	Varreduras de coleção totais realizadas para sinônimos.
`mongot_synonymSync_collScansTriggeredByChangeStream_total`	Contador	contar	Verificações de sinônimos acionadas por eventos de fluxo de alterações.
`mongot_synonymSync_collScanDurations_seconds`	Resumo	Segundos	Distribuição da duração da verificação.
`mongot_synonymSync_syncDurations_seconds`	Resumo	Segundos	Distribuição da duração da sincronização.
`mongot_synonymSync_queueDepth`	Medidor	contar	Profundidade atual da fila de sincronização de sinônimos.
`mongot_synonymSync_exceptions_total`	Contador	contar	Exceções de sincronização.

Pools de executores

Use essas métricas para monitorar os pools de executores nomeados que o mongot usa para executar o trabalho em segundo plano. Cada pool expõe o mesmo conjunto de submétricas, prefixadas com o nome do pool, para que você possa acompanhar a atividade do thread, o dimensionamento do pool, a profundidade da fila, a taxa de transferência de tarefas e o tempo de execução por tarefa em todos os pools.

A tabela a seguir lista as submétricas que cada pool de executor expõe, onde <pool> é o prefixo do nome do pool. Todas as submétricas do pool de executor carregam o rótulo name="executorMetrics".

Sufixo de submétrica	Tipo	Descrição
`<pool>_active_threads`	Medidor	Threads executando tarefas no momento.
`<pool>_pool_core_threads`, `<pool>_pool_max_threads` , `<pool>_pool_size_threads`	Medidor	Dimensionamento do pool.
`<pool>_queued_tasks`	Medidor	Tarefas aguardando um thread — o sinal de saturação.
`<pool>_queue_remaining_tasks`	Medidor	Capacidade restante da fila.
`<pool>_completed_tasks_total`	Contador	Tarefas concluídas desde a inicialização.
`<pool>_idle_seconds`	Resumo	Tempo de threads ociosas entre tarefas.
`<pool>_seconds`	Resumo	Tempo de execução por tarefa.
`<pool>_scheduled_once_total`, `<pool>_scheduled_repetitively_total`	Contador	Contagens de tarefas agendadas (para pools de agendamento).

A tabela a seguir lista os prefixos para todos os pools de executores nomeados disponíveis e seus respectivos propósitos:

Prefixo do pool do executor	O que ele executa
`mongot_blobstore_lifecycle_executor`	Trabalho do ciclo de vida do armazenamento de blobs.
`mongot_blocking_server_worker_executor`	Bloqueando threads de trabalho do servidor gRPC.
`mongot_change_stream_mode_selector_executor`	Seleção do modo de stream de alterações.
`mongot_change_stream_sync_dispatcher_executor`	Despacho de sincronização de fluxo de alteração (um dos mais movimentados em estado estacionário).
`mongot_config_monitor_executor`	Sondagem de monitoramento de configuração.
`mongot_decoding_executor`	Decodificação de workers de pipeline.
`mongot_disk_monitor_executor`	Sondagem do monitor de disco.
`mongot_grpc_health_check_executor`	Temporizador de verificação de integridade gRPC.
`mongot_idle_cursor_killer_executor`	Coleta de cursores ociosos.
`mongot_index_commit_executor`	Operações de confirmação de índice.
`mongot_index_lifecycle_executor`	Trabalho de ciclo de vida por índice.
`mongot_index_refresh_executor`	Atualizações do Lucene IndexReader.
`mongot_indexing_work_executor`	Trabalhadores de pipeline de indexação (o pool de indexação mais movimentado em estado estável).
`mongot_indexing_lifecycle_executor`	Trabalho de ciclo de vida de indexação.
`mongot_indexing_auto_embedding_executor`	Caminho de indexação de embedding automatizado. Esse pool de executores só aparece quando você configura o Automated Embedding.
`mongot_init_lifecycle_executor`	Trabalho do ciclo de vida do tempo de inicialização.
`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`	Rastreamento e ciclo de vida de visualizações materializadas. Essas métricas só estão disponíveis quando o Automated Embedding ou outros recursos com suporte de visualizações materializadas estão configurados.
`mongot_replicationOptimeUpdater_executor`	Atualizador de optime (segundo plano).
`mongot_session_refresh_executor`	Atualizador de sessão.
`mongot_system_metrics_updater_executor`	Atualizador de métricas do sistema.

Dica

Assista à saturação em todos os pools de executor

Para monitorar a saturação em todos os pools de executores, execute a seguinte query PromQL:

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

Esta query retorna a contagem de tarefas enfileiradas para cada pool de executor.

Prometheus Server Self-Metrics

A métrica a seguir está disponível para o servidor Prometheus incorporado em mongot:

Métrica	Tipo	unidade	Descrição
`mongot_prometheus_server_scraping_timer_seconds`	Resumo	segundos (`timeUnit=milliseconds`)	Quanto tempo `mongot` leva para montar uma resposta `/metrics`. O crescimento sustentado aqui significa que a própria exposição métrica está diminuindo.

Métricas específicas da configuração

As seguintes famílias de métricas aparecem na saída /metrics somente quando você habilita recursos específicos.

Família de métricas	Descrição	Disponibilidade em autogerenciado `mongot`
`mongot_embedding`	Métricas relacionadas ao embedding automatizado. Por exemplo, `mongot_initialsync_queue_requeuedEmbeddingInitialSyncs_total`, `mongot_materialized_view_lifecycle_executor` e entradas de pool de conexões com `clientName="mongot AutoEmbedding Materialized View Writer"`.	Aparecem somente quando você configura o Automated Embedding.
`mongot_mongot_ftdc_executor_failure_total`	Contagem de falhas para o executor FTDC.	Aparece somente quando você habilita o sinalizador de recurso `ftdcExecutorMetricsToPrometheus`.

Exemplo de PromQL

A maioria das métricas de latência neste catálogo são resumos, não histogramas, portanto, use seus rótulos quantile publicados diretamente quando existirem. Um número menor de métricas, como mongot_index_stats_query_limitPerQuery e mongot_index_stats_query_numCandidatesPerQuery, são histogramas e expõem _bucket séries.

# 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]))

Voltar

Configurar monitoramento para nova implantação

Logs do mongot e FTDC