connPoolStats (comando de base de datos)

Definición

connPoolStats

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

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

Nota

connPoolStats solo devuelve resultados significativos para las instancias de mongos y para las instancias de mongod 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 el resultado del comando.

Comportamiento

connPoolStats incluye estadísticas agregadas en su salida:

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

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

Ejemplo

La siguiente operación utiliza el método db.runCommand() para ejecutar el comando connPoolStats en un mongos de un clúster particionado. El clúster tiene 2 particiones, cada uno un set de réplicas de un solo nodo, y un set de réplicas de servidor de configuración. El mongos se ejecuta en una máquina de 4núcleos.

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

El comando retorna la salida del siguiente formulario:

{
   "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 el número total de conexiones salientes disponibles desde la instancia actual de mongod / mongos a otros nodos del clúster o del set de réplicas.

connPoolStats.totalLeased

Informa sobre el número total de conexiones tomadas de un pool y que se espera que regresen. Es posible que estas conexiones no permanezcan activas durante la totalidad de un alquiler y se excluyan de las métricas relacionadas. Estas conexiones no están disponibles durante la duración del contrato de arrendamiento .

connPoolStats.totalCreated

Informa el número total de conexiones salientes que ha creado la instancia actual mongod / con mongos otros nodos del clúster o set de réplicas.

connPoolStats.totalInUse

Informa el número total de conexiones salientes desde la instancia actual mongod / mongos a otros nodos del cluster particionado o set de réplicas que se encuentran actualmente en uso.

connPoolStats.totalRefreshing

Reporta el número total de conexiones salientes desde la instancia actual de mongod / mongos a otros nodos del clúster o al set de réplicas que actualmente están siendo actualizados.

connPoolStats.totalWasNeverUsed

Informa el número total de conexiones salientes de la instancia actual mongod / mongos a otros nodos del clúster o set de réplicas que se cerraron sin haber sido nunca utilizadas.

connPoolStats.replicaSetMatchingStrategy

Nuevo en la versión 5.0.

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

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

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

Nota

Si el ShardingTaskExecutorPoolReplicaSetMatching está configurado en "automatic", el replicaSetMatchingStrategy aún describe la política real que se está utilizando, no "automatic". Para encontrar el valor del ShardingTaskExecutorPoolReplicaSetMatching, utiliza getParameter que devuelve el valor del parámetro del servidor:

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

connPoolStats.acquisitionWaitTimes

Nuevo en la versión 6.3.

El informe del documento muestra un histograma con los tiempos de espera para las solicitudes de adquisición de una conexión desde mongos hasta mongod:

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

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

• inf es positivo infinito, 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 intervalos 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 el número de conexiones síncronas activas y almacenadas salientes de la instancia actual de mongod / mongos a otros miembros del clúster o set 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 el número de conexiones sincrónicas segmentadas activas y almacenadas salientes desde la instancia actual mongod / mongos a otros nodos 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 estadísticas de conexiones (en uso/disponibles/creadas/actualizándose) agrupadas por los grupos de conexiones. Un mongod o mongos tiene dos familias distintas de grupos de conexiones salientes:

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

• Pools basados en NetworkInterfaceTL (la «ruta de lectura»).

Para cada pool, el comando devuelve un documento que se asemeja 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, el connPoolStats no devuelve estadísticas para ese grupo.

connPoolStats.pools.NetworkInterfaceTL-TaskExecutorPool-[n]

Muestra estadísticas de conexión relacionadas con los pools de TaskExecutor. Típicamente, habrá un TaskExecutorPool por core, p. ej. pools.NetworkInterfaceTL-TaskExecutorPool-0 ... pools.NetworkInterfaceTL-TaskExecutorPool-7 para un procesador de 8 núcleos.

Tip

taskExecutorPoolSize

connPoolStats.pools.NetworkInterfaceTL-ShardRegistry

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

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

connPoolStats.pools.NetworkInterfaceTL-Replication

Disponible si el comando se ejecuta en un nodo de un set de réplicas.

Muestra las estadísticas del pool para las conexiones entre la instancia actual de mongod y los demás nodos del set de réplicas.

connPoolStats.pools.global

Muestra las estadísticas del pool basadas en DBClient.

connPoolStats.pools.[pool].poolWasNeverUsed

Muestra el número de conexiones en este pool de conexiones que se cerraron sin haber sido utilizadas nunca.

connPoolStats.pools.[pool].acquisitionWaitTimes

Nuevo en la versión 6.3.

Informa el tiempo de espera de las solicitudes para adquirir una conexión desde mongos a mongod. Para más detalles, consulte connPoolStats.acquisitionWaitTimes.

connPoolStats.hosts

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

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

connPoolStats.hosts.[host].available

Informa del número total de conexiones disponibles para conectarse al [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] que se hayan creado.

connPoolStats.hosts.[host].inUse

Informa la cantidad de conexiones al [host] que están actualmente en uso.

connPoolStats.hosts.[host].wasNeverUsed

Informa el número total de conexiones salientes desde host a otros miembros del clúster o del set de réplicas que se cerraron sin haber sido nunca utilizadas.

connPoolStats.hosts.[host].acquisitionWaitTimes

Nuevo en la versión 6.3.

Informa el tiempo de espera de las solicitudes para adquirir una conexión desde mongos a mongod. Para más detalles, consulte connPoolStats.acquisitionWaitTimes.

connPoolStats.replicaSets

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

connPoolStats.replicaSets.replicaSet

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

connPoolStats.replicaSets.[replicaSets].hosts

Contiene un arreglo de documentos que reporta sobre cada nodo del set de réplicas..

Estos valores se derivan de los valores de estado del set 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 pueden conectarse a la instancia.

• el mongos actual o mongod recibieron 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 primario miembro del set de réplicas.

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

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

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

Reporta true si este host es un secundario miembro del set 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 members[n].tags, si este nodo del conjunto tiene etiquetas configuradas.

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

host