perfil (comando de base de datos)

Definición

profile

Modificado en la versión 5.0.

Para una En la instanciamongod, el comando habilita, deshabilita o configura el generador de perfiles de base de datos. Este generador captura y registra datos sobre el rendimiento de las operaciones de escritura, los cursores y los comandos de base de datos en una instanciamongoden ejecución. Si el generador de perfiles está deshabilitado, el comando configura cómo se registran las operaciones lentas en el registro de diagnóstico.

mongodEn, si el nivel del generador de perfiles de base de datos 2es, se habilita el registro completo en el generador de perfiles y diagnostic log en.

En el nivel del generador de perfiles de base de 1 datos, las siguientes configuraciones modifican tanto el generador de perfiles como diagnostic log el:

• slowms

• frecuencia de muestreo

• filtro

Si el nivel del 0 perfilador de base de datos es, este se deshabilita. En el nivel,0 las siguientes configuraciones solo modifican el registro de diagnóstico:

• slowms

• frecuencia de muestreo

• filtro

En mongos una instancia, el comando solo configura cómo se escriben las operaciones en el registro de diagnóstico. No se puede habilitar el generador de perfiles de base de datos en una instancia mongos porque mongos no tiene colecciones en las que el generador de perfiles pueda escribir.

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

En, puedes mongos establecer profile el nivel en:

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

• -1 para leer la configuración actual.

El generador de perfiles está desactivado de forma predeterminada.

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 establece un bloqueo de escritura en la base de datos afectada al habilitar o deshabilitar profile profile el generador de perfiles. Esta operación suele ser breve. El bloqueo bloquea otras operaciones hasta que se complete el comando.

Cuando se conecta a un clúster fragmentado a través mongos de, puede ejecutar el profile comando contra cualquier base de datos.

Ejemplo

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

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