Database Profiler

Configurações de perfil global e por banco de dados

slowms e sampleRate são configurações globais que afetam todos os bancos de dados no processo.

Nível de perfilamento e filtro são configurações de nível de banco de dados quando configurados com profile ou db.setProfilingLevel(). Quando definidas como opções de linha de comando ou arquivo de configuração, elas afetam todo o processo.

Especifique o limite para operações lentas

Por padrão, o limite de operação lenta é de 100 milissegundos.

As operações lentas são registradas com base em workingMillis, que é a quantidade de tempo que o MongoDB gasta trabalhando nessa operação. Isso significa que fatores como a espera por bloqueios e o controle de fluxo não afetam o fato de uma operação exceder o limite de operação lenta.

Para alterar o limite de operação lenta, use uma das seguintes opções:

• Defina o valor de slowms usando o comando profile ou o ajudante de shell db.setProfilingLevel().

• Configure o valor de --slowms a partir da linha de comando na inicialização.

• Defina o valor de slowOpThresholdMs em um arquivo de configuração.

O exemplo a seguir define o nível de perfilamento do banco de dados conectado no momento como 1 e define o limite de operação lenta para a instância mongod como 20 milissegundos:

db.setProfilingLevel( 1, { slowms: 20 } )

Um nível de criação de perfil de 1 faz com que o perfil registre as operações mais lentamente do que o limite de slowms.

Para mongos, utilize db.setProfilingLevel() para configurar slowms e sampleRate. Essas configurações afetam apenas o log de diagnóstico em mongos, não o profiler. A criação de perfil não está disponível em mongos. [1]

O exemplo a seguir define o limite de operação lenta de uma instância mongos para o registro de operações lentas em 20:

db.setProfilingLevel( 0, { slowms: 20 } )

As entradas do criador de perfil e as mensagens de log de diagnóstico (ou seja, mensagens de log mongod/mongos) para operações de leitura/gravação incluem:

• planCacheShapeHash para ajudar a identificar queries lentas com a mesma forma de query de cache de plano.

  A partir do MongoDB 8.0, o campo queryHash existente é duplicado em um novo campo chamado planCacheShapeHash. Se você estiver usando uma versão anterior do MongoDB , verá apenas o campo queryHash. As futuras versões do MongoDB removerão o campo queryHash obsoleto, e você precisará usar o campo planCacheShapeHash em seu lugar.

• planCacheKey para fornecer mais informações sobre o cache do plano de consulta para queries lentas.

Os membros secundários de um conjunto de réplicas agora registram entradas de oplog que demoram mais do que o limite de operação lenta para serem aplicadas. Essas mensagens de atraso no oplog:

• São registradas para os secundários no diagnostic log.

• São registradas sob o componente REPL com o texto applied op: <oplog entry> took <num>ms.

• Não dependem dos níveis de registro (seja no nível do sistema ou do componente)

• Não dependem do nível de perfil.

• São afetados por slowOpSampleRate.

O perfilador não captura entradas de oplog lentas.

Crie um perfil de uma amostra aleatória de operações lentas

Para criar o perfil de apenas um subconjunto amostrado aleatoriamente de operações lentas, defina sampleRate de uma das seguintes maneiras: [2]

• Defina o valor de sampleRate usando o comando profile ou o ajudante de shell db.setProfilingLevel().

• Configure o valor de --slowOpSampleRate para mongod ou --slowOpSampleRate para mongos a partir da linha de comando na inicialização.

• Defina o valor de slowOpSampleRate em um arquivo de configuração.

Por padrão, o sampleRate é configurado para 1.0, significando que todas as operações lentas são perfiladas. Quando sampleRate é definido entre 0 e 1, os bancos de dados com um nível de perfilamento 1 apenas perfilam uma amostragem aleatória de apenas uma porcentagem das operações lentas com base em sampleRate.

O exemplo a seguir define o nível de criação de perfil como 1 e define os perfis para amostrar 42% das operações lentas:

db.setProfilingLevel( 1, { sampleRate: 0.42 } )

O valor da taxa de amostragem modificado também se aplica ao log do sistema.

Para mongos, slowms e sampleRate afetam apenas o log de diagnóstico, não o profiler. [1] Para definir a taxa de amostragem para o registro mongos:

db.setProfilingLevel( 0, { sampleRate: 0.42 } )

Definir um filtro para determinar as operações perfiladas

Para controlar quais operações são perfiladas e registradas, defina um filtro de uma das seguintes maneiras:

• profile comando ou db.setProfilingLevel().

• filter em um arquivo de configuração.

Para mongod, filter afeta o log de diagnóstico e o profiler, se habilitados. Para mongos, filter afeta somente o log de diagnóstico.

