connPoolStats (comando de base de datos)

Definición

connPoolStats

El comando connPoolStats devuelve información sobre las conexiones salientes abiertas desde la instancia de base de datos actual a otros miembros de la clúster fragmentado o conjunto de réplicas.

Para ejecutar connPoolStats, utiliza el método db.runCommand( { <command> } ).

Nota

connPoolStats solo devuelve resultados significativos para instancias mongos y para mongod instancias en clústeres fragmentados.

Compatibilidad

Este comando está disponible en implementaciones alojadas en los siguientes entornos:

• MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

• MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB

• MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

Sintaxis

El comando tiene la siguiente sintaxis:

db.runCommand(
   {
     connPoolStats: 1
   }
)

El valor del argumento (es decir, 1 ) no afecta la salida del comando.

Comportamiento

connPoolStats incluye estadísticas agregadas en su salida:

• El campo muestra la información agregada por hosts host.

• El campo muestra la información agregada por pools grupo.

Ejemplo

La siguiente operación utiliza el métododb.runCommand()para ejecutar el comandoconnPoolStatsen unmongosde un clúster fragmentado. El clúster fragmentado tiene 2 fragmentos, cada uno con un conjunto de réplicas de un solo miembro y un conjunto de réplicas del servidor de configuración. Elmongosse ejecuta en una máquina de 4núcleos.

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

El comando devuelve la salida del siguiente formato:

{
   "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>
}

Salida

connPoolStats.totalAvailable

Informa la cantidad total de conexiones salientes disponibles desde la instancia actual mongod / a otros mongos miembros del clúster fragmentado o del conjunto de réplicas.

connPoolStats.totalLeased

Informa el número total de conexiones prestadas de un grupo y que se espera que regresen. Estas conexiones podrían no permanecer activas durante la duración de un arrendamiento y se excluyen de las métricas relacionadas. Estas conexiones no están disponibles durante la duración del arrendamiento.

connPoolStats.totalCreated

Informa la cantidad total de conexiones salientes creadas por la instancia mongod / actual a mongos otros miembros del clúster fragmentado o del conjunto de réplicas.

connPoolStats.totalInUse

Informa la cantidad total de conexiones salientes desde la instancia actual mongod / a otros mongos miembros del clúster fragmentado o del conjunto de réplicas que están actualmente en uso.

connPoolStats.totalRefreshing

Informa la cantidad total de conexiones salientes desde la instancia actual mongod / a otros mongos miembros del clúster fragmentado o del conjunto de réplicas que se están actualizando actualmente.

connPoolStats.totalWasNeverUsed

Informa la cantidad total de conexiones salientes desde la instancia actual mongod / a otros mongos miembros del clúster fragmentado o del conjunto de réplicas que se cerraron sin haber sido utilizados.

connPoolStats.replicaSetMatchingStrategy

Nuevo en la versión 5.0.

En una instancia, este valor informa la política utilizada por la instancia para determinar el límite de tamaño mínimo de sus grupos de conexiones a los nodos dentro de los conjuntos de mongos réplicas.

En una instancia, este valor informa la política utilizada por la instancia para determinar mongod el límite de tamaño mínimo de sus grupos de conexiones a nodos dentro de otros conjuntos de réplicas.

La política para mongos y se puede mongod ShardingTaskExecutorPoolReplicaSetMatching configurar con el parámetro.

Nota

Si se establece ShardingTaskExecutorPoolReplicaSetMatching "automatic"en, sigue describiendo la política replicaSetMatchingStrategy utilizada,"automatic" no. Para encontrar el valor ShardingTaskExecutorPoolReplicaSetMatching de, utilice, que devuelve el valor del parámetro del getParameter servidor:

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

connPoolStats.acquisitionWaitTimes

Nuevo en la versión 6.3.

El documento informa un histograma con los tiempos de espera de las solicitudes para adquirir una conexión desde mongos mongodhasta:

• El documento contiene rangos de tiempo en milisegundos y la cantidad de solicitudes de conexión en cada rango.

• -inf es infinito negativo y las solicitudes de conexión en el rango (-inf, 0ms) no esperaron.

• inf es infinito positivo y las solicitudes de conexión en el rango [1000ms, inf) esperaron un tiempo mayor o igual a 1,000 milisegundos.

• totalCount es el número total de solicitudes de conexión para todos los rangos de tiempo.

"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

Informa la cantidad de conexiones sincrónicas salientes activas y almacenadas desde la instancia actual mongod / a otros mongos miembros del clúster fragmentado o del conjunto de réplicas.

Estas conexiones forman parte de un conjunto que es un subconjunto de los datos informados por totalAvailable, totalCreated y totalInUse.

connPoolStats.numAScopedConnection

Informa la cantidad de conexiones sincrónicas salientes activas y almacenadas desde la instancia actual mongod / a otros mongos miembros del clúster fragmentado o del conjunto de réplicas.

Estas conexiones forman parte de un conjunto que es un subconjunto de los datos informados por totalAvailable, totalCreated y totalInUse.

