On this page
db.setProfilingLevel()
On this page
Definition
db.
setProfilingLevel
( level, options )-
Configures the database profiler. This method provides a wrapper around the
profile
command.Parameter Type Description level
integer Configures the profiler level. The following profiler levels are available:
Level Description 0
The profiler is off and does not collect any data. This is the default profiler level. 1
The profiler collects data for operations that take longer than the value of slowms
.2
The profiler collects data for all operations. options
document or integer Optional. Accepts an integer or an options document. If an integer value is passed as the
options
argument 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
logLevel
is 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
logLevel
settings, 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 thelogLevel
does 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.
sampleRate
accepts 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.