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 muestra la información agregada por pools grupo.

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 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 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, 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 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 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:

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

• Grupos 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 miembro de un conjunto 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 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 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 fragmentado o conjunto 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 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 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 conjunto de réplicas conectado al mongod / mongos actual.

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 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 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

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 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