문서 메뉴
문서 홈
/
MongoDB 매뉴얼
/
참조
/
데이터베이스 명령
/
진단 명령

connPoolStats

이 페이지의 내용

  • 정의
  • 구문
  • 행동
  • 예제
  • 출력

정의

connPoolStats

connPoolStats 명령은 현재 데이터베이스 인스턴스에서 샤드 클러스터 또는 복제본 세트의 다른 멤버로의 열린 발신 연결에 관한 정보를 반환합니다.

connPoolStats를 실행하려면 db.runCommand( { <command> } ) 메서드를 사용합니다.

참고

connPoolStats 은(는) 샤드 클러스터의 mongos 인스턴스 및 mongod 인스턴스에 대해서만 의미 있는 결과를 반환합니다.

구문

명령은 다음과 같은 구문을 가집니다:

db.runCommand(
   {
     connPoolStats: 1
   }
)

인수 값(예: 1 )는 명령의 출력에 영향을 주지 않습니다.

행동

connPoolStats 는 출력에 집계된 통계를 포함합니다.

  • hosts 필드에는 호스트별로 집계된 정보가 표시됩니다.

  • pools 필드에는 풀별로 집계된 정보가 표시됩니다.

참고

실행 중인 작업의 방해를 방지하기 위해 connPoolStats 은(는) 잠금을 사용하지 않습니다. 따라서 connPoolStats 가 정보를 수집할 때 개수가 약간 변경되어 hosts } 연결 개수와 pools 연결 개수 간에 약간의 차이가 발생할 수 있습니다.

예제

다음 작업은 메서드를 사용하여 샤드 클러스터의 db.runCommand() 에서 connPoolStats 명령을 실행합니다. 샤드 클러스터에는 mongos 2 샤드, 각각 단일 멤버 복제본 세트 및 config 서버 복제본 세트 1개가 있습니다.mongos 는 4코어 머신에서 실행됩니다.

db.runCommand( { "connPoolStats" : 1 } )

이 명령은 다음 형식의 출력을 반환합니다.

참고

connPoolStats 출력은 배포 및 connPoolStats 를 실행하는 멤버에 따라 달라집니다.

