mongot 구성

YAML 설정 파일을 사용하여 MongoDB Search 및 벡터 검색 배포서버에 대한 mongot 를 설정합니다.

팁

Kubernetes 연산자 배포용 MongoDB 컨트롤러의 경우 MongoDBSearch 사용자 지정 리소스를 사용하여 mongot을(를) 구성할 수 있습니다. 자세한 내용은 MongoDBSearch를 참조하세요.

다음 예시는 MongoDB Community를 사용하는 자체 관리형 mongot 배포서버에 대한 사용 가능한 모든 설정이 포함된 완전한 구성 구조를 보여줍니다.

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>

필수 설정

이 섹션에서는 모든 mongot 배포서버에 필요한 설정에 대해 설명합니다. 필요한 설정만 정의하면 mongot 은 모든 선택 사항에 대해 기본값을 사용합니다.

syncSource.replicaSet

유형: 객체

mongot에 대한 mongod 에 대한 복제 연결입니다.

syncSource.replicaSet.hostAndPort

유형: string 또는 string 목록

mongod 연결 문자열에서 시드 목록을 구성하는 데 사용되는 하나 이상의 호스트 및 포트 지정자. 제공된 지정자 수에 관계없이 mongot 은 독립형 모드가 아닌 복제본 세트 모드로 연결을 설정합니다.

storage.dataPath

유형: 문자열

mongot 가 인덱스 데이터 및 로컬 인덱스 카탈로그를 저장하기 위한 기본 경로로 사용해야 하는 경로입니다.

server

유형: 객체

mongot 쿼리 서버에 대한 설정입니다.

server.grpc

유형: 객체

mongot 와 mongod 간의 gRPC 통신을 위한 수신 서버 설정.

server.grpc.address

유형: 문자열

gRPC 수신 서버가 수신하는 주소입니다. 다음 형식을 사용합니다.

<host>:<port>

자체 관리형 배포서버에서는 검색 및 인덱스 관리 트래픽을 mongot으로 보내는 mongod 프로세스에서 이 주소에 액세스할 수 있어야 합니다. mongod 가 mongotHost 및 searchIndexManagementHostAndPort 설정에 사용하는 호스트 및 포트와 일치하도록 구성합니다.

단일 호스팅 개발의 경우 localhost 가 가장 안전한 기본값입니다. mongod 과 mongot 가 다른 호스팅에서 실행되는 경우 server.grpc.address 을 mongod 가 액세스할 수 있는 인터페이스로 설정합니다.

경고

시스템 토폴로지 에 따라 mongot 쿼리 서버 MongoDB 클러스터에서 액세스할 수 있는 인터페이스에 바인딩해야 할 수 있습니다. 0.0.0.0 IP 주소 에 대한 바인딩은 허용되지만 서버 모든 공용 네트워크에 노출되고 무단 액세스 의 위험이 있습니다.

보안을 강화하려면 localhost 또는 기타 신뢰할 수 있는 내부 주소와 같이 네트워크 계층에서 제어되고 보호되는 특정 인터페이스로 server.grpc.address 를 제한하는 것이 좋습니다.

선택적 설정

이 섹션에서는 mongot에 대한 선택 사항 및 조건부 필수 설정에 대해 설명합니다. 이 설정을 생략하면 mongot 은 해당하는 경우 지정된 기본값을 사용합니다.

복제본 세트 인증 설정

syncSource.replicaSet.x509

유형: 객체

필요성: syncSource.replicaSet.scramAuth을 사용하지 않는 경우 필수

mongot 을 mongod로 인증하기 위한 X.509 인증서 설정입니다.

syncSource.replicaSet.x509.caFile

유형: 문자열

필요성: syncSource.replicaSet.x509을 사용하는 경우 필수

mongod에서 제시하는 인증서를 확인하기 위한 신뢰할 수 있는 인증서가 포함된 인증서 발급 기관(CA) 파일입니다. 파일에는 PEM 형식의 X.509 인증서 컬렉션이 포함되어 있어야 합니다.

