对于 AI 代理：可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单
Docs 主页
/
工具
/
MongoDB 数据库工具
Docs 主页
/
工具
/
MongoDB 数据库工具
Docs 主页
/
工具
/
MongoDB 数据库工具

mongostat

本文档适用于 mongostat 的 100.19.0 版本。

Synopsis

mongostat 是一个命令行工具，可快速概览当前正在运行的mongod 或mongos 实例的状态。使用mongostat 帮助识别系统瓶颈。

mongostat 在功能上与 UNIX/Linux 文件系统实用程序 vmstat 类似，但提供了有关 mongod 和 mongos 实例的数据。

mongostat从系统命令行行运行 ，而不是mongo Shell。

语法

mongostat 事务语法：

mongostat <options> <connection-string> <polling interval in seconds>

选项

--help

返回有关 mongostat 的选项和使用的信息。

--verbose, -v

增加标准输出或日志文件中返回的内部报告数量。通过包括多个 -v 选项来提高详细程度，（例如 -vvvvv。）

--version

返回 mongostat 版本号。

--config=<filename>

100.3.0版本新增。

指定 YAML 配置文件的完整路径，该文件包含以下 mongostat 选项的敏感值：

除通过密码提示来指定密码之外，这是为 mongostat 指定密码的另一推荐方法。您可以在文件中使用任何参数的组合。

配置文件采用以下形式：

password: <password>
uri: mongodb://mongodb0.example.com:27017
sslPEMKeyPassword: <password>

如果您指定了 password 选项但未指定 uri，则可以使用 mongostat 命令行选项指定连接字符串的其他组件，例如 --username 和 --host。

请务必使用相应的文件系统权限保护此文件。

重要

使用 --config 选项时，请注意以下限制和行为：

  • 如果您提供 password 字段，并在 uri 字段中提供一个与密码冲突的连接字符串，则 mongorestore 会抛出错误。

  • 如果您使用 --config 指定配置文件，并使用 --password、--uri 或 --sslPEMKeyPassword mongostat命令行选项，则命令行选项将覆盖相应的配置文件选项。

--uri=<connectionString>

指定 MongoDB 部署的可解析 URI 连接字符串（用引号括起）：

--uri="mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][/[database][?options]]"

从100.0 的mongostat 版本开始，也可以将连接字符串作为位置参数提供，而不使用--uri 选项：

mongostat mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][/[database][?options]]

作为位置参数，可以在命令行上的任何位置指定连接字符串，前提是它以 mongodb:// 或 mongodb+srv:// 开头。例如：

mongostat --username joe --password secret1 mongodb://mongodb0.example.com:27017 --ssl

只能提供一个连接字符串。无论是使用 --uri 选项还是作为位置参数，尝试纳入多个连接字符串都会导致错误。

有关连接字符串的组件信息，请参阅连接字符串 URI 格式文档。

注意

connection string 中的某些组件也可以使用各自的显式命令行选项来指定，例如 --username 和 --password。在提供连接字符串的同时，使用显式选项并指定冲突信息会导致错误。

注意

如果在Ubuntu 上使用mongostat18.04 ，则在使用带有 选项的cannot unmarshal DNS SRV 连接字符串（采用mongodb+srv:// 形式）时，您可能会遇到--uri 错误消息。如果是这样，请改用以下选项之一：

警告

在某些系统上，使用 --uri 选项在连接字符串中提供的密码可能会对其他用户调用的系统状态程序（例如 ps）可见。请考虑：

  • 在连接字符串中省略密码，接收交互式密码提示，或者

  • 使用 --config 选项指定包含密码的配置文件。

--host=<hostname><:port>, -h=<hostname><:port>

默认：localhost:27017

指定 MongoDB 部署的可解析主机名。默认情况下，mongostat 尝试连接到在本地主机端口号 27017 上运行的 MongoDB 实例。

要连接到副本集，您可以指定要报告的一个或多个副本集成员，如下所示（另请参阅 --discover 标志）：

--host=<hostname1><:port>,<hostname2><:port>,<...>

如果您使用 IPv6 并采用 <address>:<port> 格式，则须将地址与端口的组合部分用方括号括起（即 [<address>]）。

或者，也可直接在 URI connection string 中指定主机名。在使用 --host 的同时提供连接字符串并指定冲突信息将导致错误。

