perfil (comando de base de datos)

Definición

profile

Modificado en la versión 5.0.

Para un mongod instancia, el comando habilita, deshabilita o configura el perfilador de base de datos. El perfilador captura y registra datos sobre el rendimiento de las operaciones de escritura, cursores y comandos de base de datos en una instancia activa de mongod. Si el perfilador está deshabilitado, el comando configura cómo se registran las operaciones lentas en el registro de diagnóstico.

En mongod, si el nivel del perfilador de base de datos es 2, el registro completo está habilitado en el perfilador y el diagnostic log.

En el nivel de perfilador de base de datos 1, los siguientes ajustes modifican tanto el perfilador como el diagnostic log:

• slowms

• sampleRate

• filtro

Si el nivel del perfilador de base de datos es 0, el perfilador de base de datos está deshabilitado. En el nivel 0, la configuración siguiente solo modifica el registro de diagnósticos:

• slowms

• sampleRate

• filtro

En una mongos instancia, el comando sólo configura cómo se escriben las operaciones en el registro de diagnóstico. No se puede habilitar el perfilador de base de datos en una mongos instancia porque mongos no tiene ninguna colección en la que el perfilador pueda guardar.

A partir de MongoDB,5.0 los cambios realizados en el generador de perfiles de base level deslowms sampleRatedatos,, o filter mediante el El comando profile o el método contenedor db.setProfilingLevel() se registran en el log file.

En mongos, puedes establecer el nivel de profile en:

• 0 para establecer el slowms, sampleRate y filter para el registro de diagnóstico;

• -1 para leer la configuración actual.

El perfilador está desactivado por defecto.

Advertencia

El perfilado puede degradar el rendimiento y exponer datos de la consulta no cifrados en el registro del sistema. Considera detenidamente cualquier implicación de rendimiento y seguridad antes de configurar y activar el perfilador en una implementación de producción.

Consulte Sobrecarga del perfilador para obtener más información sobre la posible degradación del rendimiento.

Compatibilidad

Este comando 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 comando tiene la siguiente sintaxis:

db.runCommand(
  {
    profile: <level>,
    slowms: <threshold>,
    sampleRate: <rate>,
    filter: <filter expression>
  }
)

Campos de comandos

El comando toma los siguientes campos:

{ <field1>: <expression1>, ... }

Los db.getProfilingStatus() db.setProfilingLevel() métodos de shell y profile proporcionan envoltorios alrededor del comando.

Comportamiento

El comando profile obtiene un bloqueo de escritura en la base de datos afectada mientras activa o desactiva el perfilador. Normalmente, esta es una operación breve. El bloqueo detiene otras operaciones hasta que finaliza el comando profile.

Cuando esté conectado a un clúster fragmentado a través de mongos, puede ejecutar el comando profile en cualquier base de datos.

Ejemplo

db.runCommand(
   {
     profile: 1,
     filter:
        {
           $or:
           [
              { millis: { $gte: 100 } },
              { user: "testuser@admin" }
           ]
        }
   }
)

db.runCommand(
   {
      profile: 1,
      filter: "unset"
   }
)