Configurar mongot

Utilice un archivo de configuración YAML para configurar mongot para las implementaciones de MongoDB Search y búsqueda vectorial.

Tip

Para las implementaciones de MongoDB Controllers para Kubernetes Operator, puede usar el recurso personalizado MongoDBSearch para configurar mongot. Para obtener más información, consulte MongoDBSearch.

El siguiente ejemplo muestra la estructura de configuración completa con todas las configuraciones disponibles para implementación autogestionada de mongot con MongoDB Community:

syncSource:
   replicaSet: <object>
      hostAndPort: <string or list of strings>
      x509: <object>
         caFile: <string>
         tlsCertificateKeyFile: <string>
         tlsCertificateKeyFilePasswordFile: <string>
      scramAuth: <object>
         username: <string>
         passwordFile: <string>
         authSource: <string>
         tls: <object>
            enabled: <boolean>
            caFile: <string>
            tlsCertificateKeyFile: <string>
            tlsCertificateKeyFilePasswordFile: <string>
   router: <object>
      hostAndPort: <string or list of strings>
      x509: <object>
         caFile: <string>
         tlsCertificateKeyFile: <string>
         tlsCertificateKeyFilePasswordFile: <string>
      scramAuth: <object>
         username: <string>
         passwordFile: <string>
         authSource: <string>
         tls: <object>
            enabled: <boolean>
            caFile: <string>
            tlsCertificateKeyFile: <string>
            tlsCertificateKeyFilePasswordFile: <string>
   replicationReader:
      readPreference: <string>
      tagSets: <string or list of strings>
storage: <object>
   dataPath: <string>
server: <object>
   grpc: <object>
      address: <string>
      tls: <object>
         mode: <string>
         certificateKeyFile: <string>
         certificateKeyFilePasswordFile: <string>
         caFile: <string>
   name: <string>
metrics: <object>
   enabled: <boolean>
   address: <string>
healthCheck: <object>
   address: <string>
logging: <object>
   verbosity: <string>
   logPath: <string>
embedding:
   providerEndpoint: <string>
   queryKeyFile: <string>
   indexingKeyFile: <string>
   isAutoEmbeddingViewWriter: <boolean>
advancedConfigs: <object>
   indexing: <object>
      lucene: <object>
         refresh: <object>
            intervalMs: <int>
         mergePolicy: <object>
            tiered: <object>
               vectorMergePolicy: <object>
                  mergeBudgetMb: <int>
         mergeScheduler: <object>
            concurrent: <object>
               maxThreadCount: <int>
         fieldLimit: <int>
   querying: <object>
      lucene: <object>
         maxClauseLimit: <int>
         vectorFloorSegmentMB: <double>
   replication: <object>
      mongodb: <object>
         numConcurrentInitialSyncs: <int>
         numConcurrentChangeStreams: <int>
         numIndexingThreads: <int>
         numConcurrentSynonymSyncs: <int>
         pauseAllInitialSyncs: <boolean>
         pauseInitialSyncOnIndexIds: <list of strings>
         changeStreamMaxTimeMs: <int>
         changeStreamCursorMaxTimeSec: <int>
         numChangeStreamDecodingThreads: <int>
      initialSync: <object>
         bufferless: <object>
            enableNaturalOrderScan: <boolean>
   diskMonitor: <object>
      pauseReplicationThreshold: <double>
      resumeReplicationThreshold: <double>
      crashThreshold: <double>
      pauseInitialSyncThreshold: <double>
      resumeInitialSyncThreshold: <double>
   autoEmbedding: <object>
      materializedView: <object>
         numConcurrentChangeStreams: <int>
         numIndexingThreads: <int>
         numEmbeddingThreads: <int>
         numConcurrentInitialSyncs: <int>
         matViewWriterMaxConnections: <int>
         mvWriteRateLimitRps: <int>
         embeddingProviderRpsLimit: <int>
         maxInFlightEmbeddingGetMores: <int>
         embeddingGetMoreBatchSize: <int>
         changeStreamMaxTimeMs: <int>
         changeStreamCursorMaxTimeSec: <int>
         numChangeStreamDecodingThreads: <int>
         requestRateLimitBackoffMs: <int>
         globalMemoryBudgetHeapPercent: <int>
         perBatchMemoryBudgetHeapPercent: <int>
   cursor: <object>
      idleCursorHandlingRateMs: <int>
      cursorIdleTimeMs: <int>
   ftdc: <object>
      enabled: <boolean>
      directorySizeMb: <int>
      fileSizeMb: <int>
      collectionPeriodMillis: <int>