--port=<port>

默认值：27017

指定 MongoDB 实例侦听客户端连接的 TCP 端口。

或者，也可以直接在 URI connection string 中指定端口。在提供连接字符串的同时使用 --port 并指定冲突信息将导致错误。

--ssl

允许连接到已启用 TLS/SSL支持的mongodmongos 或 。

或者，也可以直接在URI connection string 中配置 TLS/SSL 支持。在提供连接字符串的同时使用 --ssl 并指定冲突信息将导致错误。

有关 TLS/SSL 和 MongoDB 的更多信息，请参阅为 TLS/SSL 配置 mongod 和 mongos 和客户端的 TLS/SSL 配置。

--sslCAFile=<filename>

指定包含来自证书颁发机构的根证书链的 .pem 文件。使用相对或绝对路径指定 .pem 文件的文件名。

或者，也可以直接在 URI connection string 中指定 .pem 文件。在提供连接字符串的同时使用 --sslCAFile 并指定冲突信息将导致错误。

有关 TLS/SSL 和 MongoDB 的更多信息，请参阅为 TLS/SSL 配置 mongod 和 mongos 和客户端的 TLS/SSL 配置。

--sslPEMKeyFile=<filename>

指定同时包含 TLS/SSL 证书和密钥的 .pem 文件。使用相对或绝对路径指定 .pem 文件的文件名。

使用 --ssl 选项连接到已启用 CAFile 且未启用 allowConnectionsWithoutCertificates 的 mongod 或 mongos 时，需要使用此选项。

或者，也可以直接在 URI connection string 中指定 .pem 文件。在提供连接字符串的同时使用 --sslPEMKeyFile 并指定冲突信息将导致错误。

有关 TLS/SSL 和 MongoDB 的更多信息，请参阅为 TLS/SSL 配置 mongod 和 mongos 和客户端的 TLS/SSL 配置。

--sslPEMKeyPassword=<value>

指定用于解密证书密钥文件的密码（即 ）。仅当证书密钥文件已加密时才使用--sslPEMKeyFile --sslPEMKeyPassword选项。在所有情况下，mongostat 都会从所有日志记录和报告输出中编辑密码。

如果 PEM文件中的私钥已加密并且您未指定--sslPEMKeyPassword 选项，则mongostat 将提示输入密码。请参阅 TLS/SSL 证书密码。

或者，也可以直接在 URI connection string 中指定密码。在提供连接字符串的同时使用 --sslPEMKeyPassword 并指定冲突信息将导致错误。

有关 TLS/SSL 和 MongoDB 的更多信息，请参阅为 TLS/SSL 配置 mongod 和 mongos 和客户端的 TLS/SSL 配置。

警告

在某些系统上，直接使用 --sslPEMKeyPassword 选项提供的密码，可能会被其他用户调用的系统状态程序（如 ps ）探测到。可以考虑使用 --config 选项，指定一个包含密码的配置文件。

--sslCRLFile=<filename>

指定包含证书吊销列表的 .pem 文件。使用相对或绝对路径指定 .pem 文件的文件名。

有关 TLS/SSL 和 MongoDB 的更多信息，请参阅为 TLS/SSL 配置 mongod 和 mongos 和客户端的 TLS/SSL 配置。

--sslAllowInvalidCertificates

绕过对服务器证书的验证检查并允许使用无效证书。使用 设置时，allowInvalidCertificates MongoDB将使用无效证书记录为警告。

警告

尽管可用，但请尽可能避免使用 --sslAllowInvalidCertificates 选项。如果需要使用 --sslAllowInvalidCertificates，请仅在不可能入侵的系统上使用该选项。

mongod在不验证服务器证书的情况下连接到 或 实例存在潜在的安全风险。如果只需禁用 TLS/SSL 证书中的主机名验证，请参阅mongos--sslAllowInvalidHostnames 。

或者，也可以直接在 URI connection string 中禁用证书验证。在提供连接字符串的同时使用 --sslAllowInvalidCertificates 并指定冲突信息将导致错误。

有关 TLS/SSL 和 MongoDB 的更多信息，请参阅为 TLS/SSL 配置 mongod 和 mongos 和客户端的 TLS/SSL 配置。

