公共预览版:请在以下位置提供反馈:返回Performance Advisor和查询分析器识别出的慢速查询的日志行。
Performance Advisor监控MongoDB认为速度缓慢的查询,并建议新索引以提高查询性能。MongoDB Cloud 根据集群上的平均操作时间设置慢查询阈值。这将启用与工作负载相关的建议。要使用此资源,请求的API密钥必须具有任何项目数据访问角色或项目可观察性查看者角色。
1此命令是自动生成的,对应于:1 和Atlas API端点 https://www.mongodb.com/zh-cn/docs/atlas/reference/api-resources-spec/v2 /# 标签/Performance- Advisor/operation/listSlowQueries。
有关更多信息和示例,请参阅上面链接的参考API文档。
语法
atlas api performanceAdvisor listSlowQueries [options]
选项
名称 | 类型 | 必需 | 说明 |
---|---|---|---|
--duration | int | false | 查询在集群的托管命名空间中查找慢查询的时间长度。此参数以毫秒为单位。
|
--envelope | envelope | false | 指示应用程序是否将响应包装在信封JSON对象中的标志。某些API客户端无法访问权限HTTP响应标头或状态代码。要修复此问题,请在查询中设立Envelope=true。返回结果列表的端点将结果对象用作信封。应用程序将状态参数添加到响应正文中。 |
--groupId | 字符串 | true | 用于标识项目的唯一 24-十六进制数字字符串。 使用 [/groups](# 标签/Projects/operation/listProjects) 端点检索身份验证的用户有权访问权限的所有项目。 注意:群组和项目是同义词。您的群组 ID 与项目 ID 相同。对于现有群组,群组/项目 ID 保持不变。资源和相应的端点使用“群组”一词。 |
-h,--help | false | listSlowQueries 的帮助 | |
--nLogs | int | false | 日志中要返回的最大行数。 |
--namespaces | . | false | 从中检索慢速查询的命名空间。命名空间由一个数据库和一个集合资源组成,写作 .: |
--output | 字符串 | false | 首选API格式,可以是 ["JSON", go-template] 此值默认为 "JSON"。 |
--output-file | 字符串 | false | 要将API输出写入其中的文件。 当端点的输出为二进制(例如:gzip)且命令未通过管道传输(例如: Atlas command > out.zip)时,需要使用此标志 |
--pretty | false | 指示响应正文是否应位于 <a href=" https://en.wikipedia.org/wiki/Prettyprint "target="_blank" rel="noopener noreferrer">pretty-print</a> 格式。 | |
--processId | mongod | true | 为MongoDB进程提供服务的托管和端口的组合。托管必须是运行MongoDB进程(mongod或 |
--since | int | false | 查询检索慢速查询的日期和时间。此参数以自 [UNIX 纪元](https://en.wikipedia.org/wiki/Unix_time) 以来经过的毫秒数表示其值。
|
--version | 字符串 | false | 进行API调用时要使用的API版本 [选项:"2023-01-01"],默认为最新版本或配置文件 api_version 配置值(如果设立了此值),默认为 "2023-01-01"。 |
继承选项
名称 | 类型 | 必需 | 说明 |
---|---|---|---|
-P, --profile | 字符串 | false | 要从您的配置文件中使用的配置文件的名称。要学习;了解Atlas CLI配置文件,请参阅 https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. |
示例
运行以下命令。
atlas api performanceAdvisor listSlowQueries --version 2023-01-01 --envelope false --groupId 32b6e34b3d91647abb20e7b8 --pretty false --processId [processId]