AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.
Docs Menu

샤딩 인사이트

상용 Atlas 배포에서 MongoDB 8.0 이상 실행 M10+ 샤딩된 클러스터가 필요합니다.

Atlas Sharding Insights는 샤딩된 클러스터에 대한 전용 모니터링 및 관찰 가능성을 제공합니다. 샤딩 인사이트 대시 대시보드 샤딩 메타데이터, hardware 사용량, 데이터 배포 및 밸런서 활동을 한곳에서 제공합니다. 샤딩 인사이트를 사용하여 성능 지표 보고, 워크로드 분산을 추적 , 샤딩된 클러스터의 구성 요소 전반에 걸친 문제를 식별합니다.

Atlas 샤딩 결정이 클러스터의 성능을 향상시킬 수 있는 시기를 식별하는 데 도움이 되는 Performance Advisor 에서 다음과 같은 권장 사항을 제공합니다.

  • 복제본 설정하다 확장하다 제한에 근접하고 있습니다.

  • 대규모 또는 증가하는 비샤드 컬렉션

  • 클러스터가 저장 또는 리소스 한도에 근접

샤드 키 분석기를 사용하여 이러한 권장 사항에 대한 후보 샤드 키를 분석 .

샤딩 인사이트는 클러스터 구성 요소 전체의 성능, 워크로드 분산, 리소스 사용량을 모니터 할 수 있는 Shards, Collections 및 Mongos Instances 보기를 제공합니다.

이 페이지에는 클러스터 요약 정보, 활성 샤딩 권장 사항 및 시간 경과에 따른 hardware 및 샤딩별 지표 보여주는 차트가 표시됩니다.

지난 1시간부터 지난 90일까지의 시간 범위 로 지표 필터하다 하거나 사용자 지정 날짜 및 시간 범위 선택하여 특정 기간을 분석 수 있습니다.

1
  1. 아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

  2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

  3. 사이드바에서 Database 제목 아래의 Clusters를 클릭합니다.

Clusters(클러스터) 페이지가 표시됩니다.

2
3

샤딩 인사이트 페이지는 다음과 같은 보기를 제공합니다.

  • Shards: 개별 샤드에 대한 지표 모니터링합니다.

  • Collections: 개별 컬렉션에 대한 지표 모니터링합니다.

  • Mongos Instances: 클러스터 의 mongos 인스턴스에 대한 지표 모니터링합니다.

시간 범위 선택기를 사용하여 사전 설정된 시간 범위 선택하거나 Filter by Date and Time 선택기로 사용자 지정 날짜 및 시간 범위 선택합니다.

참고

샤딩 인사이트 및 샤딩 권장 사항은 기본값 으로 활성화되어 있습니다. 프로젝트 소유자와 관리자는 프로젝트 설정의 프로젝트 수준에서 이러한 기능을 토글할 수 있습니다.

  • Sharding Insights: " 샤딩 상태 및 지표 보기"

  • Sharding Recommendations: " 샤딩 구성 개선을 위한 사용자 지정 권장 사항"

샤딩 인사이트 페이지 상단에는 주요 클러스터 개요 정보를 보여주는 요약 섹션이 표시됩니다.

  • 총 샤드: 클러스터 에 있는 총 샤드 수입니다.

  • 밸런서 상태: 밸런서 의 현재 상태 (활성화 또는 비활성화)입니다.

  • 밸런싱 기간(UTC): 설정하다 경우 밸런서 작업에 대한 구성된 시간 창 .

  • config 서버: 구성 서버 상태 개요입니다.

이 요약은 클러스터의 샤딩 구성 및 현재 상태 에 대한 간략한 개요를 제공합니다.

클러스터 요약 아래의 Recommendations 카드에는 클러스터 에 대한 활성 샤딩 권장 사항이 표시되며, 권장 사항 수를 나타내는 배지가 있습니다. 카드를 펼치면 각 권장 사항의 요약을 볼 수 있습니다. Atlas 다음을 감지하면 조치 권장합니다.

  • 샤딩 의 이점을 누릴 수 있는 대규모 또는 증가 중인 비샤드 컬렉션 .

  • 저장 또는 리소스 제한에 근접한 클러스터 , 추가 샤드의 이점을 누릴 수 있습니다.

  • 확장하다 제한에 근접한 복제본 세트 , 샤딩된 클러스터 로 변환하면 도움이 될 수 있습니다.

