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 a través del comando profile o del método asistente de shell db.setProfilingLevel(), la configuración del nivel de perfilado y del filtro se establece a nivel de base de datos. Cuando se establecen como opciones de la línea de comandos o archivo de configuración, los ajustes del nivel de perfilado y de filter afectan a todo el proceso.

Especifique el umbral para las operaciones lentas

Por defecto, el umbral para operaciones lentas es de 100 milisegundos. Para cambiar el umbral de operación lenta, especifica el valor del umbral requerido 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.

El siguiente ejemplo establece el nivel de creación de perfiles para la base de datos conectada actualmente a 1 y establece el umbral de operación lenta para la instancia mongod en 20 milisegundos:

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

Un nivel de creación de perfiles de 1 hace que el perfilador registre operaciones más lentas que el umbral de slowms.

Puedes usar db.setProfilingLevel() para configurar slowms y sampleRate para mongos. Para mongos, las configuraciones slowms y sampleRate solo afectan al registro de diagnóstico y no al perfilador, ya que la creación de perfiles no está disponible en mongos. [1]

El siguiente ejemplo establece el umbral de operación lenta de una instancia mongos para registrar operaciones lentas en 20:

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 de consulta.

• 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 se establece en 1.0, lo que significa que se perfilan todas las operaciones lentas. Cuando sampleRate se establece entre 0 y 1, las bases de datos con un nivel de creación de perfiles 1 solo perfilan un porcentaje de operaciones lentas seleccionado aleatoriamente basado en sampleRate.

En el siguiente ejemplo, se configura el nivel de creación de perfiles para la base de datos conectada actualmente a 1 y se configura el perfilador para que muestree 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.

Puedes usar db.setProfilingLevel() para configurar slowms y sampleRate para mongos. Para mongos, los ajustes de configuración de slowms y sampleRate solo afectan al registro de diagnóstico y no al perfilador porque 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.

El siguiente db.setProfilingLevel() ejemplo establece el nivel de perfil para la base de datos actualmente conectada:

• el nivel de perfilado a 1,

• 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( 1, { filter: { op: "query", millis: { $gt: 2000 } } } )

Comprueba el nivel de creación de perfiles

Para ver el nivel de perfilado, ejecuta el siguiente ejemplo en mongosh:

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 desactivar el perfilado, ejecuta el siguiente ejemplo en mongosh:

db.setProfilingLevel(0)

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

Para entornos de desarrollo y prueba, puedes activar la creación de perfiles de bases de datos para toda una instancia mongod. El nivel de creación de perfiles se aplica a todas las bases de datos proporcionadas por la instancia mongod.

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]

slowms y slowOpSampleRate también afectan las operaciones que se registran en el registro de diagnóstico cuando logLevel está configurado en 0. slowms y 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 queries de ejemplo en la colección system.profile. Para obtener detalles de la salida de la query, consulta Salida del perfilador 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 que tarden más de 5 milisegundos en completarse, ejecuta:

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

Para devolver operaciones para un rango de tiempo específico, ejecuta:

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 que tenga activado el perfilado, el asistente show profile en mongosh muestra las 5 operaciones más recientes que tardaron al menos 1 milisegundo en ejecutarse. Ejecuta show profile desde mongosh:

show profile

La system.profile colección

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.