추가 설정 구성
이 페이지의 내용
- 클러스터의 MongoDB 버전 선택
- 릴리스 주기 선택
- 클러스터의 백업 옵션 구성
- M2/M5 계층 백업 옵션
- M10+ 티어 백업 옵션
- 종료 방지
- 샤딩된 클러스터 배포
- 샤드 배포 정보
- 구성 서버 배포 정보
mongos
정보 배포- 샤드 수를 구성합니다.
- 복제본 세트를 샤딩된 클러스터로 업그레이드 시 고려할 사항
- Atlas용 BI Connector 활성화
- 읽기 설정
- 샘플링 설정
- 자체 암호화 키 관리
- 전제 조건
- 절차
- 추가 옵션 구성
- 고려 사항
- 추가 설정 보기 및 편집
- 최소 oplog 기간 설정
- Oplog 크기 설정
- 인덱스 키 제한 적용
- 서버 측 JavaScript 허용
- 수정 및 익명화된 쿼리 데이터의 로깅 활성화
- 최소 TLS 프로토콜 버전을 설정합니다.
- 모든 쿼리에 인덱스 필요
- 디폴트 쓰기 고려
- 트랜잭션 수명 설정
- 청크 마이그레이션 동시성을 설정합니다.
- 빠른 디스크 사전 예열 활성화 또는 비활성화
- 읽기 작업의 기본 시간 제한 설정
- 복제본 세트 확장 모드 구성
- 로그 편집 활성화
- 샤딩된 클러스터용 Atlas 관리 Config 서버
Atlas 클러스터에 대해 다음과 같은 추가 설정을 구성할 수 있습니다.
클러스터의 MongoDB 버전 선택
Atlas는 다음 계층 및 MongoDB 버전으로 클러스터를 생성할 수 있도록 지원합니다.
MongoDB 버전 | 지원 M10+ | 무료 및 공유 티어( M0 , M2 , M5 )에서 지원됨 |
---|---|---|
MongoDB 5.0 | ||
MongoDB 6.0 | ||
MongoDB 7.0 | ||
최신 릴리스(자동 업그레이드) |
중요
클러스터에서 MongoDB의 릴리스 후보를 실행하는 경우, Atlas는 일반적으로 사용 가능한 릴리스 버전이 출시되면 클러스터를 안정적인 릴리스 버전으로 업그레이드합니다.
Rapid Release MongoDB 버전을 사용하려면 Latest Release를 선택해야 자동 업그레이드가 실행됩니다. 특정 Rapid Release 버전은 선택할 수 없습니다.
새로운 패치 릴리스가 제공되면 Atlas는 클러스터 가용성을 유지하기 위해 순차적으로 이러한 릴리스로 업그레이드합니다. 다음 Rapid Release 버전으로 업그레이드하는 동안 Atlas UI Database
Deployments 페이지의 클러스터 카드에는 현재 클러스터에서 사용 가능한 기능을 반영하기 위해 MongoDB 버전 대신 클러스터의 FCV
가 표시될 수 있습니다.
Atlas가 주요 MongoDB 버전의 사용 기한 만료를 처리하는 방법의 자세한 내용은 사용 기한 만료가 임박한 MongoDB 버전을 사용하는 Atlas 클러스터는 어떻게 되나요?를 참조하세요.
중요
클러스터를 업그레이드하기 전에 주요 버전 업그레이드에 대한 현재 권장되는 모범 사례를 참조하세요.
클러스터의 MongoDB 버전을 선택하려면 클러스터 양식의 Additional Settings 섹션에 있는 드롭다운을 사용하세요.
사용 가능한 경우, 클러스터를 확장할 때 기존 Atlas 클러스터를 최신 주요 MongoDB 버전으로 업그레이드할 수 있습니다. 그러나 한 주요 버전에서 이전의 주요 버전으로 클러스터를 다운그레이드할 수는 없습니다.
중요
프로젝트에 특정 MongoDB 버전에 도입된 작업을 사용하는 사용자 지정 역할이 포함된 경우, 사용자 지정 역할을 삭제하지 않는 한 해당 버전보다 낮은 버전의 MongoDB로 클러스터를 만들 수 없습니다.
릴리스 주기 선택
주요 릴리스 주기 또는 빠른 릴리스 주기 중 하나를 따르도록 Atlas 클러스터를 설정할 수 있습니다.
프리 티어 및 공유 계층 클러스터는 주요 릴리스 주기를 따라야 합니다. 클러스터 양식의 Additional Settings 섹션에 있는 드롭다운에서 특정 MongoDB 버전을 선택하여 주요 릴리스 주기를 따르도록 전용 계층 클러스터를 구성할 수 있습니다.
Atlas는 주요 릴리스 주기에 따라 클러스터를 자동으로 업그레이드하지 않습니다. 새 주요 릴리스가 정식 버전으로 출시될 때마다 수동으로 업그레이드를 예약해야 합니다.
클러스터 양식의 Additional Settings 섹션에 있는 드롭다운에서 Latest Release를 선택하여 빠른 릴리스 주기를 따르도록 전용 계층 클러스터를 구성할 수 있습니다.
MongoDB의 최신 주요 버전을 실행하는 경우에만 Rapid Release로 클러스터를 구성할 수 있습니다. 만약 클러스터가 이전 주요 버전을 실행하는 경우 Rapid Release로 전환하려면 수동으로 최신 주요 버전으로 업그레이드해야 합니다.
Atlas는 Rapid Release 주기를 따르는 클러스터에 최신 MongoDB 릴리스를 사용합니다. Atlas는 순차적으로 이러한 클러스터를 새로운 주요 및 Rapid Release 버전으로 자동 업그레이드하여 각 릴리스가 제공될 때 클러스터 가용성을 유지합니다. 다음 Rapid Release 버전으로 업그레이드하는 동안 Atlas UI Clusters 페이지의 클러스터에는 현재 클러스터에서 사용 가능한 기능을 반영하기 위해 MongoDB 버전 대신 클러스터의 FCV
가 표시될 수 있습니다.
참고
클러스터를 주요 릴리스에서 빠른 릴리스 주기로 전환하면 현재 사용 가능한 빠른 릴리스로 바로 업그레이드됩니다. 예를 들어, MongoDB 6.2가 최신 빠른 릴리스이고 6.0을 실행하는 클러스터를 빠른 릴리스로 구성하면 클러스터가 MongoDB 6.2로 바로 업그레이드됩니다.
Rapid Release를 따르는 클러스터를 주요 버전 주기로 되돌리려면 Select a Version 드롭다운 메뉴에서 가장 최근의 주요 버전을 선택하면 됩니다. 그러나 해당 연도의 첫 번째 Rapid Release가 제공되기 전에만 이 작업을 수행할 수 있습니다. 클러스터가 주요 버전에서 Rapid Release 버전으로 업데이트된 후에는 다음 중 버전이 출시될 때까지 클러스터를 되돌릴 수 없습니다.
MongoDB 버전 관리에 대한 자세한 내용은 MongoDB 매뉴얼의 MongoDB 버전 관리 를 참조하세요. 빠른 릴리스 주기에 대한 자세한 내용은 MongoDB Stable API 및 빠른 릴리스 주기 이해를 참조하세요.
클러스터의 백업 옵션 구성
본 섹션에서는 Atlas 클러스터의 백업 구성 옵션에 대해 설명합니다.
M2/M5 계층 백업 옵션
Atlas 는 M2
및 M5
공유 클러스터에 대한 백업을 자동으로 활성화하며 비활성화할 수 없습니다. 학습 내용은 공유 클러스터 백업을 참조하세요.
M10+ 티어 백업 옵션
M10+
Atlas 클러스터에 대한 백업을 활성화하려면 Turn on Backup (M10 and up)을 Yes
로 전환합니다. 이를 활성화하면 Atlas는 정기적으로 데이터베이스의 스냅샷을 생성하여 프로젝트의 보존 정책에 따라 보존합니다.
참고
백업 컴플라이언스 정책을 활성화한 경우 클라우드 백업을 비활성화할 수 없습니다. 백업 컴플라이언스 정책에 Require Point in Time Restore to all clusters 옵션이 On으로 설정되어 있고 MongoDB 지원이 없는 경우 연속 클라우드 백업을 비활성화할 수 없습니다. 연속 클라우드 백업을 비활성화하려면 백업 컴플라이언스 정책에 지정된 보안 담당자 또는 법적 대리인이 지원을 요청하고 까다로운 확인 프로세스를 거쳐야 합니다.
Atlas는 M10+
클러스터에 대해 다음과 같은 백업 옵션을 제공합니다.
백업 옵션 | 설명 |
---|---|
Atlas는 클러스터에 있는 데이터의 증분 스냅샷을 생성하고 해당 스냅샷에서 데이터를 복원할 수 있도록 합니다. Atlas는 스냅샷 대상 복제본 세트 멤버와 동일한 클라우드 공급자 리전에 스냅샷을 저장합니다. | |
종료 방지
클러스터에 대해 Termination Protection을 활성화하려면 Termination Protection을 Yes로 전환합니다.
활성화하면 Atlas는 사용자가 클러스터를 삭제할 수 없도록 합니다. 종료 방지 기능이 활성화된 클러스터를 삭제하려면 먼저 종료 방지 기능을 비활성화해야 합니다. 기본적으로 Atlas는 모든 클러스터에 대해 종료 방지 기능을 비활성화합니다.
클러스터 종료에 대한 자세한 내용은 배포 1개 종료하기를 참조하세요.
샤딩된 클러스터 배포
팁
컬렉션을 샤딩하거나 클러스터 티어를 업그레이드하는 대신, 자주 액세스하지 않는 데이터를 Atlas 클러스터에서 MongoDB가 관리하는 읽기 전용 연합 데이터베이스 인스턴스로 옮기도록 Online Archive를 구성할 수 있습니다. 온라인 아카이브에 대해 자세히 알아보려면 온라인 아카이브 관리를 참조하십시오.
클러스터를 샤딩된 클러스터로 배포하려면 Shard your cluster (M30 and up)를 Yes
로 전환합니다.
샤딩된 클러스터는 수평 확장을 지원하며 샤드, 구성 서버 및 mongos 라우터로 구성됩니다. 자세한 내용은 구성 서버 배포서버 정보를 참조하세요. 샤딩된 읽기 작업이 계속 작동하려면 구성 서버가 읽기 가능한 상태로 유지되어야 합니다.
Atlas 관리형 설정 서버를 사용하도록 설정하면 Atlas는 전용 설정 서버를 사용하는 대신 설정 서버 데이터를 애플리케이션 데이터와 함께 코로케이션할 수 있습니다. 자세한 내용은 샤딩된 클러스터용 Atlas 관리 구성 서버를 참조하세요.
샤드 배포 정보
Atlas는 각 샤드를 3개의 노드 복제본 세트로 배포하며 여기서 각 노드는 구성된 Cloud Provider & Region, Cluster Tier 및 Additional Settings를 사용하여 배포됩니다. Atlas는 샤드 노드당 mongod
하나를 배포합니다.
교차 리전 cluster의 경우 샤드당 노드 수는 구성된 리전 전체의 투표 선택 가능 노드 및 읽기 전용 노드의 총 수와 동일합니다. Atlas는 선택한 리전 전체에 샤드 노드를 분산합니다.
구성 서버 배포 정보
전용 config 서버의 경우 Atlas는 config 서버를 3노드 복제본 세트로 배포합니다. config 서버는 M30 클러스터 계층에서 실행됩니다. 멀티 리전 클러스터에서는 config 서버가 여러 리전에 분산됩니다.
리전 간 클러스터의 경우 Atlas는 config 서버 최적의 가용성을 보장하기 위해 복제본 세트 노드를 배포합니다. 예를 들어, 선택한 클라우드 서비스 제공자 및 리전 구성에서 지원하는 경우, Atlas는 세 개의 서로 다른 가용영역과 세 개의 서로 다른 리전에 config 서버를 배포할 수 있습니다. 샤딩된 읽기 작업이 계속 작동하려면 config 서버가 읽기 가능한 상태로 유지되어야 합니다. 자세한 내용은 config 서버 가용성을 참조하세요.
Atlas 관리형 설정 서버를 사용하도록 설정하면 Atlas는 전용 설정 서버를 사용하는 대신 설정 서버 데이터를 애플리케이션 데이터와 함께 코로케이션할 수 있습니다. 자세한 내용은 샤딩된 클러스터용 Atlas 관리 구성 서버를 참조하세요.
샤딩된 클러스터에서 우선순위가 가장 높은 리전에 영향을 미치는 리전 장애 또는 리전 장애 시뮬레이션으로 인해 클러스터가 읽기 작업에 사용할 수 없게 될 수 있습니다. 구성 서버를 복원하려면 다음 단계를 따르세요.
mongos
배포 정보
Atlas는 각 샤드의 각 노드에 대해 하나의 mongos
라우터를 배포합니다. 리전 간 클러스터의 경우, 이를 통해 MongoDB 드라이버를 사용하는 클라이언트가 지리적으로 '가장 가까운' mongos
에 연결할 수 있습니다.
클러스터에서 mongos
의 라우터 수를 계산하려면 샤드 수에 샤드당 복제본 세트 노드 수를 곱합니다.
샤딩된 클러스터 배포는 복제본 세트 배포로 변환할 수 없습니다.
서버 인스턴스 수가 비용에 미치는 영향에 대해 자세히 알아보려면 노드 수를 참조하세요.
샤딩된 클러스터에 대해 자세히 알아보려면 MongoDB 매뉴얼의 Sharding 참조합니다.
샤드 수를 구성합니다.
이 필드는 배포가 샤딩된 클러스터인 경우에만 표시됩니다.
클러스터는 1~100개의 샤드를 포함할 수 있습니다.
복제본 세트를 다중 샤드 클러스터로 확장하려면 먼저 단일 샤드 클러스터로 확장하고 애플리케이션을 다시 시작하고 클러스터에 다시 연결한 후 샤드를 추가해야 합니다.
애플리케이션 클라이언트를 다시 연결하지 않으면 애플리케이션이 데이터 중단을 겪을 수 있습니다.
복제본 세트 클러스터를 단일 샤드 클러스터로 확장한 후 샤딩된 클러스터와 함께 배포할 샤드 수를 설정할 수 있습니다.
샤딩된 클러스터의 샤드 수를 줄이는 경우, Atlas는 "_id"
필드에 있는 숫자에 따라 내림차순으로 샤드를 제거합니다(샤딩된 클러스터 구성 참조). 예를 들어, 다음과 같은 세 개의 샤드가 있는 샤딩된 클러스터를 가정해 보겠습니다.
"shard0"
"shard1"
"shard2"
샤드 수를 2개로 설정하면 Atlas는 클러스터에서 "shard2"
를 제거합니다.
중요
샤드를 제거하면 Atlas는 movePrimary 명령을 사용하여 해당 샤드에 있는 샤드되지 않은 데이터베이스를 나머지 샤드로 이동합니다.
샤드 제거 프로세스 중에도 모든 샤드된 컬렉션은 온라인 상태로 유지되며 사용이 가능합니다. 그러나 movePrimary
작업 중에 샤딩되지 않은 컬렉션에 대한 읽기 또는 쓰기 작업을 수행하면 마이그레이션 실패 또는 데이터 손실과 같은 예기치 않은 동작이 발생할 수 있습니다.
샤드를 제거하기 전에 샤드되지 않은 컬렉션이 포함된 데이터베이스의 프라이머리 샤드를 이동하는 것이 좋습니다.
자세한 내용은 기존 샤딩된 클러스터에서 샤드 제거를 참조하세요.
프로덕션 환경에서는 단일 샤드로 샤딩된 클러스터를 생성하지 마세요. 단일 샤드로 샤딩된 클러스터는 다중 샤드 구성과 동일한 이점을 제공하지 않습니다. 단일 샤드 클러스터를 만든 후 애플리케이션을 다시 시작하고 클러스터에 다시 연결하고 나서 클러스터에 샤드를 추가합니다.
복제본 세트를 샤딩된 클러스터로 업그레이드 시 고려할 사항
클러스터 계층이 M30
이상인 경우 복제본 세트 배포를 샤딩된 클러스터 배포로 업그레이드할 수 있습니다.
복제본 세트를 다중 샤드 클러스터로 확장하려면 먼저 단일 샤드 클러스터로 확장하고 애플리케이션을 다시 시작하고 클러스터에 다시 연결한 후 샤드를 추가해야 합니다.
애플리케이션 클라이언트를 다시 시작하지 않는 경우 Atlas가 샤드 전체에 데이터를 배포하기 시작하면 데이터가 일치하지 않을 수 있습니다.
애플리케이션 클라이언트를 다시 연결하지 않으면 애플리케이션이 데이터 중단을 겪을 수 있습니다.
Atlas용 BI Connector 활성화
중요
Atlas BI Connector 의 수명이 곧 종료됩니다. 2025 6월에 더 이상 사용되지 않으며 더 이상 지원되지 않습니다.
MongoDB 가 Atlas용 BI Connector 에서 Atlas Atlas SQL 로 전환하고 있습니다. 새 인터페이스로 전환하는 방법에 대한 학습 내용은 Atlas BI Connector 에서 Atlas SQL 로 전환을 참조하세요.
이 클러스터에 대해 Atlas용 BI Connector를 활성화하려면 Enable Business Intelligence Connector (M10 and up) 을 Yes로 전환합니다.
참고
Atlas용 비즈니스 인텔리전스용 MongoDB 커넥터(BI 커넥터)는 M10
이상의 클러스터에서만 사용할 수 있습니다.
BI Connector 는 사용자에게 MongoDB 데이터베이스에 대한 SQL 기반 액세스 를 제공하는 강력한 도구입니다. 결과적으로 BI Connector 는 CPU 및 메모리 집약적일 수 있는 작업을 수행합니다. M10
및 M20
클러스터 계층의 hardware 리소스가 제한되어 있으므로 BI Connector 를 활성화할 때 클러스터 의 성능 저하가 발생할 수 있습니다. 이 문제가 발생하면 M30
이상의 클러스터 로 확장하다 하거나 BI Connector 를 비활성화하세요.
활성화한 경우 Atlas용 BI 커넥터를 읽을 노드 유형을 선택합니다.
읽기 설정
다음 표에서는 BI Connector에 사용할 수 있는 읽기 기본 설정과 해당 readPreference 및 readPreferenceTag 연결 문자열 옵션에 대해 설명합니다.
BI Connector 읽기 설정 | 설명 | 읽기 설정 | readPreferenceTags |
---|---|---|---|
기본 | 프라이머리 노드에서 읽습니다. |
| none |
보조 | 세컨더리 노드에서 읽습니다. |
|
|
분석 | 분석 노드에서 읽습니다. |
|
|
노드 유형
nodeType
읽기 설정 태그는 BI Connector for Atlas가 연결되는 노드 유형을 나타냅니다.. 이 옵션에는 다음 값을 지정할 수 있습니다.
ELECTABLE
는 BI Connector를 프라이머리 노드와 선택 가능한 세컨더리 노드로 제한합니다.READ_ONLY
는 BI Connector가 선택 불가능한 세컨더리 노드에 연결하도록 제한합니다.ANALYTICS
는 BI Connector를 분석 노드에만 연결하도록 제한합니다.팁
Analytics 읽기 설정을 사용하는 경우 Atlas는 Atlas용 BI Connector가 읽는 분석 노드와 동일한 하드웨어에 Atlas용 BI Connector를 배치합니다.
투표 선택 가능 노드는 데이터 보유 노드를 Atlas용 BI 커넥터에서 분리하여 Atlas용 BI Connector와 리소스를 두고 경쟁하기 때문에 cluster의 안정성과 성능이 향상됩니다.
트래픽이 많은 프로덕션 환경에서는 Primary Node 연결보다 Secondary Node(s) 또는 Analytics Node(s)에 연결하는 것이 더 나을 수 있습니다.
하나 이상의 분석 노드가 있는 클러스터의 경우 Analytics Node를 선택하여 운영 워크로드에서 Atlas 쿼리용 BI Connector를 분리하고 전담 읽기 전용 분석 노드에서 읽습니다. 이 옵션을 사용하면 선택 가능한 노드가 Atlas용 BI Connector와 리소스를 두고 경쟁하지 않으므로 클러스터의 안정성과 성능이 향상됩니다.
샘플링 설정
관계형 스키마를 생성하려면 BI Connector에 MongoDB의 샘플링 데이터가 필요합니다.
.drdl
파일을 사용할 수 없으며 mongodrdl 명령을 사용하여 Atlas BI 커넥터에서 샘플링 단계를 대체할 수 없습니다.
다음과 같은 샘플링 설정을 구성할 수 있습니다.
BI Connector 옵션 | 유형 | 설명 |
---|---|---|
스키마 샘플 크기 | integer | 선택 사항입니다. BI Connector가 스키마 정보를 수집할 때 각 데이터베이스에 대해 샘플링하는 문서 수입니다. 자세한 내용은 BI Connector 문서를 참조하세요. |
샘플 새로고침 간격 | integer | 선택 사항입니다. BI Connector가 스키마를 다시 만들기 위해 데이터를 다시 샘플링하는 빈도(초)로, 자세히 보려면 BI Connector 문서를 참조합니다. |
자체 암호화 키 관리
참고
이 기능 은 M0
무료 클러스터 및 Flex 클러스터에서는 사용할 수 없습니다. 사용할 수 없는 기능에 학습 보려면 Atlas M(무료0 클러스터), M2 및 M5 제한을 참조하세요.
Atlas는 모든 클러스터 저장과 스냅샷 볼륨을 암호화하여 모든 미사용 클러스터 데이터의 보안을 보장합니다(미사용 암호화). Atlas Project Owners
는 MongoDB 암호화 스토리지 엔진과 Atlas와 호환되는 미사용 데이터 암호화 제공자를 사용하여 미사용 데이터에 대해 추가 암호화 계층을 구성할 수 있습니다.
Atlas는 다음과 같은 미사용 데이터 암호화 제공자를 지원합니다.
전제 조건
Atlas 클러스터에서 미사용 데이터 암호화 기능을 활성화하기 전에 키 관리를 사용하여 미사용 데이터 암호화를 사용하도록 Atlas 프로젝트를 구성해야 합니다. 자세한 내용은 고객 키 관리를 사용한 미사용 데이터 암호화를 참조하세요.
클러스터의 한 미사용 데이터 암호화 제공자에서 다른 제공자로 전환하려면 먼저 클러스터에 대해 미사용 데이터 암호화를 비활성화한 다음 원하는 미사용 데이터 암호화 제공자로 다시 활성화해야 합니다. 자세한 내용은 고객 키 관리를 사용한 미사용 데이터 암호화를 참조하세요.
절차
이러한 cluster와 관련하여 자체 암호화 키 관리를 시작하려면 Encryption using your Key Management (M10 and up) 을 Yes로 전환합니다.
키 관리를 사용하는 Atlas 암호화는 M10+
복제본 세트 클러스터에서 사용할 수 있습니다.Atlas 암호화는 클러스터 백업 암호화만 지원합니다.
자체 암호화 키를 관리하면 클러스터의 시간당 실행 비용이 증가합니다. 고급 보안 기능에 대한 Atlas 청구에 대한 자세한 내용은 고급 보안을 참조하세요.
중요
Atlas가 Atlas 프로젝트 키 관리 제공자 혹은 cluster를 암호화하는 데 사용된 암호화 키에 액세스할 수 없는 경우 해당 cluster에 액세스할 수 없고 복구할 수 없게 됩니다. Atlas가 사용하는 암호화 키 또는 키 관리 제공자 자격 증명을 수정, 삭제 혹은 비활성화하기 전에 각별하게 주의를 기울입니다.
추가 옵션 구성
M10+
유료 계층 클러스터에서 다음 mongod
런타임 옵션을 구성할 수 있습니다.
고려 사항
Atlas는 복제본 세트 및 샤딩된 클러스터에 대해 Oplog Size 을 동적으로 수정합니다. 하지만 Minimum TLS Protocol Version 및 Allow Server-Side JavaScript 설정의 경우 샤드 멤버와 config 서버 복제본 세트의 롤링 재시작을 수행합니다. Atlas가 유지 관리 작업 중 고가용성을 지원하는 방법에 대해 자세히 알아보려면 MongoDB Atlas가 고가용성을 제공하는 방법을 참조합니다.
추가 설정 보기 및 편집
이러한 설정을 보고 편집하려면 다음 단계를 따르세요.
Atlas CLI를 사용하여 한 클러스터의 고급 구성 설정을 업데이트하려면 다음 명령을 실행합니다.
atlas clusters advancedSettings update <clusterName> [options]
명령 구문과 매개 변수에 관한 자세한 내용은 Atlas CLI 설명서의 Atlas 클러스터 고급 설정 업데이트를 참조하세요.
Atlas UI를 사용하여 이러한 설정을 보고 편집하려면 클러스터 양식에서 Additional Settings 아래의 More Configuration Options을(를) 여세요.
최소 oplog 기간 설정
클러스터의 oplog 항목에 대한 보존 기간을 수정합니다. 기본적으로 Atlas는 mongod
가 oplog에서 항목을 제거하기 전까지 24시간 동안 항목을 유지합니다.
이 옵션은 클러스터의 각 mongod
에 대해 storage.oplogMinRetentionHours
구성 파일 옵션을 수정하는 것에 해당합니다.
최소 oplog window를 설정하려면 다음 단계를 따르세요.
저장 자동 확장이 허용되고 이를 해제하지 않았는지 확인합니다. Atlas는 디폴트로 자동 확장을 활성화합니다.
최소 oplog window를 원하는 값으로 설정합니다. 이 값을 설정하지 않으면 Atlas는
mongod
가 oplog에서 oplog 항목을 제거하기 전에 24시간 동안 oplog 항목을 보존합니다.
Oplog 크기 설정
라이브 마이그레이션 또는 대량의 데이터 로드 시 도움이 되는 고정된 oplog 크기를 설정할 수 있습니다.
클러스터의 저장 자동 확장에서 제외하는 경우에만 Set Oplog Size 구성 설정을 지정할 수 있습니다.
스토리지 자동 확장이 활성화된 클러스터의 경우 대신 Minimum Oplog Window를 설정할 수 있습니다. 최소 oplog window 설정을 참조하세요. Atlas는 기본값으로 스토리지 자동 확장을 활성화합니다.
설정할 수 있는 최소 oplog 크기는 990메가바이트입니다. 선택한 oplog 크기로 인해 클러스터 디스크의 사용 가능한 용량이 25% 미만인 경우 Atlas에서 오류를 반환합니다.
현재 oplog 크기와 복제 지연 시간을 확인하려면 다음을 수행합니다.
mongosh
를 통해 클러스터에 연결합니다.Atlas admin
역할을 가진 사용자로 인증합니다.rs.printReplicationInfo()
메서드를 실행합니다.
Atlas는 현재 oplog 크기와 복제 지연 시간을 표시합니다.
고정된 oplog 크기를 설정하려면 다음 단계를 따르세요.
스토리지 자동 확장을 선택 해제합니다.
최소 Oplog Window를
0
으로 설정합니다.필요한 oplog 크기를 결정합니다.
Atlas UI에서 마이그레이션 프로세스 동안의 지연 시간을 모니터링합니다.
마이그레이션 중 Atlas UI에 표시된 지연 시간이
rs.printReplicationInfo()
메서드를 사용하여 얻은 복제 지연 시간에 가까워지면 oplog 크기를 늘리세요.
인풋 박스에 원하는 Oplog Size를 메가바이트 단위로 지정합니다. 설정은 디스크상의 크기가 아니라 oplog의 압축되지 않은 크기를 구성합니다.
샤딩된 클러스터 배포의 경우, 이 옵션은 클러스터에 있는 각 샤드의 oplog 크기를 수정합니다.
이 옵션은 클러스터의 각
mongod
에 대해replication.oplogSizeMB
구성 파일 옵션을 수정하는 것에 해당합니다.경고
oplog의 크기를 줄이려면 oplog에서 데이터를 제거해야 합니다. Atlas는 oplog의 크기를 줄이기 위해 제거된 모든 oplog 항목에 액세스하거나 해당 항목을 복원할 수 없습니다. oplog를 줄이기 전에 이러한 데이터 손실의 영향을 고려하세요.
디스크 공간 고려 사항
사용 가능한 디스크 공간을 늘리기 위해 oplog의 크기를 줄이지 마세요. oplog 컬렉션(local.oplog.rs
)만 oplog 크기를 줄여 절약되는 공간을 되찾을 수 있습니다. 다른 컬렉션은 oplog 저장 공간을 줄임으로써 얻을 수 있는 이점이 없습니다.
인덱스 키 제한 적용
1024바이트 인덱스 키 제한 적용을 허용하거나 사용하지 않도록 비활성화합니다. 대상 collection의 인덱스 필드 전체에서 해당 인덱스 항목이 1024바이트를 초과하지 않는 경우에만 문서를 업데이트하거나 삽입할 수 있습니다.
비활성화된 경우 mongod
는 제한을 위반하는 문서를 작성하지만 인덱싱하지는 않습니다. 이 옵션은 클러스터의 각 mongod
에 대해 setParameter
명령을 통해 param.failIndexKeyTooLong
매개변수를 수정하는 것에 해당합니다.
중요
인덱스 키 한도
param.failIndexKeyTooLong
MongoDB 버전 4.2 에서 더 이상 사용되지 않으며 MongoDB 4.4 이상에서 제거되었습니다. 4.2 이전 MongoDB의 경우 이 매개 변수를 false
로 설정합니다.
서버 측 JavaScript 허용
JavaScript의 서버 측 실행을 수행하는 작업 실행을 활성화하거나 비활성화합니다.
클러스터에서 5.0 미만의 MongoDB 버전을 실행하는 경우 이 옵션은 클러스터의 각
mongod
에 대해security.javascriptEnabled
구성 파일 옵션을 수정하는 것에 해당합니다.클러스터가 MongoDB 버전 5.0 이상을 실행하는 경우 이 옵션은 클러스터의 각
mongod
및mongos
의security.javascriptEnabled
구성 파일 옵션을 수정하는 것에 해당합니다.클러스터가 MongoDB 버전 8.0을 실행하는 경우 보안 및 성능 향상을 위해 서버 사이드 Allow Server-Side JavaScript이 기본적으로 비활성화되어 있습니다. 이 옵션은 클러스터 내 각
mongod
와mongos
의security.javascriptEnabled
설정 파일 옵션에 해당합니다.
참고
MongoDB 버전 5.0 이상에서는 security.javascriptEnabled
가 mongos에도 적용됩니다.
수정 및 익명화된 쿼리 데이터의 로깅 활성화
편집되고 익명화된 $queryStats
출력을 MongoDB 로그에 포함합니다. $queryStats
출력에 리터럴 또는 필드 값이 포함되어 있지 않습니다. 이 설정을 활성화하면 클러스터 성능에 영향을 미칠 수 있습니다.
참고
MongoDB 7.1 이상을 실행하는 Atlas 클러스터에 대해서만 쿼리 데이터의 로깅을 활성화하도록 허용할 수 있습니다.
최소 TLS 프로토콜 버전을 설정합니다.
이 클러스터가 수신 연결에 대해 허용하는 최소 TLS 버전을 설정합니다. 이 옵션은 클러스터의 각 mongod
에 대해 net.tls.disabledProtocols
구성 파일 옵션을 구성하는 것에 해당합니다.
참고
TLS 1.0 사용 중단
더 이상 사용되지 않는 TLS(전송 계층 보안) 1.0 프로토콜 버전을 사용하도록 설정하는 방법으로 이 옵션을 고려하고 있다면, 계속 진행하기 전에 Atlas가 지원하는 TLS 버전은 무엇인가요?를 읽어보세요. Atlas의 TLS 1.0 지원 중단은 전송 중인 데이터의 보안을 향상시키며 업계 모범 사례에 부합합니다. Atlas 클러스터에 대해 TLS 1.0을 활성화하는 것은 보안 위험을 수반합니다. TLS 1.1 이상을 지원하도록 애플리케이션 스택을 업데이트하는 데 필요한 기간 동안만 TLS 1.0을 사용하도록 설정하는 것이 좋습니다.
모든 쿼리에 인덱스 필요
결과를 반환하기 위해 컬렉션 스캔이 필요한 쿼리 실행을 활성화 또는 비활성화합니다. 이 옵션은 클러스터의 각 mongod
에 대해 setParameter
명령을 통해 notablescan
매개 변수를 수정하는 것에 해당합니다.
디폴트 쓰기 고려
이 클러스터에 대한 쓰기 작업에 대해 MongoDB에서 요청하는 기본값 승인 수준을 설정합니다.
MongoDB 5.0부터 클러스터의 기본 쓰기 고려는 대다수입니다.
트랜잭션 수명 설정
다중 문서 트랜잭션의 최대 수명을 설정합니다. 이 옵션은 클러스터의 각 mongod
에 setParameter
명령을 통해 transactionLifetimeLimitSeconds
매개변수를 수정하는 것에 해당합니다.
중요
트랜잭션 수명을 1초 이하로 설정할 수 없습니다.
클러스터의 기본 트랜잭션 수명은 60초입니다.
청크 마이그레이션 동시성을 설정합니다.
MongoDB 버전 5.0.15 또는 6.0.6 이상 버전을 실행하는 샤드 Atlas 클러스터의 경우 소스 샤드 및 수신 샤드의 스레드 수를 설정하여 청크 마이그레이션의 성능을 개선할 수 있습니다. 이 값은 총 CPU 코어 수의 절반으로 설정할 수 있습니다. 자세한 내용은 chunkMigrationConcurrency
를 참조하세요.
빠른 디스크 사전 예열 활성화 또는 비활성화
빠른 디스크 예열을 활성화하려면 클러스터의 경우 Allow Fast Disk Pre-Warming(을)를 Yes(으)로 토글합니다.
클러스터에 대해 빠른 디스크 예열을 비활성화하려면 Allow Fast Disk Pre-Warming 을 No로 전환합니다.
기본 클라우드 공급자 인프라의 설계로 인해 Atlas가 클러스터에서 새 노드를 프로비저닝해야 할 때마다(예: 기존 리전에 새 노드를 추가하는 경우) 디스크 사전 예열이 발생합니다. 디스크 사전 예열은 숨겨진 세컨더리 노드를 일시적으로 사용합니다.
빠른 디스크 사전 예열은 백그라운드 디스크 예열보다 빠릅니다. 기본적으로 Atlas는 배포에 대해 빠른 디스크 사전 예열을 활성화합니다. 디스크 사전 예열이 활성화되면 Atlas는 노드를 숨기고 이 노드가 읽기 작업을 실행할 수 없도록 합니다.
다음 권장 사항을 고려하세요.
일관된 쿼리 지연 시간을 요구하는 워크로드가 있는 경우 이 설정을 활성화하세요.
일관된 쿼리 성능보다 최대한의 가용성을 보장하는 워크로드가 있고 새로 추가되거나 교체된 노드가 즉시 활성화되고 표시되어야 하는 경우 이 설정을 비활성화하고 사전 예열 프로세스가 완료될 때까지 사전 예열이 완료된 노드에 대한 태그가 포함된 사용자 지정 연결 문자열을 사용합니다. 이 연결 문자열을 사용하면 대부분의 IOPS가 사전 예열 프로세스에 활용되는 동안 노드에서 읽기가 방지됩니다.
읽기 작업의 기본 시간 제한 설정
MongoDB 버전 8.0+를 실행하는 클러스터의 경우 이러한 클러스터에 대한 모든 읽기 작업의 기본 최대 제한 시간(밀리초)을 지정할 수 있습니다. 이렇게 하면 의도하지 않은 장기 실행 쿼리로부터 데이터베이스를 보호할 수 있습니다. 이 옵션은 클러스터 매개변수 defaultMaxTimeMS에 해당합니다.
복제본 세트 확장 모드 구성
클러스터의 복제본 세트 확장 모드를 수정합니다. 기본적으로, Atlas는 노드를 In Parallel By Workload Type로 확장합니다. 이는 Atlas가 운영 노드와 함께 분석 작업을 병렬로 확장함을 의미합니다.
Atlas는 In Parallel By Node Type 및 Sequential 모드를 사용하여 복제본 세트를 확장할 수도 있습니다.
In Parallel By Node Type 모드는 빈번하고 시기적절한 클러스터 계층 확장이 필요한 대규모 동적 워크로드에 적합합니다. 이 모드에서는 Atlas가 선택 가능한 노드를 읽기 전용 및 분석 노드와 병렬로 확장합니다. 이는 가장 빠른 확장 전략이지만, 광범위한 세컨더리 읽기 수행 시 워크로드의 지연 시간에 영향을 미칠 수 있습니다.
Sequential 모드는 정상 상태 워크로드 및 지연 시간에 민감한 세컨더리 읽기를 수행하는 애플리케이션을 위한 것으로, Atlas가 모든 노드를 순차적으로 확장한다는 의미입니다.
로그 편집 활성화
이 옵션을 켜면 필드 값에 잠재적으로 민감한 정보가 기록되지 않습니다. 자세한 내용은 로그 편집을 참조하세요.
로그 편집을 활성화 및 비활성화하려면 롤링 재시작이 필요합니다.
샤딩된 클러스터용 Atlas 관리 Config 서버
새 샤딩된 클러스터에 대한 config 서버 유형의 Atlas 관리를 활성화하거나 비활성화합니다. Atlas로 관리되는 config 서버는 최적의 성능과 비용 절감을 위한 기준에 따라 config 서버 유형을 자동으로 전환합니다. 샤딩된 클러스터에 대해 Atlas 관리 config 서버를 사용하도록 설정하지 않는 경우, Atlas는 항상 클러스터에 전용 config 서버를 사용합니다.
모든 8.0에 대해 Atlas 샤딩 클러스터, Atlas에서 관리하는 config 서버는 기본적으로 On입니다. Atlas 관리 config 서버를 비활성화하려면 토글을 Off로 설정합니다. 클러스터에 샤드와 임베디드 config 서버가 4개 미만인 경우, Atlas 관리형 config 서버를 끄면 클러스터가 전용 구성 서버로 즉시 전환됩니다.
Config 서버 유형
Atlas에서 관리하는 config 서버가 활성화된 각각의 새로운 샤딩 클러스터에 대해 Atlas는 샤드가 4개 미만인 클러스터용 내장 config 서버와 샤드가 3개 이상인 클러스터용 전용 config 서버를 배포합니다.
임베디드 config 서버는 애플리케이션 데이터를 구성 샤드에 있는 구성 데이터와 함께 콜로케이션합니다. 임베디드 config 서버 클러스터는 리소스 사용량이 적으므로 비용이 저렴합니다.
전용 config 서버는 설정 데이터에 대해 별도의 전용 설정 서버 복제본 세트를 사용합니다. 애플리케이션 데이터는 전용 config 서버의 구성 데이터와 함께 배치되지 않습니다. 전용 config 서버 클러스터는 추가 복제본 세트를 사용하므로 비용이 더 많이 듭니다.
config 서버 유형에 대한 고려 사항에 대해 자세히 알아보려면 config 서버 고려 사항을 참조하세요.
Config 서버 변경 기준
Atlas 관리 Config 서버를 활성화하면 Atlas는 다음과 같이 초기 클러스터 Config 서버 유형을 결정합니다.
클러스터 샤드 수가 3개보다 많으면 Atlas는 전용 Config 서버를 사용합니다.
클러스터 샤드 수가 3개 이하인 경우 Atlas 는 내장된 구성 서버를 사용합니다.
Atlas 관리형 구성 서버를 활성화한 상태에서 샤드를 추가하거나 제거하면 Atlas는 동일한 기준을 사용하여 샤드 클러스터의 구성 서버 유형을 자동으로 다시 선택합니다.
config 서버 고려 사항
MongoDB 8.0보다 낮은 버전을 가진 모든 클러스터는 전용 구성 서버를 사용합니다.
다음 기능 중 하나를 사용하는 경우에는 Atlas가 config 서버 유형을 변경하지 않습니다.
샤드가 3개 이상인 클러스터에서 이러한 기능 사용으로 인해 전용 config 서버로 전환할 수 없는 경우 MongoDB 지원팀에 문의하여 구성 서버 유형을 변경하세요.
Atlas 관리 config 서버를 활성화하는 경우 다음 사항을 고려하세요.
MongoDB 8.0 이상을 실행하는 클러스터의 경우 복제본 세트 ID는 복제본 세트에 저장된 데이터 유형을 반영하지 않습니다.
복제본 세트 ID에
shard
라는 텀이 포함된 복제본 세트는 애플리케이션 데이터, 구성 데이터 또는 둘 다(예:atlas-abc123-shard-0
)를 저장할 수 있습니다.복제본 세트 ID에
config
라는 용어가 포함된 복제본 세트는 애플리케이션 데이터(예:atlas-abc123-config-0
)를 저장할 수 있습니다.
백업 스냅샷 고려 사항
전용 config 서버가 있는 클러스터에서 전용 config 서버를 사용하는 클러스터로만 스냅샷을 복원할 수 있습니다.
내장된 구성 서버가 있는 클러스터에서 내장된 구성 서버를 사용하는 클러스터로만 스냅샷을 복원할 수 있습니다.