Performance Advisor 에서 권장 사항의 세부 정보를 보려면 권장 사항을 클릭합니다. 후보 샤드 키를 평가하려면 Analyze Shard Keys를 클릭하여 새 탭 에서 샤드 키 분석기를 엽니다.

클러스터 에 활성 권장 사항이 없는 경우 카드에는 "현재는 권장 사항 없음"이 표시됩니다. 메시지.

Shards 보기에는 선택한 지표 에 대한 time-series 차트와 클러스터의 샤드 테이블이 표시됩니다. 기본값 으로 대시보드 System CPU, System Memory, Connections 및 Opcounters 차트가 표시됩니다.

다른 지표 표시하려면 지표 선택기에서 해당 지표를 선택합니다. 차트와 샤드 테이블을 노드 유형별로 필터하다 하려면 노드 필터하다 에서 All Nodes, Primaries 또는 Secondaries를 선택합니다.

샤딩 인사이트는 카테고리별로 그룹화된 다음 지표 제공합니다.

샤드 별로 집계된 하드웨어 리소스 사용량 지표 :

  • System CPU: 샤드 의 모든 코어에서 사용된 CPU 시간의 백분율입니다.

  • System Memory: 샤드 에서 사용 중인 RAM 의 양입니다.

  • System Network: 샤드 에서 초당 들어오고 나가는 총 네트워크 바이트입니다.

  • Disk IOPS: 초당 디스크 읽기 및 쓰기 (write) 작업 수입니다.

  • Disk Latency: 디스크 작업의 평균 읽기 및 쓰기 (write) 지연 시간 .

  • Disk Throughput: 초당 디스크에서 읽고 쓴 바이트 수입니다.

  • Disk Space: 샤드 에서 사용되고 사용 가능한 디스크 공간입니다.

  • Data Size: 샤드 에 보관된 사용자 데이터의 압축되지 않은 크기로, 데이터베이스 전체에서 합산됩니다. 프로젝트 에 대해 데이터베이스 통계 컬렉션 비활성화된 경우 이 차트 비어 있습니다.

샤드 당 쿼리 및 작업 처리량 지표 :

  • Connections: 샤드 에 대한 활성 클라이언트 연결의 수입니다.

  • Opcounters: 초당 삽입, 쿼리, 업데이트, 삭제, 가져오기 및 명령 작업의 비율입니다.

  • Queues: 글로벌 락 획득하기 위해 대기 중인 작업의 수입니다.

  • Replication Lag: 복제 중 프라이머리 와 세컨더리 간의 지연 시간(밀리초)입니다.

  • Read Latency: 샤드 에 대한 읽기 작업의 평균 실행 시간입니다.

  • Write Latency: 샤드 에 대한 쓰기 (write) 작업의 평균 실행 시간입니다.

  • Command Latency: 샤드 에 대한 명령 작업의 평균 실행 시간입니다.

샤드 당 스토리지 엔진 캐시 사용량 및 효율성 :

  • Cache Fill Ratio: 현재 사용 중인 구성된 스토리지 엔진 캐시 의 백분율입니다. 100%에 가까운 비율은 작업 세트 캐시 보다 크다는 것을 나타냅니다.

  • Dirty Fill Ratio: 아직 디스크에 기록되지 않은 수정된 페이지를 보유하고 있는 구성된 스토리지 엔진 캐시 의 비율입니다. 비율이 높으면 쓰기 (write) 과부하를 나타낼 수 있습니다.

  • Cache Hit Ratio: 디스크에서 페이지를 읽지 않고 스토리지 엔진 캐시 에서 처리된 페이지 요청의 비율입니다.

