On this page
db.setProfilingLevel()
On this page
Definition
db.setProfilingLevel( level, options )-
Configures the database profiler. This method provides a wrapper around the
profilecommand.Parameter Type Description levelinteger Configures the profiler level. The following profiler levels are available:
Level Description 0The profiler is off and does not collect any data. This is the default profiler level. 1The profiler collects data for operations that take longer than the value of slowms.2The profiler collects data for all operations. optionsdocument or integer Optional. Accepts an integer or an options document. If an integer value is passed as the
optionsargument instead of a document, the value is assigned toslowms. The following options are available:slowms Default: 100Type: integerThe slow operation time threshold, in milliseconds. Operations that run for longer than this threshold are considered slow.
When
logLevelis set to0, MongoDB records slow operations to the diagnostic log at a rate determined byslowOpSampleRate. For MongoDB 3.6 deployments, starting in version 3.6.11, the secondaries of replica sets log all oplog entry messages that take longer than the slow operation threshold to apply regardless of the sample rate.At higher
logLevelsettings, all operations appear in the diagnostic log regardless of their latency with the following exception: the logging of slow oplog entry messages by the secondaries. The secondaries log only the slow oplog entries; increasing thelogLeveldoes not log all oplog entries.Note
This argument affects the same setting as the configuration file option
slowOpThresholdMs.sampleRate Default: 1.0Type: doubleThe fraction of slow operations that should be profiled.
sampleRateaccepts values between 0 and 1, inclusive.Note
This argument affects the same setting as the configuration option
slowOpSampleRate.Important
Profiling can impact performance and shares settings with the system log. Carefully consider any performance and security implications before configuring and enabling the profiler on a production deployment.
See Profiler Overhead for more information on potential performance degradation.