db.stats()

이 페이지의 내용

설명

행동
예시

설명

db.stats(scale)

단일 데이터베이스의 사용 상태를 반영하는 통계를 반환합니다.

db.stats() 메서드는 dbStats 데이터베이스 명령을 감싸는 래퍼(wrapper)입니다.

필드

db.stats() 메서드에는 다음과 같은 선택적 필드가 있습니다.

필드	유형	설명
확장	숫자	선택 사항입니다. 다양한 크기의 데이터에 대한 배율 인수입니다. 크기 데이터를 바이트 단위로 반환하려면 `scale` 기본값은 1입니다. 바이트가 아닌 킬로바이트를 표시하려면 `scale` 값 `1024`로 지정합니다. 정수가 아닌 배율 인수를 지정하면 MongoDB는 지정된 인수의 정수 부분을 사용합니다. 예를 들어, 배율 인수를 `1023.999` 으로 지정하면 MongoDB는 배율 인수로 `1023` 을 사용합니다. 버전 4.2부터 출력에 크기 값의 크기를 조정하는 데 사용되는 `scaleFactor` 이 포함됩니다.
무료 스토리지	숫자	선택 사항입니다. collection에 할당된 여유 공간에 대한 정보를 반환하려면 `freeStorage`을(를) 1로 설정합니다. 인스턴스 에 많은 수의 컬렉션 또는 인덱스가 있는 경우 여유 공간 사용량 데이터를 가져오면 처리 지연이 발생할 수 있습니다. 여유 공간 세부 정보 없이 `db.stats()` 데이터를 수집하려면 `freeStorage` 를 0 로 설정하다 하거나 필드 를 포함하지 않습니다.

출력

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를 실행하여 비정상 종료 후 통계를 복원합니다.

비정상 종료 후

validate는 collStats 출력의 카운트 통계를 최신 값으로 업데이트합니다.
collStats 출력에 삽입되거나 제거된 문서 수와 같은 기타 통계는 추정치입니다.

복제본 세트 구성원 국가 제한

복제본 세트 노드에서 실행하는 경우 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

돌아가기

db.shutdownServer

db.version