{
   "numClientConnections" : <num>,
   "numAScopedConnections" : <num>,
   "totalInUse" : <num>,
   "totalAvailable" : <num>,
   "totalLeased" : <num>,
   "totalCreated" : <num>,
   "totalRefreshing" : <num>,
   "replicaSetMatchingStrategy" : <string>,
   "acquisitionWaitTimes" : {  // Added in MongoDB 6.3
      "(-inf, 0ms)" : { "count" : <num> },
      "[0ms, 50ms)" : { "count" : <num> },
      "[50ms, 100ms)" : { "count" : <num> },
      "[100ms, 150ms)" : { "count" : <num> },
      "[150ms, 200ms)" : { "count" : <num> },
      "[200ms, 250ms)" : { "count" : <num> },
      "[250ms, 300ms)" : { "count" : <num> },
      "[300ms, 350ms)" : { "count" : <num> },
      "[350ms, 400ms)" : { "count" : <num> },
      "[400ms, 450ms)" : { "count" : <num> },
      "[450ms, 500ms)" : { "count" : <num> },
      "[500ms, 550ms)" : { "count" : <num> },
      "[550ms, 600ms)" : { "count" : <num> },
      "[600ms, 650ms)" : { "count" : <num> },
      "[650ms, 700ms)" : { "count" : <num> },
      "[700ms, 750ms)" : { "count" : <num> },
      "[750ms, 800ms)" : { "count" : <num> },
      "[800ms, 850ms)" : { "count" : <num> },
      "[850ms, 900ms)" : { "count" : <num> },
      "[900ms, 950ms)" : { "count" : <num> },
      "[950ms, 1000ms)" : { "count" : <num> },
      "[1000ms, inf)" : { "count" : <num> },
      "totalCount" : <num>
   },
   "pools" : {
      "NetworkInterfaceTL-TaskExecutorPool-0" : {
         "poolInUse" : <num>,
         "poolAvailable" : <num>,
         "poolLeased" : <num>,
         "poolCreated" : <num>,
         "poolRefreshing" : <num>,
         "acquisitionWaitTimes" : <document>,  // Added in MongoDB 6.3
         "cfg1.example.net:27019" : {
            "inUse" : <num>,
            "available" : <num>,
            "leased" : <num>,
            "created" : <num>,
            "refreshing" : <num>,
            "acquisitionWaitTimes" : <document>  // Added in MongoDB 6.3
         },
      },
      "NetworkInterfaceTL-TaskExecutorPool-1" : {
         "poolInUse" : <num>,
         "poolAvailable" : <num>,
         "poolLeased" : <num>,
         "poolCreated" : <num>,
         "poolRefreshing" : <num>,
         "acquisitionWaitTimes" : <document>,  // Added in MongoDB 6.3
         "cfg1.example.net:27019" : {
            "inUse" : <num>,
            "available" : <num>,
            "leased" : <num>,
            "created" : <num>,
            "refreshing" : <num>,
            "acquisitionWaitTimes" : <document>  // Added in MongoDB 6.3
         }
      },
      "NetworkInterfaceTL-TaskExecutorPool-2" : {
         "poolInUse" : <num>,
         "poolAvailable" : <num>,
         "poolLeased" : <num>,
         "poolCreated" : <num>,
         "poolRefreshing" : <num>,
         "acquisitionWaitTimes" : <document>,  // Added in MongoDB 6.3
         "cfg1.example.net:27019" : {
            "inUse" : <num>,
            "available" : <num>,
            "leased" : <num>,
            "created" : <num>,
            "refreshing" : <num>,
            "acquisitionWaitTimes" : <document>  // Added in MongoDB 6.3
         }
      },
      "NetworkInterfaceTL-TaskExecutorPool-3" : {
         "poolInUse" : <num>,
         "poolAvailable" : <num>,
         "poolLeased" : <num>,
         "poolCreated" : <num>,
         "poolRefreshing" : <num>,
         "acquisitionWaitTimes" : <document>,  // Added in MongoDB 6.3
         "cfg1.example.net:27019" : {
            "inUse" : <num>,
            "available" : <num>,
            "leased" : <num>,
            "created" : <num>,
            "refreshing" : <num>,
            "acquisitionWaitTimes" : <document>  // Added in MongoDB 6.3
         }
      },
      "NetworkInterfaceTL-ShardRegistry" : {
         "poolInUse" : <num>,
         "poolAvailable" : <num>,
         "poolLeased" : <num>,
         "poolCreated" : <num>,
         "poolRefreshing" : <num>,
         "acquisitionWaitTimes" : <document>,  // Added in MongoDB 6.3
         "cfg1.example.net:27019" : {
            "inUse" : <num>,
            "available" : <num>,
            "leased" : <num>,
            "created" : <num>,
            "refreshing" : <num>,
            "acquisitionWaitTimes" : <document>  // Added in MongoDB 6.3
         },
         "cfg2.example.net:27019" : {
            "inUse" : <num>,
            "available" : <num>,
            "leased" : <num>,
            "created" : <num>,
            "refreshing" : <num>,
            "acquisitionWaitTimes" : <document>  // Added in MongoDB 6.3
         },
         "cfg3.example.net:27019" : {
            "inUse" : <num>,
            "available" : <num>,
            "leased" : <num>,
            "created" : <num>,
            "refreshing" : <num>,
            "acquisitionWaitTimes" : <document>  // Added in MongoDB 6.3
         },
         "shard1.example.net:27018" : {
            "inUse" : <num>,
            "available" : <num>,
            "leased" : <num>,
            "created" : <num>,
            "refreshing" : <num>,
            "acquisitionWaitTimes" : <document>  // Added in MongoDB 6.3
         },
         "shard2.example.net:27018" : {
            "inUse" : <num>,
            "available" : <num>,
            "leased" : <num>,
            "created" : <num>,
            "refreshing" : <num>,
            "acquisitionWaitTimes" : <document>  // Added in MongoDB 6.3
         }
      },
      "global" : {
         "poolInUse" : <num>,
         "poolAvailable" : <num>,
         "poolLeased" : <num>,
         "poolCreated" : <num>,
         "poolRefreshing" : <num>,
         "acquisitionWaitTimes" : <document>,  // Added in MongoDB 6.3
         "cfg3.example.net:27019" : {
            "inUse" : <num>,
            "available" : <num>,
            "leased" : <num>,
            "created" : <num>,
            "refreshing" : <num>,
            "acquisitionWaitTimes" : <document>  // Added in MongoDB 6.3
         },
         "cfg1.example.net:27019" : {
            "inUse" : <num>,
            "available" : <num>,
            "leased" : <num>,
            "created" : <num>,
            "refreshing" : <num>,
            "acquisitionWaitTimes" : <document>  // Added in MongoDB 6.3
         },
         "cfg2.example.net:27019" : {
            "inUse" : <num>,
            "available" : <num>,
            "leased" : <num>,
            "created" : <num>,
            "refreshing" : <num>,
            "acquisitionWaitTimes" : <document>  // Added in MongoDB 6.3
         },
         "shard2.example.net:27018" : {
            "inUse" : <num>,
            "available" : <num>,
            "leased" : <num>,
            "created" : <num>,
            "refreshing" : <num>,
            "acquisitionWaitTimes" : <document>  // Added in MongoDB 6.3
         },
         "shard1.example.net:27018" : {
            "inUse" : <num>,
            "available" : <num>,
            "leased" : <num>,
            "created" : <num>,
            "refreshing" : <num>,
            "acquisitionWaitTimes" : <document>  // Added in MongoDB 6.3
         }
      }
   },
   "hosts" : {
      "cfg3.example.net:27019" : {
         "inUse" : <num>,
         "available" : <num>,
         "leased" : <num>,
         "created" : <num>,
         "refreshing" : <num>,
         "acquisitionWaitTimes" : <document>  // Added in MongoDB 6.3
      },
      "cfg1.example.net:27019" : {
         "inUse" : <num>,
         "available" : <num>,
         "leased" : <num>,
         "created" : <num>,
         "refreshing" : <num>,
         "acquisitionWaitTimes" : <document>  // Added in MongoDB 6.3
      },
      "cfg2.example.net:27019" : {
         "inUse" : <num>,
         "available" : <num>,
         "leased" : <num>,
         "created" : <num>,
         "refreshing" : <num>,
         "acquisitionWaitTimes" : <document>  // Added in MongoDB 6.3
      },
      "shard2.example.net:27018" : {
         "inUse" : <num>,
         "available" : <num>,
         "leased" : <num>,
         "created" : <num>,
         "refreshing" : <num>,
         "acquisitionWaitTimes" : <document>  // Added in MongoDB 6.3
      },
      "shard1.example.net:27018" : {
         "inUse" : <num>,
         "available" : <num>,
         "leased" : <num>,
         "created" : <num>,
         "refreshing" : <num>,
         "acquisitionWaitTimes" : <document>  // Added in MongoDB 6.3
      }
   },
   "replicaSets" : {
      "csRS" : {
         "hosts" : [
            {
               "addr" : "cfg1.example.net:27019",
               "ok" : <bool>,
               "ismaster" : <bool>,
               "hidden" : <bool>,
               "secondary" : <bool>,
               "pingTimeMillis" : <num>
            },
            {
               "addr" : "cfg2.example.net:27019",
               "ok" : <bool>,
               "ismaster" : <bool>,
               "hidden" : <bool>,
               "secondary" : <bool>,
               "pingTimeMillis" : <num>
            },
            {
               "addr" : "cfg3.example.net:27019",
               "ok" : <bool>,
               "ismaster" : <bool>,
               "hidden" : <bool>,
               "secondary" : <bool>,
               "pingTimeMillis" : <num>
            }
         ]
      },
      "shardB" : {
         "hosts" : [
            {
               "addr" : "shard2.example.net:27018",
               "ok" : <bool>,
               "ismaster" : <bool>,
               "hidden" : <bool>,
               "secondary" : <bool>,
               "pingTimeMillis" : <num>
            }
         ]
      },
      "shardA" : {
         "hosts" : [
            {
               "addr" : "shard1.example.net:27018",
               "ok" : <bool>,
               "ismaster" : <bool>,
               "hidden" : <bool>,
               "secondary" : <bool>,
               "pingTimeMillis" : <num>
            }
         ]
      }
   },
   "ok" : 1,
   "$clusterTime" : {
      "clusterTime" : <timestamp>,
      "signature" : <document>
   },
   "operationTime" : <timestamp>
}

