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 configuran mediante el profile comando o db.setProfilingLevel() el método auxiliar de shell, elnivel de perfilado y la configuración de filtros se establecen a nivel de base de datos. Cuando se configuran como opciones de línea de comandos o archivo de configuración, el nivel de perfilado y filter la configuración 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 de umbral requerido de una de las siguientes formas:

• 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 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 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, ejecute el siguiente ejemplo mongosh en:

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 el análisis de perfiles, ejecute el siguiente ejemplo mongosh en:

db.setProfilingLevel(0)

Activa la creación de perfiles para una instancia mongod completa

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 con la función de perfilado habilitada, el show profile asistente en muestra mongosh las 5 operaciones más recientes que tardaron al menos 1 milisegundos en ejecutarse. Ejecutar show profile mongoshdesde:

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.

Cambia el tamaño de la colección system.profile en el primario

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 que system.profile sea 4000000 bytes (4 MB), utilice la siguiente secuencia de operaciones mongosh en:

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

Cambia el tamaño de la colección system.profile 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.