mongostat

概要¶

该mongostat实用程序提供了当前正在运行mongod 或mongos 实例的状态的快速概述。mongostat在功能上类似于UNIX / Linux文件系统实用程序vmstat，但是提供有关mongod和mongos实例的数据 。

运行mongostat系统命令行，而不是mongo外壳。

可用性¶

该mongostat工具是MongoDB工具包的一部分。请查阅所用平台的 安装指南，以获取有关如何在MongoDB安装过程中安装工具包的说明。

该工具包也可以从 MongoDB下载中心获得，可以单独tools下载，也可以包含在 TGZ或ZIP下载中，具体取决于平台。在Windows上，MSI安装程序包括所有工具作为默认安装的一部分。

所需的访问权限¶

为了连接到mongod使用--auth选项强制执行授权的，请指定 --username和--password选项，并且连接用户必须serverStatus对集群资源具有 特权操作。

内置角色clusterMonitor提供此特权以及其他特权。要创建仅具有运行特权的角色mongostat，请参阅创建要运行的角色mongostat。

行为¶

选项¶

mongostat¶

--help¶

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

--verbose, -v¶

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

--version¶

返回mongostat版本号。

--uri=<connectionString>¶

3.4.6版中的新功能。

指定可解析的URI 连接字符串（用引号引起来）以连接到MongoDB部署。

复制

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

有关连接字符串的组成部分的信息，请参阅“ 连接字符串URI格式”文档。

注意

对于TLS / SSL选项，请使用命令行选项代替TLS / SSL的 URI选项（从4.2开始可用）。

重要

以下命令行选项不能与--urioption 一起使用：

• --host
• --port
• --username
• --password（如果 URI连接字符串还包含密码）
• --authenticationDatabase
• --authenticationMechanism

而是将这些选项指定为--uri 连接字符串的一部分。

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

默认值：本地主机：27017

指定mongod要连接的主机名称。默认情况下，mongostat尝试连接到端口号为localhost上运行的MongoDB实例27017。

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

复制

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

如果使用IPv6并使用<address>:<port>格式，则必须将地址和端口组合的一部分括在方括号（例如[<address>]）中。

注意

您不能同时指定--host和--uri。

--port=<port>¶

默认值：27017

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

注意

您不能同时指定--port和--uri。

--ipv6¶

在3.0版中删除。

启用IPv6支持，并允许mongostat使用IPv6网络连接到MongoDB实例。在MongoDB 3.0之前，您必须指定--ipv6使用IPv6。在MongoDB 3.0和更高版本中，始终启用IPv6。

--ssl¶

启用与mongod或mongos已启用TLS / SSL支持的连接。

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

--sslCAFile=<filename>¶

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

从3.4版开始，如果未指定--tlsCAFile/ net.tls.CAFile（或它们的别名--sslCAFile/ net.ssl.CAFile），并且您没有使用x.509身份验证，则在连接到启用TLS / SSL的服务器时将使用系统范围的CA证书存储。

要使用x.509身份验证，--tlsCAFile或者net.tls.CAFile 必须指定，除非使用--tlsCertificateSelector或 --net.tls.certificateSelector。或者，如果使用ssl别名， --sslCAFile或net.ssl.CAFile必须指定，除非使用 --sslCertificateSelector或net.ssl.certificateSelector。

警告

版本3.2及更早版本：对于TLS / SSL连接（--ssl），以 mongod和mongos，如果mongostat没有运行 --sslCAFile，mongostat不会尝试验证服务器证书。这会造成过期mongod和mongos证书以及伪装成有效mongod或 mongos实例的外部进程的漏洞。如果可能发生入侵，请确保始终指定CA文件来验证服务器证书。

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

--sslPEMKeyFile=<filename>¶

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

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

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

--sslPEMKeyPassword=<value>¶

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

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

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

--sslCRLFile=<filename>¶

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

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

--sslAllowInvalidCertificates¶

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

