정의
경고
$queryStats 애그리게이션 단계는 지원되지 않으며 향후 릴리스에서 안정적임을 보장하지 않습니다. 출력이 향후 릴리스에서 변경될 수 있으므로 이 단계의 특정 출력 형식에 의존하는 기능을 빌드하지 마세요.
기록된 쿼리에 대한 런타임 통계를 반환합니다.
$queryStats aggregate(), find(), distinct(), count(), update(), insert(), deleteOne() 및 deleteMany() 쿼리에 대한 지표를 수집하고 보고합니다. $queryStats 는 Queryable Encryption사용하는 쿼리에 대한 정보를 수집하지 않습니다.
요구 사항:
$queryStats 단계는 클러스터 계층 이 M10 이상인 MongoDB Atlas 에서 호스팅되는 배포에서 활성화됩니다.
$queryStats 단계를 실행하려면 파이프라인이 다음 요구 사항을 충족해야 합니다.
파이프라인은
admin데이터베이스에서 실행되어야 합니다.$queryStats은(는) 파이프라인의 첫 번째 단계여야 합니다.
구문
db.adminCommand( { aggregate: 1, pipeline: [ { $queryStats: { transformIdentifiers: { algorithm: <string>, hmacKey: <binData> /* subtype 8 - used for sensitive data */ } } } ], cursor: { } } )중요
특정 컬렉션 에서 $queryStats 를 실행 수 없습니다. 전체 예제는 예제를 참조하세요 .
명령 필드
$queryStats 은(는) 다음 필드를 사용합니다.
필드 | 필요성 | 유형 | 설명 |
|---|---|---|---|
| 옵션 | 문서 |
|
|
| 문자열 | 출력의 네임스페이스 정보 및 필드 이름에 적용되는 해시 변환 유형입니다. 현재 지원되는 유일한 |
|
| BinData | EMAC 변환의 비공개 키 입력입니다. |
액세스 제어
배포서버에서 액세스 제어를 적용하는 경우 $queryStats 를 실행하는 사용자는 다음 권한이 있어야 합니다.
transformIdentifiers옵션 없이$queryStats를 실행하려면 사용자에게queryStatsRead권한 조치가 있어야 합니다.transformIdentifiers옵션으로$queryStats를 실행하려면 사용자에게queryStatsRead및queryStatsReadTransformed권한 조치가 모두 있어야 합니다.
기본 제공 clusterMonitor 역할은 queryStatsRead 및 queryStatsReadTransformed 권한을 제공합니다. 다음 예에서는 admin 데이터베이스에 clusterMonitor 역할을 부여합니다.
db.grantRolesToUser( "<user>", [ { role: "clusterMonitor", db: "admin" } ])행동
다음 섹션에서는 $queryStats 단계의 동작 세부정보를 설명합니다.
$queryStats가 쿼리 통계를 추적하는 방법
$queryStats 단계에 대한 통계는 인메모리에 저장된 가상 collection에서 추적됩니다. 가상 collection의 메모리 제한은 시스템 전체 메모리의 1%입니다.
$queryStats 샘플 작업 방법
버전 9.0에 추가 되었습니다.
MongoDB 9.0부터 $queryStats는 기본적으로 읽기 (write) 및 쓰기 (write) 작업의 1% 샘플에 대한 통계를 수집합니다. 샘플링 속도를 변경하려면 읽기 (write) 작업의 경우 internalQueryStatsSampleRate 매개변수를 설정하고, 쓰기 (write) 작업의 경우 internalQueryStatsWriteCmdSampleRate 매개변수를 설정합니다. 두 매개변수 모두 0.0에서 1.0 사이의 값을 허용합니다.
$queryStats은(는) MongoDB가 샘플링한 작업만 보고하므로, 해당 출력은 배포서버에서 실행된 작업의 하위 집합을 나타냅니다. 개수와 실행 시간은 샘플링된 작업만 반영합니다.
$queryStats 그룹이 문서를 반환하는 방법
$queryStats 공통 속성을 가진 쿼리를 동일한 출력 문서로 그룹화합니다. 결과 문서를 쿼리 통계 항목 이라고 합니다.
$queryStats 사용자 제공 필드 값을 해당 데이터 유형으로 정규화하여 유사한 쿼리를 함께 그룹화합니다. 예를 들어 { item: 'card' } 으로 지정된 필터는 { item : '?string'} 로 정규화됩니다. $queryStats 는 hint 및 comment 와 같은 일부 쿼리 옵션의 값도 정규화합니다.
$queryStats readConcern 및 readPreference 과 같은 옵션의 리터럴 값을 유지합니다.
쿼리 통계 항목에 포함된 전체 옵션 목록은 명령 쿼리 형태 찾기를 참조하세요.
$queryStats가 transformationIdentifier를 사용하여 데이터를 변환하는 방법
LMAC 키가 transformIdentifiers 옵션에 지정된 경우 $queryStats 은(는) LMAC 키를 사용하여 다음 데이터에 EMAC-SHA-256 해시 함수를 적용합니다.
문서 필드 이름
컬렉션 이름
데이터베이스 이름
$queryStats 다음 데이터에 EMAC 변환을 적용 하지 않습니다 .
연산자 이름과 같은 MQL 키워드(예:
$gte).$setWindowFields의partitionBy매개변수와 같은 매개변수 이름입니다.필드 값.
$queryStats쿼리가 기록될 때 쿼리의 필드 값을 데이터 유형(예: 숫자 또는 문자열)으로 정규화합니다.$queryStats은(는) 사용자 데이터가 포함된 필드 값을 저장하지 않습니다.
변환된 출력의 예시 는 변환된 예제를 참조하세요 .
$queryStats Log Entries
MongoDB 는 배포서버 로그 에 $queryStats 작업을 기록합니다. 기본값 으로 MongoDB 는 $queryStats 작업의 호출만 기록하고 작업 출력은 기록하지 않습니다. transformIdentifiers 옵션이 포함된 $queryStats 작업의 경우 변환된 출력을 로그 항목에 포함할지 여부를 지정할 수 있습니다.
$queryStats 로깅 동작을 제어하는 방법을 알아보려면 $queryStats 로그 출력 토글을 참조하세요.
변경 스트림
다음 이벤트 중 하나가 발생하면 변경 스트림 에 대한 쿼리 통계가 업데이트됩니다.
커서 가 생성됩니다.
getMore작업이 완료됩니다.커서 가 닫힙니다.
변경 스트림에 대해 보고된 쿼리 통계에는 다음과 같은 동작이 있습니다.
totalExecMicros과 같은 실행 지표 에는 가장 최근 작업(커서 생성,getMore또는 커서 닫기)에 대한 정보가 포함되어 있습니다.내부
getMore작업은execCount지표를 증가시킵니다.firstResponseExecMicros각getMore작업에 대해 통계가 수집되고 업데이트되므로totalExecMicros과 는 항상 동일합니다.커서 가 닫히면
lastExecutionMicros은 0 입니다.
샤드 클러스터 동작
버전 8.3에 추가 되었습니다.
샤딩된 클러스터에서 $queryStats 가 활성화되면 MongoDB 각 mongod 및 mongos 에 대해 쿼리 통계를 별도로 기록합니다. 샤드 서버는 mongos에서 시작되는 쿼리에 대한 통계도 기록 . 이는 사용자가 mongos를 통해 라우팅하는 쿼리에 대해 보다 완전한 샤드 수준 지표 제공합니다.
출력
$queryStats 쿼리 통계 항목의 배열을 반환합니다. 일부 쿼리 통계 항목 속성에는 리터럴 값이 포함되어 있으며, 일부 속성은 일반적인 쿼리를 그룹화하도록 정규화됩니다.
참고
MongoDB 9.0은 지표 조직을 개선하기 위해 $queryStats 출력 구조를 업데이트합니다.
쿼리 통계 항목에는 다음과 같은 최상위 문서가 포함되어 있습니다.
문서 | 설명 |
|---|---|
| 쿼리 통계 출력의 항목을 정의하는 속성의 고유한 조합입니다.
각각의 고유한 속성 조합은 |
|
|
| 각 쿼리 통계 항목과 연결된 애그리게이션된 런타임 지표를 포함합니다. 각 쿼리 통계 항목은 동일한 키를 공유하는 각 쿼리에 대한 통계를 기록합니다. |
출력 배열의 각 문서에는 다음 필드가 포함되어 있습니다.
필드 | 유형 | 리터럴 또는 정규화 | 설명 |
|---|---|---|---|
| 문서 | 리터럴 | 쿼리 형태와 쿼리 세트를 함께 그룹화하는 추가 쿼리 속성을 포함합니다. |
| 문서 | 리터럴 | 유사한 쿼리를 함께 그룹 하는 데 사용되는 속성을 포함합니다. 자세한 내용은 쿼리 형태를 참조하세요. |
| 문서 | 리터럴 | 키와 연결된 클라이언트 정보를 설명합니다. |
| 문서 | 리터럴 | 클라이언트 애플리케이션 이름 |
| 문서 | 리터럴 | 쿼리를 실행하는 데 사용되는 드라이버를 설명합니다. |
| 문자열 | 리터럴 | 쿼리를 실행하는 데 사용된 드라이버의 이름입니다. 가능한 값에는 |
| 문자열 | 리터럴 | 쿼리를 실행하는 데 사용된 드라이버의 버전 번호 |
| 문서 | 리터럴 | 쿼리를 실행한 클라이언트에서 사용하는 운영 체제를 설명합니다. |
| 문자열 | 리터럴 | 운영 체제 유형 |
| 문자열 | 리터럴 | 운영 체제의 이름 |
| 문자열 | 리터럴 | 운영 체제의 아키텍처입니다. 가능한 값에는 |
| 문자열 | 리터럴 | 운영 체제의 버전 번호 |
| 문서 | 리터럴 | 키에 대한 읽기 고려 (read concern) |
| 문자열 | 리터럴 | 쿼리가 실행된 컬렉션의 유형입니다. 자세한 내용은 컬렉션 유형을 참조하세요. |
| 문서 또는 문자열 | 정규화 | 쿼리에 대한 힌트 로 사용된 인덱스 |
| 문자열 | 정규화 | 키의 배치 크기 입니다. 배치 크기는 쿼리 결과의 각 배치 에서 반환될 수 있는 최대 문서 수를 지정합니다. 기본값 으로 초기 배치 크기는 |
| 문자열 | 정규화 | 키와 관련된 주석 |
| 문자열 | 정규화 | 키와 연결된 maxTimeMS 값 |
| 부울 | 정규화 | 키와 연결된 noCursorTimeout 옵션 |
| 문자열 | 리터럴 | 키와 연결된 읽기 설정 |
| 문자열 | 리터럴 | 키와 연결된 Stable API 버전입니다. 서버 업그레이드를 위한 MongoDB Stable API를 참조하세요. |
| 부울 | 리터럴 | 키와 연결된 |
| 부울 | 리터럴 | 키와 연결된 |
| 문자열 | 리터럴 |
|
| 문자열 | 리터럴 | 버전 8.0에 추가 되었습니다.
|
| 문서 | 리터럴 | 키에 대한 런타임 통계를 설명합니다. |
| 문서 | 리터럴 | 버전 9.0에 추가 되었습니다. 커서 및 배치 프로토콜과 관련된 지표 |
| 문서 | 리터럴 | 버전 9.0에서 변경되었습니다. 키 내의 쿼리 가 처리 되기 시작한 시점부터 서버 가 첫 번째 결과 배치 를 반환할 때까지 소요된 시간을 설명합니다.
|
| 문서 | 리터럴 | 버전 9.0에 추가 되었습니다. 쿼리 실행과 관련된 지표 |
| 문서 | 리터럴 | 버전 9.0에서 변경되었습니다. 키 내에서 쿼리가 반환한 문서 수를 설명합니다. |
| NumberLong | 리터럴 | 지정된 키를 사용하여 쿼리에서 반환된 총 문서 수입니다. |
| NumberLong | 리터럴 | 지정된 키를 사용하여 쿼리에서 반환되는 최대 문서 수 |
| NumberLong | 리터럴 | 지정된 키를 사용하여 쿼리에서 반환된 최소 문서 수입니다. |
| NumberDecimal | 리터럴 | 키 내 쿼리가 반환하는 문서 수의 제곱의 합계입니다.
|
| 문서 | 리터럴 | 쿼리에서 검사하는 키 수를 설명합니다. |
| Integer | 리터럴 | 검사한 키의 총 개수 |
| NumberLong | 리터럴 | 검사되는 최대 키 수 |
| NumberLong | 리터럴 | 검사하는 키 수 최소화 |
| NumberDecimal | 리터럴 | 검사한 키 수의 제곱합입니다.
|
| 문서 | 리터럴 | 버전 9.0에서 변경되었습니다. 쿼리로 검사한 문서 수를 설명합니다. |
| Integer | 리터럴 | 쿼리 에서 검사한 문서의 총 개수 |
| NumberLong | 리터럴 | 검사할 최대 문서 수 |
| NumberLong | 리터럴 | 최소 검사 문서 수 |
| NumberDecimal | 리터럴 | 검사한 문서 수의 제곱의 합입니다.
|
| 문서 | 리터럴 | 버전 9.0에서 변경되었습니다. 쿼리가 읽은 바이트 수를 설명합니다. |
| Integer | 리터럴 | 쿼리에서 읽은 총 바이트 수 |
| NumberLong | 리터럴 | 최대 읽기 바이트 수 |
| NumberLong | 리터럴 | 읽은 최소 바이트 수 |
| NumberDecimal | 리터럴 | 읽은 바이트 수의 제곱합입니다. |
| 문서 | 리터럴 | 버전 9.0에서 변경되었습니다. 쿼리의 읽기 시간을 마이크로초 단위로 설명합니다. |
| Integer | 리터럴 | 마이크로초 단위의 쿼리 총 읽기 시간 |
| NumberLong | 리터럴 | 마이크로초 단위의 쿼리 최대 읽기 시간 |
| NumberLong | 리터럴 | 마이크로초 단위의 최소 쿼리 읽기 시간 |
| NumberDecimal | 리터럴 | 쿼리의 읽기 시간 제곱의 합(마이크로초 단위) |
| NumberLong | 리터럴 | 버전 9.0에서 변경되었습니다. 쿼리 작업이 예상 실행 티켓 획득 시간을 초과한 횟수입니다. |
| NumberLong | 리터럴 | 버전 9.0에서 변경되었습니다. 쿼리 작업이 예상 실행 티켓 획득 시간을 초과한 총 시간(밀리초)입니다. |
| NumberLong | 리터럴 | 버전 9.0에서 변경되었습니다. 쿼리 작업이 예상 실행 티켓 획득 시간을 초과한 가장 긴 시간(밀리초)입니다. |
| NumberLong | 리터럴 | 지정된 키를 가진 모든 쿼리에 대한 가장 최근 쿼리의 실행 런타임입니다. |
| NumberLong | 리터럴 | 지정된 키로 쿼리가 실행된 횟수입니다. |
| 문서 | 리터럴 | 버전 9.0에서 변경되었습니다. 쿼리 계획 관련 지표 |
| 문서 | 리터럴 | 버전 9.0에서 변경되었습니다. 두 개의 필드
|
| 문서 | 리터럴 | 버전 9.0에서 변경되었습니다. 두 개의 필드
|
| 문서 | 리터럴 | 버전 9.0에서 변경되었습니다. 두 개의 필드
|
| 문서 | 리터럴 | 버전 9.0에서 변경되었습니다. 두 개의 필드
|
| 문서 | 리터럴 | 버전 9.0에 추가 되었습니다. 주어진 키가 있는 쿼리에 대해 MongoDB가 선택한 플랜 형태의 수입니다. 자세한 내용은 플랜 형태 카운터를 참조하세요. |
| 문서 | 리터럴 | 버전 9.0에 추가 되었습니다. 최적 계획의 전반적인 형태의 개수. 각 우승 계획은 최대 하나의 패턴과 일치합니다. |
| 문서 | 리터럴 | 버전 9.0에 추가 되었습니다. 최적의 플랜에 나타나는 플랜 단계 유형의 수입니다. 단일 최적 플랜이 여러 노드 카운터와 일치할 수 있습니다. |
| 문서 | 리터럴 | 버전 9.0에 추가 되었습니다. 선택된 플랜이 사용하는 데이터 액세스 경로 및 인덱스 바운드의 수입니다. 단일 선택 플랜은 여러 액세스 경로 카운터와 일치할 수 있습니다. |
| 문서 | 리터럴 | 버전 9.0에서 변경되었습니다. 쓰기 (write)와 관련된 지표 |
| NumberLong | 리터럴 | 버전 9.0에 추가 되었습니다. 업데이트가 선택하는 문서 수 |
| NumberLong | 리터럴 | 버전 9.0에 추가 되었습니다. 업데이트 작업이 삽입하는 문서 수 |
| NumberLong | 리터럴 | 버전 9.0에 추가 되었습니다. 업데이트 작업이 수정하는 문서 수 |
| NumberLong | 리터럴 | 버전 9.0에 추가 되었습니다. 삭제 작업으로 삭제되는 문서 수 |
| NumberLong | 리터럴 | 버전 9.0에 추가 되었습니다. 삽입 작업으로 삽입되는 문서 수(업서트 제외) |
| NumberLong | 리터럴 | 버전 9.0에 추가 되었습니다. 원본 업데이트 요청에서의 업데이트 수 |
| 문서 | 리터럴 | 지정된 키로 쿼리를 실행하는 데 소요된 총 시간을 설명합니다. 쿼리 결과가
|
| NumberLong | 리터럴 | 지정된 키로 쿼리를 실행하는 데 소요된 총 시간 |
| NumberLong | 리터럴 | 주어진 키로 쿼리를 실행하는 데 소요된 최장 시간 |
| NumberLong | 리터럴 | 주어진 키로 쿼리를 실행하는 데 소요된 최단 시간 |
| NumberDecimal | 리터럴 | 지정된 키를 사용한 모든 쿼리에 대한 총 실행 시간의 제곱합입니다. |
| NumberLong | 리터럴 | 쿼리 처리 시작부터 서버가 첫 번째 결과 배치를 반환할 때까지 소요된 총 시간입니다. |
| NumberLong | 리터럴 | 쿼리 처리 시작부터 서버가 첫 번째 결과 배치를 반환할 때까지 소요된 최장 시간입니다. |
| NumberLong | 리터럴 | 쿼리 처리 시작부터 서버가 첫 번째 결과 배치를 반환할 때까지 소요된 최단 시간입니다. |
| NumberDecimal | 리터럴 | 쿼리 처리 시작부터 서버가 첫 번째 결과 배치를 반환할 때까지 소요된 시간의 제곱의 합계입니다.
|
| 날짜 | 리터럴 | 마지막 재시작 이후 지정된 키의 쿼리가 처음 사용된 시간입니다. |
| 날짜 | 리터럴 | 지정된 키가 포함된 쿼리가 가장 최근에 사용된 시간입니다. |
| NumberLong | 리터럴 | 잠금 및 흐름 제어를 기다리는 시간과 같은 의도적인 일시 중지를 제외한 작업 실행 시간입니다. |
| 문서 | 리터럴 | 쿼리 계획 동안 사용될 때 CBR에 관련된 지표가 포함됩니다. CBR은 여러 쿼리 계획을 평가하여 예상 비용을 기반으로 가장 효율적인 계획을 선택합니다. 버전 8 의 새로운 기능입니다.3.3. |
| 문서 | 리터럴 | 주어진 키를 가진 쿼리의 비용 기반 순위 지정을 위해 샘플링된 문서 수와 관련된 지표가 포함됩니다. 버전 8 의 새로운 기능입니다.3.3. |
| NumberLong | 리터럴 | 비용 기반 순위 지정 동안 샘플링된 총 문서 수. 버전 8 의 새로운 기능입니다.3.3. |
| NumberLong | 리터럴 | 비용 기반 순위 지정 동안 샘플링된 문서의 최대 수. 버전 8 의 새로운 기능입니다.3.3. |
| NumberLong | 리터럴 | 비용 기반 순위 지정 시 샘플링되는 문서의 최소 개수. 버전 8 의 새로운 기능입니다.3.3. |
| NumberDecimal | 리터럴 | 비용 기반 순위 지정 중 샘플링한 문서 수의 제곱의 합계
버전 8 의 새로운 기능입니다.3.3. |
| 문서 | 리터럴 | 비용 기반 순위 지정 동안 사용된 각 카디널리티 추정 메서드의 카운트가 포함됩니다. 각 필드는 특정 추정 메서드가 사용된 횟수를 나타냅니다. 버전 8 의 새로운 기능입니다.3.3. |
| NumberLong | 리터럴 | 히스토그램 기반 카디널리티 추정이 사용된 횟수 버전 8 의 새로운 기능입니다.3.3. |
| NumberLong | 리터럴 | 샘플링 기반 카디널리티 추정이 사용된 횟수. 버전 8 의 새로운 기능입니다.3.3. |
| NumberLong | 리터럴 | 휴리스틱 기반 카디널리티 추정이 사용된 횟수. 버전 8 의 새로운 기능입니다.3.3. |
| NumberLong | 리터럴 | 카디널리티 추정에 대한 혼합 접근 방식이 사용된 횟수. 버전 8 의 새로운 기능입니다.3.3. |
| NumberLong | 리터럴 | 메타데이터 기반 카디널리티 추정이 사용된 횟수. 버전 8 의 새로운 기능입니다.3.3. |
| NumberLong | 리터럴 | 코드 기반 카디널리티 추정이 사용된 횟수. 버전 8 의 새로운 기능입니다.3.3. |
| 문서 | 리터럴 | 쿼리 작업의 CPU 사용량과 관련된 지표 포함되어 있습니다. 이 문서 Linux 시스템에서만 사용할 수 있습니다. 버전 8.2에 추가 되었습니다. |
| NumberLong | 리터럴 | 쿼리 작업에 소요된 총 CPU 시간(나노초) 입니다. 이 필드는 Linux 시스템에서만 사용할 수 있습니다. 버전 8.2에 추가 되었습니다. |
| NumberLong | 리터럴 | 쿼리 작업에 소요되는 최대 CPU 시간(나노초). 이 필드는 Linux 시스템에서만 사용할 수 있습니다. 버전 8.2에 추가 되었습니다. |
| NumberLong | 리터럴 | 쿼리 작업에 소요된 최소 CPU 시간(나노초)입니다. 이 필드는 Linux 시스템에서만 사용할 수 있습니다. 버전 8.2에 추가 되었습니다. |
| NumberDecimal | 리터럴 | 쿼리 작업에 소요된 CPU 시간의 제곱합입니다. 이 필드 Linux 시스템에서만 사용할 수 있습니다.
버전 8.2에 추가 되었습니다. |
| NumberLong | 리터럴 | 쿼리 실행 중에 문의한 모든 원격 샤드의 로컬 피크 추적 메모리 합계와 피크 추적 메모리 합계입니다. 버전 9.0에 추가 되었습니다. |
| NumberLong | 리터럴 | 최대 로컬 추적 메모리 사용량입니다. 버전 9.0에 추가 되었습니다. |
| 문서 | 리터럴 | 지정된 키로 쿼리를 계획하는 데 소요된 시간과 관련된 지표가 포함됩니다. 버전 8.3에 추가 되었습니다. |
| NumberLong | 리터럴 | 총 쿼리 계획 시간. 버전 8.3에 추가 되었습니다. |
| NumberLong | 리터럴 | 최대 쿼리 계획 시간. 버전 8.3에 추가 되었습니다. |
| NumberLong | 리터럴 | 최소 쿼리 계획 시간입니다. 버전 8.3에 추가 되었습니다. |
| NumberDecimal | 리터럴 | 쿼리 계획 시간의 제곱의 합.
버전 8.3에 추가 되었습니다. |
| NumberLong | 리터럴 | 쿼리 작업에서 초당 버전 8.3에 추가 되었습니다. |
| NumberLong | 리터럴 | 샘플링된 쿼리 작업을 위해 시스템이 버전 8.3에 추가 되었습니다. |
플랜 모양 카운터
버전 9.0에 추가 되었습니다.
metrics.queryPlanner.planShapeCounters 문서는 MongoDB가 주어진 키를 가진 쿼리에 대해 각 플랜 형태를 얼마나 자주 선택했는지 기록합니다. 이 카운터를 사용하여 워크로드가 가장 많이 의존하는 쿼리 계획을 확인하세요.
planShapeCounters 최대 3개의 하위 문서를 포함하며, 각 하위 문서는 카운터 이름을 개수에 매핑합니다.
하위 문서 | 설명 |
|---|---|
| 각 승리 플랜의 전체 형태를 계산합니다. 패턴은 상호 배타적이므로 각 쿼리 실행은 최대 하나의 패턴 카운터를 증가시킵니다. |
| 각 승리 계획에 나타나는 계획 단계의 유형을 계산합니다. 노드 카운터는 상호 배타적이지 않으므로 하나의 쿼리 실행으로 여러 카운터가 증가할 수 있습니다. |
| 각 승리 플랜이 사용하는 데이터 액세스 경로와 인덱스 바운드를 계산합니다. 액세스 경로 카운터는 상호 배타적이지 않으므로 하나의 쿼리 실행으로 여러 카운터가 증가할 수 있습니다. |
각 카운터는 계획이 해당 단계나 액세스 경로를 여러 번 사용하더라도 각 쿼리 실행마다 최대 1씩 증가합니다. 예를 들어, $or 단계 아래에 1,000 분기가 있는 계획은 일치하는 $or 노드 카운터를 1,000가 아닌 1씩 증가시킵니다. 결과적으로 카운터는 각 실행이 단계를 몇 번 사용했는지가 아니라 몇 번의 실행이 단계를 사용했는지를 기록합니다.
MongoDB는 카운트가 0인 카운터를 생략하고 카운터가 없는 하위 문서를 생략합니다. 기록된 쿼리 중 플랜 형태 카운터를 생성한 쿼리가 없으면 MongoDB는 planShapeCounters 문서를 완전히 생략합니다. 예시, _id로 단일 문서를 일치시키는 쿼리는 추적된 플랜 형태와 일치하지 않는 빠른 경로를 사용하므로 해당 쿼리 통계 항목에는 planShapeCounters 문서가 포함되지 않습니다.
MongoDB는 최상위 쿼리에 대해서만 플랜 형태 카운터를 기록합니다. 예를 들어, MongoDB는 $lookup 단계의 외부 측에 대한 카운터를 기록하지 않습니다.
카운터 패턴
각 패턴 카운터 이름은 액세스 경로 단계를 시작으로 승리한 계획의 단계를 순서대로 나열합니다. 예시, ixscanFetchSort은 인덱스 스캔을 사용하고, 일치하는 문서를 가져온 다음, 정렬하는 승리한 계획의 수를 계산합니다.
패턴 이름은 대략적인 수준에서 계획을 설명합니다. 이 이름은 limit 및 skip 단계를 생략하며, 단계가 필터를 적용하는지 또는 계획이 어떤 유형의 프로젝션을 사용하는지 구분하지 않습니다. 이러한 세부 정보를 확인하려면 패턴 카운터를 nodes 카운터 및 항목에 대한 쿼리 형태와 결합하세요.
patterns 다음 카운터를 포함할 수 있습니다.
액세스 경로 | 카운터 |
|---|---|
컬렉션 스캔 |
|
페치를 사용한 인덱스 스캔 |
|
다음과 같은 인덱스 스캔: |
|
즉시 가져오기 없는 인덱스 스캔 |
|
노드 카운터
MongoDB는 쿼리 실행 엔진을 선택한 후 노드 카운터를 기록합니다. 따라서 카운터에는 슬롯 기반 엔진으로 푸시된 집계 단계를 나타내는 계획 단계가 포함됩니다.
nodes 다음 카운터를 포함할 수 있습니다.
카운터 | 설명 |
|---|---|
| 필터 적용 여부에 따라 별도로 계산되는 컬렉션 스캔 단계입니다. |
| 단계에 필터가 적용되는지 여부에 따라 별도 계산되는 인덱스 스캔 단계입니다. |
| 필터 적용 여부에 따라 별도로 계산되는 Fetch 단계입니다. |
| 해시 기반 인덱스 교차 단계는 단계가 필터를 적용하는지 여부에 따라 별도로 계산됩니다. |
| 정렬된 인덱스 교집합 단계. |
|
|
| 정렬 병합 단계는 해당 단계가 필터를 적용하는지 여부와 100 개 이상의 하위 단계가 있는지 여부에 따라 별도로 계산됩니다. |
| 문서 대신 인덱스 키를 반환하는 단계입니다. |
| 샤드에서 고아 문서를 필터링하는 단계입니다. |
| 프로젝션 유형별로 별도로 계산된 프로젝션 단계입니다. |
| 정렬을 위한 정렬 키를 생성하는 단계입니다. |
| 정렬 단계는 정렬 유형과 정렬에 제한이 있는지 여부에 따라 별도로 계산됩니다. |
| limit 단계는 limit 값에 따라 별도로 계산됩니다. |
| skip 단계는 skip 값에 따라 별도로 계산됩니다. |
| 텍스트 검색 결과를 결합하는 단계입니다. |
| 매치 단계입니다. |
| 문서의 루트를 대체하는 단계입니다. |
| 그룹 스테이지. |
| 결과를 언와인드(unwind)하는지 여부에 따라 별도로 계산되는 동등성 조회 단계입니다. |
| Time Series 버킷을 언팩하는 단계입니다. |
| 조인 단계는 조인 알고리즘(해시 조인, 중첩 루프 조인, 인덱스 중첩 루프 조인, 인덱스 프로브)별로 별도로 계산됩니다. |
액세스 경로 카운터
accessPaths 다음 카운터를 포함할 수 있습니다.
카운터 | 설명 |
|---|---|
| 컬렉션 스캔은 스캔이 클러스터형 인덱스를 사용하는지 여부에 따라 별도로 계산됩니다. |
| 문서를 가져오지 않는 인덱스 스캔. |
| 문서를 가져오는 인덱스 스캔입니다. |
| 문서를 반환하지 않고 인덱스 키를 계산하는 스캔입니다. |
| 스캔이 문서를 가져오는지 여부에 따라 별도로 계산되는 중복 인덱스 키를 건너뛰는 스캔입니다. |
| |
| 텍스트 인덱스를 사용하는 텍스트 검색입니다. |
| 컬렉션 스캔, 인덱스 스캔, 카운트 스캔, 디스틴트 스캔 또는 지리 공간적 액세스 경로를 사용하지 않는 우승 플랜입니다. 텍스트 검색만 수행하는 플랜은 |
| 인덱스 속성별로 별도로 계산된 인덱스 스캔입니다. 단일 인덱스 스캔으로 이러한 카운터 중 여러 개가 증가할 수 있습니다. |
| 스캔에서 사용하는 인덱스 바운드를 기준으로 별도 계산되는 인덱스 스캔. MongoDB는 스캔에서 두 가지 이상의 버운드를 사용할 때 |
| 필드에 여러 개의 바운드가 있는 인덱스 스캔은 바운드 수에 따라 별도로 계산됩니다. |
collectionType
key.collectionType 필드는 기록된 쿼리가 실행된 컬렉션 유형을 나타냅니다. collectionType 는 다음 값 중 하나일 수 있습니다.
필드 | 설명 |
|---|---|
| |
| 쿼리가 표준 컬렉션에서 실행되었습니다. |
| 존재하지 않는 컬렉션에서 쿼리가 실행되었습니다. |
| |
| 쿼리가 뷰에 대해 실행되었습니다. |
| 쿼리가 가상 collection에서 실행되었습니다. 가상 collection에서 수행되는 작업은 다음과 같습니다. |
쿼리 형태
key.queryShape 문서 에 쿼리 형태 필드가 포함되어 있습니다. 쿼리 형태에 학습 보려면 쿼리 형태를 참조하세요 .
key.queryShape 의 필드는 쿼리 통계 항목을 생성한 명령에 따라 달라집니다. $queryStats 은 aggregate, find, distinct, count, update, insert 및 delete 명령에 대한 쿼리 통계 항목을 생성합니다.
각 쿼리 형태 속성은 쿼리 옵션에 해당합니다. 예를 들어 key.queryShape.sort 은 쿼리 형태의 sort() 사양에 해당합니다.
명령 쿼리 형태 찾기
다음 표에서는 find 명령에 대한 쿼리 형태 속성을 설명합니다.
필드 | 유형 | 리터럴 또는 정규화 |
|---|---|---|
| 문서 | 정규화 |
| 문서 | 리터럴 |
| 문서 | 정규화 |
| Integer | 정규화 |
| Integer | 정규화 |
| 부울 | 리터럴 |
| 문서 | 정규화 |
| 문서 | 정규화 |
| 부울 | 리터럴 |
| 부울 | 리터럴 |
| 부울 | 리터럴 |
| 부울 | 리터럴 |
| 부울 | 리터럴 |
| 문서 | 리터럴 |
| 부울 | 리터럴 |
| 문서 | 정규화 |
집계 명령 쿼리 형태
다음 표에서는 aggregate 명령에 대한 쿼리 형태 속성을 설명합니다.
필드 | 유형 | 리터럴 또는 정규화 |
|---|---|---|
| 배열 | 정규화 |
| 부울 | 리터럴 |
| 부울 | 리터럴 |
| 부울 | 리터럴 |
| 문서 | 리터럴 |
| 문자열 또는 문서 | 정규화 |
| 문서 | 정규화 |
고유한 명령 쿼리 형태
다음 표에서는 distinct 명령에 대한 쿼리 형태 속성을 설명합니다.
필드 | 유형 | 리터럴 또는 정규화 |
|---|---|---|
| 문서 | 정규화 |
| 문자열 | 리터럴 |
| 문서 | 정규화 |
count 명령 쿼리 형태
다음 표에서는 count 명령에 대한 쿼리 형태 속성을 설명합니다.
필드 | 유형 | 리터럴 또는 정규화 |
|---|---|---|
| 문서 | 정규화 |
| 문서 | 정규화 |
| Integer | 정규화 |
| Integer | 정규화 |
업데이트 명령 쿼리 형태
버전 9.0에 추가 되었습니다.
다음 표에서는 update 명령에 대한 쿼리 형태 속성을 설명합니다. $queryStats은(는) 최상위 update 명령 전체가 아니라 updates 배열의 각 업데이트 성명서에 대한 쿼리 형태 통계를 추적합니다.
필드 | 유형 | 리터럴 또는 정규화 |
|---|---|---|
| 문서 | 정규화 |
| 문서 또는 배열 | 정규화 |
| 문서 | 정규화 |
| 문서 배열 | 정규화 |
| 부울 | 리터럴 |
| 부울 | 리터럴 |
| 문서 | 정규화 |
| 문서 | 리터럴 |
중요
$queryStats time series 컬렉션의 update 작업에 대한 쿼리 형태 통계를 수집하지 않습니다.
insert 명령 쿼리 형태
버전 9.0에 추가 되었습니다.
다음 표에서는 insert 명령에 대한 쿼리 형태 속성을 설명합니다. $queryStats은 documents 배열의 각 문서가 아니라 전체 insert 명령에 대해 쿼리 형태 통계를 한 번 추적합니다. MongoDB는 삽입된 문서의 수나 내용에 관계없이 항상 documents를 고정된 자리 표시자 값으로 정규화합니다.
필드 | 유형 | 리터럴 또는 정규화 |
|---|---|---|
| 배열 | 정규화 |
중요
$queryStats time series 컬렉션의 insert 작업에 대한 쿼리 형태 통계를 수집하지 않습니다.
삭제 명령 쿼리 형태
버전 9.0에 추가 되었습니다.
다음 표에서는 delete 명령에 대한 쿼리 형태 속성을 설명합니다. $queryStats은(는) 최상위 delete 명령 전체가 아니라 deletes 배열의 각 삭제 성명서에 대한 쿼리 형태 통계를 추적합니다.
key.queryShape.limit 삭제 성명서의 limit 필드를 반영합니다. 여기서 0은 일치하는 모든 문서를 삭제하고 1는 단일 문서를 삭제합니다. 쿼리 통계 항목의 수를 제한하지 않습니다.
필드 | 유형 | 리터럴 또는 정규화 |
|---|---|---|
| 문서 | 정규화 |
| Integer | 리터럴 |
| 문서 | 정규화 |
| 문서 | 리터럴 |
중요
$queryStats time series 컬렉션의 delete 작업에 대한 쿼리 형태 통계를 수집하지 않습니다.
추가 지표
쿼리 통계 항목에는 쿼리에 대한 추가 정보를 제공하는 metrics.supplementalMetrics 문서 포함될 수 있습니다.
$vectorSearch Metrics
쿼리 형태 에 $vectorSearch 가 포함되어 있으면 $queryStats 는 다음과 같은 추가 지표 출력합니다.
필드 | 유형 | 설명 |
|---|---|---|
| 문서 |
|
| 문서 |
|
| 문서 |
|
예시
이 섹션의 예시를 실행하려면 다음 데이터로 시작하세요.
db.products.insertMany( [ { item: "card", qty: 15 }, { item: "envelope", qty: 20 }, { item: "stamps" , qty: 30 } ])그런 다음 다음 명령을 실행합니다.
db.products.find( { item: "card" } )
db.products.aggregate( [ { $match: { qty: { $gt: 20 } } }] )다음 예제에서는 다양한 유형의 데이터 변환을 사용하여 $queryStats 의 출력을 보여 줍니다.
다음 섹션의 예시 $queryStats 출력은 다른 명령의 실행에 따라 달라질 수 있습니다.
변환되지 않은 예제
입력:
db.getSiblingDB("admin").aggregate( [ { $queryStats: { } }] )출력:
[ { key: { queryShape: { cmdNs: { db: 'test', coll: 'products' }, command: 'find', filter: { item: { '$eq': '?string' } } }, client: { driver: { name: 'nodejs|mongosh', version: '5.1.0' }, os: { type: 'Darwin', name: 'darwin', architecture: 'arm64', version: '22.6.0' }, platform: 'Node.js v16.19.1, LE (unified)', version: '5.1.0|1.8.0', application: { name: 'mongosh 1.8.0' } }, collectionType: 'collection' }, keyHash: 'dsoJ+LHAru0z6MJ1/IygJnnLTrlpVYYmPnlmNZbZrLI=', queryShapeHash: "uxMLCvpiJ5N/IRqt4c28/0A8F01C8AA16CA805FF5C1A5737535F97E40C2A90CE91A82CCB7A74C7CCB9C48", metrics: { lastExecutionMicros: Long("4254"), execCount: Long("1"), totalExecMicros: { sum: Long("4254"), max: Long("4254"), min: Long("4254"), sumOfSquares: Decimal128("18096516") }, firstResponseExecMicros: { sum: Long("4254"), max: Long("4254"), min: Long("4254"), sumOfSquares: Decimal128("18096516") }, docsReturned: { sum: Long("1"), max: Long("1"), min: Long("1"), sumOfSquares: Decimal128("1") }, planningTimeMicros: { sum: Long("2150"), max: Long("2150"), min: Long("2150"), sumOfSquares: Decimal128("4622500") }, costBasedRanker: { cardinalityEstimationMethods: { Histogram: Long("0"), Sampling: Long("0"), Heuristics: Long("0"), Mixed: Long("0"), Metadata: Long("0"), Code: Long("0") }, nDocsSampled: { sum: Long("0"), max: Long("0"), min: Long("0"), sumOfSquares: Decimal128("0") } }, firstSeenTimestamp: ISODate("2023-09-14T12:30:27.989Z"), latestSeenTimestamp: ISODate("2023-09-14T12:30:27.989Z") }, asOf: Timestamp({ t: 1694695007, i: 0 }) }, { key: { queryShape: { cmdNs: { db: 'test', coll: 'products' }, command: 'aggregate', pipeline: [ { '$match': { qty: { '$gt': '?number' } } } ] }, apiVersion: '1', client: { driver: { name: 'nodejs|mongosh', version: '5.1.0' }, os: { type: 'Darwin', name: 'darwin', architecture: 'arm64', version: '22.6.0' }, platform: 'Node.js v16.19.1, LE (unified)', version: '5.1.0|1.8.0', application: { name: 'mongosh 1.8.0' } }, collectionType: 'collection', cursor: { batchSize: '?number' } }, keyHash: '2QLBfL0m1lliStdN4XvBjqVBtZQ6ffaB2L1pJ99twT8=', queryShapeHash: "uxMLCvpiJ5N/IRqt4c28/0A8F01C8AA16CA805FF5C1A5737535F97E40C2A90CE91A82CCB7A74C7CCB9C48", metrics: { lastExecutionMicros: Long("350"), execCount: Long("3"), totalExecMicros: { sum: Long("3084"), max: Long("2499"), min: Long("235"), sumOfSquares: Decimal128("6422726") }, firstResponseExecMicros: { sum: Long("3084"), max: Long("2499"), min: Long("235"), sumOfSquares: Decimal128("6422726") }, docsReturned: { sum: Long("3"), max: Long("1"), min: Long("1"), sumOfSquares: Decimal128("3") }, planningTimeMicros: { sum: Long("1850"), max: Long("850"), min: Long("420"), sumOfSquares: Decimal128("1252500") }, costBasedRanker: { cardinalityEstimationMethods: { Histogram: Long("0"), Sampling: Long("0"), Heuristics: Long("0"), Mixed: Long("0"), Metadata: Long("0"), Code: Long("0") }, nDocsSampled: { sum: Long("0"), max: Long("0"), min: Long("0"), sumOfSquares: Decimal128("0") } }, firstSeenTimestamp: ISODate("2023-11-29T21:16:17.796Z"), latestSeenTimestamp: ISODate("2023-11-29T21:17:12.385Z") }, asOf: Timestamp({ t: 1701292827, i: 0 }) }]변환된 예제
입력:
db.getSiblingDB("admin").aggregate( [ { $queryStats: { transformIdentifiers: { algorithm: "hmac-sha-256" , hmacKey: BinData(8, "87c4082f169d3fef0eef34dc8e23458cbb457c3sf3n2") } } } ] )출력:
[ { key: { queryShape: { cmdNs: { db: 'Mtrt3iG7dsX5c5uCSIhSVlcu5qD3u3xx2EQnS1dJLxM=', coll: '3oJE6AyOuf8h5NqWiXETxulFlPm3QUXbMnMjL2EqAU4=' }, command: 'find', filter: { 'VWVRow7Ure92ajRPfrpWiU8OtDeWcLePFIq0+tooBng=': { '$eq': '?string' } } }, client: { driver: { name: 'nodejs|mongosh', version: '5.1.0' }, os: { type: 'Darwin', name: 'darwin', architecture: 'arm64', version: '22.6.0' }, platform: 'Node.js v16.19.1, LE (unified)', version: '5.1.0|1.8.0', application: { name: 'mongosh 1.8.0' } }, collectionType: 'collection' }, keyHash: 'q4vxam+wbk8tTrl8D0MDFH1LQAbI8fWspfkGKhEUROk=', queryShapeHash: "uxMLCvpiJ5N/IRqt4c28/0A8F01C8AA16CA805FF5C1A5737535F97E40C2A90CE91A82CCB7A74C7CCB9C48", metrics: { lastExecutionMicros: Long("4254"), execCount: Long("1"), keysExamined: { sum: Int("5"), max: Long("5"), min: Long("5"), sumOfSquares: Decimal128("25") }, docsExamined: { sum: Long("1"), max: Long("1"), min: Long("1"), sumOfSquares: Decimal128("1") }, hasSortStage: {true: Long("0"), false: Long("1")}, usedDisk: {true: Long("0"), false: Long("1")}, fromMultiPlanner: {true: Long("0"), false: Long("1")}, fromPlanCache: {true: Long("1"), false: Long("0")}, totalExecMicros: { sum: Long("4254"), max: Long("4254"), min: Long("4254"), sumOfSquares: Decimal128("18096516") }, firstResponseExecMicros: { sum: Long("4254"), max: Long("4254"), min: Long("4254"), sumOfSquares: Decimal128("18096516") }, docsReturned: { sum: Long("1"), max: Long("1"), min: Long("1"), sumOfSquares: Decimal128("1") }, planningTimeMicros: { sum: Long("2150"), max: Long("2150"), min: Long("2150"), sumOfSquares: Decimal128("4622500") }, costBasedRanker: { cardinalityEstimationMethods: { Histogram: Long("0"), Sampling: Long("0"), Heuristics: Long("0"), Mixed: Long("0"), Metadata: Long("0"), Code: Long("0") }, nDocsSampled: { sum: Long("0"), max: Long("0"), min: Long("0"), sumOfSquares: Decimal128("0") } }, firstSeenTimestamp: ISODate("2023-09-14T12:30:27.989Z"), latestSeenTimestamp: ISODate("2023-09-14T12:30:27.989Z") }, asOf: Timestamp({ t: 1694695712, i: 0 }) }, { key: { queryShape: { cmdNs: { db: 'Mtrt3iG7dsX5c5uCSIhSVlcu5qD3u3xx2EQnS1dJLxM=', coll: '3oJE6AyOuf8h5NqWiXETxulFlPm3QUXbMnMjL2EqAU4=' }, command: 'aggregate', pipeline: [ { '$match': { 'RVqrwNEPotzdKnma/T7s4YcgNvpqO29BMDoni2N4IMI=': { '$gt': '?number' } } } ] }, apiVersion: '1', client: { driver: { name: 'nodejs|mongosh', version: '5.1.0' }, os: { type: 'Darwin', name: 'darwin', architecture: 'arm64', version: '22.6.0' }, platform: 'Node.js v16.19.1, LE (unified)', version: '5.1.0|1.8.0', application: { name: 'mongosh 1.8.0' } }, collectionType: 'collection', cursor: { batchSize: '?number' } }, keyHash: 'HEhpQTYB+/wVoHLkOkMd+EC2jguQlMJ1N/vTE7+b8Js=', queryShapeHash: "uxMLCvpiJ5N/IRqt4c28/0A8F01C8AA16CA805FF5C1A5737535F97E40C2A90CE91A82CCB7A74C7CCB9C48", metrics: { lastExecutionMicros: Long("350"), execCount: Long("3"), keysExamined: { sum: Int("5"), max: Long("5"), min: Long("5"), sumOfSquares: Decimal128("25") }, docsExamined: { sum: Long("1"), max: Long("1"), min: Long("1"), sumOfSquares: Decimal128("1") }, hasSortStage: {true: Long("0"), false: Long("1")}, usedDisk: {true: Long("0"), false: Long("1")}, fromMultiPlanner: {true: Long("0"), false: Long("1")}, fromPlanCache: {true: Long("1"), false: Long("0")}, totalExecMicros: { sum: Long("3084"), max: Long("2499"), min: Long("235"), sumOfSquares: Decimal128("6422726") }, firstResponseExecMicros: { sum: Long("3084"), max: Long("2499"), min: Long("235"), sumOfSquares: Decimal128("6422726") }, docsReturned: { sum: Long("3"), max: Long("1"), min: Long("1"), sumOfSquares: Decimal128("3") }, planningTimeMicros: { sum: Long("1850"), max: Long("850"), min: Long("420"), sumOfSquares: Decimal128("1252500") }, costBasedRanker: { cardinalityEstimationMethods: { Histogram: Long("0"), Sampling: Long("0"), Heuristics: Long("0"), Mixed: Long("0"), Metadata: Long("0"), Code: Long("0") }, nDocsSampled: { sum: Long("0"), max: Long("0"), min: Long("0"), sumOfSquares: Decimal128("0") } }, firstSeenTimestamp: ISODate("2023-11-29T21:16:17.796Z"), latestSeenTimestamp: ISODate("2023-11-29T21:17:12.385Z") }, asOf: Timestamp({ t: 1701293302, i: 0 }) },]MongoDB Node.js 운전자 사용하여 집계 파이프라인 에 $queryStats 단계를 추가하려면 파이프라인 객체 에서 $queryStats 연산자 사용합니다.
다음 예시 기록된 쿼리에 대한 변환되지 않은 런타임 통계를 출력하는 파이프라인 단계를 만듭니다. 그런 다음 이 예시 에서는 집계 파이프라인 실행합니다.
const pipeline = [{ $queryStats: {} }];
const adminDb = client.db("admin");const cursor = adminDb.aggregate(pipeline);return cursor;변환된 예제
변환된 쿼리 통계를 반환하려면 파이프라인 단계에 transformIdentifiers 필드 포함합니다.
const pipeline = [ { $queryStats: { transformIdentifiers: { algorithm: "hmac-sha-256", hmacKey: new Binary(Buffer.from("87c4082f169d3fef0eef34dc8e23458cbb457c3aabbccddeeff00112233445566778899", "hex"), 8) } } }];
const adminDb = client.db("admin");const cursor = adminDb.aggregate(pipeline);return cursor;MongoDB Atlas 데이터 컬렉션
MongoDB Atlas는 주기적으로 $queryStats 을(를) 사용하여 쿼리에 대한 익명화된 데이터를 수집하여 MongoDB 제품을 개선합니다. 또한, 사용자의 데이터는 사용량에 따른 기능 제안을 위해 사용될 수 있습니다. MongoDB는 $queryStats 으)로 수집한 데이터를 4년 동안 보관합니다.
배포서버에서 $queryStats 을(를) 실행하면 Atlas 조직별로 고유한 EMAC 키를 사용하여 데이터를 변환하고 민감한 정보가 수집되지 않도록 합니다.