Database Profiler

Configuraciones de perfilado globales y por base de datos

Los ajustes de creación de perfiles slowms y sampleRate son globales. Cuando se configuran, afectan a todas las bases de datos del proceso.

Cuando se establece mediante el comando profile o el método asistente de shell db.setProfilingLevel(), la configuración del nivel de perfilado y la configuración del filtro se establecen a nivel de base de datos. Cuando se establecen como opciones de línea de comandos o archivo de configuración, el nivel de perfilado y la configuración de filter afectan a todo el proceso.

Especifique el umbral para las operaciones lentas

Por defecto, el umbral de operaciones lentas es de 100 milisegundos. Para cambiar el umbral de operación lenta, especifica el valor deseado del umbral de una de las siguientes maneras:

• Establece el valor de slowms usando el comando profile o el método asistente de shell db.setProfilingLevel().

• Establece el valor de --slowms desde la línea de comandos al inicio.

• Establece el valor de slowOpThresholdMs en un archivo de configuración.

Por ejemplo, el siguiente código establece el nivel de perfilado para la instancia actual de mongod en 1 y establece el umbral de operación lenta para la instancia mongod en 20 milisegundos:

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

El nivel de perfilado de 1 perfilará las operaciones más lentas que el umbral.

A partir de MongoDB 4.0, puedes usar db.setProfilingLevel() para configurar slowms y sampleRate para mongos. Para el mongos, la configuración de slowms y sampleRate solo afecta el registro de diagnóstico y no el perfilador, ya que la creación de perfiles no está disponible en mongos. [1]

Por ejemplo, lo siguiente establece el umbral de lentitud de una instancia de mongos para registrar operaciones lentas:

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

Las entradas del perfilador y los mensajes del registro de diagnóstico (es decir, mensajes de registro de mongod/mongos) para las operaciones de lectura/escritura incluyen:

• queryHash para ayudar a identificar consultas lentas con la misma forma del query.

• planCacheKey para proporcionar más perspectiva sobre la caché del plan del query para queries lentos.

Los miembros secundarios de un set de réplicas ahora registran entradas de oplog que tardan más que el umbral de una operación lenta en aplicarse. Estos mensajes lentos del oplog:

• Se registran para los secundarios en el diagnostic log.

• Se documentan en el registro bajo el componente REPL con el texto applied op: <oplog entry> took <num>ms.

• No depende de los niveles de registro (ya sea a nivel del sistema o del componente)

• No depende del nivel de perfil.

• Se ven afectados por slowOpSampleRate.

El perfilador no captura entradas lentas del oplog.

Perfila una muestra aleatoria de operaciones lentas

Para perfilar solo un subconjunto aleatorio de todas las operaciones lentas, especifique la tasa de muestra deseada de una de las siguientes maneras: [2]

• Establece el valor de sampleRate usando el comando profile o el método asistente de shell db.setProfilingLevel().

• Establece el valor de --slowOpSampleRate para mongod o --slowOpSampleRate para mongos desde la línea de comandos al inicio.

• Establece el valor de slowOpSampleRate en un archivo de configuración.

Por defecto, sampleRate está configurado en 1.0, lo que significa que todas las operaciones lentas se perfilan. Cuando sampleRate se encuentra entre 0 y 1, las bases de datos con nivel de perfilado 1 solo perfilan un porcentaje muestreado aleatoriamente de operaciones lentas de acuerdo con sampleRate.

Por ejemplo, el siguiente método establece el nivel de perfíl para mongod en 1 y configura el perfilador para muestrear el 42% de todas las operaciones lentas:

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

El valor de la tasa de muestra modificada también se aplica al registro del sistema.

A partir de MongoDB 4.0, puedes usar db.setProfilingLevel() para configurar slowms y sampleRate para mongos. Para el mongos, la configuración de slowms y sampleRate solo afecta el registro de diagnóstico y no el perfilador, ya que la creación de perfiles no está disponible en mongos. [1]

Por ejemplo, lo siguiente establece la tasa de muestreo de una instancia de mongos para registrar operaciones lentas:

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

Configura un filtro para determinar las operaciones perfiladas

Puedes configurar un filtro para controlar qué operaciones se perfilan y registran. Puedes configurar el filtro de creación de perfiles de una de las siguientes maneras:

• Establece el valor de filter usando el comando profile o el método asistente de shell db.setProfilingLevel().

• Establece el valor de filter en un archivo de configuración.

Para las instancias de mongod, filter afecta tanto el registro de diagnóstico como, si está activado, al perfilador.

Para las instancias de mongos, filter afecta únicamente al registro de diagnóstico y no al perfilador, ya que la creación de perfiles no está disponible en mongos.

Por ejemplo, el siguiente método se db.setProfilingLevel() mongod establece para una instancia:

• el nivel de perfilado a 2,

• el filtro de { op: "query", millis: { $gt: 2000 } }, que genera que el perfilador solo registre query operaciones que tomaron más de 2 segundos.

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

Comprueba el nivel de creación de perfiles

Para ver el nivel de perfil, emita lo siguiente mongosh desde:

db.getProfilingStatus()

El shell devuelve un documento similar al siguiente:

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

El campo was indica el nivel actual de creación de perfiles.

El campo slowms indica el umbral de operation time, en milisegundos, a partir del cual las operaciones se consideran lentas.

El campo sampleRate indica el porcentaje de operaciones lentas que se deben perfilar.

Inhabilitar la creación de perfiles

Para deshabilitar la creación de perfiles, utilice el siguiente asistente mongosh en:

db.setProfilingLevel(0)

Habilitar la creación de perfiles para toda la instancia mongod

Para fines de desarrollo en entornos de prueba, puede habilitar la generación de perfiles de base de datos para una instancia completa. El nivel de generación de perfiles se mongod mongod aplica a todas las bases de datos proporcionadas por la instancia.

A fin de activar la creación de perfiles para una instancia de mongod, pasa las siguientes opciones a mongod al inicio.

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

Alternativamente, puedes especificar operationProfiling en el archivo de configuración.

Esto establece el nivel de creación de perfiles en 1, define las operaciones lentas como aquellas que duran más de 15 milisegundos y especifica que solo se debe perfilar el 50 % de las operaciones lentas. [2]

El slowms y el slowOpSampleRate también afectan qué operaciones se registran en el registro de diagnóstico cuando logLevel está configurado en 0. El slowms y el slowOpSampleRate también están disponibles para configurar el registro de diagnóstico para mongos. [2]

Perfilado y fragmentación de bases de datos

No puedes habilitar la creación de perfiles en una instancia de mongos. Para activar el perfilado en un clúster particionado, debes activar el perfilado para cada instancia de mongod en el clúster.

Sin embargo, se puede establecer --slowms y slowOpSampleRate en mongos para configurar el registro de diagnóstico para operaciones lentas.

Queries de datos de ejemplo del perfilador

Esta sección muestra ejemplos de consultas a la system.profile colección. Para obtener una explicación del resultado de la consulta, consulte Salida del Analizador de Base de Datos.

Para devolver las 10 entradas de registro más recientes en la colección system.profile, ejecuta una query similar a la siguiente:

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

Para devolver todas las operaciones, excepto las operaciones de comando ($cmd), ejecuta una query similar a la siguiente:

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

Para devolver operaciones para una colección particular, ejecuta una query similar a la siguiente. Este ejemplo devuelve operaciones en la colección test de la base de datos mydb:

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

Para devolver operaciones más lentas que 5 milisegundos, ejecute una query similar a la siguiente:

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

Para devolver información de un determinado rango de tiempo, ejecute una consulta similar a la siguiente:

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

El siguiente ejemplo examina el rango de tiempo, suprime el campo user de la salida para facilitar la lectura y ordena los resultados según el tiempo que tardó en ejecutarse cada operación:

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

Muestra los cinco eventos más recientes

En una base de datos con la generación de perfiles habilitada, el show profile asistente en muestra mongosh las 5 operaciones más recientes que tardaron al menos 1 milisegundos en ejecutarse. Ejecute show profile mongoshdesde, como se indica a continuación:

show profile

La colección system.profile

La colección system.profile es una colección con tamaño fijo con un tamaño por defecto de 1 megabyte. Una colección de este tamaño, por lo general, puede almacenar varios miles de documentos de perfil, pero algunas aplicaciones pueden utilizar más o menos datos de creación de perfiles por operación. Si debes cambiar el tamaño de la colección system.profile, sigue los pasos descritos a continuación.

Cambiar el tamaño de system.profile la colección en la base de datos principal

Para cambiar el tamaño de la colección system.profile en el primario, debes hacer lo siguiente:

1. Inhabilitar la creación de perfiles.

2. Descarta la colección system.profile.

3. Crear una nueva colección system.profile.

4. Vuelve a activar la creación de perfiles.

Por ejemplo, para crear una nueva colección system.profile que tenga 4000000 bytes (4 MB), utiliza la siguiente secuencia de operaciones en mongosh:

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

Cambie el tamaño de la system.profile colección en un secundario

Para cambiar el tamaño de la colección system.profile en un secundario, debes detener el secundario, ejecutarlo como autónomo y, a continuación, realizar los pasos anteriores. Cuando hayas terminado, reinicia el autónomo como nodo del set de réplicas. Para obtener más información, consulta Mantenimiento de los miembros del set de réplicas autogestionado.