샤딩된 컬렉션의 샤드별 데이터 크기, 문서 수 및 청크 분포:

  • Owned Data Size: 각 샤드 가 소유한 데이터의 크기로, 샤딩된 컬렉션에서 합산됩니다.

  • Orphaned Data Size: 각 샤드 에 있는 고아 데이터의 크기로, 샤딩된 컬렉션에서 합산됩니다.

  • Owned Document Count: 각 샤드 가 소유한 문서 수로, 샤딩된 컬렉션에서 합산됩니다.

  • Orphaned Document Count: 샤딩된 컬렉션에서 합산된 각 샤드 에 있는 고아 문서의 수입니다.

  • Chunk Count: 샤딩된 컬렉션에서 각 샤드 에 있는 청크의 수입니다.

  • Jumbo Chunk Count: 각 샤드 에 있는 점보 청크의 수입니다. 밸런서 점보 청크를 마이그레이션 할 수 없습니다.

이러한 지표 샤드 전체의 성능 병목 현상, 용량 문제 및 데이터 배포 불균형을 식별하는 데 도움이 됩니다.

차트 아래의 샤드 표에는 선택한 범위 동안 각 샤드 의 상태, 데이터 크기, 평균 및 최대 CPU 사용량, 초당 읽기, 초당 쓰기가 나열됩니다. 테이블은 차트에 표시되는 샤드를 제어합니다. 테이블에 표시할 열을 선택하려면 Edit Columns을 클릭합니다.

샤드 에 대한 세부 정보 패널을 열려면 해당 행을 클릭합니다. 패널에는 샤드의 활성 경고 및 개요 지표 표시되며, 여기에는 샤딩된 컬렉션 수, 평균 읽기 및 쓰기 (write) 로드, 평균 작업 실행 시간, 캐시 활동, 범위 삭제기 활동 등을 포함합니다.

기록 지표 보려면 시간 범위 선택합니다.

  • 사전 설정 범위: 1시간, 8시간, 12시간, 24시간, 3일, 7일, 30일, 60일 또는 90일 중에서 선택 .

  • 사용자 지정 범위: Filter by Date and Time 선택기를 사용하여 특정 시작 및 종료 날짜와 시간을 선택합니다.

특정 창 으로 확대하려면 차트 드래그합니다. 선택한 시간 범위 로 돌아가려면 Reset zoom를 클릭합니다.

기록 데이터는 추세를 식별하고, 시간 경과에 따른 변화를 추적 , 문제와 특정 이벤트의 상관 관계를 파악하는 데 도움이 됩니다.

Atlas 컬렉션에 가장 적합한 샤드 키를 분석 하고 선택할 수 있는 도구인 샤드 키 분석기를 제공합니다. Performance Advisor 통해 Shard Key Advisor에 액세스하여 클러스터의 쿼리 패턴과 워크로드 특성을 기반으로 후보 샤드 키를 평가하세요.

샤딩 인사이트 페이지의 Recommendations 카드에서 Analyze Shard Keys을 클릭하여 Shard Key Advisor를 열 수도 있습니다.

샤드 키 관리자를 사용하려면 Project Data Access Read Only 또는 Project Sharding Manager 역할 과 같은 데이터 액세스 역할 있어야 합니다.

분석기 는 샤딩 권장 사항과 함께 Performance Advisor 에 표시되며 다음 항목에 대한 즉각적인 분석을 제공합니다.

  • 카디널리티: 후보 필드에 있는 값의 고유성입니다.

  • 단조성: 시간이 지남에 따라 필드 값이 증가하거나 감소하는지 여부.

  • 빈도: 필드 전체의 값 분포 .

선택적으로 쿼리 샘플링을 활성화 읽기 및 쓰기 (write) 배포 패턴에 대한 심층적인 인사이트를 얻을 수 있습니다.

샤딩 인사이트를 사용하려면 클러스터 다음 요구 사항을 충족해야 합니다.

  • 클러스터 구성: 샤드 클러스터 ( 복제본 세트에는 사용할 수 없음).

  • MongoDB 버전: MongoDB 8.0 이상.

  • 클러스터 계층: M10 클러스터 계층 이상.

  • 프로젝트 설정: 샤딩 인사이트는 기본값 으로 활성화되어 있습니다. 클러스터 사이드바에 Sharding Insights 페이지가 표시되지 않는 경우,프로젝트 설정에서 해당 설정이 활성화되어 있는지 확인하세요.

  • 환경: 상업용 Atlas 배포에만 해당됩니다.

