operação atual

Nesta página

Definição

Sintaxe
Comportamento
Controle de acesso
Exemplos
Exemplo de saída
Campos de Saída

Definição

currentOp: Retorna umdocumento que contém informações sobre operações em andamento para a instância do mongod .

Sintaxe

O comando tem a seguinte sintaxe:

db.adminCommand(
   {
     currentOp: 1
   }
)

Observação

A partir do MongoDB 5.0, o estágio de aggregation $currentOp é usado ao executar o método auxiliar db.currentOp() com mongosh.

Diante disso, na versão 5.0 do shell e com mongosh, os conjuntos de resultados de db.currentOp() não estão sujeitos ao limite do tamanho de retorno de documento BSON de 16 MB para documentos das versões anteriores do mongo herdado.

Comportamento

currentOp deve ser executado no banco de dados admin e pode aceitar vários campos opcionais.

Campo	Descrição
`"$ownOps"`	Booleano. Se definido para `true`, retorna informações somente sobre as operações do usuário atual. Em instâncias do `mongod` , os usuários estão sempre autorizados a executar `currentOp` com `"$ownOps": true` para visualizar suas próprias operações. Consulte controle de acesso.
`"$all"`	Booleano. Se definido para `true`, retorna informações sobre todas as operações, incluindo operações em conexões ociosas e operações do sistema. `"$all": true` substitui quaisquer filtros de campo de saída.
<filter>	Especifique as condições de filtro nos Campos de Saída. Veja exemplos.
`comment`	Opcional. Um comentário fornecido pelo usuário para anexar a este comando. Depois de definido, esse comentário aparece junto com os registros desse comando nos seguintes locais: mensagens de log do mongod, no campo `attr.command.cursor.comment`. Saída do perfil do banco de dados, no campo `command.comment`. Saída `currentOp`, no campo `command.comment`. Um comentário pode ser qualquer tipo BSON válido (string, inteiro, objeto, array etc).

currentOp e o analisador de banco de dados relatam as mesmas informações de diagnóstico básicas para operações CRUD, incluindo o seguinte:

Essas operações também são incluídas no logging de slow querys (consulte slowOpThresholdMs para obter mais informações sobre o logging de slow querys).

Controle de acesso

Em sistemas executados com authorization, o usuário deve ter acesso que inclua a ação de privilégio inprog.

Os usuários podem utilizar o $ownOps em instâncias do mongod para visualizar suas próprias operações sem a ação de privilégio do inprog.

db.adminCommand( { currentOp: 1, "$ownOps": 1 } )

Dica

Veja também:

Crie uma função para gerenciar as operações atuais

Exemplos

Os exemplos seguintes utilizam o comando currentOp com vários documentos de query para filtrar a saída.

Exibir todas as operações atuais

db.adminCommand(
   {
     currentOp: true,
     "$all": true
   }
)

Operações de gravação aguardando um bloqueio

O exemplo a seguir retorna informações sobre todas as operações de gravação que estão aguardando um bloqueio:

db.adminCommand(
   {
     currentOp: true,
     "waitingForLock" : true,
     $or: [
        { "op" : { "$in" : [ "insert", "update", "remove" ] } },
        { "command.findandmodify": { $exists: true } }
    ]
   }
)

Operações ativas sem rendimento

O exemplo a seguir retorna informações sobre todas as operações em execução ativas que nunca produziram:

db.adminCommand(
   {
     currentOp: true,
     "active" : true,
     "numYields" : 0,
     "waitingForLock" : false
   }
)

Operações ativas em um banco de dados específico

O exemplo a seguir retorna informações sobre todas as operações ativas do banco de dados db1 que estão em execução há mais de 3 segundos:

db.adminCommand(
   {
     currentOp: true,
     "active" : true,
     "secs_running" : { "$gt" : 3 },
     "ns" : /^db1\./
   }
)

Operações de indexação ativas

O exemplo a seguir retorna informações sobre operações de criação de índice:

db.adminCommand(
    {
      currentOp: true,
      $or: [
        { op: "command", "command.createIndexes": { $exists: true }  },
        { op: "none", "msg" : /^Index Build/ }
      ]
    }
)

Exemplo de saída

Campos de Saída

currentOp.type

Novidades na versão 4.2.

O tipo de operação. Os valores são:

op
idleSession
idleCursor

Se o currentOp.type for op, o currentOp.op fornecerá detalhes sobre a operação específica.

currentOp.host: O nome do host em que a operação é executada.

currentOp.desc: Uma descrição do cliente. Esta string inclui o connectionId.

currentOp.connectionId: Um identificador da conexão em que a operação se originou.

currentOp.client

Uma string com informações sobre a origem da operação.

Para transações com vários documentos, client armazena informações sobre o cliente mais recente para executar uma operação dentro da transação.

currentOp.appName: O identificador do aplicativo cliente que executou a operação. Use uma opção appName de connection string para definir um valor personalizado para o campo appName.

currentOp.clientMetadata

Informações adicionais sobre o cliente.

Para transações com vários documentos, client armazena informações sobre o cliente mais recente para executar uma operação dentro da transação.

currentOp.currentOpTime: A hora de início da operação.

currentOp.effectiveUsers: Uma array que contém um documento para cada usuário associado à operação. Cada documento de usuário contém o nome user e a autenticação db.
Dica
Veja também:
currentOp.runBy
Novidades na versão 4.2.

currentOp.runBy

Uma array que contém um documento para cada usuário que está personificando effectiveUser(s) para a operação. O documento runBy contém o nome user e a autenticação db. Em geral, o usuário do runBy é o usuário __system; por exemplo,

"runBy" : [
   {
      "user" : "__system",
      "db" : "local"
   }
]

Disponível apenas em clusters fragmentados

Novidades na versão 4.2.

currentOp.lsid

O identificador da sessão.

Somente presente se a operação estiver associada a uma sessão.

currentOp.transaction

Um documento que contém informações de transação multidocumento.