connPoolStats (comando de banco de dados)

Definição

connPoolStats

O comando retorna informações sobre as conexões connPoolStats de saída abertas da instância do banco de dados atual para outros membros do cluster fragmentado ou conjunto de réplicas.

Para executar connPoolStats, use o método db.runCommand( { <command> } ).

Observação

connPoolStats só retorna resultados significativos para instâncias mongos mongod e para instâncias em clusters fragmentados.

Compatibilidade

Esse comando está disponível em implantações hospedadas nos seguintes ambientes:

MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem

Observação

Este comando é aceito em todos os clusters do MongoDB Atlas. Para obter informações sobre o suporte do Atlas a todos os comandos, consulte Comandos não suportados.

MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB
MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

Sintaxe

O comando tem a seguinte sintaxe:

db.runCommand(
   {
     connPoolStats: 1
   }
)

O valor do argumento (ou seja, 1 ) não afeta a saída do comando.

Comportamento

connPoolStats inclui estatísticas agregadas em sua saída:

O campo exibe as informações agregadas por hosts host.
O campo exibe as informações agregadas por pools grupo.

Observação

Para evitar interrupção em quaisquer operações em execução, não aceita nenhuma trava. Dessa forma, connPoolStats as contagens podem mudar ligeiramente à medida que coleta informações, resultando em connPoolStats hosts pools pequenas diferenças entre as contagens de conexão e.

Exemplo

A seguinte operação utiliza o métododb.runCommand()para executar o comandoconnPoolStatsem ummongosde um cluster fragmentado. O cluster fragmentado tem 2 shards, cada um um conjunto de réplicas de um único membro, e um conjunto de réplicas de servidor de configuração . Omongosé executado em uma máquina 4-core.

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

O comando retorna a saída do seguinte formulário:

Observação

A saída varia dependendo do sistema e connPoolStats connPoolStats do membro em relação ao qual você executa, entre outros fatores.

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

Saída

connPoolStats.totalAvailable: Informa o número total de conexões de saída disponíveis da instância mongod / mongos atual para outros membros do cluster fragmentado ou conjunto de réplicas.

connPoolStats.totalLeased: Relata o número total de conexões emprestadas de um pool e esperadas para retornar. Essas conexões podem não permanecer ativas durante a duração de uma concessão e são excluídas das métricas relacionadas. Essas conexões estão indisponíveis durante a duração do aluguel.

connPoolStats.totalCreated: Relata o número total de conexões de saída já criadas pela instância mongod / mongos atual para outros membros do cluster fragmentado ou conjunto de réplicas.

connPoolStats.totalInUse: Relata o número total de conexões de saída da instância atual do mongod / mongos para outros membros do cluster fragmentado ou conjunto de réplicas que estão atualmente em uso.

connPoolStats.totalRefreshing: Relata o número total de conexões de saída da instância mongod / mongos atual para outros membros do cluster fragmentado ou conjunto de réplicas que estão sendo atualizados no momento.

connPoolStats.totalWasNeverUsed: Relata o número total de conexões de saída da instância atual do mongod / mongos para outros membros do cluster fragmentado ou conjunto de réplicas que foram fechados sem nunca terem sido usados.

connPoolStats.replicaSetMatchingStrategy

Novidade na versão 5.0.

Em uma instância mongos , esse valor reporta a política usada pela instância para determinar o limite de tamanho mínimo de seu pool de conexões para nós dentro dos conjuntos de réplicas.

Em uma instância mongod , esse valor reporta a política usada pela instância para determinar o limite de tamanho mínimo de seus pool de conexões para nós dentro de outros conjuntos de réplicas.

A política para mongos e mongod pode ser definida com o parâmetro ShardingTaskExecutorPoolReplicaSetMatching .

Observação

Se o estiver ShardingTaskExecutorPoolReplicaSetMatching definido "automatic" como, o ainda descreverá a política real que está sendo replicaSetMatchingStrategy usada,"automatic" não. Para localizar o valor do,ShardingTaskExecutorPoolReplicaSetMatching utilize que retorna o valor do parâmetro do servidor getParameter :

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

connPoolStats.acquisitionWaitTimes

Novidades na versão 6.3.

O documento relata um histograma com os tempos de espera para as solicitações adquirirem uma conexão de mongos a mongod:

O documento contém faixas de tempo em milissegundos e o número de solicitações de conexão em cada faixa.
-inf é infinito negativo e as solicitações de conexão na faixa (-inf, 0ms) não esperaram.
inf é infinito positivo e as solicitações de conexão no intervalo [1000ms, inf) esperaram um tempo maior ou igual a 1.000 milissegundos.
totalCount é o número total de solicitações de conexão para todos os intervalos de tempo.

"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 o número de conexões síncronas de saída ativas e armazenadas da instância mongod / mongos atual para outros membros do cluster fragmentado ou conjunto de réplicas.

Essas conexões fazem parte de um pool que é um subconjunto dos dados relatados totalAvailable por, totalCreated totalInUsee.

connPoolStats.numAScopedConnection

