db.stats()
설명
db.stats(scale)
단일 데이터베이스의 사용 상태를 반영하는 통계를 반환합니다.
db.stats()
메서드는dbStats
데이터베이스 명령을 감싸는 래퍼(wrapper)입니다.
필드
db.stats()
메서드에는 다음과 같은 선택적 필드가 있습니다.
필드 | 유형 | 설명 |
---|---|---|
숫자 | 선택 사항입니다. 다양한 크기의 데이터에 대한 배율 인수입니다. 크기 데이터를 바이트 단위로 반환하려면 정수가 아닌 배율 인수를 지정하면 MongoDB는 지정된 인수의 정수 부분을 사용합니다. 예를 들어, 배율 인수를 버전 4.2부터 출력에 크기 값의 크기를 조정하는 데 사용되는 | |
숫자 | 선택 사항입니다. collection에 할당된 여유 공간에 대한 정보를 반환하려면 인스턴스 에 많은 수의 컬렉션 또는 인덱스가 있는 경우 여유 공간 사용량 데이터를 가져오면 처리 지연이 발생할 수 있습니다. 여유 공간 세부 정보 없이 |
출력
db.stats()
메서드는 데이터베이스 시스템 상태에 대한 통계가 포함된 문서를 반환합니다. freeStorage 세부 정보를 포함한 전체 목록은 다음과 같습니다.
{ db: 'test', collections: 2, views: 0, objects: 1689, avgObjSize: 52.56542332741267, dataSize: 86.7021484375, storageSize: 100, freeStorageSize: 32, indexes: 2, indexSize: 116, indexFreeStorageSize: 36, totalSize: 216, totalFreeStorageSize: 68, scaleFactor: 1024, fsUsedSize: 60155820, fsTotalSize: 61255492, ok: 1, '$clusterTime': { clusterTime: Timestamp({ t: 1646085664, i: 1 }), signature: { hash: Binary(Buffer.from("0000000000000000000000000000000000000000", "hex"), 0), keyId: Long("0") } }, operationTime: Timestamp({ t: 1646085664, i: 1 }) }
출력에 대한 설명은 출력을 참조하세요.
행동
예기치 않은 종료 후 정확도
Wired Tiger storage engine을 사용하여 mongod
를 비정상적으로 종료한 후 db.stats()
에서 보고하는 개수 및 크기 통계가 부정확할 수 있습니다.
편차의 정도는 마지막 체크포인트와 비정상 종료 사이에 수행된 삽입, 업데이트 또는 삭제 작업의 수에 따라 달라집니다. 체크포인트는 보통 60초마다 발생합니다. 그러나mongod
기본값이 아닌 --syncdelay
설정으로 실행되는 인스턴스는 체크포인트가 다소 빈번하게 발생할 수 있습니다.
mongod
의 각 컬렉션에서 validate
를 실행하여 비정상 종료 후 통계를 복원합니다.
비정상 종료 후
복제본 세트 구성원 국가 제한
복제본 세트 노드에서 실행하는 경우 dbStats
연산을 수행하려면 노드가 PRIMARY
또는 SECONDARY
상태여야 합니다. 노드가 STARTUP2
와 같은 다른 상태이면 연산 오류가 발생합니다.
예시
Scale Output Values
값을 킬로바이트 단위로 반환하려면 확장하다 을 1024
로 설정하다 합니다.
db.stats(1024)
참고
배율 인수는 값을 정수로 반올림합니다.
단일 값 반환하기
indexSize
와 같은 단일 값을 반환하려면 필드 이름을 db.stats()
에 추가합니다.
db.stats().indexSize db.stats(1024).indexSize
출력에는 원래 값과 배율이 적용된 값 간의 차이가 표시됩니다.
118784 116
컬렉션에 할당된 여유 공간에 대한 반환 정보
컬렉션에 할당된 여유 공간에 대한 정보를 반환하려면 freeStorage 필드 를 db.stats()
에 전달합니다.
다음 예시에서는 indexFreeStorageSize
(킬로바이트)를 반환합니다.
db.stats( { freeStorage: 1, scale: 1024 } ).indexFreeStorageSize