从MongoDB 4.0开始，如果在使用x.509身份验证时指定 --sslAllowInvalidCertificates或 （或在MongoDB 4.2中为别名或 ），则无效的证书仅足以建立TLS / SSL连接，但不足以进行身份验证。net.ssl.allowInvalidCertificates: true--tlsAllowInvalidateCertificatesnet.tls.allowInvalidCertificates: true

警告

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

如果mongoShell（和其他 MongoDB Tools）与该--sslAllowInvalidCertificates选项一起运行 ，则 mongoShell（和其他 MongoDB Tools）将不会尝试验证服务器证书。这会造成过期mongod和mongos证书以及伪装成有效mongod或mongos实例的外部进程 的漏洞 。如果仅需要禁用TLS / SSL证书中的主机名验证，请参阅--sslAllowInvalidHostnames。

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

--sslAllowInvalidHostnames¶

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

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

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

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

注意

您不能同时指定--username和--uri。

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

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

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

注意

您不能同时指定--password和--uri。

--authenticationDatabase=<dbname>¶

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

注意

您不能同时指定--authenticationDatabase和--uri。

--authenticationDatabase需要mongod 和mongos使用实例验证。

--authenticationMechanism=<name>¶

默认值：SCRAM-SHA-1

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

在版本4.0中进行了更改： MongoDB删除了对不赞成使用的MongoDB Challenge-Response（MONGODB-CR）身份验证机制的支持。

MongoDB使用SHA-256哈希函数（SCRAM-SHA-256）添加了对SCRAM机制的支持。

值	描述
SCRAM-SHA-1	使用SHA-1哈希函数的RFC 5802标准咸化挑战响应身份验证机制。
SCRAM-SHA-256	使用SHA-256哈希函数的RFC 7677标准咸化挑战响应身份验证机制。 要求featureCompatibilityVersion设置为4.0。 版本4.0中的新功能。
MONGODB-X509	MongoDB TLS / SSL证书认证。
GSSAPI（Kerberos）	使用Kerberos的外部身份验证。此机制仅在MongoDB Enterprise中可用。
普通（LDAP SASL）	使用LDAP的外部身份验证。您还可以PLAIN 用于验证数据库内用户。PLAIN以纯文本形式传输密码。此机制仅在MongoDB Enterprise中可用 。

注意

您不能同时指定--authenticationMechanism和--uri。

--gssapiServiceName=<string>¶

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

此选项仅在MongoDB Enterprise中可用。

--gssapiHostName=<string>¶

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

此选项仅在MongoDB Enterprise中可用。

--humanReadable=<boolean>¶

默认值：true

3.4版的新功能。

设为时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>¶

3.4版的新功能。

指定时，mongostat在mongostat输出中仅包括指定的字段。

使用点符号指定 ，如中所示 。serverStatus fieldsmetrics.document.inserted

要为字段指定自定义名称，请使用<field>=<customName>，如下所示：

复制

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

-o 支持以下方法来修改为给定serverStatus字段返回的信息：

rate（）¶

使用.rate()以查看每秒其中serverStatus场从改变速率mongostat呼叫到呼叫。

更改与.rate现场的视野率（）演示了如何使用 mongostat与-o和.rate() 方法。

diff（）¶

使用.diff()到视图多少serverStatus领域已自上次改变mongostat通话。呼叫之间的间隔由指定<sleeptime>。

使用.diff（）进行的视场更改说明了 mongostatwith-o和.diff() 方法的使用。

mongostat支持指定任一 -o或-O：你不能包括两个选项。

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

-O=<field list>¶

3.4版的新功能。

指定时，mongostatserverStatus在默认mongostat输出之后包括指定的 字段。

使用点符号指定 ，如中所示 。serverStatus fieldsmetrics.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。

--http¶

配置mongostat为使用HTTP接口而不是原始数据库连接来收集数据。

在版本3.6中进行了更改： MongoDB 3.6删除了MongoDB弃用的HTTP接口和REST API。

--all¶

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

--json¶

以JSON格式返回mongostat的输出。

--interactive¶

3.4版的新功能。

显示