syncSource.replicaSet.x509.tlsCertificateKeyFile

유형: 문자열

필요성: syncSource.replicaSet.x509을 사용하는 경우 필수

mongod로 mongot 을(를) 인증하기 위한 X.509 인증서 및 개인 키가 포함된 PEM 파일의 경로입니다. syncSource.replicaSet.x509을(를) 구성할 때 필수입니다.

syncSource.replicaSet.x509.tlsCertificateKeyFilePasswordFile

유형: 문자열

필요성: 선택 사항

syncSource.replicaSet.x509.tlsCertificateKeyFile에 지정된 인증서 키 파일을 해독하기 위한 비밀번호가 포함된 파일의 경로입니다.

syncSource.replicaSet.scramAuth

유형: 객체

필요성: syncSource.replicaSet.x509을 사용하지 않는 경우 필수

SCRAM 인증 설정입니다.

syncSource.replicaSet.scramAuth.username

유형: 문자열

필요성: 필수

인증할 사용자 이름입니다.

syncSource.replicaSet.scramAuth.passwordFile

유형: 문자열

필요성: 필수

인증할 비밀번호가 포함된 파일의 경로입니다.

syncSource.replicaSet.scramAuth.authSource

유형: 문자열

필요성: 선택 사항

기본값: admin

mongot 인증 자격 증명과 연결된 데이터베이스의 이름입니다.

syncSource.replicaSet.scramAuth.tls

유형: 객체

필요성: 선택 사항

기본값: false

TLS 설정

syncSource.replicaSet.scramAuth.tls.enabled

유형: 부울

필요성: syncSource.replicaSet.scramAuth.tls을 지정하는 경우 필수입니다.

TLS 인증을 활성화하는 플래그입니다. TLS 인증을 활성화하려면 true 으로 설정하세요.

syncSource.replicaSet.scramAuth.tls.caFile

유형: 문자열

필요성: 선택 사항

syncSource.replicaSet.scramAuth.tls.tlsCertificateKeyFile

유형: 문자열

필요성: 선택 사항

mongod로 mongot 을(를) 인증하기 위한 x.509 인증서 및 비공개 키가 포함된 PEM 파일 의 경로입니다.

syncSource.replicaSet.scramAuth.tls.tlsCertificateKeyFilePasswordFile

유형: 문자열

필요성: 선택 사항

syncSource.replicaSet.scramAuth.tls.tlsCertificateKeyFile에 지정된 인증서 키 파일을 해독하기 위한 비밀번호가 포함된 파일의 경로입니다.

샤딩된 클러스터 설정

syncSource.router

유형: 객체

mongot에 대한 mongos 에 대한 복제 연결입니다. 생략하면 mongot 는 샤딩되지 않은 환경에서 실행되는 것으로 간주합니다. 샤딩된 클러스터 배포에 필요합니다.

syncSource.router.x509

유형: 객체

필요성: syncSource.router.scramAuth을 사용하지 않는 경우 필수

mongot 을 mongos로 인증하기 위한 X.509 인증서 설정입니다.

syncSource.router.x509.caFile

유형: 문자열

필요성: syncSource.router.x509을 사용하는 경우 필수

mongos에서 제시하는 인증서를 확인하기 위한 신뢰할 수 있는 인증서가 포함된 인증서 발급 기관(CA) 파일입니다. 파일에는 PEM 형식의 X.509 인증서 컬렉션이 포함되어 있어야 합니다.

syncSource.router.x509.tlsCertificateKeyFile

유형: 문자열

필요성: syncSource.router.x509을 사용하는 경우 필수

mongos로 mongot 을(를) 인증하기 위한 X.509 인증서 및 개인 키가 포함된 PEM 파일의 경로입니다. syncSource.router.x509을(를) 구성할 때 필수입니다.

