쿼리 형태 인사이트를 사용하여 느리게 실행되는 쿼리가 있는 쿼리 형태 에 대한 작업 수준의 쿼리 실행 지표 모니터 할 수 있습니다. Query Shape Insights 페이지에는 프로젝트 에서 총 실행 시간이 가장 긴 쿼리 형태에 대한 성능 지표 설명하는 차트와 표가 표시됩니다. 표시된 쿼리 형태 데이터를 호스팅하다, 샤드, 시간 범위 별로 필터하다 최대 5개의 쿼리 형태를 선택하여 해당 지표 차트에서 시각화할 수 있습니다.
Atlas MongoDB 버전 8.0 이상을 실행 전용 클러스터(M10 이상)에서만 쿼리 형태 인사이트를 지원합니다.
Atlas의 쿼리 형태 통계 수집 방법
쿼리 형태 인사이트는 클러스터에서 실행되는 작업의 하위 집합에서 데이터를 표시합니다. 컬렉션 방법은 클러스터의 MongoDB 버전에 따라 달라집니다:
MongoDB 8.x를 실행하는 클러스터에서, Atlas가 각 호스트에서 최대 100 개의 읽기 쿼리를 초당 기록합니다. Atlas는 쓰기 (write) 작업을 수집하지 않습니다.
MongoDB 9.0 이상을 실행하는 클러스터에서 Atlas는 기본적으로 읽기 및 쓰기 (write) 작업의 1% 를 무작위로 샘플링합니다. 표시된 지표 값에는 샘플 작업만 반영되며, 총 작업의 약 1% 수준입니다. 드물게 실행되는 쿼리 형태는 결과에서 표시되지 않을 수 있습니다. 이 방법은 쓰기 (write) 작업(
insert,update,delete)도 수집하며, 이 작업은 쿼리 형태 Insights에서 읽기 작업과 함께 표시됩니다.
참고
MongoDB 8.x에서 9.0으로 클러스터를 업그레이드한 후, 쿼리 형태 인사이트의 지표 총계는 업그레이드 전보다 훐씬 다르게 나타날 수 있습니다. 이 차이는 클러스터의 워크로드 변경이 아니라 샘플링 방법의 변경을 반영합니다.
필요한 액세스 권한
쿼리 형태 인사이트를 사용하여 지표 보려면 프로젝트에 대한 Project Observability Viewer, Project Data Access Read Only, Project Data Access Read/Write, Project Data Access Admin 또는 Project Owner 액세스 있어야 합니다.
중요
쿼리 형태는 필드 이름을 노출하지만 수정된 값에는 사용자 PII가 포함될 수 있습니다. 쿼리 형태 인사이트에서 잘린 쿼리 형태 또는 전체 쿼리 형태를 보려면 위에 나열된 프로젝트 역할 중 하나가 있어야 하며, 각 역할에 PII를 볼 수 있는 액세스 있어야 합니다. 이러한 권한이 없는 사용자의 경우 쿼리 형태 인사이트는 쿼리 쿼리 형태 해시로 쿼리 형태를 식별합니다.
쿼리 형태 인사이트에 액세스
쿼리 형태 인사이트 액세스 하려면 다음을 수행합니다.
Atlas 에서 프로젝트 의 Clusters 페이지로 이동합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.
사이드바에서 Database 제목 아래의 Clusters를 클릭합니다.
Clusters(클러스터) 페이지가 표시됩니다.
쿼리 인사이트 필터링
Query Insights 페이지를 노드, 노드 상태 (프라이머리 또는 세컨더리) 및 샤드 별로 필터하다 할 수 있습니다. 지난 7일 이내의 사용자 지정 날짜 범위 로 필터하다 하거나 다음 사전 설정 시간 범위 중 하나를 선택할 수도 있습니다.
7일
5일
2일
24 시간 (기본값)
12시간
8시간
1시간
필터하다 적용 Atlas 현재 화면의 차트 및 표에 대한 데이터를 다시 가져옵니다.
참고
분석 노드 는 세컨더리 노드 상태 기준으로 필터하다 때 포함됩니다.
Charts 및 테이블에서 지표 보기
쿼리 형태 인사이트는 실행 속도가 느린 쿼리가 있는 프로젝트 의 쿼리 형태에 대한 지표 설명하는 차트와 테이블을 표시합니다.
쿼리 형태 인사이트 표에는 프로젝트 의 각 상위 쿼리 형태 에 대한 행이 하나씩 포함되어 있으며, 여기서 상위 쿼리 형태는 가장 높은 총 실행 시간에 따라 결정됩니다. 각 행에는 쿼리 형태 또는 쿼리 형태 해시, 쿼리 형태 의 네임스페이스 , 쿼리 명령, 표시하도록 선택한 지표 포함됩니다. Edit Columns 버튼을 사용하여 다음 지표 중 테이블 열로 포함할 지표 를 선택할 수 있습니다.
메트릭 | 설명 |
|---|---|
총 실행 시간 | |
평균 실행 시간 | |
실행 횟수 | 지정된 쿼리 형태 가진 쿼리가 실행된 총 횟수입니다. |
키 검사 | 지정된 쿼리 형태 가진 쿼리에서 검사한 인바운드 및 아웃바운드 인덱스 키의 총 개수입니다. |
검사한 키: 반환됨 | 지정된 쿼리 형태 의 쿼리에서 반환된 문서가 포함된 인덱스에 대해 검사한 인바운드 및 아웃오브 인덱스 키의 비율입니다. |
Docs 검토 | 지정된 쿼리 형태 가진 쿼리에서 검사한 문서의 총 개수입니다. |
반환된 Docs | 지정된 쿼리 형태 가진 쿼리에서 반환된 문서의 총 개수입니다. |
검사된 Docs : 반환됨 | 지정된 쿼리 형태 의 쿼리에서 반환된 문서 대비 검사한 문서의 비율입니다. |
Docs 일치된 | 지정된 쿼리 형태 가진 쿼리에서 일치한 문서의 총 개수입니다. MongoDB 9.0 이상을 실행하는 클러스터의 쓰기 (write) 명령에서만 사용 가능합니다. |
Docs 수정됨 | 지정된 쿼리 형태 가진 쿼리에서 수정된 문서의 총 개수입니다. MongoDB 9.0 이상을 실행하는 클러스터의 쓰기 (write) 명령에서만 사용 가능합니다. |
Docs 업서트됨 | 지정된 쿼리 형태 가진 쿼리에서 업서트된 문서의 총 개수입니다. MongoDB 9.0 이상을 실행하는 클러스터의 쓰기 (write) 명령에서만 사용 가능합니다. |
Docs 삽입됨 | 지정된 쿼리 형태 가진 쿼리에서 삽입된 문서의 총 개수입니다. MongoDB 9.0 이상을 실행하는 클러스터의 쓰기 (write) 명령에서만 사용 가능합니다. |
Docs 삭제 | 지정된 쿼리 형태 가진 쿼리에서 삭제된 문서의 총 개수입니다. MongoDB 9.0 이상을 실행하는 클러스터의 쓰기 (write) 명령에서만 사용 가능합니다. |
키 삽입됨 | 지정된 쿼리 형태 가진 쿼리에서 삽입된 인덱스 키의 총 개수입니다. MongoDB 9.0 이상을 실행하는 클러스터의 쓰기 (write) 명령에서만 사용 가능합니다. |
키 삭제 | 지정된 쿼리 형태 가진 쿼리에서 삭제된 인덱스 키의 총 개수입니다. MongoDB 9.0 이상을 실행하는 클러스터의 쓰기 (write) 명령에서만 사용 가능합니다. |
총 응답 시간 | 쿼리 처리 시작부터 첫 번째 서버 응답까지 소요된 시간(마이크로초)입니다. |
마지막 실행 시간 | 지정된 쿼리 형태 를 가진 가장 최근 쿼리 의 실행 런타임(마이크로초)입니다. |
P50 실행 시간 | 실행 시간 히스토그램의 50번째 백분위 . |
P90 실행 시간 | 실행 시간 히스토그램의 90번째 백분위 . |
P99 실행 시간 | 실행 시간 히스토그램의 99번째 백분위 . |
Query Shape Statistics 구성 요소 헤더의 드롭다운 메뉴에서 차트 로 작성할 각 지표를 선택하여 위의 지표 중 하나 이상에 대한 차트를 표시할 수도 있습니다.
Atlas 한 번에 최대 5개의 쿼리 형태에 대해 각 지표 차트 수 있습니다. 기본값 으로 Atlas Charts Total Execution Time가 가장 높은 5개 쿼리 형태에 대한 각 지표를 차트로 표시합니다. 원하는 쿼리 형태의 행에 있는 확인란을 선택하거나 선택 취소하여 다양한 쿼리 형태를 차트 로 작성할 수 있습니다. 원하는 쿼리 형태의 행에 있는 확인란을 선택하거나 선택 취소하여 표에서 차트 로 작성할 쿼리 형태를 관리 할 수 있습니다.
쿼리 형태 에 대한 자세한 내용을 보려면 쿼리 형태 의 행을 클릭하여 Query Shape Details 보기를 엽니다. 이 뷰에는 전체 쿼리 형태 및 쿼리 형태 해시, 위에 나열된 각 테이블 지표 및 다음 추가 지표 포함됩니다.
마지막으로 본 타임스탬프
처음 본 타임스탬프
마지막으로 본 애플리케이션
마지막으로 본 드라이버 이름 및 버전
처음 본 애플리케이션
처음 본 드라이버 이름 및 버전
쿼리 형태 보고서
Atlas가 프로젝트의 클러스터에 대한 효율적이지 않은 쿼리 형태를 요약하는 쿼리 형태 보고서 이메일을 보낼 수 있습니다. 느린 쿼리를 식별하고 조사하는 데 도움이 되도록 보고서에서 Query Shape Insights 페이지로 직접 연결됩니다.
자격
Atlas 프로젝트가 다음 기준을 충족하는 경우, Atlas는 프로젝트를 자동으로 쿼리 형태 보고서에 구독합니다.
프로젝트는
Query Targeting: Scanned Objects / Returned경고를 받습니다.경고는 MongoDB 버전 8.0 이상을 실행하는 전용 클러스터(M10 이상)에서 발생합니다.
Project Owner 사용자는 프로젝트가 쿼리 대상 경고를 받았는지 여부와 관계없이 쿼리 형태 보고서를 수동으로 구독하거나 구독 취소할 수도 있습니다. 자세한 내용은 보고서 구독 관리를 참조하세요.
행동 신고
Atlas는 다음 예정에 따라 쿼리 형태 보고서를 보냅니다:
프로젝트가 적격이 되면 Atlas가
Query Targeting: Scanned Objects / Returned경고 후 약 1시간 이내에 첫 번째 보고서를 보냅니다.Atlas가 프로젝트가 수신 거부할 때까지 주당 약 1회 추가 보고서를 보냅니다.
Atlas는 Project Owner 역할을 가진 모든 사용자에게 각 보고서를 보냅니다.
특정 보고 기간에 대해 적격 쿼리 형태가 존재하지 않은 경우, Atlas는 해당 보고서를 건너뛰고 다음 예정된 보고서를 계속합니다.
보고서 내용
각 쿼리 형태 보고서 이메일에는 다음 정보가 포함되어 있습니다.
Atlas UI의 조직, 프로젝트 및 클러스터에 대한 링크
클러스터의 Query Shape Insights 페이지로 이동하는 링크.
최대 5개의 쿼리 형태 표, 총 실행 시간으로 순위가 정렬된. 각 쿼리 형태는 표시되려면 보고 기간 동안 최소 10 회 실행되어야 합니다.
Query Shape Insights 페이지에서 각 쿼리 형태의 세부 정보로 이동하는 링크
Project Settings의 보고서 구독 설정 링크. 자세히 알아보려면 프로젝트 설정 관리를 참조하세요.
쿼리 형태 테이블에는 지난 3일 동안 각 쿼리 형태에 대한 다음 지표가 포함됩니다.
열 | 설명 |
|---|---|
컬렉션 이름 | 쿼리 형태가 대상으로 하는 컬렉션의 이름입니다. |
평균 실행 시간 | 지정된 쿼리 형태로 쿼리를 실행하는 데 소요된 평균 시간. |
실행 횟수 | 지정된 쿼리 형태 가진 쿼리가 실행된 총 횟수입니다. |
Docs 검사됨:반환 비율 | 지정된 쿼리 형태 의 쿼리에서 반환된 문서 대비 검사한 문서의 비율입니다. |
보고서 구독 관리
프로젝트 설정에서 쿼리 형태 보고서를 구독하거나 구독을 취소할 수 있습니다. 이 설정은 프로젝트의 모든 사용자의 보고서를 제어합니다. Project Owner 역할을 가진 사용자만 구독을 변경할 수 있으며, Project Owner 사용자만 보고서를 받습니다.
쿼리 형태 보고서 관리:
Atlas에서 Project Settings 페이지로 이동합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.
사이드바에서 아이콘을 Project Overview 옆에 있는 클릭합니다.
- 프로젝트 설정 페이지
- 표시합니다.
Query Shape Reports 설정을 전환합니다.
토글을 켜서 구독하거나, 토글을 꺼서 구독을 취소하세요. 처음 구독할 때 보고서에 포함할 클러스터를 선택합니다. 변경 사항은 프로젝트의 모든 Project Owner 사용자에게 적용됩니다.
쿼리 형태 보고서 이메일에서 구독 취소 링크를 클릭하여 구독을 취소할 수도 있습니다. 이 링크를 클릭하면 Project Settings으로 이동합니다. 이 곳에서 Atlas가 해당 프로젝트의 수신을 중단합니다. 구독 취소 링크는 로그인을 할 필요 없이도 작동합니다.
제한 사항
쿼리 형태 보고서에는 다음과 같은 제한 사항이 있습니다:
구독 설정은 전체 프로젝트에 적용됩니다. 개별 사용자를 구독하거나 구독 취소할 수 없습니다.
쿼리 형태 보고서는 Atlas Administration API를 통해 사용할 수 없습니다.
차트로 작성할 쿼리 셰이프 선택
기본값 으로 Query Shape Insights 는 Total Execution Time가 가장 높은 상위 5개 쿼리 형태에 대한 메트릭 차트를 표시합니다. Query Shape Insights 테이블에서 차트 로 작성할 쿼리 형태를 최대 5개까지 선택할 수 있습니다.
Query Shape Insights 테이블에서 쿼리 형태를 검색 하고 선택하려면 다음을 수행합니다.