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.

Starting in MongoDB 5.0, changes made to the database profiler level, slowms, sampleRate, or filter using the profile command or db.setProfilingLevel() wrapper method are recorded in the 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: The fully managed service for MongoDB deployments in the cloud

• 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>, ... }

The db.getProfilingStatus() and db.setProfilingLevel() shell methods provide wrappers around the profile command.

Comportamento

The profile command obtains a write lock on the affected database while enabling or disabling the profiler. This is typically a short operation. The lock blocks other operations until the profile command has completed.

When connected to a sharded cluster through mongos, you can run the profile command against any database.

Exemplo

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

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