syncSource.router.x509.tlsCertificateKeyFilePasswordFile

유형: 문자열

필요성: 선택 사항

syncSource.router.x509.tlsCertificateKeyFile에 지정된 인증서 키 파일을 해독하기 위한 비밀번호가 포함된 파일의 경로입니다.

syncSource.router.scramAuth

유형: 객체

필요성: syncSource.router.x509을 사용하지 않는 경우 필수

SCRAM 인증 설정입니다.

syncSource.router.scramAuth.username

유형: 문자열

필요성: 필수

인증할 사용자 이름입니다.

syncSource.router.scramAuth.passwordFile

유형: 문자열

필요성: 필수

인증할 비밀번호가 포함된 파일의 경로입니다.

syncSource.router.scramAuth.authSource

유형: 문자열

필요성: 선택 사항

mongot 인증 자격 증명 과 연결된 데이터베이스 의 이름입니다. 지정하지 않으면 authSource 의 기본값은 admin입니다.

syncSource.router.scramAuth.tls

유형: 객체

필요성: 선택 사항

기본값: false

TLS 설정

syncSource.router.scramAuth.tls.enabled

유형: 부울

필요성: syncSource.router.scramAuth.tls을 지정하는 경우 필수입니다.

TLS 인증을 활성화하는 플래그입니다. TLS 인증을 활성화하려면 true 으로 설정하세요.

syncSource.router.scramAuth.tls.caFile

유형: 문자열

필요성: 선택 사항

syncSource.router.scramAuth.tls.tlsCertificateKeyFile

유형: 문자열

필요성: 선택 사항.

mongos로 mongot 을(를) 인증하기 위한 x.509 인증서 및 비공개 키가 포함된 PEM 파일 의 경로입니다.

syncSource.router.scramAuth.tls.tlsCertificateKeyFilePasswordFile

유형: 문자열

syncSource.router.scramAuth.tls.tlsCertificateKeyFile에 지정된 인증서 키 파일을 해독하기 위한 비밀번호가 포함된 파일의 경로입니다.

복제 읽기 설정 (read preference)

syncSource.replicationReader

유형: 객체

복제용 복제본 세트를 읽을 때 mongot에서 사용하는 읽기 설정(read preference)을 제어합니다.

복제본 세트 노드 태그로 읽기를 필터링하려면 syncSource.replicationReader.tagSets을 지정합니다.

syncSource.replicationReader.readPreference

유형: 문자열

기본값: secondaryPreferred

읽기 설정 (read preference) mongot 는 복제 작업에 사용합니다. 다음 값을 지정할 수 있습니다.

primary
primaryPreferred
secondary
secondaryPreferred
nearest

참고

인덱스 관리 명령은 이 설정과 관계없이 항상 primary 읽기 설정(read preference)을 사용합니다.

syncSource.replicationReader.tagSets

Type: Array

어떤 복제본 세트 노드가 복제 읽기를 수신하는지 필터링하는 태그 세트의 배열입니다. syncSource.replicationReader.readPreference 이 primary인 경우에는 이 설정을 구성할 수 없습니다.

tagSets의 각 요소는 복제본 세트 멤버 태그와 일치하는 { name: <name>, value: <value> } 객체의 배열입니다. mongot는 태그 세트를 순서대로 평가하고 멤버와 일치하는 첫 번째 태그 세트를 사용합니다. 예시는 다음과 같습니다.

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

gRPC 서버 설정

server.grpc.address 설정이 필수 사항입니다. 다른 모든 server.grpc 설정은 선택 사항입니다.

server.grpc.tls

유형: 객체

TLS configuration options for the gRPC listen server.

server.grpc.tls.mode

유형: 문자열

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

"TLS"
"mTLS"
"disabled"

server.grpc.tls을 구성할 때 필수입니다.

server.grpc.tls.certificateKeyFile

유형: 문자열

