쿼리 형태 인사이트를 사용하여 실행 속도가 느린 쿼리가 있는 쿼리 형태에 대한 작업 수준 쿼리 실행 지표를 모니터링할 수 있습니다. 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)을 수집합니다.
참고
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 프로젝트 형태 쿼리 보고서에 자동으로 구독합니다.
프로젝트
Query Targeting: Scanned Objects / Returned경고 받습니다.경고 MongoDB 버전 8.0 이상 실행 전용 클러스터 (M10 이상)에서 발생합니다.
Project Owner 사용자는 프로젝트 쿼리 타겟팅 경고 수신했는지 여부에 관계없이 쿼리 형태 보고서를 수동으로 구독 하거나 구독 취소할 수도 있습니다. 자세히 학습 보고서 구독 관리를 참조하세요.
행동 보고
Atlas 다음 예정 에 따라 쿼리 형태 보고서를 보냅니다.
프로젝트 자격을 갖추게 되면
Query Targeting: Scanned Objects / Returned경고 약 1시간 후에 첫 번째 보고서를 Atlas .Atlas 프로젝트 구독을 취소할 때까지 약 일주일에 한 번 추가 보고서를 보냅니다.
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 관리 API 통해 사용할 수 없습니다.
차트로 작성할 쿼리 셰이프 선택
기본값 으로 Query Shape Insights 는 Total Execution Time가 가장 높은 상위 5개 쿼리 형태에 대한 메트릭 차트를 표시합니다. Query Shape Insights 테이블에서 차트 로 작성할 쿼리 형태를 최대 5개까지 선택할 수 있습니다.
Query Shape Insights 테이블에서 쿼리 형태를 검색 하고 선택하려면 다음을 수행합니다.