구성

설정

구성 파일 사용하여 다음 mongosync 설정을 구성할 수 있습니다.

명령줄 에서 를 구성하려면 mongosync 명령줄 옵션을 참조하세요.

acceptDisclaimer

유형: bool

내장된검증자에 대한 면책조항에 동의합니다.

이 설정 없이 mongosync 프로세스 시작되면 각 고지 사항을 수락하라는 메시지가 표시됩니다.

이 설정을 사용하면 이미 고지 사항을 읽고 수락한 사용자가 고지 사항을 수락하고 mongosync 프로세스 시작할 수 있습니다.

명령줄에서 acceptDisclaimer 설정을 지정하려면 --acceptDisclaimer 옵션을 참조하세요.

버전 1.9에 추가 되었습니다.

cluster0

유형: 문자열

Sets the connection URI for the first cluster. The first cluster can serve as either the source or the destination in the sync process. Designate the source and destination clusters in the call to the start API endpoint.

mongosync 연결에 대한 자세한 내용은 연결을 참조하세요.

명령줄에서 cluster0 설정을 지정하려면 --cluster0 옵션을 참조하세요.

cluster1

유형: 문자열

Sets the connection URI for the second cluster. The second cluster can serve as either the source or the destination in the sync process. Designate the source and destination clusters in the call to the start API endpoint.

mongosync 연결에 대한 자세한 내용은 연결을 참조하세요.

명령줄에서 cluster1 설정을 지정하려면 --cluster1 옵션을 참조하세요.

createIndexesBatchSize

버전 1 의 새로운 기능입니다.19.0.

유형: integer

최소: 1

최대값: 64

대상 클러스터에서 인덱스 생성의 배치 크기를 명시적으로 설정하다. 기본값 으로 mongosync 은(는) Atlas 대상 클러스터에서 이 값을 프로그래밍 방식으로 최적화합니다.

경고

인덱스 당 100 MB-1 GB 의 메모리를 할당했는지 확인합니다. 또한 동시 인덱스 생성에 사용되는 총 메모리가 대상 클러스터 RAM 의 20% 미만으로 유지되는지 확인합니다. 인덱스 생성에 대상 RAM 의 20% 이상을 할당하면 파일 시스템 캐시 방해하여 대상 클러스터 에 대한 쓰기 버퍼링에 사용할 수 있는 메모리가 줄어들 수 있습니다.

자세한 내용은 인덱스 생성 최적화를 참조하세요.

명령줄에서 createIndexesBatchSize 설정을 지정하려면 --createIndexesBatchSize 옵션을 참조하세요.

disableMetricsLogging

유형: 부울

버전 1 의 새로운 기능입니다.16.0.

Mongosync 바이너리를 실행 때 지표 로깅을 비활성화합니다.

경고

효과적인 문제 해결 및 지원 위해 지표 로깅을 활성화된 상태로 유지하는 것이 좋습니다.

자세한 내용은 Mongosync 지표를 참조하세요.

명령줄에서 disableMetricsLogging 설정을 지정하려면 --disableMetricsLogging 옵션을 참조하세요.

자세한 내용은 사용자 데이터 컬렉션을 참고하세요.

disableTelemetry

유형: 부울

버전 1 의 새로운 기능입니다.4.0.

mongosync에 대한 원격 분석 데이터 수집을 비활성화합니다.

기본적으로 mongosync는 MongoDB 제품을 개선하기 위해 익명의 애그리게이션된 사용 데이터를 수집합니다. mongosync를 실행하면 이 원격 분석 데이터 수집을 사용하지 않도록 설정할 수 있습니다.

명령줄에서 disableTelemetry 설정을 지정하려면 --disableTelemetry 옵션을 참조하세요.

자세한 내용은 사용자 데이터 컬렉션을 참고하세요.

disableVerification

유형: 부울

내장된 검증 도구를 비활성화합니다. 비활성화하면 mongosync 는 마이그레이션 확인하지 않습니다. 다른 확인 방법은 데이터 전송 확인을 참조하세요.

이 옵션은 확인과 함께 mongosync 를 실행 때 OOM 종료를 경험하고 더 많은 리소스를 할당할 수 없거나 확인 재시작을 허용하지 않는 고객을 위한 해결 방법을 제공합니다. 확인을 비활성화한 상태에서 마이그레이션 완료할 수 있습니다. 후속 재시작 및 되돌리기를 위해 인증은 비활성화된 상태로 유지됩니다.

mongosync 이 처음 시작될 때는 이 옵션을 사용하면 안 됩니다. 대신 기본값 으로 확인이 활성화되어 있으므로 /start 요청 매개변수 verification.enabled: false 을(를) 사용하여 확인을 비활성화합니다.

명령줄에서 확인을 비활성화하려면 옵션을 --disableVerification 참조하세요.

버전 1.10에 추가 되었습니다.

enableCappedCollectionHandling

유형: 부울

mongosync 마이그레이션 중에 새 고정 사이즈 컬렉션을 활성화 려면 이 플래그를 전달해야 합니다.

마이그레이션 중에 새 고정 사이즈 컬렉션을 만들 활성화 하려면 true 로 설정합니다. 기본값은 false입니다.