PKCS#8 개인 키를 사용하여 mongot 에 대한 유효한 X.509 인증서가 포함된 PEM 파일. mongod 은 --tlsCAFile 옵션으로 지정한 CA(인증서 발급 기관) 파일을 사용하여 인증서를 검증합니다. server.grpc.tls.mode 가 "TLS" 또는 "mTLS"인 경우 필수입니다.

server.grpc.tls.certificateKeyFilePasswordFile

유형: 문자열

server.grpc.tls.certificateKeyFile에 지정된 인증서 키 파일을 해독하기 위한 비밀번호가 포함된 파일의 경로입니다.

server.grpc.tls.caFile

유형: 문자열

mongod이 제시하는 인증서를 확인하기 위한 신뢰할 수 있는 인증서가 포함된 인증서 발급 기관(CA) 파일입니다. 파일에는 PEM 형식의 X.509 인증서 컬렉션이 포함되어 있어야 합니다. server.grpc.tls.mode 가 "mTLS"인 경우 필수입니다.

server.name

유형: 문자열

mongot 인스턴스를 식별하기 위한 사용자 제공 이름입니다. MongoDB는 $listSearchIndexes와 같은 프로그래밍 인터페이스에서 mongot 호스팅을 식별하기 위해 server.name 을 사용합니다. 이 설정을 생략하면 MongoDB가 자동으로 이름을 생성합니다.

지표 설정

metrics

유형: 객체

mongot Prometheus 지표 엔드포인트 리스너에 대한 설정입니다.

metrics.enabled

유형: 부울

기본값: false

Prometheus 지표 엔드포인트를 활성화하는 플래그입니다. 이것을 false으로 설정하면 MongoDB는 metrics 블록의 다른 설정의 구문을 구문 분석하고 유효성을 검사하지만 Prometheus 지표 리스너를 시작하지 않습니다. metrics를 구성할 때 필요합니다.

metrics.address

유형: 문자열

기본값: localhost:9946

Prometheus /metrics 엔드포인트가 노출되는 소켓 주소 (IPv4 또는 IPv6)입니다. 다음 형식을 사용합니다.

<host>:<port>

상태 확인 설정

healthCheck

유형: 객체

mongot 상태 확인 엔드포인트에 대한 설정입니다. 상태 확인 엔드포인트를 비활성화할 수는 없지만 수신 주소를 구성할 수는 있습니다.

healthCheck.address

유형: 문자열

기본값: localhost:8080

상태 확인 수신기가 수신하는 주소입니다. 다음 형식을 사용합니다.

<host>:<port>

로깅 설정

logging

유형: 객체

로깅 옵션.

logging.verbosity

유형: 문자열

기본값: INFO

로그의 상세 수준입니다. 값은 유효한 Logback 로그 수준이어야 합니다.

logging.logPath

유형: 문자열

mongot 이 Logback 파일 애펜더를 사용하여 로그를 쓰는 파일의 경로입니다. 이 설정을 생략하면 MongoDB는 로그 파일 애펜더를 생성하거나 구성하지 않습니다.

자동 임베딩 설정

기본 설정

자동 임벡딩을 사용하려면 다음 설정을 구성합니다.

참고

queryKeyFile 과 indexingKeyFile 은 한 쌍으로 작동합니다. 두 파일 중 하나라도 구성하지 않으면 mongot 은 경고를 로그하고 자동 임베딩을 비활성화합니다.
providerEndpoint 선택 사항입니다. 설정되면 mongot 은 구성된 임베딩 서비스 엔드포인트에 대한 재정의로 적용합니다.
isAutoEmbeddingViewWriter 생략하면 false 으로 기본값이 설정됩니다.

embedding.providerEndpoint

유형: 문자열

임베딩 제공자 엔드포인트의 URL입니다. 기본 임베딩 제공자 엔드포인트에 대한 선택 사항 재정의입니다. mongot 이(가) 기본 엔드포인트 대신 특정 제공자 엔드포인트로 임베딩 요청을 보내려면 이것을 사용하세요.