Configuraciones requeridas

En esta sección se describen las configuraciones necesarias para todas las implementaciones de mongot. Si solo define las configuraciones necesarias, mongot utiliza los valores por defecto para todas las configuraciones opcionales.

syncSource.replicaSet

Tipo: Objeto

Conexiones de replicación a mongod para mongot.

syncSource.replicaSet.hostAndPort

Tipo: string o lista de strings

Uno o más especificadores de host y puerto utilizados para construir la lista de nodos iniciales en la cadena de conexión mongod. Independientemente de la cantidad de especificadores proporcionados, mongot establece la conexión en modo de set de réplicas, no en modo autónomo.

storage.dataPath

Tipo: string

Ruta que mongot debe utilizar como ruta base para almacenar datos de índice y el catálogo local de índices.

server

Tipo: Objeto

Configuración de los servidores de query mongot.

server.grpc

Tipo: Objeto

Configuración del servidor de escucha para la comunicación gRPC entre mongot y mongod.

server.grpc.address

Tipo: string

Dirección en la que el servidor de escucha de gRPC escucha. Utilice el siguiente formato:

<host>:<port>

En las implementaciones autogestionadas, esta dirección debe ser accesible para los procesos mongod que envían tráfico de búsqueda y gestión de índices a mongot. Configúrelo para que coincida con el host y el puerto que mongod utiliza para su configuración mongotHost y searchIndexManagementHostAndPort.

Para el desarrollo de un solo host, localhost es el valor más seguro por defecto. Si mongod y mongot se ejecutan en diferentes host, establezca server.grpc.address en una interfaz a la que mongod pueda acceder.

Advertencia

Dependiendo de la topología del sistema, puede ser necesario vincular el servidor de query mongot a una interfaz accesible desde el clúster de MongoDb. Aunque se permite la vinculación a la dirección IP 0.0.0.0, expone el servidor a todas las redes públicas y conlleva el riesgo de un acceso no autorizado.

Para mejorar la seguridad, considera restringir server.grpc.address a interfaces específicas que estén controladas y protegidas en la capa de red, como localhost u otras direcciones internas confiables.

Configuraciones opcionales

Esta sección describe los ajustes opcionales y los requeridos condicionalmente para mongot. Si omites estos ajustes, mongot utiliza el valor por defecto especificado cuando sea aplicable.

Configuración de autenticación de set de réplicas

syncSource.replicaSet.x509

Tipo: Objeto

Necesidad: Obligatorio si no utiliza syncSource.replicaSet.scramAuth

X.509 configuración de certificado para autenticar mongot con mongod.

syncSource.replicaSet.x509.caFile

Tipo: string

Necesidad: Requerido si utiliza syncSource.replicaSet.x509

Archivo de la Autoridad de Certificación (CA) que contiene certificados de confianza para verificar el certificado presentado por mongod. El archivo debe contener una colección de certificados X.509 en formato PEM.

syncSource.replicaSet.x509.tlsCertificateKeyFile

Tipo: string

Necesidad: Requerido si utiliza syncSource.replicaSet.x509

Ruta al archivo PEM que contiene el certificado X.509 y la llave privada para la autenticación de mongot con mongod. Obligatorio al configurar syncSource.replicaSet.x509.

syncSource.replicaSet.x509.tlsCertificateKeyFilePasswordFile

Tipo: string

Necesidad: Opcional

Ruta al archivo que contiene la contraseña para descifrar el archivo de clave del certificado especificado en syncSource.replicaSet.x509.tlsCertificateKeyFile.

syncSource.replicaSet.scramAuth

Tipo: Objeto

Necesidad: Obligatorio si no utiliza syncSource.replicaSet.x509

Configuración para la autenticación SCRAM.

syncSource.replicaSet.scramAuth.username

Tipo: string

Necesidad: Requerido

El nombre de usuario para autenticarse.

syncSource.replicaSet.scramAuth.passwordFile

Tipo: string

Necesidad: Requerido

Ruta a un archivo que contiene la contraseña para autenticarse.

syncSource.replicaSet.scramAuth.authSource

Tipo: string

Necesidad: Opcional

Por defecto: admin

Nombre de la base de datos asociada con las credenciales de autenticación mongot.