connPoolStats.pools

Informes sobre las estadísticas de conexión (en uso/disponibles/creadas/actualizándose) agrupadas por grupos de conexiones. Un mongod o un mongos tienen dos familias distintas de grupos de conexiones salientes:

• Grupos basados ​​en DBClient (la "ruta de escritura") y

• Grupos basados ​​en NetworkInterfaceTL (la "ruta de lectura").

Para cada grupo, el comando devuelve un documento similar al siguiente:

{
  "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
  },
  ...
}

Nota

Si no hay conexiones (en uso/disponibles/creadas/actualizándose) para un grupo en particular,connPoolStats no devuelve estadísticas para ese grupo.

connPoolStats.pools.NetworkInterfaceTL-TaskExecutorPool-[n]

Muestra las estadísticas de conexión relacionadas con los grupos de TaskExecutor. Normalmente, habrá un grupo de TaskExecutor por núcleo, por ejemplo, pools.NetworkInterfaceTL-TaskExecutorPool-0 ... pools.NetworkInterfaceTL-TaskExecutorPool-7 para un procesador de 8núcleos.

Tip

taskExecutorPoolSize

connPoolStats.pools.NetworkInterfaceTL-ShardRegistry

Disponible si el comando se ejecuta en un miembro de un clúster fragmentado.

Muestra las estadísticas del grupo para las conexiones entre la instancia actual mongod / mongos y otros miembros del clúster fragmentado.

connPoolStats.pools.NetworkInterfaceTL-Replication

Disponible si el comando se ejecuta en un miembro de un conjunto de réplicas.

Muestra las estadísticas del grupo para las conexiones entre la mongod instancia actual y los demás miembros del conjunto de réplicas.

connPoolStats.pools.global

Muestra las estadísticas del grupo basadas en DBClient.

connPoolStats.pools.[pool].poolWasNeverUsed

Muestra la cantidad de conexiones en este grupo de conexiones que se cerraron sin haber sido utilizadas.

connPoolStats.pools.[pool].acquisitionWaitTimes

Nuevo en la versión 6.3.

Informa los tiempos de espera de las solicitudes para obtener una conexión de a. Para más mongos mongoddetalles,connPoolStats.acquisitionWaitTimes consulte.

connPoolStats.hosts

Informes sobre estadísticas de conexión (en uso/disponibles/creadas/actualizándose) agrupadas por hosts.

Contiene documentos que representan un informe de conexiones entre la instancia mongod / mongos actual y cada miembro del clúster fragmentado o conjunto de réplicas.

connPoolStats.hosts.[host].available

Informa el número total de conexiones disponibles para conectarse a [host].

connPoolStats.hosts.[host].leased

Informa el número total de conexiones al host tomadas de un grupo y que se espera que sean devueltas. Es posible que estas conexiones no permanezcan activas durante todo el tiempo de la reserva y se excluyan de las métricas relacionadas. Estas conexiones no están disponibles durante la vigencia de la reserva.

connPoolStats.hosts.[host].created

Informa el número de conexiones al [host] jamás creadas.

connPoolStats.hosts.[host].inUse

Informa el número de conexiones al [host] que están actualmente en uso.

connPoolStats.hosts.[host].wasNeverUsed

Informa la cantidad total de conexiones salientes desde host a otros miembros del clúster fragmentado o del conjunto de réplicas que se cerraron sin haber sido utilizadas.

connPoolStats.hosts.[host].acquisitionWaitTimes

Nuevo en la versión 6.3.

Informa los tiempos de espera de las solicitudes para obtener una conexión de a. Para más mongos mongoddetalles,connPoolStats.acquisitionWaitTimes consulte.

connPoolStats.replicaSets

Contiene documentos que representan un informe de información relacionada con cada conjunto de réplicas conectado al mongod / mongos actual.

connPoolStats.replicaSets.replicaSet

Informes sobre cada conjunto de réplicas conectado al mongod / mongos actual.

connPoolStats.replicaSets.[replicaSets].hosts

Contiene una serie de documentos que informan sobre cada miembro del conjunto de réplicas.

Estos valores derivan de los valores de estado del conjunto de réplicas.

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

Informa la dirección del nodo en el set de réplicas en formato [hostname]:[port].

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

Informa false cuando:

• El mongos o mongod actual no puede conectarse a la instancia.

• El mongos o mongod actual recibió una excepción o error de conexión.

Este campo es para uso interno.

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

Informa true si este host es el miembro principal del conjunto de réplicas.

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

Informa true si este host es un miembro oculto del conjunto de réplicas.

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

Informa true si este host es un miembro secundario del conjunto de réplicas.

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

Informa el tiempo de ping en milisegundos desde el mongos o mongod a este host.

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

Informa el, si este miembro del conjunto tiene etiquetas members[n].tags configuradas.

Consulte también Respuesta para obtener detalles sobre el ok campo de estado, el operationTime campo y el campo.$clusterTime

host