embedding.queryKeyFile

유형: 문자열

쿼리 시간 임베딩 요청의 키가 포함된 파일의 경로입니다. 자동 임베딩에 필요합니다.

embedding.indexingKeyFile

유형: 문자열

인덱싱 시간 임베딩 요청의 키가 포함된 파일의 경로입니다. 자동 임베딩에 필요합니다.

embedding.isAutoEmbeddingViewWriter

유형: 부울

자동 임베딩 뷰 작성을 담당하는 리더 mongot 인스턴스를 지정하는 플래그입니다. true인 경우 이 mongot 인스턴스는 자동 임베딩 구체화된 뷰 업데이트의 작성자 역할을 합니다.

단일 인스턴스 배포의 경우 인스턴스가 자동 임베딩 보기를 쓰도록 하려면 이 값을 true 으로 설정합니다.

복제본 세트 또는 샤딩된 클러스터에 대한 mongot 인스턴스가 여러 개 있는 경우 중복 또는 충돌을 방지하기 위해 하나의 인스턴스만 자동화된 임베딩 뷰를 작성하도록 합니다. 값을 다음과 같이 설정합니다.

true mongot 인스턴스 자동 임베딩 뷰 작성을 담당하는 리더로 지정합니다.
false mongot 인스턴스를 자동 임베딩 뷰를 쓰기 (write) 하지 않는 팔로우로 지정합니다.

advancedSettings

advancedConfigs.autoEmbedding.materializedView.numConcurrentChangeStreams

유형: 정수

필요성: 선택 사항

기본값: 호스트의 CPU 코어 수의 2 배

구체화된 뷰 복제 프로세스가 한 번에 가질 수 있는 최대 정상 상태 변경 스트림 수입니다. 양의 정수여야 합니다.

advancedConfigs.autoEmbedding.materializedView.numIndexingThreads

유형: 정수

필요성: 선택 사항

기본값: 최소 1개의 호스트 CPU 코어 수

구체화된 뷰의 인덱스에 임베딩 데이터를 쓰는 데 사용되는 스레드 수입니다. 양의 정수여야 합니다.

advancedConfigs.autoEmbedding.materializedView.numEmbeddingThreads

유형: 정수

필요성: 선택 사항

기본값: 최소 1개의 호스트 CPU 코어 수

임베딩 제공자에서 임베딩을 요청하는 데 사용되는 스레드 수. 양의 정수여야 합니다.

advancedConfigs.autoEmbedding.materializedView.numConcurrentInitialSyncs

유형: 정수

필요성: 선택 사항

기본값: advancedConfigs.replication.mongodb.numConcurrentInitialSyncs의 절반. 결과가 1보다 작은 경우 1를 사용합니다. advancedConfigs.replication.mongodb.numConcurrentInitialSyncs도 설정하지 않으면 기본값은 1가 됩니다.

초기 동기화를 동시에 실행할 수 있는 자동화된 임베딩 인덱스의 최대 수입니다. 동시성을 제한하면 초기 빌드 동안 소스 mongod 노드와 임베딩 제공자에 가해지는 부하가 줄어듭니다. 양의 정수여야 합니다.

advancedConfigs.autoEmbedding.materializedView.matViewWriterMaxConnections

유형: 정수

필요성: 선택 사항

기본값: 4

구체화된 뷰 컬렉션에 쓰기 위해 사용되는 최대 연결 수입니다. 16보다 작거나 같은 양의 정수여야 합니다.

advancedConfigs.autoEmbedding.materializedView.mvWriteRateLimitRps

유형: 정수

필요성: 선택 사항

Default: No limit

이 노드의 구체화된 뷰 컬렉션에 초당 최대 불크 쓰기 커밋 수. 이 설정을 사용하여 소스 mongod 노드에 대한 쓰기 처리량을 제한합니다. 양의 정수여야 합니다.