syncSource.replicaSet.scramAuth.tls

Tipo: Objeto

Necesidad: Opcional

Por defecto: false

Configuración de TLS.

syncSource.replicaSet.scramAuth.tls.enabled

Tipo: booleano

Necesidad: Requerido si especifica syncSource.replicaSet.scramAuth.tls

Marca para habilitar la autenticación TLS. Establezca en true para habilitar la autenticación TLS.

syncSource.replicaSet.scramAuth.tls.caFile

Tipo: string

Necesidad: Opcional

syncSource.replicaSet.scramAuth.tls.tlsCertificateKeyFile

Tipo: string

Necesidad: Opcional

Ruta al archivo PEM que contiene el certificado x.509 y la llave privada para la autenticación de mongot con mongod.

syncSource.replicaSet.scramAuth.tls.tlsCertificateKeyFilePasswordFile

Tipo: string

Necesidad: Opcional

Ruta al archivo que contiene la contraseña para descifrar el archivo de clave del certificado especificado en syncSource.replicaSet.scramAuth.tls.tlsCertificateKeyFile.

Configuración de clústeres particionados

syncSource.router

Tipo: Objeto

Conexiones de replicación a mongos para mongot. Si se omite, mongot asume que se está ejecutando en un entorno no particionado. Obligatorio para implementaciones de clúster particionado.

syncSource.router.x509

Tipo: Objeto

Necesidad: Obligatorio si no utiliza syncSource.router.scramAuth

X.509 configuración de certificado para autenticar mongot con mongos.

syncSource.router.x509.caFile

Tipo: string

Necesidad: Requerido si utiliza syncSource.router.x509

Archivo de la Autoridad de Certificación (CA) que contiene certificados de confianza para verificar el certificado presentado por mongos. El archivo debe contener una colección de certificados X.509 en formato PEM.

syncSource.router.x509.tlsCertificateKeyFile

Tipo: string

Necesidad: Requerido si utiliza syncSource.router.x509

Ruta al archivo PEM que contiene el certificado X.509 y la llave privada para la autenticación de mongot con mongos. Obligatorio al configurar syncSource.router.x509.

syncSource.router.x509.tlsCertificateKeyFilePasswordFile

Tipo: string

Necesidad: Opcional

Ruta al archivo que contiene la contraseña para descifrar el archivo de clave del certificado especificado en syncSource.router.x509.tlsCertificateKeyFile.

syncSource.router.scramAuth

Tipo: Objeto

Necesidad: Obligatorio si no utiliza syncSource.router.x509

Configuración para la autenticación SCRAM.

syncSource.router.scramAuth.username

Tipo: string

Necesidad: Requerido

El nombre de usuario para autenticarse.

syncSource.router.scramAuth.passwordFile

Tipo: string

Necesidad: Requerido

Ruta a un archivo que contiene la contraseña para autenticarse.

syncSource.router.scramAuth.authSource

Tipo: string

Necesidad: Opcional

Nombre de la base de datos asociada con las credenciales de autenticación mongot. Si no se especifica, authSource por defecto es admin.

syncSource.router.scramAuth.tls

Tipo: Objeto

Necesidad: Opcional

Por defecto: false

Configuración de TLS.

syncSource.router.scramAuth.tls.enabled

Tipo: booleano

Necesidad: Requerido si especifica syncSource.router.scramAuth.tls

Marca para habilitar la autenticación TLS. Establezca en true para habilitar la autenticación TLS.

syncSource.router.scramAuth.tls.caFile

Tipo: string

Necesidad: Opcional

syncSource.router.scramAuth.tls.tlsCertificateKeyFile

Tipo: string

Necesidad: Opcional.

Ruta al archivo PEM que contiene el certificado x.509 y la llave privada para la autenticación de mongot con mongos.

syncSource.router.scramAuth.tls.tlsCertificateKeyFilePasswordFile

Tipo: string

Ruta al archivo que contiene la contraseña para descifrar el archivo de clave del certificado especificado en syncSource.router.scramAuth.tls.tlsCertificateKeyFile.

Configuración de preferencia de lectura de replicación

syncSource.replicationReader

Tipo: Objeto

Controla la preferencia de lectura que mongot utiliza al leer el set de réplicas para la replicación.

Para filtrar las lecturas por las etiquetas de los set de réplicas, especifique syncSource.replicationReader.tagSets.

syncSource.replicationReader.readPreference

