Navigation

Alpha Release of MongoDB CLI

This is a pre-release early version of MongoDB CLI. Do not use MongoDB CLI to manage production environments.

mongocli ops-manager measurements disks describe

On this page

The measurements disks describe command lists the available measurements for a specified partition on a specified Ops Manager host. You can get a list of partition names for a host with the measurements disks list command. You can get the host IDs associated with a particular Ops Manager project with the process list command.

Syntax

mongocli ops-manager|om measurements disks describe <hostID> <partition-name>
     --granularity <granularity>
     --period <period>
     --start <start>
     --end <end>
     [--limit <number>]
     [--page <number>]
     [--type <type>]
     [ --profile|-P <profile-name> ]
     [ --projectId <project-ID> ]

Note

Use -h or --help to view the command-line help for this command.

Options

Note

You must specify either:

  • period or
  • start and end.
Option Type Description Required?
<hostID> String The host ID of the server running the MongoDB process. yes
<partition-name> string The name of the disk or partition for which to get available measurements. yes
granularity String

An ISO-8601-formatted time period that specifies the interval between measurement data points. For example, PT1M specifies 1-minute granularity.

The following subset of ISO-8601-formatted time periods are supported:

  • PT1M
  • PT5M
  • PT1H
  • P1D
yes
period String An ISO-8601-formatted time period that specifies the length of time in the past to query. For example, to request the last 36 hours, specify: period=P1DT12H. Mutually exclusive with start and end. yes
start String The time at which to start retrieving measurements, as specified by an ISO-8601 timestamp string. If you specify start, you must also specify end. Mutually exclusive with period. yes
end String The time at which to stop retrieving measurements, as specified by an ISO-8601 timestamp string. If you specify end, you must also specify start. Mutually exclusive with period. yes
type String

Specifies which measurement to return. If type is not specified, all measurements are returned.

You must specify a measurement that is valid for the host. Atlas returns an error if a specified measurement is invalid.

The following measurement values are valid:

  • DISK_PARTITION_IOPS_READ
  • DISK_PARTITION_IOPS_WRITE
  • DISK_PARTITION_IOPS_TOTAL
Measures throughput of I/O operations for the disk partition used for MongoDB.
  • DISK_PARTITION_UTILIZATION
The percentage of time during which requests are being issued to and serviced by the partition. This includes requests from any process, not just MongoDB processes.
  • DISK_PARTITION_LATENCY_READ
  • DISK_PARTITION_LATENCY_WRITE
Measures latency, per operation type, of the disk partition used by MongoDB.
  • DISK_PARTITION_SPACE_FREE
  • DISK_PARTITION_SPACE_USED
  • DISK_PARTITION_SPACE_PERCENT_FREE
  • DISK_PARTITION_SPACE_PERCENT_USED
Measures the free disk space and used disk space on the disk partition used by MongoDB.
no
--limit number Number of items per page. no
--page number Page number no
--profile, -P string Name of the profile where the project ID and the Programmatic API Keys for the project are saved. If omitted, uses the default profile. To learn more about creating a profile, see Configure the MongoDB CLI. no
--projectId string Unique identifier of the project for which to retrieve events. If omitted, uses the project ID listed in the profile. no

Output

The command prints the following fields in JSON format to the terminal if the command succeeds. If the command prints an error, see Troubleshooting for recommended solutions.

The HTTP response returns a JSON document that includes the following objects:

Name Type Description
end string The end of the period for which to retrieve measurements, specified as an ISO-8601 timestamp.
granularity string An ISO-8601-formatted time period that specifies the size of the interval covered by each data point. For example, PT5M specifies a 5-minute granularity.
groupId string The ID of the project that owns the MongoDB process.
hostId string The hostname of the machine running the MongoDB process.
links array An array of documents, representing a link to one or more sub-resources and/or related resources such as list pagination. See Linking for more information.
measurements object array An array of measurements and their data points.
measurements.name string The name of the measurement.
measurements.units string

How the measurement is quantified. Possible units are:

  • PERCENT
  • MILLISECONDS
  • BYTES
  • GIGABYTES
  • BYTES_PER_SECOND
  • MEGABYTES_PER_SECOND
  • GIGABYTES_PER_HOUR
  • SCALAR_PER_SECOND
  • SCALAR
partitionName string Name of the disk or partition to which the measurements pertain.
processId string The hostname and port of the machine running the MongoDB process.
start string The start of the period for which to retrieve measurements, specified as an ISO-8601 timestamp.

Example

The following example uses the mongocli ops-manager measurements disks describe command to retrieve available process measurements for the data partition on a host with ID 5abbc52a0bd66b71d71f5698. The granularity is set to one minute, with a period of one minute. The command uses a profile named egOmProfile where the project ID and the Programmatic API Keys are stored.

mongocli ops-manager measurements disks describe \
  5abbc52a0bd66b71d71f5698 data \
  --granularity PT1M --period PT1M \
  --profile egAtlasProfile

The previous command produces the following output.

{
     "end": "",
     "granularity": "PT1M",
     "groupId": "5dd5a6b6f10fab1d71a58495",
     "hostId": 5abbc52a0bd66b71d71f5698",
     "links": [
     ],
     "measurements": [
             {
                     "name": "DISK_PARTITION_IOPS_READ",
                     "units": "SCALAR_PER_SECOND"
             },
             {
                     "name": "DISK_PARTITION_IOPS_WRITE",
                     "units": "SCALAR_PER_SECOND"
             },
             {
                     "name": "DISK_PARTITION_IOPS_TOTAL",
                     "units": "SCALAR_PER_SECOND"
             },
             {
                     "name": "DISK_PARTITION_UTILIZATION",
                     "units": "PERCENT"
             },
             {
                     "name": "DISK_PARTITION_LATENCY_READ",
                     "units": "MILLISECONDS"
             },
             {
                     "name": "DISK_PARTITION_LATENCY_WRITE",
                     "units": "MILLISECONDS"
             },
             {
                     "name": "DISK_PARTITION_SPACE_FREE",
                     "units": "BYTES"
             },
             {
                     "name": "DISK_PARTITION_SPACE_USED",
                     "units": "BYTES"
             },
             {
                     "name": "DISK_PARTITION_SPACE_PERCENT_FREE",
                     "units": "PERCENT"
             },
             {
                     "name": "DISK_PARTITION_SPACE_PERCENT_USED",
                     "units": "PERCENT"
             }
     ],
     "processId": "myOmHost.example.com:27017",
     "start": "",
     "partitionName": "data"
 }