db.setProfilingLevel() (mongosh 메서드)

정의

db.setProfilingLevel(level, options)

버전 5.0에서 변경되었습니다.

mongod 인스턴스의 경우, 이 메서드는 데이터베이스 프로파일러를 활성화, 비활성화 또는 구성합니다. 프로파일러는 실행 중인 mongod 인스턴스의 쓰기 작업, 커서, 데이터베이스 명령의 성능에 대한 데이터를 캡처하고 기록합니다. 프로파일러가 비활성화된 경우 이 메서드는 저속 작업이 진단 로그에 기록되는 방식을 구성합니다.

참고

db.setProfilingLevel()이 포함된 프로파일링 수준의 변경 사항은 지속되지 않습니다. 서버가 다시 시작되면 이 값은 0(기본값) 또는 operationProfiling.mode 설정이나 --profile 명령줄 옵션으로 설정된 값으로 되돌아갑니다.

If the database profiler level is 1 or 2 (specifically, the database profiler is enabled), the slowms and sampleRate affect the behavior of both the profiler and the diagnostic log.

If the database profiler level is 0 (specifically, database profiler is disabled), the slowms and sampleRate, affect only the diagnostic log.

mongos 인스턴스를 사용하면 이 메서드는 slowms, sampleRate, filter 구성 설정을 설정하여 진단 로그에 작업이 기록되는 방식을 구성합니다. mongos에는 프로파일러가 쓸 수 있는 컬렉션이 없으므로 mongos 인스턴스에 데이터베이스 프로파일러를 활성화할 수 없습니다. mongos 인스턴스의 경우 profile 수준은 0이어야 합니다.

You can specify a filter on both mongod and mongos instances to control which operations are logged by the profiler. When you specify a filter for the profiler, the slowms, and sampleRate options are not used for profiling and slow-query log lines.

db.setProfilingLevel() provides a wrapper around the profile command.

MongoDB 부터는 명령 또는 profile 래퍼 메서드를 5.0 사용하여 데이터베이스 level slowmssampleRate filter db.setProfilingLevel() 프로파일러,, 또는 에 수행한 변경 사항이 에 log file 기록됩니다.

호환성

이 메서드는 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.

MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스

중요

이 명령은 M0 및 Flex 클러스터에서 지원되지 않습니다. 자세한 내용은 지원되지 않는 명령을 참조하세요.

MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

구문

The db.setProfilingLevel() method has the following form:

db.setProfilingLevel(<level>, <options>)

매개변수

Parameter

유형

설명

레벨

integer

데이터베이스 프로파일러 수준을 구성합니다. 사용할 수 있는 프로파일러 수준은 다음과 같습니다.

0

프로파일러가 꺼져 있고 데이터를 수집하지 않습니다. 이것이 기본 설정된 프로파일러 수준입니다.

1

프로파일러는 slowms 값보다 오래 걸리거나 필터와 일치하는 작업에 대한 데이터를 수집합니다.

필터가 설정된 경우:

slowms, sampleRate 옵션은 프로파일링에 사용되지 않습니다.
프로파일러는 필터와 일치하는 작업만 캡처합니다.

2

프로파일러는 모든 작업에 대한 데이터를 수집합니다. 2 수준으로 설정하다 하면 프로파일러가 slowms 및 filter에 대해 사용자가 제공한 값을 무시합니다.

Because profiling is not available on mongos, db.setProfilingLevel() cannot be used to set the profiling level to a value other than 0 on a mongos instance.

옵션

문서 또는 정수

선택 사항. 정수 또는 옵션 문서를 사용할 수 있습니다. 문서 대신 options 인수로 정수 값이 전달되면 해당 값은 slowms에 할당됩니다. 사용 가능한 옵션은 다음과 같습니다.