Tipo: string

Por defecto: secondaryPreferred

La preferencia de lectura mongot se usa para operaciones de replicación. Puede especificar los siguientes valores:

primary
primaryPreferred
secondary
secondaryPreferred
nearest

Nota

Los comandos de gestión de índices siempre utilizan la preferencia de lectura primary, independientemente de esta configuración.

syncSource.replicationReader.tagSets

Type: Array

Arreglo de conjuntos de etiquetas que filtran qué miembros del set de réplicas reciben lecturas de replicación. No puedes configurar este ajuste si syncSource.replicationReader.readPreference es primary.

Cada elemento de tagSets es un arreglo de { name: <name>, value: <value> } objetos que coinciden con las etiquetas del set de réplicas. mongot evalúa los conjuntos de etiquetas en orden y utiliza el primer conjunto que coincide con un nodo. Por ejemplo:

tagSets:
  - [ { name: hostname, value: mongod1 },
      { name: region, value: us-east-1 } ]

Configuración del servidor gRPC

La configuración server.grpc.address es obligatoria. Todas las demás configuraciones de server.grpc son opcionales.

server.grpc.tls

Tipo: Objeto

TLS configuration options for the gRPC listen server.

server.grpc.tls.mode

Tipo: string

TLS mode for the gRPC server. Must be one of the following values:

"TLS"
"mTLS"
"disabled"

Obligatorio al configurar server.grpc.tls.

server.grpc.tls.certificateKeyFile

Tipo: string

Archivo PEM que contiene un certificado X.509 válido para mongot mediante una llave privada PKCS#8. mongod valida este certificado mediante un archivo de Autoridad Certificadora (CA) que especifica con la opción --tlsCAFile. Obligatorio cuando server.grpc.tls.mode es "TLS" o "mTLS".

server.grpc.tls.certificateKeyFilePasswordFile

Tipo: string

Ruta al archivo que contiene la contraseña para descifrar el archivo de clave del certificado especificado en server.grpc.tls.certificateKeyFile.

server.grpc.tls.caFile

Tipo: string

server.name

Tipo: string

Nombre proporcionado por el usuario para identificar una instancia mongot. MongoDB utiliza server.name para identificar hosts mongot en interfaces programáticas como $listSearchIndexes. Si omite esta configuración, MongoDB genera un nombre automáticamente.

Configuración de métricas

metrics

Tipo: Objeto

Configuraciones para el servidor de escucha del endpoint de métricas de Prometheus mongot.

metrics.enabled

Tipo: booleano

Por defecto: false

Indicador que habilita el endpoint de métricas de Prometheus. Si establece esto en false, MongoDB analiza y valida la sintaxis de las otras configuraciones en el bloque metrics, pero no inicia el oyente de métricas de Prometheus. Obligatorio cuando configure metrics.

metrics.address

Tipo: string

Por defecto: localhost:9946

Dirección de socket (IPv4 o IPv6) en la que se expone el punto final de Prometheus /metrics. Utilice el siguiente formato:

<host>:<port>

Configuración de verificación de estado

healthCheck

Tipo: Objeto

Configuración para el endpoint de verificación de estado mongot. No puede deshabilitar el endpoint de verificación de estado, pero puede configurar su dirección de escucha.

healthCheck.address

Tipo: string

Por defecto: localhost:8080

Dirección en la que escucha el detector de verificación de estado. Utilice el siguiente formato:

<host>:<port>

Configuración de registro

logging

Tipo: Objeto

Opciones para el registro.

logging.verbosity

Tipo: string

Por defecto: INFO

Nivel de verbosidad del registro. El valor debe ser un nivel de registro válido de Logback.

logging.logPath

Tipo: string

Ruta a un archivo donde mongot guarda los registros mediante un apéndice de archivo Logback. Si omite esta configuración, MongoDB no creará ni configurará una entrada de registro.

Configuración de incrustación automatizada

Configuración básica

Configura los siguientes ajustes para habilitar la incrustación automatizada.

Nota

queryKeyFile y indexingKeyFile funcionan como un par. Si no configura ninguno de los archivos, mongot registra una advertencia y deshabilita la incrustación automática.
providerEndpoint es opcional. Cuando se establece, mongot lo aplica como una anulación para el punto final del servicio de incrustación configurado.
isAutoEmbeddingViewWriter por defecto es false si lo omite.

embedding.providerEndpoint

