db.serverStatus()
db.serverStatus()
데이터베이스 프로세스의 상태 에 대한 개요를 제공하는 문서 를 반환합니다.
이 명령은 데이터베이스 명령
serverStatus
을 감싸는 래퍼(wrapper)를 제공합니다.
호환성
이 메서드는 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.
MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스
중요
이 명령은 M0, M2 및 M5 클러스터에서 지원되지 않습니다. 자세한 내용은 지원되지 않는 명령을 참조하세요.
MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전
행동
기본적으로 db.serverStatus()
는 출력에서 다음을 제외합니다.
repl 문서의 일부 내용.
기본적으로 제외되는 필드를 포함하려면 명령에서 최상위 필드를 지정하고 이 필드를 1
로 설정합니다. 기본적으로 포함되는 필드를 제외하려면 필드를 지정하고 0으로 설정합니다. 최상위 필드 또는 포함되는 필드를 지정할 수 있습니다.
예를 들어 다음 작업은 출력에서 repl
, metrics
, locks
정보를 억제합니다.
db.serverStatus( { repl: 0, metrics: 0, locks: 0 } )
다음 예시에서는 출력에 모든 repl 정보를 포함합니다.
db.serverStatus( { repl: 1 } )
초기화
db.serverStatus()
에서 보고된 통계는 mongod
서버가 다시 시작될 때 재설정됩니다. db.serverStatus()
명령은 서버 이벤트에 의해 초기화될 때까지 일부 통계를 보고하지 않습니다.
예를 들어 mongod
서버를 다시 시작한 후 db.serverStatus()
는 findAndModify
에 대한 값을 반환하지 않습니다.
db.serverStatus().metrics.commands.findAndModify // No results returned
업데이트 쿼리를 실행한 후 db.serverStatus()
를 후속 호출하면 예상 지표를 표시합니다.
{ "arrayFilters" : NumberLong(0), "failed" : NumberLong(0), "pipeline" : NumberLong(0), "total" : NumberLong(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 출력을 참조하세요.