문서 메뉴
문서 홈
/
MongoDB 매뉴얼
/
참조
/
Mongosh
/
컬렉션 메서드

db.collection.latencyStats()

이 페이지의 내용

  • 정의
  • 출력
  • 예제

정의

db.collection.latencyStats(options)

중요

Mongo쉬 방법

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

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

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

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

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

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

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

팁

다음도 참조하세요.

$collStats

출력

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

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

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

필드 이름
설명
latency
총 결합된 지연 시간을 마이크로초 단위로 제공하는 64비트 정수입니다.
ops
시작 이후 컬렉션에 대해 수행된 총 작업 수를 제공하는 64비트 정수입니다.
histogram

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

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

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

필드 이름
설명
micros

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

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

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

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

histogram: [
  { micros: NumberLong(1), 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) }
]

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

  • 1마이크로초 이하로 걸리는 10개 작업

  • (1, 2] 마이크로초 범위 내 1개 작업

  • (3072, 4096] 마이크로초 범위 내 1개 작업

  • (12288, 16384] 마이크로초 범위 내 1,000개 작업

  • (32768, 49152] 마이크로초 범위 내 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()

이 페이지의 내용