Tipo: string

URL del punto final del proveedor de incrustación. Anulación opcional para el punto final del proveedor de incrustación por defecto. Utilice esta opción si desea que mongot envíe solicitudes de incrustación a un punto final de proveedor específico en lugar del punto final por defecto.

embedding.queryKeyFile

Tipo: string

Ruta al archivo que contiene la clave para las solicitudes de incrustación en tiempo de query. Obligatorio para la incrustación automatizada.

embedding.indexingKeyFile

Tipo: string

Ruta al archivo que contiene la clave para las solicitudes de incrustación en tiempo de índice. Obligatorio para la incrustación automatizada.

embedding.isAutoEmbeddingViewWriter

Tipo: booleano

Indicador para designar la instancia mongot líder responsable de escribir la vista de incrustación automatizada. Si es verdadero, esta instancia mongot actúa como escritor para las actualizaciones de vistas materializadas de incrustación automática.

Para implementaciones de instancia única, establezca este valor en true para permitir que la instancia guarde la vista de incrustaciones automatizadas.

Si tiene varias instancias de mongot para sets de réplicas o clústeres particionados, asegúrese de que solo una instancia guarde la vista de incrustación automatizada para evitar duplicaciones o conflictos. Establezca el valor en:

true para designar una instancia mongot como líder responsable de escribir la Vista de auto-incorporaciones.
false para designar una instancia de mongot como seguidor que no guarde la vista de auto-incrustaciones.

configuración avanzada

advancedConfigs.autoEmbedding.materializedView.numConcurrentChangeStreams

Tipo: entero

Necesidad: Opcional

Por defecto: 2 veces el recuento de núcleos de CPU del host

Número máximo de flujos de cambio de estado estable que el proceso de replicación de vistas materializadas puede tener pendientes en un momento dado. Debe ser un entero positivo.

advancedConfigs.autoEmbedding.materializedView.numIndexingThreads

Tipo: entero

Necesidad: Opcional

Por defecto: El número de núcleos de CPU del host, con un mínimo de 1

Número de subprocesos utilizados para guardar datos de incrustación en los índices de la vista materializada. Debe ser un entero positivo.

advancedConfigs.autoEmbedding.materializedView.numEmbeddingThreads

Tipo: entero

Necesidad: Opcional

Por defecto: El número de núcleos de CPU del host, con un mínimo de 1

Número de subprocesos utilizados para la solicitud de incrustación al proveedor de incrustación. Debe ser un entero positivo.

advancedConfigs.autoEmbedding.materializedView.numConcurrentInitialSyncs

Tipo: entero

Necesidad: Opcional

Por defecto: la mitad de advancedConfigs.replication.mongodb.numConcurrentInitialSyncs. Si el resultado es inferior a 1, se utiliza 1. Si no establece advancedConfigs.replication.mongodb.numConcurrentInitialSyncsn también, el valor predeterminado es 1.

Número máximo de índices de incrustación automatizada que pueden ejecutar su sincronización inicial al mismo tiempo. La limitación de la simultaneidad reduce la carga colocada en el nodo mongod de origen y el proveedor de incrustación durante las compilaciones iniciales. Debe ser un número entero positivo.

advancedConfigs.autoEmbedding.materializedView.matViewWriterMaxConnections

Tipo: entero

Necesidad: Opcional

Por defecto: 4

Número máximo de conexiones utilizadas para guardar en la colección de vistas materializadas. Debe ser un número entero positivo no mayor que 16.

advancedConfigs.autoEmbedding.materializedView.mvWriteRateLimitRps

Tipo: entero

Necesidad: Opcional

Default: No limit

Número máximo de confirmaciones de escritura masiva por segundo en la colección de vistas materializadas de este nodo. Utilice esta configuración para limitar el rendimiento de guardar en el nodo de origen mongod. Debe ser un número entero positivo.

advancedConfigs.autoEmbedding.materializedView.embeddingProviderRpsLimit

Tipo: entero

Necesidad: Opcional

Default: No limit

Número máximo de solicitudes por segundo que este nodo puede enviar al proveedor de incrustaciones. Este es un límite de nivel de nodo. Debe ser un entero positivo no superior a 100.

advancedConfigs.autoEmbedding.materializedView.maxInFlightEmbeddingGetMores

Tipo: entero

Necesidad: Opcional

Por defecto: 3

