db.setProfilingLevel() (método mongosh)

Definición

db.setProfilingLevel(level, options)

Modificado en la versión 5.0.

Para un 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 perfilado con db.setProfilingLevel() no persisten. Cuando el servidor se reinicia, vuelve a 0 (el valor por defecto), o al valor establecido mediante la configuración operationProfiling.mode o la opción de línea de comandos --profile.

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

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.

Puedes especificar un filtro tanto en la instancia mongod como en mongos para controlar qué operaciones se registran mediante el perfilador. Cuando se especifica un filter para el perfilador, las opciones slowms y sampleRate no se usan para el perfilado y las líneas de registro de consultas lentas.

db.setProfilingLevel() proporciona un contenedor alrededor del comando profile.

A partir de MongoDB 5.0, los cambios realizados en el perfilador de base de datos level, slowms, sampleRate o filter utilizando el comando profile o el método contenedor db.setProfilingLevel() se registran en el log file.

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")
      }
   }
}

Dónde:

• was es la configuración de nivel anterior.

• slowms es el ajuste anterior slowms.

• sampleRate es el anterior sampleRate ajuste.

• 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 actual de creación de perfiles, consulte db.getProfilingStatus().

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" } )