이 페이지는 시간 범위, 선택한 지표, 노드 필터하다, 선택한 샤드 등의 보기 설정을 페이지 URL 에 유지합니다. 이를 통해 특정 뷰를 북마크에 추가하거나 팀 과 URL을 주식 수 있습니다.

전제 조건을 충족하지 않는 클러스터 에서 샤딩 인사이트에 액세스 경우, Atlas 샤딩 인사이트 페이지 대신 해당 기능 사용할 수 없는 이유를 설명하는 배너를 표시합니다.

이 출시하다 에서는 샤딩 인사이트에 다음과 같은 제한 사항이 있습니다.

샤딩 인사이트는 다음 지원 하지 않습니다.

  • 복제본 설정하다 배포( 샤딩된 클러스터만 해당).

  • 8.0 이전의 MongoDB 버전을 실행 클러스터.

  • M10 이하 계층의 클러스터.

  • Atlas 데이터 지역화를 사용하는 클러스터.

  • Cloud Manager 또는 Ops Manager 배포.

  • 정부 cloud 환경.

이 출시하다 다음을 지원 하지 않습니다.

  • 샤딩 인사이트 데이터에 대한 Atlas 관리 API 액세스 .

  • 샤딩 인사이트 구성을 위한 Terraform 제공자 지원 .

  • 샤딩 인사이트 지표 위한 MongoDB MCP 서버 통합.

이러한 기능은 향후 릴리스에서 추가될 수 있습니다.

권장 사항에 따라 조치를 취하거나 샤딩 변경하기 전에 다음과 같은 중요한 고려 사항을 검토 .

  • 영구적인 변경: 복제본 세트 샤딩된 클러스터 로 변환하는 것은 영구적인 아키텍처 결정이며 되돌릴 수 없습니다.

  • 계획 필요: 컬렉션 을 샤드 하기 전에 샤딩 문서를 검토하고 샤드 키 전략을 계획하세요.

  • 샤드 키 선택: 쿼리 패턴을 지원하고 우수한 데이터 분산을 제공하는 샤드 키 선택합니다. 잠재적 샤드 키를 평가하려면 샤드 키 선택을 참조하세요.

  • 프로덕션 전 테스트: 프로덕션에 적용하기 전에 샤딩된 클러스터 에서 선택한 샤드 키 애플리케이션 테스트합니다. 복제본 세트 에서 샤딩된 클러스터 로 이동하면 기능 및 성능에 차이가 발생할 수 있습니다. 애플리케이션 이 이러한 차이점을 적절하게 처리하는지 확인합니다.

샤드 클러스터는 복제본 세트와 다른 쓰기 (write) 작업 시맨틱을 가집니다.

클러스터 를 샤드 전에 샤딩 작업 제한 사항을 검토합니다.

  • PrivateLink 영향: 클러스터 에서 PrivateLink를 사용하는 경우 복제본 세트 에서 샤딩된 클러스터 로 변환하면 샤드에 대한 연결이 완전히 차단 됩니다. 애플리케이션 다시 시작되어 mongos 라우터에 다시 연결될 때까지 다운타임이 발생합니다.

  • 연결 업데이트: 복제본 세트 에서 샤딩된 클러스터 로 변환할 때 mongos 라우터에 다시 연결하려면 애플리케이션 다시 시작해야 합니다. 애플리케이션 SRV 연결 문자열 사용하는 경우 연결 문자열 변경할 필요는 없지만 애플리케이션 다시 시작해야 합니다. 기존 샤딩된 클러스터 에 샤드를 추가할 때 애플리케이션 다시 시작할 필요는 없습니다.

샤드 간에 컬렉션을 이동하는 경우:

  • 한 번에 하나씩: 한 번에 하나의 컬렉션 만 이동할 수 있습니다.

  • 쓰기 차단 없음: 컬렉션 이동은 이동 중에 쓰기 (write) 작업을 계속할 수 있는 리샤딩을 사용합니다.

  • 대상 용량: 대상 샤드 저장 및 리소스 용량 충분해야 합니다.

  • 작업 시간: 대규모 컬렉션은 이동하는 데 상당한 시간이 걸릴 수 있습니다.

샤딩 개념, 권장 사항 및 클러스터 관리 에 대해 자세히 학습 다음을 참조하세요.