Docs Menu
Docs Home
/
MongoDB 매뉴얼
/ / /

connPoolStats

이 페이지의 내용

  • 정의
  • 호환성
  • 구문
  • 행동
  • 예시
  • 출력
connPoolStats

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

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

참고

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

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

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

참고

이 명령은 모든 MongoDB Atlas 클러스터에서 지원됩니다. 모든 명령에 대한 자세한 내용은 지원되지 않는 명령을 참조하세요.

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

db.runCommand(
{
connPoolStats: 1
}
)

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

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

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

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

참고

실행 중인 작업에 대한 간섭을 피하기 위해 connPoolStats 잠금을 사용하지 않습니다. 따라서 connPoolStats가 정보를 수집함에 따라 개수가 약간 변경될 수 있으며 그 결과 hostspools 연결 수 간에 약간의 차이가 발생할 수 있습니다.

다음 작업은 메서드를 사용하여 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 인스턴스에서 이 값은 다른 복제본 세트 내의 노드에 대한 연결 풀의 최소 크기 제한을 결정하기 위해 인스턴스가 사용하는 정책을 보고합니다.

mongosmongod 에 대한 정책은 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, totalCreatedtotalInUse에서 보고한 데이터의 하위 집합인 풀의 일부입니다.

connPoolStats.numAScopedConnection

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

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

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 입니다.

다음도 참조하세요.

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

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

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

해당 host 복제 세트숨겨진 멤버인 경우 true를 보고합니다.

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

해당 host복제 세트세컨더리 멤버인 경우 true를 보고합니다.

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

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

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

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

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

host

돌아가기

collStats