slowms	기본값: 100 유형: 정수 느린 작동 시간 임계값(밀리초 단위)입니다. 이 임계값보다 오래 실행되는 작업은 느린 것으로 간주됩니다. `logLevel`을 `0`으로 설정하면, MongoDB는 `slowOpSampleRate` 에 의해 결정되는 속도로 느린 작업을 진단 로그에 기록합니다. `logLevel` 설정이 높을수록 노드의 지연 시간에 관계없이 모든 작업이 진단 로그에 표시됩니다. 단, 세컨더리의 느린 oplog 항목 메시지 로그 기록은 예외입니다. 세컨더리는 느린 oplog 항목만 로그하며 `logLevel` 을 늘린다고 해서 모든 oplog 항목이 로그되지는 않습니다. `mongod` 2} 인스턴스의 경우 이 설정은 진단 로그와 프로파일러(사용 설정된 경우)에 모두 영향을 줍니다. `mongos` 인스턴스의 경우, `mongos`에서는 프로파일링을 사용할 수 없으므로 이 설정은 진단 로그에만 영향을 미치고 프로파일러에는 영향을 미치지 않습니다. 이 인수는 구성 파일 옵션 `slowOpThresholdMs`와 동일한 설정에 영향을 줍니다.
sampleRate	기본값: 1.0 유형: double 프로파일링하거나 기록해야 하는 저속 작업의 비율입니다. `sampleRate`에 0과 1(두 값 모두 포함) 사이의 값을 사용할 수 있습니다. `mongod` 2} 인스턴스의 경우 이 설정은 진단 로그와 프로파일러(사용 설정된 경우)에 모두 영향을 줍니다. `mongos` 인스턴스의 경우, `mongos`에서는 프로파일링을 사용할 수 없으므로 이 설정은 진단 로그에만 영향을 미치고 프로파일러에는 영향을 미치지 않습니다. 이 인수는 구성 옵션 `slowOpSampleRate`와 동일한 설정에 영향을 줍니다.
필터	유형: 객체 프로파일링되고 기록되는 작업을 제어하는 필터 표현식입니다. 필터 표현식의 필드는 프로파일러 출력의 모든 필드가 될 수 있습니다. `mongod` 2} 인스턴스의 경우 이 설정은 진단 로그와 프로파일러(사용 설정된 경우)에 모두 영향을 줍니다. `mongos` 인스턴스의 경우, `mongos`에서는 프로파일링을 사용할 수 없으므로 이 설정은 진단 로그에만 영향을 미치고 프로파일러에는 영향을 미치지 않습니다. 기록된 작업을 제어하는 데 사용되는 필터의 예를 보려면 프로파일링된 작업을 결정하기 위한 필터 설정을 참조하세요. 프로파일링 필터가 설정된 경우 slowms 및 sampleRate 옵션은 진단 로그 또는 프로파일러에 영향을 주지 않습니다.

반환

이 메서드는 해당 설정의 이전 값이 포함된 문서를 반환합니다.

{
   "was" : 2,
   "slowms" : 100,
   "sampleRate" : 1,
   "filter" : {
      "$and" : [
         {
            "op" : {
               "$eq" : "query"
            }
         },
         {
            "millis" : {
               "$gt" : 20000
            }
         }
      ]
   },
   "note" : "When a filter expression is set, slowms and sampleRate are not used for profiling and slow-query log lines.",
   "ok" : 1
}

{
   "was" : 0,
   "slowms" : 100,
   "sampleRate" : 1,
   "filter" : {
      "$and" : [
         {
            "op" : {
               "$eq" : "query"
            }
         },
         {
            "millis" : {
               "$gte" : 2000
            }
         }
      ]
   },
   "note" : "When a filter expression is set, slowms and sampleRate are not used for profiling and slow-query log lines.",
   "ok" : 1,
   "$clusterTime" : {
      "clusterTime" : Timestamp(1572991238, 1),
      "signature" : {
         "hash" : BinData(0,"hg6GnlrVhV9MAhwWdeHmHQ4T4qU="),
         "keyId" : Long("6755945537557495811")
      }
   },
   "operationTime" : Timestamp(1572991238, 1)
}

