profile (comando de banco de dados)

Definição

profile

Alterado na versão 5.0.:

Para uma instância do mongod, o comando habilita, desabilita ou configura o analisador de banco de dados. O analisador captura e registra dados sobre o desempenho de operações de gravação, cursores e comandos de banco de dados em uma instância mongod em execução. Se o analisador estiver desabilitado, o comando configurará como as operações lentas serão registradas no registro de diagnóstico.

Em mongod, se o nível do criador de perfil do banco de dados estiver 2, o log completo será habilitado no criador de perfil e no diagnostic log.

No nível do perfil do banco de dados 1, as seguintes configurações modificam tanto o perfil quanto o diagnostic log:

• slowms

• sampleRate

• filtro, filtro

Se o nível do perfil do banco de dados for 0, o perfil do banco de dados será desabilitado. No nível 0, as seguintes configurações modificam apenas o registro de diagnóstico:

• slowms

• sampleRate

• filtro, filtro

Para uma instância do mongos , o comando configura somente como as operações são gravadas no registro de diagnóstico. Não é possível habilitar o criador de profiler de banco de dados de dados em uma instância mongos porque mongos não tem nenhuma coleção na qual o criador de profiler possa gravar.

A partir do MongoDB 5.0, as alterações feitas no profiler de banco de dados level, slowms, sampleRate, ou filter usando o comando profile ou o método wrapper db.setProfilingLevel() são registradas no log file.

Em mongos, você pode definir profile nível para:

• 0 para definir slowms, sampleRate e filter para o registro de diagnóstico;

• -1 para ler as configurações atuais.

O profiler está desativado por padrão.

Aviso

A análise pode degradar o desempenho e expor dados de query não criptografados no registro do sistema. Considere cuidadosamente quaisquer implicações de desempenho e segurança antes de configurar e habilitar o analisador em um sistema de produção.

Consulte Sobrecarga do criador de perfil para obter mais informações sobre a possível degradação do desempenho.

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

• 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(
  {
    profile: <level>,
    slowms: <threshold>,
    sampleRate: <rate>,
    filter: <filter expression>
  }
)

Campos de comando

O comando utiliza os seguintes campos:

{ <field1>: <expression1>, ... }

Os métodos de shell db.getProfilingStatus() e db.setProfilingLevel() fornecem envoltórios em torno do comando profile.

Comportamento

O comando profile obtém um bloqueio de gravação no banco de dados afetado enquanto habilita ou desabilita o profiler. Normalmente, essa é uma operação curta. A trava bloqueia outras operações até que o comando profile seja concluído.

Quando conectado a um cluster fragmentado por meio de mongos, é possível executar o comando profile em qualquer banco de dados.

Exemplo

db.runCommand(
   {
     profile: 1,
     filter:
        {
           $or:
           [
              { millis: { $gte: 100 } },
              { user: "testuser@admin" }
           ]
        }
   }
)

db.runCommand(
   {
      profile: 1,
      filter: "unset"
   }
)