Database Profiler

글로벌 및 데이터베이스별 프로파일링 설정

slowms and sampleRate are global settings that affect all databases in the process.

Profiling level and filter are database-level settings when set with profile or db.setProfilingLevel(). When set as command-line or configuration file options, they affect the entire process.

느린 작업에 대한 임계값 지정하기

기본적으로 느린 작업의 임계값은 100밀리초입니다.

느린 작업은 MongoDB가 해당 작업에 소요하는 시간인 workingMillis를 기준으로 기록됩니다. 즉 잠금 대기 및 흐름 제어와 같은 요소는 작업이 느린 작업 임계값을 초과하는지 여부에 영향을 미치지 않습니다.

To change the slow operation threshold, use one of the following:

• profile 명령 또는 db.setProfilingLevel() 셸 헬퍼 메서드를 사용하여 slowms 값을 설정합니다.

• 시작 시 명령줄에서 --slowms 값을 설정합니다.

• 구성 파일에서 slowOpThresholdMs 값을 설정합니다.

다음 예에서는 현재 연결된 데이터베이스의 프로파일링 수준을 1로 설정하고 mongod 인스턴스의 느린 작업 임계값을 20 밀리초로 설정합니다.

db.setProfilingLevel( 1, { slowms: 20 } )

프로파일링 수준이 1이면 프로파일러가 slowms 임계값보다 느린 작업을 기록합니다.

For mongos, use db.setProfilingLevel() to configure slowms and sampleRate. These settings affect only the diagnostic log on mongos, not the profiler. Profiling is not available on mongos. [1]

다음 예시에서는 느린 작업을 기록하기 위해 mongos 인스턴스의 느린 작업 임계값을 20으로 설정합니다.

db.setProfilingLevel( 0, { slowms: 20 } )

읽기/쓰기 작업에 대한 프로파일러 항목 및 진단 로그 메시지(예: mongod/mongos logmessages)에는 다음이 포함됩니다.

• planCacheShapeHash 는 동일한 플랜 캐시 쿼리 형태를 갖는 느린 쿼리를 식별하는 데 도움이 됩니다.

  MongoDB 8.0부터 기존 queryHash 필드 planCacheShapeHash라는 새 필드 에 중복됩니다. 이전 MongoDB 버전을 사용하는 경우 queryHash 필드 만 표시됩니다. 향후 MongoDB 버전에서는 더 이상 사용되지 않는 queryHash 필드 제거 될 예정이며, 대신 planCacheShapeHash 필드 사용해야 합니다.

• planCacheKey 느린 쿼리에 대한 쿼리 계획 캐시에 관해 더 많은 인사이트를 제공합니다.

이제 복제본 세트의 세컨더리 멤버가 느린 작업 임곗값보다 오래 걸리는 oplog 항목을 기록합니다. 이러한 느린 oplog 메시지의 특성은 다음과 같습니다.

• diagnostic log에 세컨더리 멤버에 대해 기록합니다.

• applied op: <oplog entry> took <num>ms 텍스트와 함께 REPL 구성 요소 아래에 기록됩니다.

• 로그 수준(시스템 또는 구성 요소 수준)에 의존하지 않습니다.

• 프로파일링 수준에 의존하지 않습니다.

• slowOpSampleRate의 영향을 받습니다.

프로파일러는 느린 oplog 항목을 캡처하지 않습니다.

느린 작업의 무작위 샘플 프로파일링

To profile only a randomly sampled subset of slow operations, set sampleRate in one of the following ways: [2]

• profile 명령 또는 db.setProfilingLevel() 셸 헬퍼 메서드를 사용하여 sampleRate 값을 설정합니다.

• 시작 시 명령줄에서 mongod에 대한 --slowOpSampleRate의 값, mongos에 대한 --slowOpSampleRate의 값을 설정합니다.

• 구성 파일에서 slowOpSampleRate 값을 설정합니다.

기본적으로 sampleRate는 1.0로 설정되며, 느린 작업이 모두 프로파일링된다는 의미입니다. sampleRate를 0에서 1 사이로 설정하면 프로파일링 수준이 1인 데이터베이스는 sampleRate에 따라 느린 작업의 무작위로 샘플링된 비율만 프로파일링합니다.

The following example sets the profiling level to 1 and sets the profiles to sample 42% of slow operations:

db.setProfilingLevel( 1, { sampleRate: 0.42 } )

수정된 샘플링 속도 값은 시스템 로그에도 적용됩니다.

For mongos, slowms and sampleRate affect only the diagnostic log, not the profiler. [1] To set the sampling rate for mongos logging:

db.setProfilingLevel( 0, { sampleRate: 0.42 } )

프로파일링될 작업을 결정하기 위한 필터 설정

To control which operations are profiled and logged, set a filter in one of the following ways:

• profile command or db.setProfilingLevel().

• filter in a configuration file.

For mongod, filter affects both the diagnostic log and the profiler, if enabled. For mongos, filter affects the diagnostic log only.

The following example sets profiling level 1 with a filter that logs only query operations taking longer than 2 seconds:

db.setProfilingLevel( 1, { filter: { op: "query", millis: { $gt: 2000 } } } )

프로파일링 수준 확인

To view the profiling level, run in mongosh:

db.getProfilingStatus()

셸은 다음과 유사한 문서를 반환합니다.

{ "was" : 0, "slowms" : 100, "sampleRate" : 1.0, "ok" : 1 }

The returned document contains:

• was: current profiling level.

• slowms: operation time threshold in milliseconds.

• sampleRate: percentage of slow operations being profiled.

프로파일링 비활성화

To disable profiling, run in mongosh:

db.setProfilingLevel(0)

전체 mongod 인스턴스에 대해 프로파일링 활성화

For development and test environments, you can enable profiling for an entire mongod instance. The profiling level applies to all databases on that instance.

Pass the following options to mongod at startup:

mongod --profile 1 --slowms 15 --slowOpSampleRate 0.5

Alternatively, specify operationProfiling in the configuration file.

This sets profiling level 1, defines slow operations as those lasting longer than 15 milliseconds, and profiles 50% of slow operations. [2]

slowms and slowOpSampleRate also affect operations recorded in the diagnostic log when logLevel is 0. Both settings also configure diagnostic logging for mongos. [2]

데이터베이스 프로파일링 및 샤딩

You cannot enable profiling on a mongos instance. To enable profiling in a sharded cluster, enable it on each mongod instance in the cluster.

You can set --slowms and slowOpSampleRate on mongos to configure the diagnostic log for slow operations.

프로파일러 데이터 쿼리 예시

이 섹션에서는 system.profile 컬렉션에 대한 쿼리 예시를 보여 줍니다. 쿼리 출력 세부 정보는 데이터베이스 프로파일러 출력을 참조하세요.

Return the most recent 10 log entries:

db.system.profile.find().limit(10).sort( { ts : -1 } ).pretty()

Return all operations except command operations ($cmd):

db.system.profile.find( { op: { $ne : 'command' } } ).pretty()

Return operations for a specific collection (this example uses mydb.test):

db.system.profile.find( { ns : 'mydb.test' } ).pretty()

Return operations taking longer than 5 milliseconds:

db.system.profile.find( { millis : { $gt : 5 } } ).pretty()

Return operations in a specific time range:

db.system.profile.find( {
   ts : {
      $gt: new ISODate("2012-12-09T03:00:00Z"),
      $lt: new ISODate("2012-12-09T03:40:00Z")
   }
} ).pretty()

Return operations in a time range, exclude the user field, and sort by duration:

db.system.profile.find( {
   ts : {
      $gt: new ISODate("2011-07-12T03:00:00Z"),
      $lt: new ISODate("2011-07-12T03:40:00Z")
   }
}, { user: 0 } ).sort( { millis: -1 } )

가장 최근 이벤트 5건 표시

프로파일링이 활성화된 데이터베이스에서 mongosh의 show profile 헬퍼는 실행 시간이 1밀리초 이상인 가장 최근 작업 5건을 표시합니다. mongosh에서 show profile 실행:

show profile

system.profile 컬렉션

The system.profile collection is a capped collection with a default size of 1 megabyte, which can typically store several thousand profile documents. If you need to change the size, follow the steps below.

프라이머리에서 system.profile 컬렉션의 크기 변경

To change the size of the system.profile collection on the primary:

1. 프로파일링을 비활성화합니다.

2. system.profile 컬렉션을 제거합니다.

3. 새 system.profile 컬렉션을 만듭니다.

4. 프로파일링을 다시 활성화합니다.

For example, to create a new system.profile collection of 4000000 bytes (4 MB) in mongosh:

db.setProfilingLevel(0)
db.system.profile.drop()
db.createCollection( "system.profile", { capped: true, size:4000000 } )
db.setProfilingLevel(1)

세컨더리에서 system.profile 컬렉션의 크기 변경

To change the size of the system.profile collection on a secondary, stop the secondary, run it as a standalone, and perform the steps above. Then, restart it as a replica set member. For more information, see Perform Maintenance on Self-Managed Replica Set Members.