출력

connPoolStats.totalAvailable

현재 mongod / mongos 인스턴스에서 샤드 cluster 또는 복제본 세트의 다른 멤버로 발신하는 사용 가능한 총 연결 수를 보고합니다.

connPoolStats.totalLeased

풀에서 빌린 후 반환될 것으로 예상되는 총 연결 수를 보고합니다. 이러한 연결은 임대 기간 동안 활성 상태로 유지되지 않을 수 있으며 관련 지표에서 제외됩니다. 이러한 연결은 임대 기간 동안에는 사용할 수 없습니다.

connPoolStats.totalCreated

현재 mongod / mongos 인스턴스에서 샤드 cluster 또는 복제본 세트의 다른 멤버에게 생성된 발신 연결의 총 건수를 보고합니다.

connPoolStats.totalInUse

현재 mongod / mongos 인스턴스에서 현재 사용 중인 샤딩된 클러스터 또는 복제본 세트 의 다른 멤버로 발신하는 연결의 총 건수를 보고합니다.

connPoolStats.totalRefreshing

현재 mongod / mongos 인스턴스에서 현재 새로 고쳐지고 있는 샤딩된 cluster 또는 복제본 세트 의 다른 멤버로 나가는 발신 연결의 총 건수를 보고합니다.

connPoolStats.totalWasNeverUsed