advancedConfigs.autoEmbedding.materializedView.embeddingProviderRpsLimit

유형: 정수

필요성: 선택 사항

Default: No limit

이 노드가 임베딩 제공자에 보낼 수 있는 최대 초당 요청 수입니다. 이는 노드 수준 제한입니다. 100보다 작거나 같은 양의 정수여야 합니다.

advancedConfigs.autoEmbedding.materializedView.maxInFlightEmbeddingGetMores

유형: 정수

필요성: 선택 사항

기본값: 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

유형: 정수

필요성: 선택 사항

기본값: 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

유형: 정수

필요성: 선택 사항

기본값: 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

유형: 정수

필요성: 선택 사항

기본값: 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

유형: 정수

필요성: 선택 사항

기본값: 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

유형: 정수

필요성: 선택 사항

기본값: 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

유형: 정수

필요성: 선택 사항

기본값: 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

유형: 정수

필요성: 선택 사항

기본값: 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.

고급 인덱싱 설정

advancedConfigs.indexing.lucene.refresh.intervalMs

유형: 정수

필요성: 선택 사항

기본값: 1000

mongot 가 인덱스된 변경 사항을 쿼리에 보여주기 위해 인덱스를 새로고침하기 전에 대기하는 간격(밀리초). 값이 낮으면 문서를 작성하는 것과 쿼리할 수 있는 것 사이의 지연이 줄어들지만 새로고침 작업이 더 자주 실행되는 비용이 발생합니다. 양의 정수여야 합니다.

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

유형: 정수

필요성: 선택 사항

기본값: 호스트 총 메모리의 10%

벡터 인덱스 세그먼트의 배경 병합에 사용할 수 있는 메가바이트 단위의 메모리 예산입니다. 예산이 큼면 더 많은 세그먼트를 한 번에 병합할 수 있어 쿼리 성능을 향상시킬 수 있지만 병합 중에 더 많은 메모리를 사용합니다. 양의 정수여야 합니다.

advancedConfigs.indexing.lucene.mergeScheduler.concurrent.maxThreadCount

유형: 정수

필요성: 선택 사항

기본값: 호스트에 사용 가능한 CPU 코어 수

인덱스 세그먼트 병합을 동시에 수행할 수 있는 최대 스레드 수입니다. 값이 높을수록 더 많은 병합이 병렬으로 실행됩니다. 양의 정수여야 합니다.

advancedConfigs.indexing.lucene.fieldLimit

유형: 정수

필요성: 선택 사항

Default: No limit

인덱스에 허용되는 인덱스 필드의 최대 개수입니다. 이 설정을 사용하여 인덱스의 무제한 필드 증가를 방지합니다. 3 이상이어야 합니다.

고급 쿼리 설정

advancedConfigs.querying.lucene.maxClauseLimit

유형: 정수

필요성: 선택 사항

기본값: 1024

단일 쿼리가 확장할 수 있는 조건의 최대 수입니다. mongot 은 이 제한을 초과하여 확장되는 쿼리를 거부합니다. 이 제한을 높이면 더 큰 쿼리를 사용할 수 있지만 메모리 및 CPU 비용이 증가합니다. 양의 정수여야 합니다.

advancedConfigs.querying.lucene.vectorFloorSegmentMB

유형: double

필요성: 선택 사항

기본값: 64.0

MongoDB 벡터 검색 인덱스의 병합 정책에 사용되는 바닥 세그먼트 크기(메가바이트 단위). mongot 은 advancedConfigs.querying.lucene.vectorFloorSegmentMB 보다 작은 세그먼트를 더 강력하게 병합하여 총 세그먼트 수를 줄이고 쿼리 성능을 향상시킵니다. 값은 양수여야 합니다.

고급 복제 설정

advancedConfigs.replication.mongodb.numConcurrentInitialSyncs

유형: 정수

필요성: 선택 사항