Informa o número de conexões síncronas com escopo de saída ativas e armazenadas da instância mongod / mongos atual para outros membros do cluster fragmentado ou conjunto de réplicas.

Essas conexões fazem parte de um pool que é um subconjunto dos dados relatados totalAvailable por, totalCreated totalInUsee.

connPoolStats.pools

Relatórios sobre estatísticas de conexão (em uso/disponível/criada/atualizada) agrupadas pelo pool de conexões. A mongod or mongos has two distinct families of outgoing connection pools:

Pools baseados em DBClient (o "caminho de gravação") e
Pools baseados em NetworkInterfaceTL (o "caminho de leitura").

Para cada pool, o comando retorna um documento semelhante ao seguinte:

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

Observação

Se não houver conexões (em uso/disponível/criada/refrescando) para um pool específico, o não retornará estatísticas para esse connPoolStats pool.

connPoolStats.pools.NetworkInterfaceTL-TaskExecutorPool-[n]: Exibe estatísticas de conexão relacionadas aos pools do TaskExecutor. Normalmente, haverá um TaskExecutorPool por núcleo, por exemplo pools.NetworkInterfaceTL-TaskExecutorPool-0 ... pools.NetworkInterfaceTL-TaskExecutorPool-7 para um processador de 8 núcleos.
Dica
taskExecutorPoolSize

connPoolStats.pools.NetworkInterfaceTL-ShardRegistry

Disponível se o comando for executado em um nó de um cluster fragmentado.

Exibe as estatísticas do pool para as conexões entre a instância mongod / mongos atual e outros membros do cluster fragmentado.

connPoolStats.pools.NetworkInterfaceTL-Replication

Disponível se o comando for executado em um membro de um conjunto de réplicas.

Exibe as estatísticas do pool para as conexões entre a instância do mongod atual e os outros nós do conjunto de réplicas.

connPoolStats.pools.global: Exibe as estatísticas do pool com base no DBClient.

connPoolStats.pools.[pool].poolWasNeverUsed: Exibe o número de conexões neste pool de conexões que foram fechadas sem nunca terem sido usadas.

connPoolStats.pools.[pool].acquisitionWaitTimes: Novidades na versão 6.3.
Informa o tempo de espera das solicitações para adquirir uma conexão de para. Para mongos mongoddetalhes,connPoolStats.acquisitionWaitTimes consulte.

connPoolStats.hosts

Relatórios sobre estatísticas de conexão (em uso/disponível/criado/atualizando) agrupados pelos hosts.

Contém documentos que representam um relatório de conexões entre a instância mongod / mongos atual e cada membro do cluster fragmentado ou conjunto de réplicas.

connPoolStats.hosts.[host].available: Informa o número total de conexões disponíveis para conexão ao [host].

connPoolStats.hosts.[host].leased: Relata o número total de conexões com o host solicitadas de um pool e esperadas para retornar. Essas conexões podem não permanecer ativas durante a duração de uma concessão e são excluídas das métricas relacionadas. Essas conexões estão indisponíveis durante a duração do aluguel.

connPoolStats.hosts.[host].created: Informa o número de conexões para o [host] já criadas.

connPoolStats.hosts.[host].inUse: Informa o número de conexões com o [host] que estão em uso no momento.

connPoolStats.hosts.[host].wasNeverUsed: Relata o número total de conexões de saída de host para outros membros do cluster fragmentado ou conjunto de réplicas que foram fechadas sem nunca terem sido usadas.

connPoolStats.hosts.[host].acquisitionWaitTimes: Novidades na versão 6.3.
Informa o tempo de espera das solicitações para adquirir uma conexão de para. Para mongos mongoddetalhes,connPoolStats.acquisitionWaitTimes consulte.

connPoolStats.replicaSets

Contém documentos que representam um relatório de informações relacionadas a cada conjunto de réplicas conectado ao mongod / mongos atual.

connPoolStats.replicaSets.replicaSet: Relatórios sobre cada conjunto de réplica conectado ao atual mongod / mongos.

connPoolStats.replicaSets.[replicaSets].hosts

Contém uma array de documentos que reporta cada membro no conjunto de réplicas.

Esses valores derivam dos valores de status do conjunto de réplicas .

connPoolStats.replicaSets.[replicaSet].hosts[n].addr: Informa o endereço do nó no conjunto de réplicas no formato [hostname]:[port] .

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

Informa false quando:

o mongos ou mongod atual não pode se conectar à instância.
o mongos ou mongod atual recebeu uma exceção ou erro de conexão.

Este campo é para uso interno.

connPoolStats.replicaSets.[replicaSet].hosts[n].ismaster: Informa true se este host for o nó primary do conjunto de réplicas.

connPoolStats.replicaSets.[replicaSet].hosts[n].hidden: Informa true se este host for um membro oculto do conjunto de réplicas.

connPoolStats.replicaSets.[replicaSet].hosts[n].secondary: Informa true se este host for um membro secundário do conjuntode réplicas.

connPoolStats.replicaSets.[replicaSet].hosts[n].pingTimeMillis: Relata o tempo de ping em milissegundos do mongos ou mongod até host este.