명령줄에서 enableCappedCollectionHandling 설정을 지정하려면 --enableCappedCollectionHandling 옵션을 참조하세요.

버전 1.20에 추가 되었습니다.

hotDocIDs

유형: 문자열

핫 문서 또는 소스 클러스터에서 매우 자주 업데이트 문서의 식별자를 설정합니다. 그런 다음 mongosync 는 마이그레이션 커밋 단계에서 이러한 문서를 복사합니다.

mongosync를 실행 때 핫 문서로 인해 복제 지연 발생하는 마이그레이션에 이 설정을 사용합니다.

다음 형식으로 식별자를 제공합니다.

{
   “db”: <string>, // the name of the database
   "collection" : <string>, // name of the collection
   "ids"    : [ {“_id”:<Object>”}, ...],
}

ids 필드의 객체는 유효한 표준 모드 확장 JSON 문자열이어야 합니다.

이 설정을 여러 번 사용하여 여러 컬렉션의 핫 문서 식별자를 제공할 수 있습니다. 다음은 컬렉션 coll1 및 coll2에서 두 개의 핫 문서 식별자를 제공하는 예시 입니다.

mongosync \
--hotDocIDs '{"db":"db1","collection":"coll1","ids":[{"_id":{"$oid":"doc1"}},{"_id":{"$oid":"6aa23c249cef3cd958e43785"}}]}' \
--hotDocIDs '{"db":"db2","collection":"coll2","ids":[{"_id":{"$oid":"70023c249cef3cd958e43269"}},{"_id":{"$oid":"7aa23c249cef3cd958e43785"}}]}' \
... other CLI arguments ...

During an in-progress migration, you can add more hot document identifiers. To add identifiers, stop mongosync, update the --hotDocIDs option or hotDocIDs setting with the new identifiers, and resume the migration. mongosync retains all supplied identifiers across restarts.

You cannot remove supplied hot document identifiers during a migration. To restart the migration from scratch and remove or correct supplied identifiers, see Restart mongosync.

참고

mongosync 역방향 동기화에서 핫 문서를 유지하지 않습니다. 역방향 동기화 중 핫 문서로 인해 복제 지연이 발생하면 mongosync 프로세스를 다시 시작하고 역방향에 대한 핫 문서 식별자를 지정합니다. 마이그레이션을 처음부터 다시 시작하지 마세요.

명령줄 에서 hotDocIDs 를 설정하다 하려면 --hotDocIDs 옵션을 참조하세요.

id

유형: 문자열

mongosync 인스턴스의 식별자를 설정합니다

샤딩된 클러스터에서 여러 mongosync 인스턴스를 실행할 때 이 설정을 사용하여 샤드를 개별적으로 동기화합니다.

The identifier value for this setting must correspond to the shard ID of the shard it syncs. To find the shard ID, use the listShards command.

명령줄에서 id 설정을 지정하려면 --id 옵션을 참조하세요.

loadLevel

유형: integer

기본값: 3

소스 클러스터와 대상 클러스터 간의 데이터 동기화를 위한 클러스터 워크로드 수준을 설정합니다.

• 4가장 높은 설정, 클러스터 워크로드를 최대화하고 데이터를 가장 빠르게 동기화합니다.

• 1로 설정하면 클러스터 워크로드가 최소화되고 데이터 동기화 속도가 가장 느려집니다.

명령줄에서 loadLevel 설정을 지정하려면 --loadLevel 옵션을 참조하세요.

경고

loadLevel을 기본값인 3보다 높게 설정하면 대상 클러스터 성능에 부정적인 영향을 줄 수 있습니다.

소스 클러스터 에 읽기 병목 현상이 있거나 대상 클러스터 에 쓰기 (write) 병목 현상이 있는 경우 loadLevel 을(를) 낮추면 성능이 향상될 수 있습니다.

버전 1.4에 추가 되었습니다.

logPath

유형: 문자열

로그 디렉토리 경로를 설정합니다. Mongosync는 이 디렉토리 의 파일에 로그를 씁니다.

자세한 내용은 로깅을 참조하세요.

명령줄에서 logPath 설정을 지정하려면 --logPath 옵션을 참조하세요.

metricsLoggingFilepath

유형: 문자열

버전 1 의 새로운 기능입니다.16.0.

지표 로그 디렉토리 경로를 설정합니다. Mongosync는 이 디렉토리 의 파일에 지표 로그를 기록합니다.

자세한 내용은 Mongosync 지표를 참조하세요.

명령줄에서 metricsLoggingFilepath 설정을 지정하려면 --metricsLoggingFilepath 옵션을 참조하세요.

port

유형: integer

기본값: 27182

Mongosync HTTP API 에 HTTP 서버 가 사용하는 포트를 설정합니다.

명령줄에서 port 설정을 지정하려면 --port 옵션을 참조하세요.

verbosity

유형: 문자열

기본값: DEBUG

로그 메시지에 사용할 상세도 수준을 설정합니다. Mongosync는 지정된 수준의 모든 메시지와 하위 수준의 모든 메시지를 기록합니다.

verbosity 설정은 다음 값을 지원합니다.

• TRACE

• DEBUG

• INFO

• WARN

• ERROR

• FATAL

• PANIC

명령줄에서 verbosity 설정을 지정하려면 --verbosity 옵션을 참조하세요.