현재 mongod / mongos 인스턴스에서 사용되지 않은 채 닫힌 샤드 cluster 또는 복제본 세트 의 다른 멤버로 발신하는 연결의 총 건수를 보고합니다.

connPoolStats.replicaSetMatchingStrategy

버전 5.0에 추가.

mongos 인스턴스에서 이 값은 인스턴스에서 사용하는 정책을 보고하여 복제본 세트 내의 노드에 대한 연결 풀의 최소 크기 제한을 결정합니다.

mongod 인스턴스에서 이 값은 다른 복제본 세트 내의 노드에 대한 연결 풀의 최소 크기 제한을 결정하기 위해 인스턴스가 사용하는 정책을 보고합니다.

mongos 및 mongod 에 대한 정책은 ShardingTaskExecutorPoolReplicaSetMatching 매개 변수를 사용하여 설정할 수 있습니다.

참고

ShardingTaskExecutorPoolReplicaSetMatching 가 "automatic" 로 설정된 경우 replicaSetMatchingStrategy 은 여전히 "automatic" 이 아닌 사용 중인 실제 정책을 설명합니다. ShardingTaskExecutorPoolReplicaSetMatching 의 값을 찾으려면 서버 매개변수의 값을 반환하는 getParameter 를 사용합니다.

db.adminCommand( { getParameter : 1, "ShardingTaskExecutorPoolReplicaSetMatching" : 1 } )
connPoolStats.acquisitionWaitTimes

버전 6.3에 추가.

문서가 mongos 에서 mongod 로 연결을 획득하기 위한 요청에 대한 대기 시간이 포함된 히스토그램을 보고합니다.

  • 이 문서에는 시간 범위(밀리초)와 각 범위 내의 연결 요청 수가 포함되어 있습니다.

  • -inf 가 음의 무한대이고 (-inf, 0ms) 범위의 연결 요청이 대기하지 않은 상태입니다.

  • inf 가 양의 무한대이고 [1000ms, inf) 범위의 연결 요청이 1,000밀리초 이상 대기한 시간입니다.

  • totalCount 는 모든 시간 범위에 대한 연결 요청의 총 개수입니다.