{
   "was" : 0,
   "slowms" : 100,
   "sampleRate" : 1,
   "filter" : {
      "$and" : [
         {
            "op" : {
               "$eq" : "query"
            }
         },
         {
            "millis" : {
               "$gte" : 2000
            }
         }
      ]
   },
   "note" : "When a filter expression is set, slowms and sampleRate are not used for profiling and slow-query log lines.",
   "ok" : 1,
   "operationTime" : Timestamp(1572991499, 2),
   "$clusterTime" : {
      "clusterTime" : Timestamp(1572991499, 2),
      "signature" : {
         "hash" : BinData(0,"nhCquIxUw7thlrBudXe3PnsnvP0="),
         "keyId" : Long("6755946491040235540")
      }
   }
}

구제척으로:

was 는 이전 수준 설정입니다.
slowms 는 이전 slowms 설정입니다.
sampleRate 는 이전 sampleRate 설정입니다.
filter 는 이전 필터 설정입니다.
note 는 filter의 동작을 설명하는 문자열입니다. 이 필드는 filter도 있는 경우에만 출력에 나타납니다.

참고

filter 및 note 필드는 이전 수준 설정에 있었던 경우에만 출력에 나타납니다.

현재 프로파일링 수준을 보려면 db.getProfilingStatus()를 참조하세요.

행동

경고

프로파일링은 성능을 저하시키고 시스템 로그에서 암호화되지 않은 쿼리 데이터를 노출시킬 수 있습니다. 프로덕션 배포서버에서 프로파일러를 구성하고 활성화하기 전에 이것이 성능과 보안에 미치는 영향을 신중하게 고려하세요.

잠재적인 성능 저하에 대한 자세한 내용은 프로파일러 오버헤드를 참조하십시오.

예시

프로파일러 활성화 및 저속 작업 임계값과 샘플 속도 설정

다음은 mongod 인스턴스에서 설정할 수 있는 값의 예입니다.

the profiling level to 1,
the slow operation threshold slowms to 20 milliseconds, and
the sampleRate to 0.42.

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

이 작업은 이전 설정 값이 포함된 문서를 반환합니다.

현재 프로파일링 수준을 보려면 db.getProfilingStatus()를 참조하세요.

프로파일러 비활성화 및 저속 작업 임계값과 샘플 속도 설정

다음은 mongod 또는 mongos 인스턴스에서 설정할 수 있는 값의 예입니다.

the profiling level to 0,
the slow operation threshold slowms to 20 milliseconds, and
the sampleRate to 0.42.

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

이 작업은 이전 설정 값이 포함된 문서를 반환합니다.

현재 프로파일링 수준을 보려면 db.getProfilingStatus()를 참조하세요.

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

다음은 mongod 인스턴스에서 설정할 수 있는 값의 예입니다.

the profiling level to 1,
필터하다 를 사용하면 프로파일러가 초 이상 걸린 작업만 기록 . { op: "query", millis: { $gt: 2000 } } query 2

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

이 작업은 이전 설정 값이 포함된 문서를 반환합니다.

현재 프로파일링 수준을 보려면 db.getProfilingStatus()를 참조하세요.

프로파일러를 활성화하지 않고 필터 설정

You can set a filter without enabling the database profiler. The following example uses a filter with a profiling level of 0.

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

프로파일링 수준이 0이므로 프로파일러가 비활성화됩니다. 및 일치하는 작업을 프로파일러 컬렉션에 기록하지 않습니다. 필터는 여전히 진단 로그에 적용됩니다.

이 작업은 이전 설정 값이 포함된 문서를 반환합니다.

현재 프로파일링 수준을 보려면 db.getProfilingStatus()를 참조하세요.

필터 설정 해제

프로필 필터를 지우려면 filter: "unset" 옵션으로 db.setProfilingLevel()을 실행합니다.

db.setProfilingLevel( 1, { filter: "unset" } )

이 작업은 이전 설정 값이 포함된 문서를 반환합니다.

현재 프로파일링 수준을 보려면 db.getProfilingStatus()를 참조하세요.

돌아가기

db.setLogLevel

db.shutdownServer