db.setProfilingLevel() (método mongosh)

Definición

db.setProfilingLevel(level, options)

Modificado en la versión 5.0.

Para una mongod En la instancia, el método habilita, deshabilita o configura el generador de perfiles de base de datos. Este generador captura y registra datos sobre el rendimiento de las operaciones de escritura, los cursores y los comandos de base de datos en mongod una instancia en ejecución. Si el generador de perfiles está deshabilitado, el método configura cómo se registran las operaciones lentas en el registro de diagnóstico.

Nota

Los cambios realizados en el nivel de perfil con db.setProfilingLevel() no se conservan. Al reiniciar el servidor, se restablece a 0 (valor predeterminado) o al valor establecido por la configuración operationProfiling.mode --profile o la opción de línea de comandos.

Si el nivel del generador de perfiles de base de datos es 1 o 2 (específicamente, el generador de perfiles de base de datos está habilitado),slowms ysampleRate afectan el comportamiento tanto del generador de perfiles como diagnostic log de.

Si el nivel del generador de perfiles de base de datos es 0 (específicamente, el generadorde perfiles de base de datos está deshabilitado),slowms y sampleRate afectan solo al registro de diagnóstico.

Con las instancias mongos, el método establece las configuraciones slowms, sampleRate y filter, que determinan cómo se registran las operaciones en el registro de diagnóstico. No es posible activar el perfilador de base de datos en una mongos instancia porque mongos no tiene ninguna colección en la que el perfilador pueda guardar. El nivel profile debe ser 0 para una instancia mongos.

Puede especificar un filtro en las instancias y para controlar qué operaciones registra el generador de perfiles. Al especificar mongod mongos un filter para el generador de perfiles, las opciones slowms y sampleRate no se utilizan para la generación de perfiles ni para las líneas de registro de consultas lentas.

db.setProfilingLevel() proporciona una envoltura alrededor del profile comando.

A partir de MongoDB,5.0 los cambios realizados en el generador de perfiles de base level deslowms sampleRatedatos,, o filter mediante el profile comando o db.setProfilingLevel() el método contenedor se registran log file en.

Compatibilidad

Este método está disponible en implementaciones alojadas en los siguientes entornos:

• MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

• MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB

• MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

Sintaxis

El método db.setProfilingLevel() tiene la siguiente forma:

db.setProfilingLevel(<level>, <options>)

Parámetros

Devuelve

El método devuelve un documento que contiene los valores anteriores de la configuración.

{
   "was" : 2,
   "slowms" : 100,
   "sampleRate" : 1,
   "filter" : {
      "$and" : [
         {
            "op" : {
               "$eq" : "query"
            }
         },
         {
            "millis" : {
               "$gt" : 20000
            }
         }
      ]
   },
   "note" : "When a filter expression is set, slowms and sampleRate are not used for profiling and slow-query log lines.",
   "ok" : 1
}

{
   "was" : 0,
   "slowms" : 100,
   "sampleRate" : 1,
   "filter" : {
      "$and" : [
         {
            "op" : {
               "$eq" : "query"
            }
         },
         {
            "millis" : {
               "$gte" : 2000
            }
         }
      ]
   },
   "note" : "When a filter expression is set, slowms and sampleRate are not used for profiling and slow-query log lines.",
   "ok" : 1,
   "$clusterTime" : {
      "clusterTime" : Timestamp(1572991238, 1),
      "signature" : {
         "hash" : BinData(0,"hg6GnlrVhV9MAhwWdeHmHQ4T4qU="),
         "keyId" : Long("6755945537557495811")
      }
   },
   "operationTime" : Timestamp(1572991238, 1)
}

{
   "was" : 0,
   "slowms" : 100,
   "sampleRate" : 1,
   "filter" : {
      "$and" : [
         {
            "op" : {
               "$eq" : "query"
            }
         },
         {
            "millis" : {
               "$gte" : 2000
            }
         }
      ]
   },
   "note" : "When a filter expression is set, slowms and sampleRate are not used for profiling and slow-query log lines.",
   "ok" : 1,
   "operationTime" : Timestamp(1572991499, 2),
   "$clusterTime" : {
      "clusterTime" : Timestamp(1572991499, 2),
      "signature" : {
         "hash" : BinData(0,"nhCquIxUw7thlrBudXe3PnsnvP0="),
         "keyId" : Long("6755946491040235540")
      }
   }
}

Donde:

• was Es la configuración de nivel anterior.

• slowms Es la configuración slowms anterior.

• sampleRate es la configuración de sampleRate anterior.

• filter Es la configuración del filtro anterior.

• note Es una cadena que explica el comportamiento de filter. Este campo solo aparece en la salida cuando filter también está presente.

Para ver el nivel de perfil actual,db.getProfilingStatus() consulte.

Comportamiento

Ejemplos

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

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

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

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