Maximum number of embedding-provider getMore operations that can be in flight concurrently for the materialized view.

Lower values reduce concurrent provider and memory pressure but can reduce embedding throughput. Higher values can improve throughput but may increase resource usage. Must be a positive integer.

advancedConfigs.autoEmbedding.materializedView.embeddingGetMoreBatchSize

Tipo: entero

Necesidad: Opcional

Por defecto: 2000

Number of documents returned in each embedding-provider getMore batch.

Larger batches can improve throughput by reducing request overhead but might increase memory usage and request latency. Must be a positive integer.

advancedConfigs.autoEmbedding.materializedView.changeStreamMaxTimeMs

Tipo: entero

Necesidad: Opcional

Por defecto: 700

Maximum time, in milliseconds, that a materialized-view change-stream request can run before it times out.

Lower values can improve responsiveness to stalled operations but might increase request and resume frequency. Higher values can reduce request churn but might delay stall detection. Must be a positive integer.

advancedConfigs.autoEmbedding.materializedView.changeStreamCursorMaxTimeSec

Tipo: entero

Necesidad: Opcional

Por defecto: 1200

Maximum lifetime, in seconds, of a change-stream cursor used by materialized-view replication.

Higher values can reduce cursor recreation. Lower values can detect long-lived or stalled cursors sooner. Must be a positive integer.

advancedConfigs.autoEmbedding.materializedView.numChangeStreamDecodingThreads

Tipo: entero

Necesidad: Opcional

Por defecto: 3

Number of threads used to decode change-stream events for the materialized view. Higher values can improve event-processing throughput but increase CPU usage. Must be a positive integer.

advancedConfigs.autoEmbedding.materializedView.requestRateLimitBackoffMs

Tipo: entero

Necesidad: Opcional

Por defecto: 250

Backoff interval, in milliseconds, that mongot applies after embedding requests are rate-limited.

Increasing this value reduces repeated requests and provider pressure during throttling but can increase embedding update latency. Must be a positive integer.

advancedConfigs.autoEmbedding.materializedView.globalMemoryBudgetHeapPercent

Tipo: entero

Necesidad: Opcional

Por defecto: 80

Percentage of the mongot heap that automated-embedding materialized-view processing can use globally.

Lower values reserve more heap for other mongot operations but can reduce automated-embedding throughput. Higher values can increase throughput but reduce memory available to other operations. Must be a positive integer.

advancedConfigs.autoEmbedding.materializedView.perBatchMemoryBudgetHeapPercent

Tipo: entero

Necesidad: Opcional

Por defecto: 40

Percentage of the mongot heap that a single automated-embedding batch can use.

This setting limits the memory impact of an individual batch. Configure it consistently with advancedConfigs.autoEmbedding.materializedView.globalMemoryBudgetHeapPercent. Must be a positive integer.

Configuración avanzada de indexación

advancedConfigs.indexing.lucene.refresh.intervalMs

Tipo: entero

Necesidad: Opcional

Por defecto: 1000

Intervalo, en milisegundos, que mongot espera antes de actualizar un índice para que los cambios indexados recientemente sean visibles para las queries. Los valores más bajos reducen el retraso entre la escritura de un documento y la posibilidad de hacerle un query, a costa de un trabajo de actualización más frecuente. Debe ser un número entero positivo.

advancedConfigs.indexing.lucene.mergePolicy.tiered.vectorMergePolicy.mergeBudgetMb

Tipo: entero

Necesidad: Opcional

Por defecto: 10% de la memoria total del host

Presupuesto de memoria, en megabytes, disponible para fusiones en segundo plano de segmentos de índice vectorial. Un presupuesto mayor permite fusionar más segmentos a la vez, lo que puede mejorar el rendimiento de las querys, pero utiliza más memoria durante las fusiones. Debe ser un número entero positivo.

advancedConfigs.indexing.lucene.mergeScheduler.concurrent.maxThreadCount

Tipo: entero

Necesidad: Opcional

Por defecto: El número de núcleos de CPU disponibles para el host

Número máximo de subprocesos que pueden realizar fusiones de segmentos de índice simultáneamente. Los valores más altos permiten que se ejecuten más fusiones en paralelo. Debe ser un número entero positivo.

advancedConfigs.indexing.lucene.fieldLimit

Tipo: entero

Necesidad: Opcional

Default: No limit

Número máximo de campos de índice permitidos en un índice. Utilice esta configuración para protegerse contra el crecimiento ilimitado de campos en los índices. Debe ser al menos 3.

