定义
db.setProfilingLevel(level, options)在版本5.0中进行了更改。
对于
mongod实例，该方法可启用、禁用或配置数据库分析器。分析器捕获并记录正在运行的mongod实例上的写入操作、游标和数据库命令性能的数据。如果分析器被禁用，该方法将配置如何将慢操作记录到诊断日志中。注意
使用
db.setProfilingLevel()对分析级别所做的更改不会保留。当服务器重新启动时，它会恢复为0（默认值），或者由operationProfiling.mode设置或--profile命令行选项设置的值。如果数据库分析器级别为
1或2（具体来说，已启用数据库分析器），则 slowms 和 sampleRate 会同时影响分析器和diagnostic log的行为。如果数据库分析器级别为
0（具体来说，数据库分析器已禁用），则 slowms 和 sampleRate 仅影响 诊断日志。使用
mongos实例，该方法设置slowms、sampleRate和filter配置设置，从而配置如何将操作写入诊断日志。您无法在mongos实例上启用数据库分析器，因为mongos没有分析器可以写入的任何集合。对于mongos实例，profile等级必须为0。您可以在
mongod和mongos实例上指定过滤，以控制分析器记录哪些操作。当您为分析器指定filter时，slowms 和 sampleRate 选项不会用于分析和慢速查询日志行。db.setProfilingLevel()提供了profile命令的封装器。从MongoDB 5.0 开始，使用
profile命令或db.setProfilingLevel()包装器方法对数据库分析器level、slowms、sampleRate或filter所做的更改会记录在log file。
兼容性
此方法可用于以下环境中托管的部署：
- MongoDB Atlas ：用于在云中部署MongoDB 的完全托管服务
MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本
MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本
语法
db.setProfilingLevel() 方法采用以下形式：
db.setProfilingLevel(<level>, <options>)
参数
Parameter | 类型 | 说明 |
|---|---|---|
整型 | 配置数据库分析器级别。以下分析器级别可用：
由于分析在 | |
文档或整数 | 可选。接受整数或选项文档。如果将整数值而不是文档作为
|
返回：
该方法返回一个包含先前设置值的文档。
{ "was" : 2, "slowms" : 100, "sampleRate" : 1, "filter" : { "$and" : [ { "op" : { "$eq" : "query" } }, { "millis" : { "$gt" : 20000 } } ] }, "note" : "When a filter expression is set, slowms and sampleRate are not used for profiling and slow-query log lines.", "ok" : 1 }
{ "was" : 0, "slowms" : 100, "sampleRate" : 1, "filter" : { "$and" : [ { "op" : { "$eq" : "query" } }, { "millis" : { "$gte" : 2000 } } ] }, "note" : "When a filter expression is set, slowms and sampleRate are not used for profiling and slow-query log lines.", "ok" : 1, "$clusterTime" : { "clusterTime" : Timestamp(1572991238, 1), "signature" : { "hash" : BinData(0,"hg6GnlrVhV9MAhwWdeHmHQ4T4qU="), "keyId" : Long("6755945537557495811") } }, "operationTime" : Timestamp(1572991238, 1) }
{ "was" : 0, "slowms" : 100, "sampleRate" : 1, "filter" : { "$and" : [ { "op" : { "$eq" : "query" } }, { "millis" : { "$gte" : 2000 } } ] }, "note" : "When a filter expression is set, slowms and sampleRate are not used for profiling and slow-query log lines.", "ok" : 1, "operationTime" : Timestamp(1572991499, 2), "$clusterTime" : { "clusterTime" : Timestamp(1572991499, 2), "signature" : { "hash" : BinData(0,"nhCquIxUw7thlrBudXe3PnsnvP0="), "keyId" : Long("6755946491040235540") } } }
其中：
slowms是之前的 slowms 设置。sampleRate是之前的 sampleRate 设置。note是解释filter行为的字符串。只有当filter也存在时，此字段才会出现在输出中。
要查看当前分析级别，请参阅 db.getProfilingStatus()。
行为
示例
启用分析器并设置慢操作阈值和采样率
以下示例集用于 mongod 实例：
将 sampleRate 设置为
0.42。
db.setProfilingLevel(1, { slowms: 20, sampleRate: 0.42 })
该操作返回一个包含先前设置值的文档。
要查看当前分析级别，请参阅 db.getProfilingStatus()。
禁用性能分析器并设置慢操作阈值和采样率
下面的示例为 mongod 或 mongos 实例进行了设置：
将 sampleRate 设置为
0.42。
db.setProfilingLevel(0, { slowms: 20, sampleRate: 0.42 })
该操作返回一个包含先前设置值的文档。
要查看当前分析级别，请参阅 db.getProfilingStatus()。
设置过滤器以确定要进行分析的操作
以下示例集用于 mongod 实例：
db.setProfilingLevel( 1, { filter: { op: "query", millis: { $gt: 2000 } } } )
该操作返回一个包含先前设置值的文档。
要查看当前分析级别，请参阅 db.getProfilingStatus()。
设置过滤器而不启用分析器
您可以在不启用数据库分析器的情况下设立filter。以下示例使用分析级别为 0 的过滤。
db.setProfilingLevel( 0, { filter: { op: "query", millis: { $gt: 2000 } } } )
由于分析级别为 0，分析器已禁用，因此不会将匹配的操作记录到分析器集合。过滤器仍然应用于诊断日志。
该操作返回一个包含先前设置值的文档。
要查看当前分析级别，请参阅 db.getProfilingStatus()。
取消设置筛选器
要清除分析筛选器，请运行带有 filter: "unset" 选项的 db.setProfilingLevel()。
db.setProfilingLevel( 1, { filter: "unset" } )
该操作返回一个包含先前设置值的文档。
要查看当前分析级别，请参阅 db.getProfilingStatus()。