db. 컬렉션.latencyStats() (mongosh 메서드)

중요

Mongo쉬 방법

이 페이지에서는 mongosh 메서드에 대해 설명합니다. 이는 데이터베이스 명령 또는 Node.js와 같은 언어별 드라이버에 대한 설명서가 아닙니다.

데이터베이스 명령의 경우 collStats 명령에서 반환된 latencyStats 필드를 참조하세요.

MongoDB API 드라이버의 경우 언어별 MongoDB 드라이버 설명서를 참조하세요.

정의

db.collection.latencyStats(options)

db.collection.latencyStats()는 지정된 컬렉션에 대한 지연 시간 통계를 반환합니다. 이는 $collStats를 감싸는 래퍼(wrapper)입니다.

이 메서드에는 다음과 같은 형식이 있습니다.

db.collection.latencyStats( { histograms: <boolean> } )

histograms 인수는 선택적 부울입니다. histograms: true인 경우 latencyStats()는 반환 문서에 지연 시간 히스토그램을 추가합니다.

팁

$collStats

호환성

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

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

참고

이 명령은 모든 MongoDB Atlas 클러스터에서 지원됩니다. 모든 명령에 대한 Atlas 지원에 관해 자세히 알아보려면 지원되지 않는 명령을 참조하십시오.

MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

출력

latencyStats() 은 다음 필드를 포함하는 latencyStats 필드 가 포함된 문서 를 반환합니다.

필드 이름	설명
`reads`	읽기 요청에 대한 지연 시간 통계입니다.
`writes`	쓰기 요청에 대한 지연 시간 통계입니다.
`commands`	데이터베이스 명령에 대한 지연 시간 통계입니다.
`transactions`	데이터베이스 트랜잭션에 대한 지연 시간 통계입니다.

이러한 각 필드에는 다음 필드가 있는 내장된 문서 포함되어 있습니다.

필드 이름

설명

latency

총 지연 시간(마이크로초)입니다.

ops

스타트업 이후 컬렉션 에 대해 수행된 작업의 총 개수입니다.

histogram

각각 지연 시간 범위 를 나타내는 내장된 문서의 배열 입니다. 각 문서 는 이전 문서 범위 의 두 배를 다룹니다. 2048 마이크로초에서 약 1 초 사이의 낮은 값의 경우 히스토그램에 반단계가 포함됩니다.

이 필드는 latencyStats: { histograms: true } 옵션이 있는 경우에만 존재합니다. count가 0인 빈 범위는 출력에서 생략됩니다.

각 문서 에는 다음과 같은 필드가 있습니다.

필드 이름	설명
`micros`	현재 지연 시간 범위 의 하한값(마이크로초)입니다. 문서의 범위는 이전 문서의 `micros` 값(배타적)과 이 문서의 `micros` 값(포괄적) 사이입니다.
`count`	지연 시간 `micros` 이하인 작업의 수입니다.

예를 들어 collStats가 다음과 같은 히스토그램을 반환하는 경우입니다.

histogram: [
  { micros: Long(0), count: Long(10) },
  { micros: Long(2), count: Long(1) },
  { micros: Long(4096), count: Long(1) },
  { micros: Long(16384), count: Long(1000) },
  { micros: Long(49152), count: Long(100) }
]

이는 [1]이 있음을 나타냅니다.

마이크로초 이하로10 걸리는 작업 2
[2, 4) 마이크로초 범위 의 1 작업
[4096, 6144) 마이크로초 범위 의 1 작업
[16384, 24576) 마이크로초 범위 의 1000 작업
[49152, 65536) 마이크로초 범위 의 100 작업

[1]	이 페이지의 `(` 기호 표기는 값이 배타적임을 의미합니다. 이 페이지의 `]` 기호 표기법은 값이 포괄적임을 의미합니다.

예시

다음과 같이 mongosh에서 latencyStats()를 실행할 수 있습니다.

db.data.latencyStats( { histograms: true } ).pretty()

latencyStats() 다음과 같은 문서를 반환합니다.

{
  "ns" : "test.data",
  "localTime" : ISODate("2016-11-01T21:56:28.962Z"),
  "latencyStats" : {
    "reads" : {
      "histogram" : [
        {
          "micros" : Long(16),
          "count" : Long(6)
        },
        {
          "micros" : Long(512),
          "count" : Long(1)
        }
      ],
      "latency" : Long(747),
      "ops" : Long(7)
    },
    "writes" : {
      "histogram" : [
        {
          "micros" : Long(64),
          "count" : Long(1)
        },
        {
          "micros" : Long(24576),
          "count" : Long(1)
        }
      ],
      "latency" : Long(26845),
      "ops" : Long(2)
    },
    "commands" : {
      "histogram" : [ ],
      "latency" : Long(0),
      "ops" : Long(0)
    }
  }
}

돌아가기

db.collection.isCapped

db.collection.mapReduce