Configuración avanzada de query

advancedConfigs.querying.lucene.maxClauseLimit

Tipo: entero

Necesidad: Opcional

Por defecto: 1024

Número máximo de cláusulas a las que puede expandirse una sola query. mongot rechaza las queries que se expanden más allá de este límite. Aumentar este límite permite queries más grandes, pero aumenta su costo de memoria y CPU. Debe ser un entero positivo.

advancedConfigs.querying.lucene.vectorFloorSegmentMB

Tipo: doble

Necesidad: Opcional

Por defecto: 64.0

Tamaño del segmento de piso, en megabytes, utilizado por la política de fusión para los índices de búsqueda vectorial de MongoDB. mongot fusiona segmentos más pequeños que advancedConfigs.querying.lucene.vectorFloorSegmentMB de forma más agresiva para reducir el número total de segmentos y mejorar el rendimiento de las queries. El valor debe ser un número positivo.

Configuración avanzada de replicación

advancedConfigs.replication.mongodb.numConcurrentInitialSyncs

Tipo: entero

Necesidad: Opcional

Por defecto: el menor de los recuentos de núcleos de CPU del host y 2

Número máximo de índices que pueden ejecutar su sincronización inicial al mismo tiempo. La limitación de la simultaneidad reduce la carga que se aplica al nodo mongod de origen mientras se realiza la creación de índices simultáneamente. Debe ser un número entero positivo.

advancedConfigs.replication.mongodb.numConcurrentChangeStreams

Tipo: entero

Necesidad: Opcional

Por defecto: 2 veces el recuento de núcleos de CPU del host

Número máximo de flujos de cambio de estado estable que pueden tener solicitudes pendientes al nodo mongod de origen en un momento dado. Esta configuración controla cuántos índices pueden extraer actualizaciones simultáneamente después de que se complete su sincronización inicial. Debe ser un número entero positivo.

advancedConfigs.replication.mongodb.numIndexingThreads

Tipo: entero

Necesidad: Opcional

Por defecto: la mitad del número de núcleos de CPU del host, con un mínimo de 1

Número de subprocesos utilizados para guardar documentos replicados y cambios en los índices. Los valores más altos pueden mejorar el rendimiento de la indexación, pero podrían aumentar el uso de CPU y memoria. El valor debe ser un número entero positivo.

advancedConfigs.replication.mongodb.numConcurrentSynonymSyncs

Tipo: entero

Necesidad: Opcional

Por defecto: 2

Número máximo de colecciones de origen de sinónimos que se pueden sincronizar simultáneamente. Debe ser un entero positivo.

advancedConfigs.replication.mongodb.pauseAllInitialSyncs

Tipo: booleano

Necesidad: Opcional

Por defecto: false

Flag that pauses all new initial-sync operations when set to true. Use this setting to prevent additional index builds from increasing disk or resource usage during recovery or maintenance.

This setting applies across the deployment and does not provide per-host control. To apply a change to this setting, perform a rolling restart of your mongot instances.

advancedConfigs.replication.mongodb.pauseInitialSyncOnIndexIds

Type: Array of Strings

Necesidad: Opcional

Por defecto: ninguno

Index IDs for which mongot pauses initial sync. Use this setting to defer selected index builds while allowing other indexes to continue synchronizing.

Each value must identify a search index. This setting applies across the deployment rather than to an individual host. To apply a change to this setting, perform a rolling restart of your mongot instances.

advancedConfigs.replication.mongodb.changeStreamMaxTimeMs

Tipo: entero

Necesidad: Opcional

Por defecto: 500

Maximum time, in milliseconds, that mongot allows an individual change-stream request to run before it times out.

Lower values can cause mongot to retry or resume change streams more frequently. Higher values can reduce request churn but may delay detection of stalled operations. Must be a positive integer.

advancedConfigs.replication.mongodb.changeStreamCursorMaxTimeSec

Tipo: entero

Necesidad: Opcional

Por defecto: 900

Maximum lifetime, in seconds, of a replication change-stream cursor.

Adjust this value only when tuning change-stream resource usage or cursor stability. Higher values can reduce cursor recreation. Lower values can detect long-lived or stalled cursors sooner. Must be a positive integer.

advancedConfigs.replication.mongodb.numChangeStreamDecodingThreads

Tipo: entero

Necesidad: Opcional