--sslAllowInvalidHostnames

禁用 TLS/SSL 证书中的主机名验证。即使证书中的主机名与指定的主机名不匹配，也支持 mongostat 连接到 MongoDB 实例。

或者，也可以直接在 URI connection string 中禁用主机名验证。在提供连接字符串的同时使用 --sslAllowInvalidHostnames 并指定冲突信息将导致错误。

有关 TLS/SSL 和 MongoDB 的更多信息，请参阅为 TLS/SSL 配置 mongod 和 mongos 和客户端的 TLS/SSL 配置。

--username=<username>, -u=<username>

指定用户名，用于对使用身份验证的MongoDB 数据库进行身份验证。与--password 和--authenticationDatabase 选项结合使用。

或者，也可直接在 URI connection string 中指定用户名。在使用 --username 的同时提供连接字符串并指定冲突信息将导致错误。

如果使用 连接到MongoDB Atlas MONGODB-AWSauthentication mechanism群集，您可以在以下位置指定您的 AWS访问权限密钥ID ：

请参阅使用 AWS IAM 凭据连接到 MongoDB Atlas 集群，了解每个凭据的示例。

--password=<password>, -p=<password>

指定密码，用于对使用身份验证的 MongoDB--authenticationDatabase--username 数据库进行身份验证。与 和 选项结合使用。

要提示用户输入密码，请传递不带 的 选项，或指定空字符串作为--username --password--password值，如--password="" 所示。

或者，也可以直接在 URI connection string 中指定密码。在提供连接字符串的同时使用 --password 并指定冲突信息将导致错误。

如果使用 连接到MongoDB Atlas MONGODB-AWSauthentication mechanism群集，您可以在以下位置指定 AWS 秘密访问权限密钥：

请参阅使用 AWS IAM 凭据连接到 MongoDB Atlas 集群，了解每个凭据的示例。

警告

在某些系统上，直接使用 --password 选项提供的密码，可能会被其他用户调用的系统状态程序（如 ps）探测到。请考虑：

  • 省略 --password 选项以接收交互式密码提示，或

  • 使用 --config 选项指定包含密码的配置文件。

--awsSessionToken=<AWS Session Token>

如果使用 连接到MongoDB Atlas 群集，并且除了MONGODB-AWSauthentication mechanism AWS访问权限密钥ID和秘密访问权限密钥之外还使用会话令牌，则可以在以下位置指定 AWS 会话令牌：

请参阅使用 AWS IAM 凭据连接到 MongoDB Atlas 集群，了解每个凭据的示例。

仅在使用 MONGODB-AWS authentication mechanism 时有效。

--authenticationDatabase=<dbname>

指定已在其中创建指定--username 的身份验证数据库。请参阅身份验证数据库。

对于在自托管部署上使用身份验证的--authenticationDatabasemongos 和mongod 实例，需要 。

如果您使用 GSSAPI (Kerberos)、PLAIN (LDAP SASL) 或 MONGODB-AWS authentication mechanisms，则须将 --authenticationDatabase 设为 $external。

或者，也可以直接在 URI connection string 中指定身份验证数据库。在提供连接字符串的同时使用 --authenticationDatabase 并指定冲突信息，将导致错误。

--authenticationMechanism=<name>

默认值：SCRAM-SHA-1

指定mongostat 实例用于向mongod 或mongos 进行身份验证的身份验证机制。

在版本 100.1.0 中进行了更改：

从版本 100.1.0 开始，mongostat 添加了在连接 MongoDB Atlas 集群时对 MONGODB-AWS 身份验证机制的支持。

值
说明

SCRAM-SHA-1

5802使用 SHA-1 哈希函数的 RFC 标准 Salted 挑战响应身份验证机制。

SCRAM-SHA-256

7677使用 SHA-256 哈希函数的 RFC 标准 Salted 挑战响应身份验证机制。

需将 featureCompatibilityVersion 设为 4.0。

MONGODB-X.509

MongoDB TLS/SSL 证书身份验证。

MONGODB-AWS

使用 AWS IAM 凭据进行外部身份验证，用于连接到 MongoDB Atlas 集群。请参阅使用 AWS IAM 凭证连接到 MongoDB Atlas 集群。

100.1.0版本新增。

GSSAPI (Kerberos)

