Database Profiler

Configuraciones de perfilado globales y por base de datos

slowms y sampleRate son configuraciones globales que afectan a todas las bases de datos en el proceso.

The Nivel de perfilado y el filtro son configuraciones a nivel de base de datos cuando se establecen con profile o db.setProfilingLevel(). Cuando se configuran como opciones de línea de comandos o archivo de configuración, afectan a todo el proceso.

Especifique el umbral para las operaciones lentas

Por defecto, el umbral para operaciones lentas es de 100 milisegundos.

Las operaciones lentas se registran en función de workingMillis, que es la cantidad de tiempo que MongoDB dedica a trabajar en esa operación. Esto significa que factores como la espera de bloqueos y el control de flujo no afectan si una operación supera el umbral de operación lenta.

Para cambiar el umbral de lentitud de la operación, utilice uno de los siguientes:

• 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.

Para mongos, utiliza db.setProfilingLevel() para configurar slowms y sampleRate. Estas configuraciones solo afectan el registro de diagnóstico en mongos, no al perfilador. El perfilado 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:

• planCacheShapeHash para ayudar a identificar queries lentos con la misma forma del query de caché de planes.

  A partir de MongoDB 8.0, el campo queryHash existente se duplica en un nuevo campo llamado planCacheShapeHash. Si estás utilizando una versión anterior de MongoDB, solo verás el campo queryHash. Las versiones futuras de MongoDB removerán el campo queryHash obsoleto y deberás utilizar el campo planCacheShapeHash en su lugar.

• 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 muestreado al azar de operaciones lentas, establezca sampleRate 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.

El siguiente ejemplo establece el nivel de creación de perfiles en 1 y configura los perfiles para muestrear el 42% de 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.

Para mongos, slowms y sampleRate afectan sólo al registro de diagnóstico, no al perfilador. [1] Para configurar la tasa de muestreo para el mongos registro:

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

Configura un filtro para determinar las operaciones perfiladas

Para controlar qué operaciones se perfilan y registran, establece un filtro de una de las siguientes maneras:

• profile comando o db.setProfilingLevel().

• filter en un archivo de configuración.

Para mongod, filter afecta tanto al registro de diagnóstico como al perfilador, si están habilitados. Para mongos, filter sólo afecta al registro de diagnóstico.

El siguiente ejemplo establece el nivel de perfilado 1 con un filtro que solo registra query operaciones que tardan más de 2 segundos:

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

Comprueba el nivel de creación de perfiles

Para visualizar el nivel de perfilado, ejecuta en mongosh:

db.getProfilingStatus()

El shell devuelve un documento similar al siguiente:

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

El documento devuelto contiene:

• was: nivel de perfilado actual.

• slowms: operation time threshold en milisegundos.

• sampleRateporcentaje de operaciones lentas siendo perfiladas.

Inhabilitar la creación de perfiles

Para desactivar la creación de perfiles, ejecútalo en mongosh:

db.setProfilingLevel(0)

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

Para entornos de desarrollo y prueba, puede habilitar la creación de perfiles para una mongod instancia completa de. El nivel de creación de perfiles se aplica a todas las bases de datos de esa instancia.

Pase las siguientes opciones a al mongod iniciar:

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

Como alternativa, especifique operationProfiling en el archivo de configuración.

Esto establece el nivel de perfilado 1, define las operaciones lentas como aquellas que duran más de 15 milisegundos y perfila el 50% de las operaciones lentas. [2]

slowms y slowOpSampleRate también afecta a las operaciones registradas en el registro de diagnóstico cuando logLevel está 0. Ambas configuraciones también configuran el registro de diagnósticos 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 habilitar el perfilado en un clúster particionado, habilítalo en cada instancia mongod en el clúster.

Puede configurar --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.

Devuelve las entradas de registro más recientes 10:

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

Devuelve todas las operaciones excepto las operaciones de comando ($cmd):

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

Devolver operaciones para una colección específica (este ejemplo usa mydb.test):

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

Operaciones de retorno que toman más de 5 milisegundos:

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

Operaciones de retorno en un intervalo de tiempo específico:

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

Devuelve operaciones en un rango de tiempo, excluye el campo user y ordena por duració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 colección system.profile

La system.profile colección tiene un tamaño máximo 1 predeterminado de megabytes, que normalmente puede almacenar varios miles de documentos de perfil. Si necesita cambiar el tamaño, siga los pasos que se indican 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 la primaria:

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 system.profile colección de 4000000 bytes (4 MB) 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 una secundaria, detén la secundaria, ejecútala como autónomo y realiza los pasos anteriores. Luego, reinícialo como miembro del set de réplicas. Para obtener más información, consulte Realizar mantenimiento en miembros del set de réplicas autogestionados.