Devuelve las mediciones de un disco o partición en el host especificado.
Para devolver el nombre de host y el puerto necesarios para este comando, ejecute atlas processes list
Para utilizar este comando, debes autenticarte con una cuenta de usuario, cuenta de servicio o una clave API con el rol de Lectura del proyecto.
Sintaxis
atlas metrics disks describe <hostname:port> <diskName> [options]
Arguments
Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
nombreDeHost:puerto | string | true | Nombre de host y número de puerto de la instancia que ejecuta el proceso MongoDB. |
diskName | string | true | Etiqueta que identifica el disco o la partición del que desea recuperar métricas. |
opciones
Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
--end | string | false | Fecha y hora con formato ISO 8601 que especifica cuándo dejar de recuperar mediciones. No puedes establecer este parámetro y período en la misma solicitud. Mutuamente exclusivo con --period. |
--granularity | string | true | Duración con formato ISO 8601 que especifica el intervalo entre puntos de datos de medición. Solo se admite el siguiente subconjunto de períodos de tiempo con formato ISO 8601: PT10S, PT1M, PT5M, PT1H, P1D. Cuando especificas la granularidad, debes especificar el periodo o el inicio y el final. |
-h, --help | false | ayuda para describir | |
--limit | Int | false | Número de elementos por página de resultados, hasta un máximo de 500. Si tienes más de 500 resultados, especifica la opción --page para cambiar la página de resultados. Este valor es 100 por defecto. |
-o, --output | string | false | Formato de salida. Los valores válidos son json, json-path, go-template o go-template-file. Para ver la salida completa, use la opción -o json. |
--page | Int | false | Número de página que especifica una página de resultados. Este valor es por defecto 1. |
--period | string | false | Período de tiempo con formato ISO 8601 que especifica la duración del tiempo pasado a query. No puede establecer este parámetro y el parámetro de inicio o final en la misma solicitud. Mutuamente excluyente con --start, --end. |
--projectId | string | false | string hexadecimal que identifica el Proyecto a utilizar. Esta opción anula la configuración en el archivo de configuración o la variable de entorno. |
--start | string | false | Fecha y hora en formato ISO 8601 que especifica cuándo comenzar a recuperar las mediciones. No puedes establecer este parámetro y período en la misma solicitud. Mutuamente exclusivo con --period. |
--type | Cuerdas | false | Mediciones a devolver. Esta opción devuelve todas las mediciones por defecto. Los valores válidos incluyen DATABASE_AVERAGE_OBJECT_SIZE, DATABASE_COLLECTION_COUNT, DATABASE_DATA_SIZE, DATABASE_STORAGE_SIZE, DATABASE_INDEX_SIZE, DATABASE_INDEX_COUNT, DATABASE_EXTENT_COUNT, DATABASE_OBJECT_COUNT y DATABASE_VIEW_COUNT |
Opciones heredadas
Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
-P, --profile | string | false | Nombre del perfil que se usará del archivo de configuración. Para aprender sobre los perfiles para Atlas CLI, consulta https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. |
Ejemplos
# Return the JSON-formatted disk metrics from the last 36 hours with 5-minute granularity for the database named testDB in the host atlas-lnmtkm-shard-00-00.ajlj3.mongodb.net:27017 atlas metrics disks describe atlas-lnmtkm-shard-00-00.ajlj3.mongodb.net:27017 testDB --granularity PT1M --period P1DT12H --output json