connPoolStats_MonogDB 中文网

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群集的a 上运行命令。分片群集具有2个分片，每个分片都是一个单成员副本集和一个配置服务器副本集。在mongos 一个4核的机器上运行。

复制

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

该命令返回以下形式的输出：

注意

该connPoolStats输出取决于部署和针对其运行成员 connPoolStats其他因素。

复制

{
   "numClientConnections" : <num>,
   "numAScopedConnections" : <num>,
   "totalInUse" : <num>,
   "totalAvailable" : <num>,
   "totalCreated" : <num>,
   "totalRefreshing" : <num>,
   "pools" : {
      "NetworkInterfaceTL-TaskExecutorPool-0" : {
         "poolInUse" : <num>,
         "poolAvailable" : <num>,
         "poolCreated" : <num>,
         "poolRefreshing" : <num>,
         "cfg1.example.net:27019" : {
            "inUse" : <num>,
            "available" : <num>,
            "created" : <num>,
            "refreshing" :<num>
         }
      },
      "NetworkInterfaceTL-TaskExecutorPool-1" : {
         "poolInUse" : <num>,
         "poolAvailable" : <num>,
         "poolCreated" : <num>,
         "poolRefreshing" : <num>,
         "cfg1.example.net:27019" : {
            "inUse" : <num>,
            "available" : <num>,
            "created" : <num>,
            "refreshing" :<num>
         }
      },
      "NetworkInterfaceTL-TaskExecutorPool-2" : {
         "poolInUse" : <num>,
         "poolAvailable" : <num>,
         "poolCreated" : <num>,
         "poolRefreshing" : <num>,
         "cfg1.example.net:27019" : {
            "inUse" : <num>,
            "available" : <num>,
            "created" : <num>,
            "refreshing" :<num>
         }
      },
      "NetworkInterfaceTL-TaskExecutorPool-3" : {
         "poolInUse" : <num>,
         "poolAvailable" : <num>,
         "poolCreated" : <num>,
         "poolRefreshing" : <num>,
         "cfg1.example.net:27019" : {
            "inUse" : <num>,
            "available" : <num>,
            "created" : <num>,
            "refreshing" :<num>
         }
      },
      "NetworkInterfaceTL-ShardRegistry" : {
         "poolInUse" : <num>,
         "poolAvailable" : <num>,
         "poolCreated" : <num>,
         "poolRefreshing" : <num>,
         "cfg1.example.net:27019" : {
            "inUse" : <num>,
            "available" : <num>,
            "created" : <num>,
            "refreshing" :<num>
         },
         "cfg2.example.net:27019" : {
            "inUse" : <num>,
            "available" : <num>,
            "created" : <num>,
            "refreshing" :<num>
         },
         "cfg3.example.net:27019" : {
            "inUse" : <num>,
            "available" : <num>,
            "created" : <num>,
            "refreshing" :<num>
         },
         "shard1.example.net:27018" : {
            "inUse" : <num>,
            "available" : <num>,
            "created" : <num>,
            "refreshing" :<num>
         },
         "shard2.example.net:27018" : {
            "inUse" : <num>,
            "available" : <num>,
            "created" : <num>,
            "refreshing" :<num>
         }
      },
      "global" : {
         "poolInUse" : <num>,
         "poolAvailable" : <num>,
         "poolCreated" : <num>,
         "poolRefreshing" : <num>,
         "cfg3.example.net:27019" : {
            "inUse" : <num>,
            "available" : <num>,
            "created" : <num>,
            "refreshing" :<num>
         },
         "cfg1.example.net:27019" : {
            "inUse" : <num>,
            "available" : <num>,
            "created" : <num>,
            "refreshing" :<num>
         },
         "cfg2.example.net:27019" : {
            "inUse" : <num>,
            "available" : <num>,
            "created" : <num>,
            "refreshing" :<num>
         },
         "shard2.example.net:27018" : {
            "inUse" : <num>,
            "available" : <num>,
            "created" : <num>,
            "refreshing" :<num>
         },
         "shard1.example.net:27018" : {
            "inUse" : <num>,
            "available" : <num>,
            "created" : <num>,
            "refreshing" :<num>
         }
      }
   },
   "hosts" : {
      "cfg3.example.net:27019" : {
         "inUse" : <num>,
         "available" : <num>,
         "created" : <num>,
         "refreshing" :<num>
      },
      "cfg1.example.net:27019" : {
         "inUse" : <num>,
         "available" : <num>,
         "created" : <num>,
         "refreshing" :<num>
      },
      "cfg2.example.net:27019" : {
         "inUse" : <num>,
         "available" : <num>,
         "created" : <num>,
         "refreshing" :<num>
      },
      "shard2.example.net:27018" : {
         "inUse" : <num>,
         "available" : <num>,
         "created" : <num>,
         "refreshing" :<num>
      },
      "shard1.example.net:27018" : {
         "inUse" : <num>,
         "available" : <num>,
         "created" : <num>,
         "refreshing" :<num>
      }
   },
   "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实例到分片群集或副本集其他成员的可用传出连接总数。

connPoolStats.totalCreated¶: 报告由当前mongod/ mongos实例向分片群集或副本集的其他成员创建的传出连接总数。

connPoolStats.totalInUse¶: 报告从当前mongod/ mongos实例到当前正在使用的分片群集或副本集其他成员的传出连接总数。

connPoolStats.totalRefreshing¶: 报告从当前mongod/ mongos实例到当前正在刷新的分片群集或副本集其他成员的传出连接总数。

connPoolStats.numClientConnection¶

报告从当前/ 实例到分片群集或副本集其他成员的活动和存储的传出同步连接数。mongodmongos

这些连接池是通过报告的数据子集的一部分totalAvailable， totalCreated和totalInUse。

connPoolStats.numAScopedConnection¶

报告从当前/ 实例到分片群集或副本集的其他成员的活动和存储的传出作用域范围的同步连接数。mongodmongos

这些连接池是通过报告的数据子集的一部分totalAvailable， totalCreated和totalInUse。

connPoolStats.pools¶

按连接池分组的连接统计信息（正在使用/可用/已创建/刷新）报告。一个 mongod或mongos有传出连接池的两个不同的家族：

基于DBClient的池（“写入路径”）和
基于NetworkInterfaceTL的池（“读取路径”）。

对于每个池，该命令将返回类似于以下内容的文档：

复制

{
  "poolInUse" : <num>,
  "poolAvailable" : <num>,
  "poolCreated" : <num>,
  "poolRefreshing" : <num>,
  "[host1]" : { "inUse" : <num>, "available" : <num>, "created" : <num>, "refreshing" : <num> },
  "[host2]" : { "inUse" : <num>, "available" : <num>, "created" : <num>, "refreshing" : <num> },
  ...
}

注意

如果特定池没有连接（正在使用/可用/已创建/刷新），connPoolStats则不会返回该池的统计信息。

connPoolStats.pools.NetworkInterfaceTL-TaskExecutorPool-[n]¶: 显示与TaskExecutor池相关的连接静态信息。通常，每个内核有一个TaskExecutorPool，例如 NetworkInterfaceTL-TaskExecutorPool-0… NetworkInterfaceTL-TaskExecutorPool-7 对于一个8内核处理器。

也可以看看

taskExecutorPoolSize

connPoolStats.pools.NetworkInterfaceTL-ShardRegistry¶

如果命令在分片群集的成员上运行，则可用。

显示当前mongod/ mongos实例与分片群集的其他成员之间的连接的池统计信息。

connPoolStats.pools.NetworkInterfaceTL-Replication¶

如果命令在副本集的成员上运行，则可用。

显示当前mongod实例与副本集的其他成员之间的连接的池统计信息。

connPoolStats.pools.global¶: 显示基于DBClient的池统计信息。

connPoolStats.hosts¶

报告按主机分组的连接统计信息（正在使用/可用/已创建/刷新）。

包含代表当前/ 实例与分片群集或副本集的每个成员之间的连接的报告的文档。mongodmongos

connPoolStats.hosts.[host].available¶: 报告可用于连接到的连接总数[host]。

connPoolStats.hosts.[host].created¶: 报告与已[host] 创建的连接数。

connPoolStats.hosts.[host].inUse¶: 报告[host] 当前正在使用的连接数。

connPoolStats.replicaSets¶

包含代表与当前/ 连接的每个副本集有关的信息报告的文档。mongodmongos

connPoolStats.replicaSets.replicaSet¶: 有关连接到当前/的每个副本集的报告。mongodmongos

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到此的ping时间（以毫秒为单位）host。

connPoolStats.replicaSets.[replicaSet].hosts[n].tags¶: 报告members[n].tags，如果集合的此成员已配置标签。

另请参阅响应，以获取有关ok状态字段，operationTime字段和$clusterTime字段的详细信息。