O exemplo a seguir define o nível de criação de perfil 1 com um filtro que registra apenas query operações que demoram mais de 2 segundos:

db.setProfilingLevel( 1, { filter: { op: "query", millis: { $gt: 2000 } } } )

Verificar nível de perfil

Para visualizar o nível de perfilamento, execute em mongosh:

db.getProfilingStatus()

A concha retorna um documento semelhante ao seguinte:

{ "was" : 0, "slowms" : 100, "sampleRate" : 1.0, "ok" : 1 }

O documento devolvido contém:

• was: nível de perfil atual.

• slowms: operation time threshold in milissegundos.

• sampleRate: porcentagem de operações lentas que estão sendo analisadas.

Desativar criação de perfil

Para desativar o perfilamento, execute em mongosh:

db.setProfilingLevel(0)

Habilitar a criação de perfil para uma instância mongod inteira

Para ambientes de desenvolvimento e teste, você pode habilitar a criação de perfil para uma instância mongod inteira. O nível de perfil se aplica a todos os bancos de dados nesta instância.

Passe as seguintes opções para mongod na inicialização:

mongod --profile 1 --slowms 15 --slowOpSampleRate 0.5

Alternativamente, especifique operationProfiling no arquivo de configuração.

Isso define o nível de criação de perfil 1, define operações lentas como aquelas que duram mais de 15 milésimos de segundo e perfila 50% das operações lentas. [2]

slowms e slowOpSampleRate também afetam as operações registradas no log de diagnóstico quando logLevel está 0. Ambas as configurações também configuram o registro de diagnóstico para mongos. [2]

Perfil e fragmentação de banco de dados

Você não pode habilitar o perfil em uma instância do mongos. Para habilitar o perfil em um cluster fragmentado, habilite-o em cada instância mongod no cluster.

Você pode definir --slowms e slowOpSampleRate em mongos para configurar o log de diagnóstico para operações lentas.

Exemplo de queries de dados do analista

Esta seção mostra exemplos de queries na collection system.profile. Para obter detalhes de saída da query, consulte Saída do analisador de banco de dados.

Retornar as 10 entradas de log mais recentes:

db.system.profile.find().limit(10).sort( { ts : -1 } ).pretty()

Retornar todas as operações exceto operações de comando ($cmd):

db.system.profile.find( { op: { $ne : 'command' } } ).pretty()

Operações de retorno para uma coleção específica (este exemplo utiliza mydb.test):

db.system.profile.find( { ns : 'mydb.test' } ).pretty()

Operações de retorno com mais de 5 milissegundos:

db.system.profile.find( { millis : { $gt : 5 } } ).pretty()

Retornar operações em uma faixa de tempo específica:

db.system.profile.find( {
   ts : {
      $gt: new ISODate("2012-12-09T03:00:00Z"),
      $lt: new ISODate("2012-12-09T03:40:00Z")
   }
} ).pretty()

Operações de retorno em um intervalo de tempo, exclua o campo user e classifique por duração:

db.system.profile.find( {
   ts : {
      $gt: new ISODate("2011-07-12T03:00:00Z"),
      $lt: new ISODate("2011-07-12T03:40:00Z")
   }
}, { user: 0 } ).sort( { millis: -1 } )

Mostrar os cinco eventos mais recentes

Em um banco de dados com a criação de perfil ativada, o assistente show profile em mongosh exibe as 5 operações mais recentes que levaram pelo menos 1 milésimo de segundo para serem executadas. Execute show profile de mongosh:

show profile

A system.profile Collection

A system.profile é uma coleção limitada com um tamanho padrão de 1 megabyte, que normalmente pode armazenar vários milhares de documentos de perfil. Se precisar alterar o tamanho, siga as etapas abaixo.

Alterar o tamanho da coleção system.profile no primário

Para alterar o tamanho da coleção system.profile no primário:

1. Desative a criação de perfil.

2. Solte a coleção system.profile.

3. Crie uma nova coleção system.profile.

4. Reativar perfil.

Por exemplo, para criar uma nova system.profile coleção de 4000000 bytes (4 MB) em mongosh:

db.setProfilingLevel(0)
db.system.profile.drop()
db.createCollection( "system.profile", { capped: true, size:4000000 } )
db.setProfilingLevel(1)

Alterar o tamanho da coleção system.profile em um secundário

Para alterar o tamanho da coleção system.profile em um secundário, interrompa o secundário, execute-o como autônomo e execute as etapas acima. Em seguida, reinicie-o como um membro do conjunto de réplicas. Para obter mais informações, consulte Executar manutenção de membros autogerenciados do conjunto de réplicas.