文档菜单
文档首页
/
MongoDB 数据库工具
/

mongotop 示例

本页内容

  • 示例
  • 了解更多

此页面展示了以下示例mongotop.

从系统命令行运行 mongotop,而不是从mongo 壳。

默认情况下,mongotop连接到本地主机上的27017端口的MongoDB实例。但是,mongotop也可以选择连接到远程mongod实例。请参阅mongotop选项获取更多信息。

要强制mongotop返回更频繁,请在命令末尾指定一个数字,单位为秒。在本例中,mongotop将每15秒返回一次。

mongotop 15

此命令产生以下输出

2019-04-29T15:35:27.785-0400 connected to: 127.0.0.1
ns total read write 2019-04-29T15:35:57-04:00
admin.system.roles 0ms 0ms 0ms
admin.system.users 0ms 0ms 0ms
admin.system.version 0ms 0ms 0ms
config.system.sessions 0ms 0ms 0ms
local.startup_log 0ms 0ms 0ms
local.system.replset 0ms 0ms 0ms

要每5分钟返回一次mongotop报告,请使用以下命令

mongotop 300

版本100.1.0.

要连接到一个已配置为通过 MongoDB Atlas 集群,该集群支持通过 AWS IAM 凭据 进行身份验证,请为 mongotop 提供一个类似以下 连接字符串

mongotop 'mongodb+srv://<aws access key id>:<aws secret access key>@cluster0.example.com/testdb?authSource=$external&authMechanism=MONGODB-AWS' <other options>

使用 AWS IAM 凭据以这种方式连接到 Atlas 使用 MONGODB-AWS 身份验证机制$external authSource,如下例所示。

如果使用 AWS 会话令牌,也需要提供相应的 AWS_SESSION_TOKEN authMechanismProperties 值,如下所示

mongotop 'mongodb+srv://<aws access key id>:<aws secret access key>@cluster0.example.com/testdb?authSource=$external&authMechanism=MONGODB-AWS&authMechanismProperties=AWS_SESSION_TOKEN:<aws session token>' <other options>

注意

如果 AWS 访问密钥 ID、秘密访问密钥或会话令牌包含以下字符

: / ? # [ ] @

这些字符必须使用百分编码进行转换。

或者,可以使用--username--password--awsSessionToken选项在连接字符串外部提供AWS访问密钥ID、秘密访问密钥和可选会话令牌,如下所示

mongotop 'mongodb+srv://cluster0.example.com/testdb?authSource=$external&authMechanism=MONGODB-AWS' --username <aws access key id> --password <aws secret access key> --awsSessionToken <aws session token> <other options>

当作为命令行参数提供时,这三个选项不需要进行百分编码。

您还可以使用标准的AWS IAM环境变量来设置这些凭据。mongotop在您使用MONGODB-AWS 认证机制时检查以下环境变量:

  • AWS_ACCESS_KEY_ID

  • AWS_SECRET_ACCESS_KEY

  • AWS_SESSION_TOKEN

如果已设置,则无需在连接字符串或通过其显式选项中指定这些凭据。

注意

如果您选择使用AWS环境变量来指定这些值,则不能与这些凭据的对应显式或连接字符串选项混合使用。要么使用访问密钥ID和秘密访问密钥(如果使用会话令牌),要么使用显式或连接字符串选项分别指定这些值。

以下示例在bash shell中设置这些环境变量

export AWS_ACCESS_KEY_ID='<aws access key id>'
export AWS_SECRET_ACCESS_KEY='<aws secret access key>'
export AWS_SESSION_TOKEN='<aws session token>'

设置其他shell中环境变量的语法将不同。有关更多信息,请咨询您平台上的文档。

您可以使用以下命令验证这些环境变量已设置

env | grep AWS

设置后,以下示例使用这些环境变量连接到MongoDB Atlas集群

mongotop 'mongodb+srv://cluster0.example.com/testdb?authSource=$external&authMechanism=MONGODB-AWS' <other options>

返回

行为

本页内容