"acquisitionWaitTimes" : {
   "(-inf, 0ms)" : { "count" : <num> },
   "[0ms, 50ms)" : { "count" : <num> },
   "[50ms, 100ms)" : { "count" : <num> },
   "[100ms, 150ms)" : { "count" : <num> },
   "[150ms, 200ms)" : { "count" : <num> },
   "[200ms, 250ms)" : { "count" : <num> },
   "[250ms, 300ms)" : { "count" : <num> },
   "[300ms, 350ms)" : { "count" : <num> },
   "[350ms, 400ms)" : { "count" : <num> },
   "[400ms, 450ms)" : { "count" : <num> },
   "[450ms, 500ms)" : { "count" : <num> },
   "[500ms, 550ms)" : { "count" : <num> },
   "[550ms, 600ms)" : { "count" : <num> },
   "[600ms, 650ms)" : { "count" : <num> },
   "[650ms, 700ms)" : { "count" : <num> },
   "[700ms, 750ms)" : { "count" : <num> },
   "[750ms, 800ms)" : { "count" : <num> },
   "[800ms, 850ms)" : { "count" : <num> },
   "[850ms, 900ms)" : { "count" : <num> },
   "[900ms, 950ms)" : { "count" : <num> },
   "[950ms, 1000ms)" : { "count" : <num> },
   "[1000ms, inf)" : { "count" : <num> },
   "totalCount" : <num>
}
connPoolStats.numClientConnection

현재 mongod / 인스턴스에서 sharded cluster mongos또는 복제본 세트 의 다른 멤버로 보내는 활성 및 저장된 발신 동기 연결의 수를 보고합니다.

이러한 연결은 totalAvailable, totalCreated 및 totalInUse 에서 보고한 데이터의 하위 집합인 풀의 일부입니다.

connPoolStats.numAScopedConnection

현재 mongod / 인스턴스에서 cluster mongos또는 복제본 세트 의 다른 멤버로 활성 및 저장된 발신 범위 지정 동기 연결의 수를 보고합니다.

이러한 연결은 totalAvailable, totalCreated 및 totalInUse 에서 보고한 데이터의 하위 집합인 풀의 일부입니다.

connPoolStats.pools

연결 풀을 기준으로 그룹화된 연결 통계(사용/사용 가능/생성/새로 고침)를 보고합니다. mongod 또는 mongos 에는 두 개의 서로 다른 발신 연결 풀 패밀리가 있습니다.

  • DBClient 기반 풀("쓰기 경로") 및

  • NetworkInterfaceTL 기반 풀("읽기 경로").

각 풀에 대해 이 명령은 다음과 유사한 문서를 반환합니다.

{
  "poolInUse" : <num>,
  "poolAvailable" : <num>,
  "poolLeased" : <num>,
  "poolCreated" : <num>,
  "poolRefreshing" : <num>,
  "acquisitionWaitTimes" : <document>,  // Added in MongoDB 6.3
  "[host1]" : {
     "inUse" : <num>, "available" : <num>, "leased" : <num>, "created" : <num>, "refreshing" : <num>,
     "acquisitionWaitTimes" : <document>  // Added in MongoDB 6.3
  },
  "[host2]" : {
     "inUse" : <num>, "available" : <num>, "leased" : <num>, "created" : <num>, "refreshing" : <num>,
     "acquisitionWaitTimes" : <document>  // Added in MongoDB 6.3
  },
  ...
}

참고

특정 풀에 대한 연결(사용/사용 가능/생성/새로 고침 중)이 없는 경우 connPoolStats 는 해당 풀에 대한 통계를 반환하지 않습니다.

connPoolStats.pools.NetworkInterfaceTL-TaskExecutorPool-[n]

TaskExecutor 풀과 관련된 연결 통계를 표시합니다. 일반적으로 코어당 하나의 TaskExecutorPool이 있습니다. 8코어 프로세서의 경우 pools.NetworkInterfaceTL-TaskExecutorPool-0 ... pools.NetworkInterfaceTL-TaskExecutorPool-7 입니다.

팁

다음도 참조하세요.

taskExecutorPoolSize

connPoolStats.pools.NetworkInterfaceTL-ShardRegistry

명령이 샤드 cluster의 멤버에서 실행되는 경우 사용할 수 있습니다.

현재 mongod / mongos 인스턴스와 샤드 cluster의 다른 멤버 간의 연결에 대한 풀 통계를 표시합니다.

connPoolStats.pools.NetworkInterfaceTL-Replication

명령이 복제본 세트의 멤버에서 실행되는 경우 사용할 수 있습니다.

현재 mongod 인스턴스와 복제본 세트의 다른 멤버 간의 연결에 대한 풀 통계를 표시합니다.

connPoolStats.pools.global

DBClient 기반 풀 통계를 표시합니다.

