

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Supervisión de Amazon DocumentDB con CloudWatch
<a name="cloud_watch"></a>

Amazon DocumentDB (compatible con MongoDB) se integra con Amazon CloudWatch para que pueda recopilar y analizar las métricas operativas de sus clústeres. Puede supervisar estas métricas mediante la CloudWatch consola, la consola Amazon DocumentDB, AWS Command Line Interface (AWS CLI) o la CloudWatch API.

CloudWatch también le permite configurar alarmas para que se le notifique si el valor de una métrica supera un umbral que especifique. Incluso puedes configurar Amazon CloudWatch Events para que tome medidas correctivas en caso de que se produzca una infracción. Para obtener más información sobre el uso CloudWatch y las alarmas, consulta la [ CloudWatch documentación de Amazon](https://docs.aws.amazon.com/cloudwatch/index.html). 

**Topics**
+ [Métricas de Amazon DocumentDB](#cloud_watch-metrics_list)
+ [Visualización CloudWatch de datos](#cloud_watch-view_data)
+ [Dimensiones de Amazon DocumentDB](#cloud_watch-metrics_dimensions)
+ [Supervisión de métricas de Opcounter](#cloud_watch-monitoring_opcounters)
+ [Supervisión de conexiones a bases de datos](#cloud_watch-monitoring_connections)

## Métricas de Amazon DocumentDB
<a name="cloud_watch-metrics_list"></a>

Para monitorizar el estado y el rendimiento del clúster e instancias de Amazon DocumentDB, puede consultar las siguientes métricas en la consola de Amazon DocumentDB. 

**nota**  
Las métricas de las siguientes tablas se aplican tanto a los clústeres elásticos como a los basados en instancias.

**Topics**
+ [Métricas de utilización de recursos](#resource-utilization)
+ [Métricas de latencia](#latency-metrics)
+ [NVMe-métricas de instancias respaldadas](#nvme-metrics)
+ [Métricas operativas](#operations-metrics)
+ [Métricas de rendimiento](#throughput-metrics)
+ [Métricas del sistema](#system-metrics)
+ [Métricas de la instancia T3](#t3-instance-metrics)

### Métricas de utilización de recursos
<a name="resource-utilization"></a>


| Métrica | Description (Descripción) | 
| --- | --- | 
| BackupRetentionPeriodStorageUsed | La cantidad total de almacenamiento de copias de seguridad en bytes utilizada para admitir la función de point-in-time restauración dentro de la ventana de retención de Amazon DocumentDB. Se incluye en el total registrado por la métrica TotalBackupStorageBilled. Se calcula de forma independiente para cada clúster de Amazon DocumentDB. | 
| ChangeStreamLogSize | La cantidad de almacenamiento que utiliza el clúster para almacenar el registro de flujos de cambios en megabytes. Este valor es un subconjunto del almacenamiento total del clúster (VolumeBytesUsed) y afecta al costo del clúster. Para obtener información acerca de los precios de almacenamiento, consulte la [página del producto de Amazon DocumentDB](https://aws.amazon.com//documentdb/pricing). El tamaño del registro de flujos de cambios es una función que indica la cantidad de cambios que se realizan en el clúster y el periodo en el que se conservará dicho registro de flujos de cambios. Para obtener más información acerca de las secuencias de cambio, consulte [Uso de flujos de cambios con Amazon DocumentDB](change_streams.md).  | 
| CPUUtilization | Porcentaje de CPU usado por una instancia. | 
| DatabaseConnections | El número de conexiones abiertas (activas e inactivas) en una instancia tomada en una frecuencia de 1 minuto. | 
| DatabaseConnectionsMax | El número máximo de conexiones abiertas (activas e inactivas) en una instancia en un período de 1 minuto. | 
| DatabaseConnectionsLimit | El número máximo de conexiones de bases de datos simultáneas (activas e inactivas) permitidas en una instancia en un momento dado. | 
| DatabaseCursors | El número de cursores abiertos en una instancia tomados en una frecuencia de 1 minuto. | 
| DatabaseCursorsMax | El número máximo de cursores abiertos en una instancia en un período de 1 minuto. | 
| DatabaseCursorsLimit | El número máximo de cursores permitidos en una instancia en un momento dado. | 
| DatabaseCursorsTimedOut | El número de cursores cuyo tiempo de espera se agotó en un período de 1 minuto. | 
| FreeableMemory | Cantidad de memoria de acceso aleatorio disponible en bytes. | 
| FreeLocalStorage | Esta métrica indica la cantidad de almacenamiento disponible en cada instancia para las tablas y los registros temporales. Este valor depende de la clase de instancia. Puede aumentar la cantidad de espacio de almacenamiento libre para una instancia eligiendo una clase de instancia más grande para ella. (Esto no se aplica a DocumentDB Serverless).  | 
| LowMemThrottleQueueDepth | La profundidad de la cola para las solicitudes que están limitadas debido a la poca memoria disponible tomada en una frecuencia de 1 minuto.  | 
| LowMemThrottleMaxQueueDepth | La profundidad máxima de la cola para las solicitudes que están limitadas debido a la poca memoria disponible en un período de 1 minuto.  | 
| LowMemNumOperationsThrottled | El número de solicitudes que están limitadas debido a la poca memoria disponible en un período de 1 minuto.  | 
| SnapshotStorageUsed | La cantidad total de almacenamiento de copias de seguridad en bytes consumida por todas las instantáneas de un clúster de Amazon DocumentDB determinado fuera de su período de retención de la copia de seguridad. Se incluye en el total registrado por la métrica TotalBackupStorageBilled. Se calcula de forma independiente para cada clúster de Amazon DocumentDB. | 
| SwapUsage | La cantidad de espacio de intercambio utilizado en la instancia. | 
| TotalBackupStorageBilled | La cantidad total de almacenamiento de copias de seguridad en bytes facturada para un clúster de Amazon DocumentDB determinado. Incluye el almacenamiento de copias de seguridad medido por las métricas BackupRetentionPeriodStorageUsed y SnapshotStorageUsed. Se calcula de forma independiente para cada clúster de Amazon DocumentDB. | 
| TransactionsOpen | El número de transacciones abiertas en una instancia en una frecuencia de 1 minuto. | 
| TransactionsOpenMax | El número máximo de transacciones abiertas en una instancia en un período de 1 minuto. | 
| TransactionsOpenLimit | El número máximo de transacciones simultáneas permitidas en una instancia en un momento dado. | 
| VolumeBytesUsed | Cantidad de almacenamiento utilizada por el clúster en bytes. Este valor afecta al costo del clúster. Para obtener información acerca de los precios, consulte la [página del producto de Amazon DocumentDB](https://aws.amazon.com//documentdb/pricing).  | 

### Métricas de latencia
<a name="latency-metrics"></a>


| Métrica | Description (Descripción) | 
| --- | --- | 
| DBClusterReplicaLagMaximum | Retardo máximo en milisegundos entre la instancia principal y cada instancia de base de datos de Amazon DocumentDB del clúster. | 
| DBClusterReplicaLagMinimum | Retardo mínimo en milisegundos entre la instancia principal y cada instancia de réplica del clúster. | 
| DBInstanceReplicaLag | La cantidad de retardo, en milisegundos, cuando la replicación actualiza desde la instancia principal a una instancia de réplica. | 
| ReadLatency | La cantidad media de tiempo que tarda cada operación de disco I/O . | 
| WriteLatency | La cantidad media de tiempo, en milisegundos, que se tarda en realizar cada I/O operación de disco. | 

### NVMe-métricas de instancias respaldadas
<a name="nvme-metrics"></a>


| Métrica | Description (Descripción) | 
| --- | --- | 
| NVMeStorageCacheHitRatio | El porcentaje de solicitudes que se responden desde la caché por niveles. | 
| FreeNVMeStorage | La cantidad de almacenamiento efímero NVMe disponible. | 
| ReadIOPSNVMeStorage | El número promedio de I/O operaciones de lectura de disco para almacenamiento efímero NVMe . | 
| ReadLatencyNVMeStorage | El tiempo medio que tarda cada I/O operación de lectura de disco en el almacenamiento efímero NVMe . | 
| ReadThroughputNVMeStorage | El número promedio de bytes leídos del disco por segundo para el almacenamiento efímero NVMe . | 
| WriteIOPSNVMeStorage | El número promedio de I/O operaciones de escritura en disco en un almacenamiento efímero NVMe . | 
| WriteLatencyNVMeStorage | El tiempo medio que tarda cada I/O operación de escritura en disco en el almacenamiento efímero NVMe . | 
| WriteThroughputNVMeStorage | El número promedio de bytes escritos en el disco por segundo para el almacenamiento efímero NVMe . | 

### Métricas operativas
<a name="operations-metrics"></a>


| Métrica | Description (Descripción) | 
| --- | --- | 
| DocumentsDeleted | El número de documentos eliminados en un período de 1 minuto. | 
| DocumentsInserted | El número de documentos insertados en un período de 1 minuto. | 
| DocumentsReturned | El número de documentos devueltos en un período de 1 minuto. | 
| DocumentsUpdated | El número de documentos actualizados en un período de 1 minuto. | 
| OpcountersCommand | El número de comandos emitidos en un período de 1 minuto. | 
| OpcountersDelete | El número de operaciones de eliminación emitidas en un período de 1 minuto. | 
| OpcountersGetmore | El número de getmores emitidos en un período de 1 minuto. | 
| OpcountersInsert | El número de operaciones de inserción emitidas en un período de 1 minuto. | 
| OpcountersQuery | El número de consultas emitidas en un período de 1 minuto. | 
| OpcountersUpdate | El número de operaciones de actualización emitidas en un período de 1 minuto. | 
| TransactionsStarted | El número de transacciones iniciadas en una instancia en un período de 1 minuto. | 
| TransactionsCommitted | El número de transacciones realizadas en una instancia en un período de 1 minuto. | 
| TransactionsAborted | El número de transacciones canceladas en una instancia en un período de 1 minuto. | 
| TTLDeletedDocuments | El número de documentos eliminados por a TTLMonitor en un período de 1 minuto. | 

### Métricas de rendimiento
<a name="throughput-metrics"></a>


| Métrica | Description (Descripción) | 
| --- | --- | 
| NetworkReceiveThroughput | Cantidad de rendimiento de red en bytes por segundo recibida de los clientes por cada instancia del clúster. Este rendimiento no incluye el tráfico de red entre las instancias del clúster y el volumen del clúster. | 
| NetworkThroughput | Cantidad de rendimiento de red en bytes por segundo recibida de los clientes y transmitida a ellos por cada instancia del clúster de Amazon DocumentDB. Este rendimiento no incluye el tráfico de red entre las instancias del clúster y el volumen del clúster.  | 
| NetworkTransmitThroughput | Cantidad de rendimiento de red en bytes por segundo enviada a los clientes por cada instancia del clúster de base de datos. Este rendimiento no incluye el tráfico de red entre las instancias del clúster y el volumen del clúster. | 
| ReadIOPS | El número medio de I/O operaciones de lectura del disco por segundo. Amazon DocumentDB indica las IOPS de lectura y escritura por separado, en intervalos de 1 minuto. | 
| ReadThroughput | El número medio de bytes leídos del disco por segundo. | 
| StorageNetworkReceiveThroughput | Cantidad de rendimiento de red en bytes por segundo recibida del volumen de almacenamiento del clúster de Amazon DocumentDB por cada instancia del clúster. | 
| StorageNetworkTransmitThroughput | Cantidad de rendimiento de red en bytes por segundo enviada al volumen de almacenamiento del clúster de Amazon DocumentDB por cada instancia del clúster. | 
| StorageNetworkThroughput | Cantidad de rendimiento de red en bytes por segundo recibida y enviada al volumen de almacenamiento del clúster de Amazon DocumentDB por cada instancia del clúster de Amazon DocumentDB. | 
| VolumeReadIOPs |  El número promedio de I/O operaciones de lectura facturadas desde un volumen de clúster, registrado en intervalos de 5 minutos. Las operaciones de lectura facturadas se calculan en el nivel del volumen de clúster, se agrupan para todas las instancias del clúster y se notifican a intervalos de 5 minutos. El valor se calcula tomando el valor de la métrica de operaciones de lectura a lo largo de un periodo de 5 minutos. Puede determinar la cantidad de operaciones de lectura facturadas por segundo tomando el valor de la métrica de operaciones de lectura facturadas y dividiéndola por 300 segundos. Por ejemplo, si las `VolumeReadIOPs` devuelven 13 686, las operaciones de lectura facturadas por segundo serán 45 (13 686/300 = 45,62). Las operaciones de lectura facturadas se acumulan para las consultas que solicitan páginas de la base de datos que no están presentes en la caché del búfer y que por tanto se deben cargar desde el almacenamiento. Es posible que aparezcan picos en las operaciones de lectura facturadas, ya que los resultados de la consulta se leen desde el almacenamiento y se cargan en la caché del búfer.  | 
| VolumeWriteIOPs |  El número promedio de I/O operaciones de escritura facturadas desde un volumen de clúster, registrado en intervalos de 5 minutos. Las operaciones de escritura facturadas se calculan en el nivel del volumen de clúster, se agrupan para todas las instancias del clúster y se notifican a intervalos de 5 minutos. El valor se calcula tomando el valor de la métrica de operaciones de escritura a lo largo de un periodo de 5 minutos. Puede determinar la cantidad de operaciones de escritura facturadas por segundo tomando el valor de la métrica de operaciones de escritura facturadas y dividiendo por 300 segundos. Por ejemplo, si las `VolumeWriteIOPs` devuelven 13 686, las operaciones de escritura facturadas por segundo serán 45 (13 686/300 = 45,62).  Tenga en cuenta que `VolumeReadIOPs` las `VolumeWriteIOPs` métricas se calculan mediante la capa de almacenamiento de DocumentDB e incluyen las IOs realizadas por las instancias principal y de réplica. Los datos se agregan cada 20 a 30 minutos y después, se generan informes en intervalos de 5 minutos, por lo que se emite el mismo punto de datos para la métrica en el período de tiempo. Si busca una métrica que se correlacione con tus operaciones de inserción en un intervalo de 1 minuto, puede usar la métrica WriteIOps a nivel de instancia. La métrica está disponible en la pestaña de supervisión de la instancia principal de Amazon DocumentDB.  | 
| WriteIOPS | El número promedio de I/O operaciones de escritura en disco por segundo. Cuando se utilizan a nivel de clúster, WriteIOPs se evalúan en todas las instancias del clúster. Las IOPS de lectura y escritura se registran por separado, en intervalos de 1 minuto. | 
| WriteThroughput | Número medio de bytes que se escriben en el disco por segundo. | 

### Métricas del sistema
<a name="system-metrics"></a>


| Métrica | Description (Descripción) | 
| --- | --- | 
| AvailableMVCCIds | Un contador que muestra el número de operaciones de escritura restantes disponibles antes de llegar a cero. Cuando este contador llegue a cero, el clúster pasará al modo de solo lectura hasta que IDs se recupere y se recicle. El contador disminuye con cada operación de escritura y aumenta a medida que la recolección de basura recicla el MVCC antiguo. IDs | 
| BufferCacheHitRatio | Porcentaje de solicitudes que se responden desde la caché de búfer. | 
| DiskQueueDepth | El número de I/O operaciones que están esperando a escribirse o leerse desde el disco. | 
| EngineUptime | Cantidad de tiempo en segundos que la instancia lleva en ejecución. | 
| IndexBufferCacheHitRatio | Porcentaje de solicitudes de índice que se responden desde la caché de búfer. Es posible que vea un pico superior al 100 % en la métrica justo después de eliminar un índice, una colección o una base de datos. Esto se resolverá automáticamente después de 60 segundos. Esta limitación se corregirá en una actualización futura del parche. | 
| LongestActiveGCRuntime | Duración en segundos del proceso activo de recopilación de elementos no utilizados más prolongado. Se actualiza cada minuto y realiza un seguimiento únicamente de las operaciones activas, excluyendo los procesos que se completan en el intervalo de un minuto. | 

### Métricas de la instancia T3
<a name="t3-instance-metrics"></a>


| Métrica | Description (Descripción) | 
| --- | --- | 
| CPUCreditUsage | El número total de créditos de CPU que se han gastado durante el periodo de medición. | 
| CPUCreditBalance | El número de créditos de la CPU que ha acumulado una instancia. Este saldo se agota cuando la CPU realiza ráfagas y los créditos de CPU se gastan más rápido de lo que se obtienen.  | 
| CPUSurplusCreditBalance | El número de créditos de CPU sobrantes que se utilizan para mantener el rendimiento de la CPU cuando el valor de CPUCredit equilibrio es cero. | 
| CPUSurplusCreditsCharged | El número de créditos de CPU sobrantes que superen la cantidad máxima de créditos de CPU que se pueden obtener en un periodo de 24 horas y que, por lo tanto, generan gastos adicionales. Para obtener más información, consulte [Monitoreo de sus créditos CPU](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-monitoring-cpu-credits.html).  | 

## Visualización CloudWatch de datos
<a name="cloud_watch-view_data"></a>

Puede ver CloudWatch los datos de Amazon mediante la CloudWatch consola, la consola Amazon DocumentDB, AWS Command Line Interface (AWS CLI) o la CloudWatch API.

------
#### [ Using the Consola de administración de AWS ]

Para ver CloudWatch las métricas mediante la consola de administración de Amazon DocumentDB, complete los siguientes pasos.

1. [Inicie sesión en y abra la Consola de administración de AWS consola de Amazon DocumentDB en https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)

1. En el panel de navegación, seleccione **Clusters (Clústeres)**.
**sugerencia**  
Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-menu-icon.png)) en la esquina superior izquierda de la página.

1. En el cuadro de navegación de clústeres, verá la columna **Identificador del clúster**. Las instancias se muestran en clústeres, de forma similar a la siguiente captura de pantalla.  
![\[Tabla de clústeres en la que se muestra cómo se anida una instancia en un clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/choose-clusters.png)

1. En la lista de instancias, seleccione el nombre de la instancia de la que desea ver las métricas. 

1. En la página de resumen de instancias resultante, seleccione la pestaña **Monitorización** para ver las representaciones gráficas de las métricas de su instancia de Amazon DocumentDB. Como se debe generar un gráfico para cada métrica, los **CloudWatch**gráficos pueden tardar unos minutos en rellenarse.

   La siguiente imagen muestra las representaciones gráficas de dos CloudWatch métricas en la consola Amazon DocumentDB y`WriteIOPS`. `ReadIOPS`  
![\[Dos gráficos de líneas que representan las métricas de WriteIOPS y CloudWatch ReadiOps en la consola Amazon DocumentDB.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/cw-metrics-con.png)

------
#### [ Using the CloudWatch Management Console ]

Para ver CloudWatch las métricas mediante la consola de CloudWatch administración, complete los siguientes pasos.

1. Inicie sesión en y abra la Consola de administración de AWS consola de Amazon DocumentDB en. [https://console.aws.amazon.com/cloudwatch](https://console.aws.amazon.com/cloudwatch)

1. En el panel de navegación, seleccione **Métricas**. A continuación, en la lista de nombres de servicios, elija **DocDB**.

1. Elija una dimensión de métrica (por ejemplo, **Métricas del clúster**).

1. La pestaña **Todas las métricas** muestra todas las métricas para dicha dimensión en **DocDB**.

   1. Para ordenar la tabla, utilice el encabezado de columna.

   1. Para representar gráficamente una métrica, active la casilla de verificación situada junto a ella. Para seleccionar todas las métricas, seleccione la casilla de verificación en la fila de encabezado de la tabla.

   1. Para filtrar por métrica, coloque el cursor sobre el nombre de la métrica y seleccione la flecha desplegable situada junto al nombre de la métrica. A continuación, selecciona **Añadir a la búsqueda**, como se muestra en la siguiente imagen.  
![\[En la pestaña Todas las métricas, se muestran las métricas y aparece una lista desplegable para el nombre de la métrica.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/cloudwatch-filter-metrics.png)

------
#### [ Using the AWS CLI ]

Para ver CloudWatch los datos de Amazon DocumentDB, utilice la CloudWatch `get-metric-statistics` operación con los siguientes parámetros.

**Parameters**
+ **--namespace**: obligatorio. El espacio de nombres del servicio para el que desea obtener métricas de CloudWatch . Para Amazon DocumentDB, debe ser `AWS/DocDB`.
+ **--metric-name**: obligatorio. El nombre de la métrica para la que desea obtener datos. 
+ **--start-time**: obligatorio. La marca temporal que determina el primer punto de datos que se va a devolver.

   El valor especificado es inclusivo; los resultados incluyen puntos de datos con la marca temporal especificada. La marca temporal debe estar en el formato UTC ISO 8601 (por ejemplo, 2016-10-03T23:00:00 Z).
+ **--end-time**: obligatorio. La marca temporal que determina el último punto de datos que se va a devolver.

  El valor especificado es inclusivo; los resultados incluyen puntos de datos con la marca temporal especificada. La marca temporal debe estar en el formato UTC ISO 8601 (por ejemplo, 2016-10-03T23:00:00 Z).
+ **--period**: obligatorio. El grado de detalle, en segundos, de los puntos de datos devueltos. Para las métricas con una resolución normal, un periodo puede ser tan breve como un minuto (60 segundos) y debe ser un múltiplo de 60. Para las métricas de alta resolución que se recopilan a intervalos de menos de un minuto, el periodo puede ser 1, 5, 10, 30, 60 o cualquier múltiplo de 60.
+ **--dimensions**— Opcional. Si la métrica contiene varias dimensiones, debe incluir un valor para cada dimensión. CloudWatch trata cada combinación única de dimensiones como una métrica independiente. No se pueden recuperar estadísticas utilizando combinaciones de dimensiones que no se han publicado. Debe especificar las mismas dimensiones que se utilizaron al crear las métricas.
+ **--statistics**: opcional. La estadística de la métrica, distinta del percentil. Para la estadística de percentil, utilice `ExtendedStatistics`. Cuando llama a `GetMetricStatistics`, debe especificar `Statistics` o `ExtendedStatistics`, pero no ambos.

**Valores permitidos:**
  + `SampleCount`
  + `Average`
  + `Sum`
  + `Minimum`
  + `Maximum`
+ **--extended-statistics**: opcional. La estadística `percentile`. Especifique valores comprendidos entre p0.0 y p100. Cuando llama a `GetMetricStatistics`, debe especificar `Statistics` o `ExtendedStatistics`, pero no ambos.
+ **--unit**: opcional. La unidad de una métrica determinada. Las métricas se pueden registrar en varias unidades. Si no se especifica una unida, se devuelven todas las unidades. Si especifica solo una unidad que la métrica no registra, los resultados de la llamada son nulos.

**Valores posibles:**
  + `Seconds`
  + `Microseconds`
  + `Milliseconds`
  + `Bytes`
  + `Kilobytes`
  + `Megabytes`
  + `Gigabytes`
  + `Terabytes`
  + `Bits`
  + `Kilobytes`
  + `Megabits`
  + `Gigabits`
  + `Terabits`
  + `Percent`
  + `Count`
  + `Bytes/Second`
  + `Kilobytes/Second`
  + `Megabytes/Second`
  + `Gigabytes/Second`
  + `Terabytes/Second`
  + `Bits/Second`
  + `Kilobits/Second`
  + `Megabits/Second`
  + `Gigabits/Second`
  + `Terabits/Second`
  + `Count/Second`
  + `None`

**Example**  
En el siguiente ejemplo se busca el valor máximo de `CPUUtilization` para un periodo de 2 horas tomando una muestra cada 60 segundos.  
Para Linux, macOS o Unix:  

```
aws cloudwatch get-metric-statistics \
       --namespace AWS/DocDB \
       --dimensions \
           Name=DBInstanceIdentifier,Value=docdb-2019-01-09-23-55-38 \
       --metric-name CPUUtilization \
       --start-time 2019-02-11T05:00:00Z \
       --end-time 2019-02-11T07:00:00Z \
       --period 60 \
       --statistics Maximum
```
Para Windows:  

```
aws cloudwatch get-metric-statistics ^
       --namespace AWS/DocDB ^
       --dimensions ^
           Name=DBInstanceIdentifier,Value=docdb-2019-01-09-23-55-38 ^
       --metric-name CPUUtilization ^
       --start-time 2019-02-11T05:00:00Z ^
       --end-time 2019-02-11T07:00:00Z ^
       --period 60 ^
       --statistics Maximum
```
La salida de esta operación será similar a lo que se indica a continuación.  

```
{
       "Label": "CPUUtilization",
       "Datapoints": [
           {
               "Unit": "Percent",
               "Maximum": 4.49152542374361,
               "Timestamp": "2019-02-11T05:51:00Z"
           },
           {
               "Unit": "Percent",
               "Maximum": 4.25000000000485,
               "Timestamp": "2019-02-11T06:44:00Z"
           },
           
           ********* some output omitted for brevity *********
           
           {
               "Unit": "Percent",
               "Maximum": 4.33333333331878,
               "Timestamp": "2019-02-11T06:07:00Z"
           }
       ]
   }
```

------

## Dimensiones de Amazon DocumentDB
<a name="cloud_watch-metrics_dimensions"></a>

Las métricas de Amazon DocumentDB se identifican por los valores de la cuenta o de la operación. Puede utilizar la CloudWatch consola para recuperar los datos de Amazon DocumentDB filtrados por cualquiera de las dimensiones de la tabla siguiente.


| Dimensión | Description (Descripción) | 
| --- | --- | 
| DBClusterIdentifier | Filtra los datos solicitados que son específicos del clúster de Amazon DocumentDB. | 
| DBClusterIdentifier, Role | Filtra los datos solicitados para un clúster de Amazon DocumentDB específico, agrupando las métricas por rol de instancia (WRITER/READER). Por ejemplo, puede agregar métricas para todas las instancias READER que pertenezcan a un clúster. | 
| DBInstanceIdentifier | Filtra los datos solicitados para una instancia de base de datos específica. | 

## Supervisión de métricas de Opcounter
<a name="cloud_watch-monitoring_opcounters"></a>

Las métricas de Opcounter tienen un valor distinto de cero (normalmente \$1 50) para los clústeres inactivos. Esto se debe a que Amazon DocumentDB realiza comprobaciones de estado periódicas, operaciones internas y tareas de recopilación de métricas.

## Supervisión de conexiones a bases de datos
<a name="cloud_watch-monitoring_connections"></a>

Al ver el número de conexiones mediante comandos del motor de base de datos, por ejemplo`db.runCommand( { serverStatus: 1 })`, es posible que vea hasta 10 conexiones más de las que ve. `DatabaseConnections` CloudWatch Esto ocurre porque Amazon DocumentDB realiza comprobaciones de estado periódicas y tareas de recopilación de métricas que no se tienen en cuenta en `DatabaseConnections`. `DatabaseConnections` representa únicamente las conexiones iniciadas por el cliente.