使用 Kerberos 的外部身份验证。此机制仅在 MongoDB Enterprise 中可用。

普通版 (LDAP SASL)

使用 LDAP 进行外部身份验证。您也可使用 PLAIN 对数据库内用户进行身份验证。PLAIN 以纯文本形式传输密码。此机制仅在 MongoDB Enterprise 中可用。

或者，也可以直接在 URI connection string 中指定身份验证机制。在提供连接字符串的同时使用 --authenticationMechanism 并指定冲突信息，将导致错误。

--gssapiServiceName=<string>

使用 GSSAPI/ Kerberos指定服务名称。仅当服务不使用默认名称 mongodb时才需要。

此选项仅在 MongoDB Enterprise 中可用。

--gssapiHostName=<string>

使用 GSSAPI/Kerberos 指定服务的主机名。仅当机器的主机名与 DNS 解析的主机名不匹配时才需要。

此选项仅在 MongoDB Enterprise 中可用。

--humanReadable=<boolean>

默认值：true

当为 true 时，mongostat 会格式化日期和数量值以便于读取，如以下示例输出所示：

insert query update delete getmore command dirty used flushes vsize  res qrw arw net_in net_out conn                time
   991    *0     *0     *0       0     2|0  3.4% 4.5%       0 2.90G 297M 0|0 0|0  12.9m   84.2k    2 Oct  6 09:45:37.478
   989    *0     *0     *0       0     2|0  3.6% 4.7%       0 2.91G 310M 0|0 0|0  12.9m   84.1k    2 Oct  6 09:45:38.476
   988    *0     *0     *0       0     1|0  3.7% 4.8%       0 2.92G 323M 0|0 0|0  12.8m   83.8k    2 Oct  6 09:45:39.481
   976    *0     *0     *0       0     2|0  3.9% 5.0%       0 2.94G 335M 0|0 0|0  12.7m   83.7k    2 Oct  6 09:45:40.476

为 false 时，mongostat 将返回原始数据，如以下示例输出所示：

insert query update delete getmore command dirty used flushes      vsize       res qrw arw   net_in net_out conn                      time
   992    *0     *0     *0       0     2|0   1.3  2.4       0 2941255680 149946368 0|0 0|0 12913607   84271    2 2016-10-06T09:45:25-04:00
   989    *0     *0     *0       0     1|0   1.5  2.6       0 2974810112 163577856 0|0 0|0 12873225   84087    2 2016-10-06T09:45:26-04:00
   996    *0     *0     *0       0     1|0   1.6  2.8       0 2972712960 177209344 0|0 0|0 12955423   84345    2 2016-10-06T09:45:27-04:00
   987    *0     *0     *0       0     1|0   1.8  2.9       0 2989490176 190840832 0|0 0|0 12861852   84008    2 2016-10-06T09:45:28-04:00
-o=<field list>

当使用-o 指定输出字段时，mongostat 输出中仅包含指定的字段。

使用点表示法指定serverStatus fields ，如metrics.document.inserted 。

自定义字段名可以包含空格。如果包含空格，不要在字段名称前后再添加引号。要为字段指定自定义名称，请使用 <field>=<customName>，如下所示：

mongostat -o='host=H,time=T,version=MongoDB Version'

-o 支持以下方法来修改返回的给定服务器状态字段信息：

.rate()

使用 查看.rate() serverStatus字段在不同mongostat 调用中的每秒更改率。

查看字段的更改率 .rate()说明了如何将mongostat -o与 和.rate() 方法结合使用。

.diff()

使用.diff() 查看自上次mongostat 调用以来 serverStatus字段的更改程度。调用之间的间隔由<sleeptime> 指定。

使用以下选项查看字段更改 .diff()说明了如何将mongostat -o与 和.diff() 方法结合使用。

mongostat 支持指定 -o或-O ：不能同时包含两个选项。

mongostat有关 的示例，请参阅指定-o 输出字段。

-O=<field list>

指定后， 会在默认mongostat serverStatusmongostat输出之后包含指定的 字段。

使用点表示法指定serverStatus fields ，如metrics.document.inserted 。

自定义字段名可以包含空格。如果包含空格，不要在字段名称前后再添加引号。要为字段指定自定义名称，请使用 <field>=<customName>，如下所示：

