db.serverStatus()데이터베이스 프로세스 상태에 대한 개요를 제공하는 문서를 반환합니다.
이 명령은 데이터베이스 명령
serverStatus을 감싸는 래퍼(wrapper)를 제공합니다.
호환성
이 메서드는 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.
- MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스
중요
이 명령은 M0 및 Flex 클러스터에서 지원되지 않습니다. 자세한 내용은 지원되지 않는 명령을 참조하세요.
MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전
행동
By default, db.serverStatus() excludes in its output:
repl 문서의 일부 내용.
기본적으로 제외되는 필드를 포함하려면 명령에서 최상위 필드를 지정하고 이 필드를 1로 설정합니다. 기본적으로 포함되는 필드를 제외하려면 필드를 지정하고 0으로 설정합니다. 최상위 필드 또는 포함되는 필드를 지정할 수 있습니다.
예를 들어 다음 작업은 출력에서 repl, metrics, locks 정보를 억제합니다.
db.serverStatus( { repl: 0, metrics: 0, locks: 0 } )
다음 예시에서는 출력에 모든 repl 정보를 포함합니다.
db.serverStatus( { repl: 1 } )
모든 선택 사항 필드 제외
MongoDB 7.0.38부터는 none: 1를 지정하여 db.serverStatus() 출력에서 모든 선택적 필드를 제외할 수 있습니다. 선택적 필드를 모두 제외한 후 포함할 필드를 지정할 수 있습니다.
이 예시 none 을 사용하여 처음에 모든 선택적 필드를 출력에서 제외한 다음 locks 문서 포함합니다.
db.serverStatus({ none: 1, locks: 1 })
초기화
The statistics reported by db.serverStatus() are reset when the mongod server is restarted. The db.serverStatus() command does not report some statistics until they have been initialized by server events.
For example, after restarting the mongod server, db.serverStatus() won't return any values for findAndModify.
db.serverStatus().metrics.commands.findAndModify // No results returned
After you run an update query, subsequent calls to db.serverStatus() display the expected metrics.
{ "arrayFilters" : Long(0), "failed" : Long(0), "pipeline" : Long(0), "total" : Long(1) }
참고
카운터가 증가하기 전에 특정 객체를 쿼리하면 db.serverStatus() 메서드는 오류를 반환합니다.
아직 문서 업데이트가 없는 경우 다음을 수행합니다.
db.serverStatus().metrics.commands.update.pipeline
반환합니다:
TypeError: db.serverStatus(...).metrics.commands.update is undefined : @(shell):1:1
포함 mirroredReads
기본적으로 mirroredReads 정보는 출력에 포함되지 않습니다. mirroredReads 정보를 반환하려면 포함을 명시적으로 지정해야 합니다.
db.serverStatus( { mirroredReads: 1 } )
포함 latchAnalysis
기본적으로 latchAnalysis 정보(버전 4.4부터 사용 가능)는 출력에 포함되지 않습니다. latchAnalysis 정보를 반환하려면 포함을 명시적으로 지정해야 합니다.
db.serverStatus( { latchAnalysis: 1 } )
출력
이 함수의 출력에 대한 전체 문서는 ServerStatus 출력을 참조하세요.