connPoolStats.pools.[pool].poolWasNeverUsed

이 연결 풀에서 사용된 적이 없고 닫힌 연결의 수를 표시합니다.

connPoolStats.pools.[pool].acquisitionWaitTimes

버전 6.3에 추가.

요청이 mongos 에서 mongod 로 연결을 획득하기 위한 대기 시간을 보고합니다. 자세한 내용은 connPoolStats.acquisitionWaitTimes 를 참조하세요.

connPoolStats.hosts

호스트별로 그룹화된 연결 통계(사용/사용 가능/생성됨/새로 고침)를 보고합니다.

현재 mongod / mongos 인스턴스와 cluster 또는 복제본 세트의 각 멤버 간의 연결 보고서를 나타내는 문서 가 포함됩니다.

connPoolStats.hosts.[host].available

[host] 에 연결하는 데 사용할 수 있는 총 연결 수를 보고합니다.

connPoolStats.hosts.[host].leased

풀에서 빌린 호스트와 반환될 것으로 예상되는 호스트의 총 연결 수를 보고합니다. 이러한 연결은 임대 기간 동안 활성 상태로 유지되지 않을 수 있으며 관련 지표에서 제외됩니다. 이러한 연결은 임대 기간 동안에는 사용할 수 없습니다.

connPoolStats.hosts.[host].created

생성된 [host] 에 대한 연결 수를 보고합니다.

connPoolStats.hosts.[host].inUse

현재 사용 중인 [host] 에 대한 연결 수를 보고합니다.

connPoolStats.hosts.[host].wasNeverUsed

host 에서 사용된 적이 없는 sharded cluster 또는 복제본 세트 의 다른 멤버로 나가는 발신 연결의 총 건수를 보고합니다.

connPoolStats.hosts.[host].acquisitionWaitTimes

버전 6.3에 추가.

요청이 mongos 에서 mongod 로 연결을 획득하기 위한 대기 시간을 보고합니다. 자세한 내용은 connPoolStats.acquisitionWaitTimes 를 참조하세요.

connPoolStats.replicaSets

현재 / 에 연결된 각 mongod 복제본 세트와 관련된 정보 보고서를 나타내는 문서 를 mongos 포함합니다.

connPoolStats.replicaSets.replicaSet

현재 mongod / 에 연결된 각 복제본 세트 에 mongos 대해 보고합니다.

connPoolStats.replicaSets.[replicaSets].hosts

복제본 세트 의 각 멤버에 대해 보고하는 문서배열을 보유합니다.

이러한 값은 복제본 세트 상태 값에서 파생됩니다.

connPoolStats.replicaSets.[replicaSet].hosts[n].addr

복제본 세트 에 있는 멤버의 주소를 [hostname]:[port] 형식으로 보고합니다.

connPoolStats.replicaSets.[replicaSet].hosts[n].ok

다음과 같은 경우 false 을(를) 보고합니다.

  • 현재 mongos 또는 mongod 는 인스턴스에 연결할 수 없습니다.

  • 현재 mongos 또는 mongod 에 연결 예외 또는 오류가 발생했습니다.

이 필드는 내부용입니다.

connPoolStats.replicaSets.[replicaSet].hosts[n].ismaster

true 이 host 가 복제본 세트 의 프라이머리 멤버인 경우 를 보고합니다.

connPoolStats.replicaSets.[replicaSet].hosts[n].hidden

true 이 host 가 복제본 세트 의 숨겨진 멤버 인 경우 를 보고합니다.

connPoolStats.replicaSets.[replicaSet].hosts[n].secondary

true 이 host 가 복제본 세트의 세컨더리 멤버인 경우 를 보고합니다.

connPoolStats.replicaSets.[replicaSet].hosts[n].pingTimeMillis

mongos 또는 mongod 에서 이 host 로의 핑 시간을 밀리초 단위로 보고합니다.

connPoolStats.replicaSets.[replicaSet].hosts[n].tags

세트의 이 멤버에 태그가 구성된 경우 members[n].tags 을 보고합니다.

ok 상태 필드, operationTime 필드 및 $clusterTime 필드에 대한 자세한 내용은 응답을 참조하세요.

host

← collStats
연결 상태 →

이 페이지의 내용