데이터베이스 프로파일러 출력
이 페이지의 내용
데이터베이스 프로파일러는 읽기 및 쓰기 작업, 커서 작업 및 데이터베이스 명령에 대한 데이터 정보를 캡처합니다. 데이터베이스 프로파일을 구성하고 프로파일 데이터 캡처 임계값을 설정하려면 데이터베이스 프로파일러 섹션을 참조하세요.
데이터베이스 프로파일러는 고정 사이즈 컬렉션인 system.profile 컬렉션에 데이터를 씁니다. 프로파일러의 출력을 보려면 system.profile 컬렉션에서 일반 MongoDB 쿼리를 사용합니다.
참고
데이터베이스 프로파일러는 데이터베이스의 system.profile 컬렉션에 데이터를 쓰기 때문에 읽기 전용인 데이터베이스의 경우에도 일부 쓰기 작업을 프로파일링합니다.
currentOp 그리고 데이터베이스 프로파일러는 다음을 포함하여 CRUD 작업에 대한 동일한 기본 진단 정보를 보고합니다.
getMore(OP_GET_MORE 및command)
이러한 작업은 느린 쿼리 로깅에도 포함됩니다. 느린 쿼리 로깅에 대한 자세한 내용은 slowOpThresholdMs를 참조하세요.
Queryable Encryption을 사용하는 경우 암호화된 컬렉션에 대한 CRUD 작업이 system.profile 컬렉션에서 생략됩니다. 자세한 내용은 편집을 참조하세요.
이제 트랜잭션 내에서 system.profile 컬렉션에 대해 읽기를 포함한 모든 연산을 수행할 수 없습니다.
경고
system.profile이라는 이름의 time series 컬렉션 또는 뷰를 만들려고 시도하지 마세요. MongoDB 6.3 이상 버전에서 이를 시도하는 경우 IllegalOperation 오류가 반환됩니다. 이전 MongoDB 버전은 충돌합니다.
출력 필드
모든 단일 작업의 경우 데이터베이스 프로파일러에서 생성한 문서에는 다음 필드의 하위 집합이 포함됩니다. 이러한 문서에서 필드의 정확한 선택은 작업 유형에 따라 다릅니다.
참고
MongoDB 버전별 출력을 보려면 해당 버전의 MongoDB 매뉴얼을 참조하세요.
system.profile.op작업 유형입니다. 가능한 값은 다음과 같습니다.
commandcountdistinctgeoNeargetMoregroupinsertmapReducequeryremoveupdate
system.profile.ns작업이 대상으로 하는 네임스페이스입니다 . MongoDB의 네임스페이스는 데이터베이스 이름 뒤에 점(
.)이 오고, 그 뒤에 컬렉션 이름이 오는 형식을 취합니다.
system.profile.command이 작업과 관련된 전체 명령 객체가 포함된 문서입니다.
예를 들어, 다음 출력에는
test데이터베이스의items컬렉션에 대한find작업에 대한 명령 객체가 포함되어 있습니다."command" : { "find" : "items", "filter" : { "sku" : 1403978 }, ... "$db" : "test" } 다음 예시 출력에는
test데이터베이스의items컬렉션에서 커서 ID가19234103609인 명령에 의해 생성된getMore작업에 대한 명령 객체가 포함되어 있습니다."command" : { "getMore" : NumberLong("19234103609"), "collection" : "items", "batchSize" : 10, ... "$db" : "test" }, 명령 문서가 50KB를 초과하는 경우 문서의 형식은 다음과 같습니다.
"command" : { "$truncated": <string>, "comment": <string> } $truncated필드는 문서의comment필드(있는 경우)를 제외한 문서의 문자열 요약을 포함합니다. 요약이 여전히 50킬로바이트를 초과하면 더 잘리게 되어 문자열 끝에 줄임표(...)로 표시됩니다.comment필드는 주석이 작업에 전달된 경우 표시됩니다. 모든 데이터베이스 명령에 주석을 첨부할 수 있습니다.
system.profile.originatingCommand커서에서 다음 결과 배치를 조회하는
"getmore"작업의 경우originatingCommand필드에 커서를 처음 생성한 전체 명령 객체(예:find또는aggregate)가 포함됩니다.
system.profile.keysExaminedMongoDB가 작업을 수행하기 위해 스캔한 인덱스 키의 수입니다.
일반적으로
keysExamined가nreturned보다 훨씬 높은 경우 데이터베이스가 결과 문서를 찾기 위해 많은 인덱스 키를 스캔하고 있다는 뜻입니다. 쿼리 성능을 개선하기 위해 인덱스를 작성 또는 수정하는 것이 좋습니다.keysExamined다음 명령과 작업에 사용할 수 있습니다.
system.profile.docsExamined작업을 수행하기 위해 MongoDB가 스캔한 collection의 문서 수입니다.
docsExamined다음 명령과 작업에 사용할 수 있습니다.
system.profile.hasSortStagehasSortStage는 쿼리가 인덱스의 순서를 사용하여 요청된 정렬된 결과를 반환할 수 없을 때true가 되는 부울입니다. 예를 들어 MongoDB는 커서에서 문서를 받은 후 문서를 정렬해야 합니다. 이 필드는 값이true인 경우에만 표시됩니다.hasSortStage다음 명령과 작업에 사용할 수 있습니다.getMore(OP_GET_MORE 및command)
system.profile.usedDisk메모리 제한으로 인해 집계 단계에서 데이터를 임시 파일에 썼는지 여부를 나타내는 부울입니다.
usedDisk가 true인 경우에만 표시됩니다.
system.profile.fromMultiPlanner쿼리 플래너가 쿼리에 대한 성공적인 실행 계획을 선택하기 전에 여러 계획을 평가했는지 여부를 나타내는 부울입니다.
값이
true인 경우에만 표시됩니다.
system.profile.replanned쿼리 시스템이 캐시된 계획을 제거하고 모든 후보 계획을 재평가했는지 여부를 나타내는 부울입니다.
값이
true인 경우에만 표시됩니다.
system.profile.replanReason캐시된 계획이 제거된 구체적인 이유를 나타내는 문자열입니다.
replanned값이true인 경우에만 표시됩니다.
system.profile.writeConflicts쓰기 작업 중에 발생한 충돌 수입니다. 예를 들어
update작업이 다른update작업과 동일한 문서를 수정하려고 시도하는 경우입니다. 쓰기 충돌(write conflict)도 참조하세요.
system.profile.numYield다른 작업이 완료될 수 있도록 작업을 양보한 횟수입니다. 일반적으로 작업은 MongoDB가 아직 메모리로 완전히 읽지 않은 데이터에 액세스해야 할 때 양보합니다. 이를 통해 MongoDB가 산출 작업에 대한 데이터를 읽는 동안 메모리에 데이터가 있는 다른 작업을 완료할 수 있습니다. 자세한 내용은 작업이 양보되는 경우에 대한 FAQ를 참조하세요.
system.profile.queryHashMongoDB 8.0 부터 기존
queryHash필드 의 이름이planCacheShapeHash로 변경되었습니다. 이전 MongoDB 버전을 사용하는 경우planCacheShapeHashqueryHash가 표시됩니다.
system.profile.queryShapeHash버전 8.0에 추가 되었습니다.
queryShapeHashstring 쿼리 형태 의 해시가 포함된 16진수 입니다. 자세한 내용은 쿼리 형태를 참조하세요.
system.profile.planCacheShapeHash계획 캐시 쿼리 형태의 해시를 나타내는 16진수 문자열로, 계획 캐시 쿼리 형태에만 종속됩니다.
planCacheShapeHash를 사용하면 쓰기 작업의 쿼리 필터를 포함하여 동일한 플랜 캐시 쿼리 형태로 느린 쿼리를 식별할 수 있습니다.참고
다른 해시 함수와 마찬가지로, 두 개의 다른 계획 캐시 쿼리 형태가 동일한 해시 값을 생성할 수 있습니다. 그러나 서로 다른 계획 캐시 쿼리 형태 간에 해시 충돌이 발생할 가능성은 거의 없습니다.
planCacheShapeHash및planCacheKey에 대한 자세한 내용은 planCacheShapeHash 및 planCacheKey를 참조하세요.MongoDB 8.0 부터 기존
queryHash필드 의 이름이planCacheShapeHash로 변경되었습니다. 이전 MongoDB 버전을 사용하는 경우planCacheShapeHashqueryHash가 표시됩니다.
system.profile.planCacheKey쿼리와 연관된 계획 캐시 항목에 대한 키의 해시입니다.
planCacheShapeHash와 달리,planCacheKey는 플랜 캐시 쿼리 형태와 현재 사용 가능한 인덱스 모두의 함수입니다. 특히, 쿼리 형태를 지원할 수 있는 인덱스가 추가되거나 삭제되면planCacheKey값은 변경될 수 있지만planCacheShapeHash는 변경되지 않습니다.planCacheShapeHash및planCacheKey에 대한 자세한 내용은 planCacheShapeHash 및 planCacheKey를 참조하세요.MongoDB 8.0 부터 기존
queryHash필드 의 이름이planCacheShapeHash로 변경되었습니다. 이전 MongoDB 버전을 사용하는 경우planCacheShapeHashqueryHash가 표시됩니다.
system.profile.queryFramework작업을 처리하는 데 사용되는 쿼리 프레임워크입니다.
system.profile.lockssystem.profile.locks는 작업 중에 유지되는 다양한 잠금 유형 및 잠금 모드에 대한 정보를 제공합니다.가능한 락 유형은 다음과 같습니다.
잠금 유형설명ParallelBatchWriterMode병렬 배치 쓰기 모드의 잠금을 나타냅니다.
이전 버전에서는 PBWM 정보가
Global잠금 정보의 일부로 보고되었습니다.ReplicationStateTransition레플리카 세트 멤버 상태 전환에 취한 잠금을 나타냅니다.Global글로벌 락을 나타냅니다.Database데이터베이스 락을 나타냅니다.Collection컬렉션 락을 나타냅니다.Mutex뮤텍스를 나타냅니다.Metadata메타데이터 락을 나타냅니다.DDLDatabaseDDL 데이터베이스 잠금을 나타냅니다.
버전 7.1에 새로 추가되었습니다.
DDLCollectionDDL collection 잠금을 나타냅니다.
버전 7.1에 새로 추가되었습니다.
oplogoplog 락을 나타냅니다.잠금 유형에 사용할 수 있는 잠금 모드는 다음과 같습니다.
잠금 모드설명R공유(S) 락을 나타냅니다.W독점(X) 락을 나타냅니다.r인텐트 공유(IS) 락을 나타냅니다.w인텐트 독점(IX) 락을 나타냅니다.다양한 락 유형에 대해 반환되는 락 정보에는 다음이 포함됩니다.
system.profile.locks.acquireWaitCount잠금이 충돌 모드에서 유지되었기 때문에 작업이
acquireCount개의 잠금에 도달할 때까지 기다려야 했던 횟수입니다.acquireWaitCount가acquireCount보다 작거나 같습니다.
system.profile.locks.timeAcquiringMicros작업이 잠금을 획득하기 위해 대기해야 했던 누적 시간(마이크로초)입니다.
timeAcquiringMicros를acquireWaitCount로 나누면 특정 잠금 모드의 대략적인 평균 대기 시간을 구할 수 있습니다.
잠금 모드에 대한 자세한 내용은 MongoDB가 사용하는 잠금 유형은 무엇인가요?를 참조하세요.
system.profile.authorization버전 5.0.0에 추가되었습니다.
각 작업에 대해 사용자 캐시에 액세스되는 횟수입니다. 이 지표는 작업이 사용자 캐시에 한 번 이상 액세스한 경우에만 표시됩니다.
이러한 지표는 저속 작업 로깅 또는 데이터베이스 프로파일링이 활성화된 경우에만 사용할 수 있습니다.
system.profile.authorization는db.currentOp()출력에 포함되지 않습니다.
system.profile.storagesystem.profile.storage정보는 스토리지 엔진 데이터에 대한 지표와 작업 대기 시간을 제공합니다.특정 스토리지 지표는 값이 0보다 큰 경우에만 반환됩니다.
system.profile.storage.data.bytesRead디스크에서 캐시로 작업을 통해 읽은 바이트 수입니다.
디스크에서 캐시로 읽은 데이터에는 쿼리를 실행하는 데 필요한 모든 것이 포함됩니다. 데이터가 이미 캐시에 있는 경우 디스크에서 읽은 바이트 수는
0일 수 있습니다.디스크에서 읽은 바이트 수에는 쿼리된 문서보다 더 많은 바이트가 포함됩니다.
WiredTiger는 페이지 단위로 읽으며 페이지에는 하나 또는 여러 개의 문서가 포함될 수 있습니다. 문서가 페이지에 있으면 해당 페이지의 모든 문서를 캐시로 읽어와서
bytesRead값에 포함합니다.캐시에 페이지 관리(예: 제거 또는 다시 읽기)가 필요한 경우
bytesRead값에는 이러한 작업의 디스크에서 읽은 데이터가 포함됩니다.인덱스가 캐시에 없거나 캐시의 인덱스가 오래된 경우, WiredTiger는 디스크에서 여러 내부 및 리프 페이지를 읽어 캐시에서 인덱스를 재구성합니다.
system.profile.storage.data.bytesWritten작업으로 인해 캐시에서 디스크로 쓰여진 바이트 수입니다.
WiredTiger는 일반적으로 쿼리를 디스크에 쓸 필요가 없습니다. 쿼리에 의해 수정된 데이터는 인메모리 캐시에 기록되며, WiredTiger는 제거 또는 체크포인트 작업의 일부로 디스크로 플러시합니다. 이러한 경우
bytesWritten은 0으로 표시됩니다.쿼리를 실행하는 스레드에 강제 페이지 관리(예: 제거)가 필요한 경우 WiredTiger는 페이지 내용을 디스크에 씁니다. 이 플러시에는 쿼리 자체의 변경 사항과 관련이 없는 데이터가 포함되어 있을 수 있으며, 이로 인해
bytesWritten이 예상보다 높은 값을 표시할 수 있습니다.
system.profile.responseLength작업 결과 문서의 길이(바이트)입니다.
responseLength가 크면 성능에 영향을 줄 수 있습니다. 쿼리 작업에 대한 결과 문서의 크기를 제한하려면 다음 중 하나를 사용할 수 있습니다.참고
MongoDB가 로그에 쿼리 프로필 정보를 기록할 때
responseLength값은 이름이reslen인 필드에 있습니다.
system.profile.protocolMongoDB Wire Protocol 요청 메시지 형식입니다.
system.profile.millismongod관점에서 작업 시작부터 작업 종료까지의 시간(밀리초)입니다.
planningTimeMicros버전 6.2에 추가되었습니다.
find또는aggregate명령이 쿼리 계획에 소비한 시간(마이크로초)입니다.
system.profile.execStats쿼리 작업의 실행 통계가 포함된 문서입니다. 다른 작업의 경우 값은 빈 문서입니다.
system.profile.execStats(은)는 통계를 트리로 표시하며, 각 노드는 쿼리 작업의 해당 단계에서 실행된 작업에 대한 통계를 제공합니다.참고
단계별로 반환되는 필드가 다르기 때문에
execStats에 대한 다음 필드 목록은 완전한 것이 아닙니다.
system.profile.appName작업을 실행한 클라이언트 애플리케이션의 식별자입니다.
appName연결 문자열 옵션을 사용하여appName필드에 대한 사용자 지정 값을 설정합니다.
system.profile.allUsers세션에 대해 인증된 사용자 정보(사용자 이름 및 데이터베이스 )의 배열 입니다. 자체 관리 배포서버의 사용자도 참조하세요.
예시 system.profile 문서
다음 예는 독립형 작업에 대한 system.profile 컬렉션에 있는 샘플 문서를 보여줍니다.
system.profile 컬렉션의 다음 문서에는 test.report 컬렉션에 대한 샘플 쿼리 작업에 대한 메트릭이 나와 있습니다.
{ "op" : "query", "ns" : "test.report", "command" : { "find" : "report", "filter" : { "a" : { "$lte" : 500 } }, "lsid" : { "id" : UUID("5ccd5b81-b023-41f3-8959-bf99ed696ce9") }, "$db" : "test" }, "cursorid" : 33629063128, "keysExamined" : 101, "docsExamined" : 101, "fromMultiPlanner" : true, "numYield" : 2, "nreturned" : 101, "planCacheShapeHash" : "811451DD", "planCacheKey" : "759981BA", "queryFramework" : "classic", "locks" : { "Global" : { "acquireCount" : { "r" : NumberLong(3), "w" : NumberLong(3) } }, "Database" : { "acquireCount" : { "r" : NumberLong(3) }, "acquireWaitCount" : { "r" : NumberLong(1) }, "timeAcquiringMicros" : { "r" : NumberLong(69130694) } }, "Collection" : { "acquireCount" : { "r" : NumberLong(3) } } }, "storage" : { "data" : { "bytesRead" : NumberLong(14736), "timeReadingMicros" : NumberLong(17) } }, "responseLength" : 1305014, "protocol" : "op_msg", "millis" : 69132, "planningTimeMicros" : 129, "planSummary" : "IXSCAN { a: 1, _id: -1 }", "execStats" : { "stage" : "FETCH", "nReturned" : 101, "executionTimeMillisEstimate" : 0, "works" : 101, "advanced" : 101, "needTime" : 0, "needYield" : 0, "saveState" : 3, "restoreState" : 2, "isEOF" : 0, "docsExamined" : 101, "alreadyHasObj" : 0, "inputStage" : { ... } }, "ts" : ISODate("2019-01-14T16:57:33.450Z"), "client" : "127.0.0.1", "appName" : "MongoDB Shell", "allUsers" : [ { "user" : "someuser", "db" : "admin" } ], "user" : "someuser@admin" }
system.profile 컬렉션에는 getMore 작업에 대한 지표가 포함됩니다. 이 예시에서 getMore는 test.report 컬렉션의 추가 문서를 반환합니다.
{ "op" : "getmore", "ns" : "test.report", "command" : { "getMore" : Long("33629063128"), "collection" : "report", "batchSize": 3, "lsid" : { "id": new UUID("3148c569-425c-4498-9168-5b7ee260bf27") }, "$db" : "test" }, originatingCommand: { "find: "report", "filter" : { "a" : { "$lte" : 500 } }, "lsid" : { "id" : UUID("5ccd5b81-b023-41f3-8959-bf99ed696ce9") }, "$db" : "test" }, "cursorid" : Long("33629063128"), "keysExamined" : 101, "docsExamined" : 101, "fromMultiPlanner" : true, "numYield" : 2, "nreturned" : 3, "planCacheShapeHash" : "811451DD", "planCacheKey" : "759981BA", "queryFramework": "classic" "locks" : { "Global" : { "acquireCount" : { "r" : NumberLong(3), "w" : NumberLong(3) } }, "Database" : { "acquireCount" : { "r" : NumberLong(3) }, "acquireWaitCount" : { "r" : NumberLong(1) }, "timeAcquiringMicros" : { "r" : NumberLong(69130694) } }, "Collection" : { "acquireCount" : { "r" : NumberLong(3) } } }, readConcern: {level: 'local', provenance: 'implicitDefault'}, "responseLength" : 1305014, "protocol" : "op_msg", "millis" : 69132, "planSummary" : "IXSCAN { a: 1, _id: -1 }", "execStats" : { "stage" : "FETCH", "filter" : { "a" : { "$lte" : 500 } }, "nReturned" : 101, "executionTimeMillisEstimate" : 0, "works" : 104, "advanced" : 104, "needTime" : 0, "needYield" : 0, "saveState" : 3, "restoreState" : 2, "isEOF" : 0, "direction": 'forward', "docsExamined" : 104 }, "ts" : ISODate("2019-01-14T16:57:33.450Z"), "client" : "127.0.0.1", "appName" : "MongoDB Shell", "allUsers" : [ { "user" : "someuser", "db" : "admin" } ], "user" : "someuser@admin" }
MongoDB 8.0 부터 기존 queryHash 필드 의 이름이 planCacheShapeHash 로 변경되었습니다. 이전 MongoDB 버전을 사용하는 경우 planCacheShapeHash queryHash 가 표시됩니다.
update(및 delete) 작업에 대한 프로필 항목에는 전체 업데이트 명령이 포함되어 있습니다.
system.profile 컬렉션의 다음 문서는 test.report 컬렉션의 샘플 업데이트 작업에 대한 지표를 보여줍니다.
{ "op" : "update", "ns" : "test.report", "command" : { "q" : { }, "u" : { "$rename" : { "a" : "b" } }, "multi" : true, "upsert" : false }, "keysExamined" : 0, "docsExamined" : 25000, "nMatched" : 25000, "nModified" : 25000, "keysInserted" : 25000, "keysDeleted" : 25000000, "numYield" : 6985, "locks" : { "Global" : { "acquireCount" : { "r" : NumberLong(6986), "w" : NumberLong(13972) } }, "Database" : { "acquireCount" : { "w" : NumberLong(6986) }, "acquireWaitCount" : { "w" : NumberLong(1) }, "timeAcquiringMicros" : { "w" : NumberLong(60899375) } }, "Collection" : { "acquireCount" : { "w" : NumberLong(6986) } }, "Mutex" : { "acquireCount" : { "r" : NumberLong(25000) } } }, "storage" : { "data" : { "bytesRead" : NumberLong(126344060), "bytesWritten" : NumberLong(281834762), "timeReadingMicros" : NumberLong(94549), "timeWritingMicros" : NumberLong(139361) } }, "millis" : 164687, "planningTimeMicros" : 129, "planSummary" : "COLLSCAN", "execStats" : { "stage" : "UPDATE", "nReturned" : 0, "executionTimeMillisEstimate" : 103771, "works" : 25003, "advanced" : 0, "needTime" : 25002, "needYield" : 0, "saveState" : 6985, "restoreState" : 6985, "isEOF" : 1, "nMatched" : 25000, "nWouldModify" : 25000, "wouldInsert" : false, "inputStage" : { "stage" : "COLLSCAN", "nReturned" : 25000, "executionTimeMillisEstimate" : 0, "works" : 25002, "advanced" : 25000, "needTime" : 1, "needYield" : 0, "saveState" : 31985, "restoreState" : 31985, "isEOF" : 1, "direction" : "forward", "docsExamined" : 25000 } }, "ts" : ISODate("2019-01-14T23:33:01.806Z"), "client" : "127.0.0.1", "appName" : "MongoDB Shell", "allUsers" : [ { "user" : "someuser", "db" : "admin" } ], "user" : "someuser@admin" }