OS Manuals

/usr/bin/mongostat

Tools for MongoDB

From mongo-tools 100.20.1-r0 (os), captured 2026-11-05 by running mongostat --help (exit 0). permalink

Also provided by 1 other package version
Usage:
  mongostat <options> <connection-string> <polling interval in seconds>

Monitor basic MongoDB server statistics.

Connection strings must begin with mongodb:// or mongodb+srv://.

See http://docs.mongodb.com/database-tools/mongostat/ for more information.

general options:
      --help                                      print usage
      --version                                   print the tool version and
                                                  exit
      --config=                                   path to a configuration file

verbosity options:
  -v, --verbose=<level>                           more detailed log output
                                                  (include multiple times for
                                                  more verbosity, e.g. -vvvvv,
                                                  or specify a numeric value,
                                                  e.g. --verbose=N)
      --quiet                                     hide all log output

connection options:
  -h, --host=<hostname>                           mongodb host(s) to connect to
                                                  (use commas to delimit hosts)
      --port=<port>                               server port (can also use
                                                  --host hostname:port)

ssl options:
      --ssl                                       connect to a mongod or mongos
                                                  that has ssl enabled
      --sslCAFile=<filename>                      the .pem file containing the
                                                  root certificate chain from
                                                  the certificate authority
      --sslPEMKeyFile=<filename>                  the .pem file containing the
                                                  certificate and key
      --sslPEMKeyPassword=<password>              the password to decrypt the
                                                  sslPEMKeyFile, if necessary
      --sslCRLFile=<filename>                     the .pem file containing the
                                                  certificate revocation list
      --sslFIPSMode                               use FIPS mode of the
                                                  installed openssl library
      --tlsInsecure                               bypass the validation for
                                                  server's certificate chain
                                                  and host name

authentication options:
  -u, --username=<username>                       username for authentication
  -p, --password=<password>                       password for authentication
      --authenticationDatabase=<database-name>    database that holds the
                                                  user's credentials
      --authenticationMechanism=<mechanism>       authentication mechanism to
                                                  use
      --awsSessionToken=<aws-session-token>       session token to authenticate
                                                  via AWS IAM

kerberos options:
      --gssapiServiceName=<service-name>          service name to use when
                                                  authenticating using
                                                  GSSAPI/Kerberos (default:
                                                  mongodb)
      --gssapiHostName=<host-name>                hostname to use when
                                                  authenticating using
                                                  GSSAPI/Kerberos (default:
                                                  <remote server's address>)

uri options:
      --uri=mongodb-uri                           mongodb uri connection string

stat options:
  -o=<field>[,<field>]*                           fields to show. For custom
                                                  fields, use dot-syntax to
                                                  index into serverStatus
                                                  output, and optional methods
                                                  .diff() and .rate() e.g.
                                                  metrics.record.moves.diff()
  -O=<field>[,<field>]*                           like -o, but preloaded with
                                                  default fields. Specified
                                                  fields inserted after default
                                                  output
      --humanReadable=                            print sizes and time in human
                                                  readable format (e.g. 1K 234M
                                                  2G). To use the more precise
                                                  machine readable format, use
                                                  --humanReadable=false
                                                  (default: true)
      --noheaders                                 don't output column names
  -n, --rowcount=<count>                          number of stats lines to
                                                  print (0 for indefinite)
      --discover                                  discover nodes and display
                                                  stats for all
      --http                                      use HTTP instead of raw db
                                                  connection
      --all                                       all optional fields
      --json                                      output as JSON rather than a
                                                  formatted table
      --useDeprecatedJsonKeys                     use old key names; only valid
                                                  with the json output option.
  -i, --interactive                               display stats in a
                                                  non-scrolling interface
Options (33)
OptionDescriptionSource
--helpprint usagehelp
--versionprint the tool version and exithelp
--configpath to a configuration filehelp
-v, --verbose levelmore detailed log output (include multiple times for more verbosity, e.g. -vvvvv, or specify a numeric value, e.g. --verbose=N)help
--quiethide all log outputhelp
-h, --host hostnamemongodb host(s) to connect to (use commas to delimit hosts)help
--port portserver port (can also usehelp
--sslconnect to a mongod or mongos that has ssl enabledhelp
--sslCAFile filenamethe .pem file containing the root certificate chain from the certificate authorityhelp
--sslPEMKeyFile filenamethe .pem file containing the certificate and keyhelp
--sslPEMKeyPassword passwordthe password to decrypt the sslPEMKeyFile, if necessaryhelp
--sslCRLFile filenamethe .pem file containing the certificate revocation listhelp
--sslFIPSModeuse FIPS mode of the installed openssl libraryhelp
--tlsInsecurebypass the validation for server's certificate chain and host namehelp
-u, --username usernameusername for authenticationhelp
-p, --password passwordpassword for authenticationhelp
--authenticationDatabase database-namedatabase that holds the user's credentialshelp
--authenticationMechanism mechanismauthentication mechanism to usehelp
--awsSessionToken aws-session-tokensession token to authenticate via AWS IAMhelp
--gssapiServiceName service-nameservice name to use when authenticating using GSSAPI/Kerberos (default: mongodb)help
--gssapiHostName host-namehostname to use when authenticating using GSSAPI/Kerberos (default: <remote server's address>)help
--uri mongodb-urimongodb uri connection stringhelp
-o fieldfields to show.help
-O fieldlike -o, but preloaded with default fields.help
--humanReadableprint sizes and time in human readable format (e.g. 1K 234M 2G).help
--noheadersdon't output column nameshelp
-n, --rowcount countnumber of stats lines to print (0 for indefinite)help
--discoverdiscover nodes and display stats for allhelp
--httpuse HTTP instead of raw db connectionhelp
--allall optional fieldshelp
--jsonoutput as JSON rather than a formatted tablehelp
--useDeprecatedJsonKeysuse old key names;help
-i, --interactivedisplay stats in a non-scrolling interfacehelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.