프로필

정의

profile

버전 5.0에서 변경됨

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

mongod에서 데이터베이스 프로파일러 수준이 2인 경우 프로파일러 및 diagnostic log에서 전체 로깅이 활성화됩니다.

데이터베이스 프로파일러 수준 1에서 다음 설정은 프로파일러와 diagnostic log을(를) 모두 수정합니다.

• slowms

• sampleRate

• 필터

데이터베이스 프로파일러 수준이 0이면 데이터베이스 프로파일러가 비활성화됩니다. 0 수준에서는 다음 설정이 진단 로그만 수정합니다.

• slowms

• sampleRate

• 필터

mongos 인스턴스 의 경우 명령은 작업이 진단 로그 에 기록되는 방식만 구성합니다. 에는 프로파일러가 쓰기 (write) 수 있는 컬렉션이 없기 때문에 {인스턴스 에서 데이터베이스 프로파일러 를 활성화 할 수 mongos 없습니다.mongos

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

mongos에서 profile 수준을 다음과 같이 설정할 수 있습니다.

• 0 진단 로그에 대해 slowms, sampleRate 및 filter을(를) 설정합니다.

• -1 현재 설정을 읽습니다.

프로파일러는 기본적으로 꺼진 상태입니다.

경고

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

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

호환성

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

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

• MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전

• MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

구문

명령은 다음과 같은 구문을 가집니다:

db.runCommand(
  {
    profile: <level>,
    slowms: <threshold>,
    sampleRate: <rate>,
    filter: <filter expression>
  }
)

명령 필드

이 명령은 다음 필드를 사용합니다.

{ <field1>: <expression1>, ... }

db.getProfilingStatus() 및 db.setProfilingLevel() shell 메서드는 profile 명령에 대한 래퍼(wrapper)를 제공합니다.

행동

profile 명령은 프로파일러를 활성화 또는 비활성화하면서 영향을 받는 데이터베이스에 대한 쓰기 잠금을 가져옵니다. 이 작업은 일반적으로 짧은 시간 내에 완료됩니다. profile 명령이 완료될 때까지 잠금이 다른 작업을 차단합니다.

mongos를 통해 샤딩된 클러스터에 연결된 경우 모든 데이터베이스에 대해 profile 명령을 실행할 수 있습니다.

예시

db.runCommand(
   {
     profile: 1,
     filter:
        {
           $or:
           [
              { millis: { $gte: 100 } },
              { user: "testuser@admin" }
           ]
        }
   }
)

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