mongostat -O=host=H,time=T

mongostat 支持指定 -O或-o ：不能同时包含两个选项。

mongostat有关 的示例，请参阅向-O 输出添加字段。

--noheaders

禁用列名或字段名的输出。

--rowcount=<number>, -n=<number>

控制要输出的行数。与 sleeptime 参数结合使用可控制 mongostat 操作的持续时间。

--rowcount除非指定 ，否则mongostat 将返回无限数量的行（例如 的值）。0

--discover

发现并报告副本集或分片集群所有成员的统计信息。当连接到副本集的任何节点时，--discover 副本集的所有非隐藏节点。连接到mongos 时，mongostat 将从集群中的所有分片返回数据。如果副本集在分片集群中提供了分片，则mongostat 将报告该副本集的非隐藏成员。

mongostat --host选项不是必需的，但在这种情况下可能有用。

使用--discover 运行时，mongostat 遵循--rowcount 。

--all

配置 mongostat 以返回所有可选的字段。

--json

以 JSON 格式返回 mongostat 的输出结果。

--interactive

在交互式非滚动界面显示 mongostat 输出，而不是默认的滚动输出。

--interactive不可与--json 选项一起使用。

有关--interactive 的示例，请参阅：在交互式界面中查看统计信息。

<sleeptime>

默认值：1

最后一个 mongostat 参数表示 mongostat 在两次调用之间等待的时长（以秒为单位）。默认情况下，mongostat 每秒返回一次调用。

mongostat 返回反映1秒内操作的值。 如果<sleeptime>的值大于1 ， mongostat会对数据求平均值以反映每秒的平均操作数。

字段

mongostat 返回反映1秒内操作的值。 当mongostat <sleeptime>的值大于1时， mongostat会对统计数据求平均值以反映每秒的平均操作数。

mongostat 输出以下字段：

inserts

每秒插入数据库的对象数量。如果后面有星号（例如 *)，数据指的是复制操作。

query

每秒查询操作数。

update

每秒更新操作数。

delete

每秒删除操作数。

getmore

get more（即，游标批处理）操作的数量。

command

每秒的命令数。在从从节点(secondary nodemongostat from replica set)系统上， 以 命令的形式表示由管字符分隔的两个值（例如| local|replicated）。

flushes

对于WiredTiger存储引擎， flushes是指在每个轮询间隔之间触发的WiredTiger检查点的数量。

dirty

仅适用于WiredTiger存储引擎。 WiredTiger缓存包含脏数据字节的百分比，计算公式为wiredTiger.cache.tracked dirty bytes in the cache /wiredTiger.cache.maximum bytes configured 。

used

仅适用于WiredTiger存储引擎。使用中的WiredTiger缓存百分比，计算公式为 /wiredTiger.cache.bytes currently in the cachewiredTiger.cache.maximum bytes configured 。

vsize

上次调用 mongostat 时进程所用的虚拟内存大小（以 MB 为单位）。

res

上次调用 mongostat 时进程所用的常驻内存大小（以 MB 为单位）。

locked

处于全局写锁状态的时间百分比。仅当 mongostat 针对 3.0 之前的 MongoDB 实例版本运行时才会出现。

qr

等待从 MongoDB 实例读取数据的客户端队列的长度。

qw

等待从 MongoDB 实例写入数据的客户端队列的长度。

ar

正在执行读取操作的活动客户端数量。

aw

执行写入操作的活动客户端数。

netIn

MongoDB 实例接收的网络流量（以 B 为单位）。

这包括来自 mongostat 本身的流量。

netOut

MongoDB 实例发送的网络流量（以 B 为单位）。

这包括来自 mongostat 本身的流量。

conn

打开的连接总数。

set

副本集的名称（如果适用）。

repl

成员的复制状态。

值
复制类型

PRI

主节点

SEC

从节点

REC

恢复

UNK

未知

RTR

mongos 进程（“路由器”）

ARB

投票节点

更多信息

有关监控 MongoDB 的更多信息，请参阅 针对 MongoDB 的监控。

有关其他 MongoDB 状态输出的更多背景信息，请参阅：

有关提供 MongoDB 指标的其他实用程序，请参阅 mongotop。

了解详情

后退
示例
来年
兼容性与安装
给本页内容打分

在此页面上