Docs Menu
Docs Home
/
MongoDB 매뉴얼
/
참조
/
Mongo쉬 방법
/
컬렉션

db.collection.latencyStats()

이 페이지의 내용

  • 정의
  • 호환성
  • 출력
  • 예시

정의

db.collection.latencyStats(options)

중요

Mongo쉬 방법

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

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

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

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

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

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

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

팁

다음도 참조하세요.

$collStats

호환성

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

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

참고

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

출력

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

필드 이름
설명

reads

읽기 요청에 대한 지연 시간 통계입니다.

writes

쓰기 요청에 대한 지연 시간 통계입니다.

commands

데이터베이스 명령에 대한 지연 시간 통계입니다.

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

필드 이름
설명

latency

총 결합된 지연 시간을 마이크로초 단위로 제공하는 64비트 정수입니다.

ops

시작 이후 컬렉션에 대해 수행된 총 작업 수를 제공하는 64비트 정수입니다.

histogram

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

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

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

필드 이름

설명

micros

현재 지연 시간 범위 의 하한 시간 경계를 마이크로초 단위로 제공하는 64비트 정수입니다.

문서의 범위는 이전 문서의 micros 값(배타적)과 이 문서의 micros 값(포괄적) 사이입니다.

count

지연 시간이 micros 이하인 작업 수를 제공하는 64비트 정수입니다.

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

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

이는 다음이 있었음을 나타냅니다:

  • 마이크로초 이하로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" : NumberLong(16),
          "count" : NumberLong(6)
        },
        {
          "micros" : NumberLong(512),
          "count" : NumberLong(1)
        }
      ],
      "latency" : NumberLong(747),
      "ops" : NumberLong(7)
    },
    "writes" : {
      "histogram" : [
        {
          "micros" : NumberLong(64),
          "count" : NumberLong(1)
        },
        {
          "micros" : NumberLong(24576),
          "count" : NumberLong(1)
        }
      ],
      "latency" : NumberLong(26845),
      "ops" : NumberLong(2)
    },
    "commands" : {
      "histogram" : [ ],
      "latency" : NumberLong(0),
      "ops" : NumberLong(0)
    }
  }
}

돌아가기

db.collection.isCapped

다음

db.collection.mapReduce

이 페이지의 내용