/ /

mongotop 示例

本页显示 mongotop 的示例。

从系统命令行运行 mongotop，而非 mongo shell。

示例

默认情况下，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

使用 AWS IAM 档案连接到 MongoDB Atlas 集群

100.1.0版本新增。：

要连接到已配置为支持通过Amazon Web Services IAM凭证进行身份验证的MongoDB Atlas 群集，请向connection string 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 authentication mechanism 和 $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>

当作为命令行参数提供时，这三个选项无需进行百分号编码。

您还可以使用标准Amazon Web Services IAM 环境变量在您的平台上设立这些凭证。当您使用 MONGODB-AWS authentication mechanism: 时，mongotop 会检查以下环境变量：

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>

了解详情

后退

行为

来年

mongofiles