기본값: 호스트의 CPU 코어 수와 2중 더 작은 값

초기 동기화를 동시에 실행할 수 있는 최대 인덱스 수. 동시 인덱스 생성 시 병렬성을 제한하면 소스 mongod 노드에 가해지는 부하가 줄어들어들어요. 양의 정수여야 합니다.

advancedConfigs.replication.mongodb.numConcurrentChangeStreams

유형: 정수

필요성: 선택 사항

기본값: 호스트의 CPU 코어 수의 2 배

소스 mongod 노드에 대해 언제든 시점에 미결 요청을 보낼 수 있는 안정상태 변경 스트림의 최대 수. 이 설정은 초기 동기화가 완료된 후 동시에 업데이트를 가져올 수 있는 인덱스 수를 제어합니다. 양의 정수여야 합니다.

advancedConfigs.replication.mongodb.numIndexingThreads

유형: 정수

필요성: 선택 사항

기본값: 호스트의 CPU 코어 수의 절반이며, 최소 1

복제된 문서 및 변경 사항을 인덱스에 쓰기 위해 사용되는 스레드 수. 값이 높으면 인덱싱 처리량을 향상시킬 수 있지만 CPU 및 메모리 사용량이 증가할 수 있습니다. 값은 양의 정수여야 합니다.

advancedConfigs.replication.mongodb.numConcurrentSynonymSyncs

유형: 정수

필요성: 선택 사항

기본값: 2

동시에 동기화할 수 있는 최대 시놀님 소스 컬렉션 수. 양의 정수여야 합니다.

advancedConfigs.replication.mongodb.pauseAllInitialSyncs

유형: 부울

필요성: 선택 사항

기본값: 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

필요성: 선택 사항

Default(기본값): 없음

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

유형: 정수

필요성: 선택 사항

기본값: 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

유형: 정수

필요성: 선택 사항

기본값: 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

유형: 정수

필요성: 선택 사항

기본값: 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

유형: 부울

필요성: 선택 사항

기본값: 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.

참고

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

advancedConfigs.diskMonitor.pauseReplicationThreshold

유형: double

필요성: 선택 사항

기본값: 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

유형: double

필요성: 선택 사항

기본값: 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

유형: double

필요성: 선택 사항

기본값: 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

유형: double

필요성: 선택 사항

기본값: 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

유형: double

필요성: 선택 사항

기본값: 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

유형: 정수

필요성: 선택 사항

기본값: 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

유형: 정수

필요성: 선택 사항

기본값: 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.

고급 FTDC 설정

advancedConfigs.ftdc.enabled

유형: 부울

필요성: 선택 사항

기본값: true

풀타임 진단 데이터 캡처(FTDC)를 활성화하는 플래그입니다. FTDC 진단 데이터 컬렉션은 기본적으로 활성화되어 있습니다. false일 때 mongot 은 부트스트랩에서 FTDC 리포터를 생성하지 않아 진단 데이터를 캡처하지 않습니다.

advancedConfigs.ftdc.directorySizeMb

유형: 정수

필요성: 선택 사항

기본값: 100

FTDC 보관 디렉토리의 최대 총 크기(메가바이트 단위). 최소한 10 이고 advancedConfigs.ftdc.fileSizeMb보다 큰야 합니다.

advancedConfigs.ftdc.fileSizeMb

유형: 정수

필요성: 선택 사항

기본값: 10

개별 FTDC 보관 파일의 최대 크기(메가바이트 단위). 최소 1 이고 advancedConfigs.ftdc.directorySizeMb보다 작아야 합니다.

advancedConfigs.ftdc.collectionPeriodMillis

유형: 정수

필요성: 선택 사항

기본값: 1000

mongot 이 FTDC에 지표를 수집하는 빈도를 제어하는 밀리초 단위의 샘플링 간격입니다. 100 이상이어야 합니다.

돌아가기

배포서버에 연결

자동 임베딩 구성