Por defecto: 4

Number of threads mongot uses to decode replication change-stream events. Higher values can improve change-stream processing throughput but increase CPU usage. Must be a positive integer.

advancedConfigs.replication.initialSync.bufferless.enableNaturalOrderScan

Tipo: booleano

Necesidad: Opcional

Por defecto: false

Flag that enables natural-order scans for bufferless initial sync when set to true.

Natural-order scans change how mongot reads documents during initial sync. Evaluate the effect on initial-sync performance and source-node load before you enable this setting in production.

Advanced Disk Monitor Settings

The disk-monitor settings use a fraction of disk capacity. For example, 0.90 represents 90% disk usage. Configure the resume thresholds below their corresponding pause thresholds to prevent repeated pause and resume cycles.

Nota

Changes to these settings take effect only after you restart mongot.

advancedConfigs.diskMonitor.pauseReplicationThreshold

Tipo: doble

Necesidad: Opcional

Por defecto: 0.90

Disk-utilization threshold at which mongot pauses replication. Pausing replication prevents additional replicated index data from increasing disk usage while the host is under disk pressure.

advancedConfigs.diskMonitor.resumeReplicationThreshold

Tipo: doble

Necesidad: Opcional

Por defecto: 0.85

Disk-utilization threshold below which mongot resumes replication after disk pressure causes replication to pause. Set this value lower than advancedConfigs.diskMonitor.pauseReplicationThreshold.

advancedConfigs.diskMonitor.crashThreshold

Tipo: doble

Necesidad: Opcional

Por defecto: 0.95

Critical disk-utilization threshold at which mongot crashes to protect the host from disk exhaustion. Set this threshold as a last-resort safety limit above the pause thresholds.

advancedConfigs.diskMonitor.pauseInitialSyncThreshold

Tipo: doble

Necesidad: Opcional

Por defecto: 0.85

Disk-utilization threshold at which mongot pauses initial-sync operations. Use this setting to prevent new index builds from consuming additional disk space when the host is already under disk pressure.

advancedConfigs.diskMonitor.resumeInitialSyncThreshold

Tipo: doble

Necesidad: Opcional

Por defecto: 0.80

Disk-utilization threshold below which mongot resumes initial-sync operations after disk pressure causes them to pause. Set this value lower than advancedConfigs.diskMonitor.pauseInitialSyncThreshold.

Advanced Cursor Settings

advancedConfigs.cursor.idleCursorHandlingRateMs

Tipo: entero

Necesidad: Opcional

Por defecto: 1800000

Interval, in milliseconds, at which mongot checks for idle cursors. Lower values allow mongot to identify idle cursors sooner but increase cursor-management work. Must be a positive integer.

advancedConfigs.cursor.cursorIdleTimeMs

Tipo: entero

Necesidad: Opcional

Por defecto: 3600000

Duration, in milliseconds, that a cursor can remain idle before mongot treats it as idle. Lower values allow mongot to reclaim cursor resources sooner but may affect clients that intentionally wait between requests. Must be a positive integer.

Configuración avanzada de FTDC

advancedConfigs.ftdc.enabled

Tipo: booleano

Necesidad: Opcional

Por defecto: true

Marca que habilita la captura de datos diagnósticos a tiempo completo (FTDC). La recopilación de datos diagnósticos de FTDC está habilitada por defecto. Cuando false, mongot no crea ningún reportero FTDC en el arranque, por lo que no captura datos diagnósticos.

advancedConfigs.ftdc.directorySizeMb

Tipo: entero

Necesidad: Opcional

Por defecto: 100

Tamaño total máximo, en megabytes, del directorio de ficheros FTDC. Debe ser al menos 10 y mayor que advancedConfigs.ftdc.fileSizeMb.

advancedConfigs.ftdc.fileSizeMb

Tipo: entero

Necesidad: Opcional

Por defecto: 10

Tamaño máximo, en megabytes, de un archivo de fichero FTDC individual. Debe ser al menos 1 y menos de advancedConfigs.ftdc.directorySizeMb.

advancedConfigs.ftdc.collectionPeriodMillis

Tipo: entero

Necesidad: Opcional

Por defecto: 1000

Intervalo de muestreo, en milisegundos, que controla la frecuencia con la que mongot recopila métricas en FTDC. Debe ser al menos 100.

Volver

Conéctese a su implementación

Configurar incrustaciones automatizadas