Monitorización de Amazon DocumentDB con CloudWatch

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

CloudWatch también le permite establecer alarmas, de modo que pueda recibir notificaciones si un valor de métrica supera un umbral que especifique. Incluso puede configurar Amazon CloudWatch Events para tomar medidas correctivas si se produce una interrupción. Para obtener más información sobre el uso de y las alarmas, consulte la documentación de Amazon CloudWatch.

Métricas de Amazon DocumentDB

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.

Uso de los recursos
Métrica	Descripción
BackupRetentionPeriodStorageUsed	La cantidad total de almacenamiento de copias de seguridad en GiB utilizada para permitir la restauración a un momento dado dentro del periodo 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. 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 secuencias de cambios con Amazon DocumentDB.
CPUUtilization	Porcentaje de CPU usado por una instancia.
DatabaseConnections	El número de conexiones abiertas en una instancia tomada en una frecuencia de un minuto.
DatabaseConnectionsMax	El número máximo de conexiones de bases de datos abiertas en una instancia en un período de un minuto.
DatabaseCursors	El número de cursores abiertos en una instancia tomados en una frecuencia de un minuto.
DatabaseCursorsMax	El número máximo de cursores abiertos en una instancia en un período de un minuto.
DatabaseCursorsTimedOut	El número de cursores cuyo tiempo de espera se agotó en un período de un 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.
LowMemThrottleQueueDepth	La profundidad de la cola para las solicitudes que están limitadas debido a la poca memoria disponible tomadas en una frecuencia de un minuto.
LowMemThrottleMaxQueueDepth	La profundidad máxima de la cola para las solicitudes que están limitadas debido a la poca memoria disponible en un periodo de un minuto.
LowMemNumOperationsThrottled	El número de solicitudes que están limitadas debido a la poca memoria disponible en un periodo de un minuto.
SnapshotStorageUsed	La cantidad total de almacenamiento de copias de seguridad en GiB consumida por todas las instantáneas de un clúster de Amazon DocumentDB determinado fuera de su periodo de retención de 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 GiB 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 un minuto.
TransactionsOpenMax	El número máximo de transacciones abiertas en una instancia en un período de un minuto.
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.

Latency (Latencia)
Métrica	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	Tiempo medio de cada operación de E/S en el disco.
WriteLatency	Tiempo medio en milisegundos de cada operación de E/S en disco.

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

Rendimiento
Métrica	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	Número medio de operaciones de E/S de lectura en 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.
VolumeReadIOPs	Número medio de operaciones de E/S de lectura facturadas desde un volumen de clúster, indicado a 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	Número medio de operaciones de E/S de escritura facturadas desde un volumen de clúster, indicado a 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 las métricas VolumeReadIOPs y VolumeWriteIOPs 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	Número medio de operaciones de E/S 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.

System (Sistema)
Métrica	Descripción
BufferCacheHitRatio	Porcentaje de solicitudes que se responden desde la caché de búfer.
DiskQueueDepth	el número de solicitudes de escritura simultáneas en el volumen de almacenamiento distribuido.
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 veas 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.

Métricas de la instancia T3
Métrica	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 han gastado para mantener el rendimiento de la CPU cuando el valor de CPUCreditBalance es igual a 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.

Visualización de las métricas de CloudWatch

Puede supervisar las métricas de Amazon CloudWatch mediante la consola CloudWatch, de la consola de Amazon DocumentDB, la AWS Command Line Interface (AWS CLI) o la API de CloudWatch.

Using the AWS Management Console

Para ver las métricas de CloudWatch mediante la consola de administración de Amazon DocumentDB, realice los pasos que se indican a continuación.

1. Inicie sesión en la AWS Management Console y abra la consola de Amazon DocumentDB en https://console.aws.amazon.com/docdb.

2. En el panel de navegación, elija Clusters (Clústeres).

   sugerencia

   Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú () en la esquina superior izquierda de la página.

3. 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.

   

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

5. 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 debe generarse un gráfico para cada métrica, los gráficos de CloudWatch pueden tardar algunos minutos en aparecer.

   La siguiente imagen muestra las representaciones gráficas de dos métricas de CloudWatch en la consola Amazon DocumentDB, WriteIOPS y ReadIOPS.

   

Using the CloudWatch Management Console

Para ver las métricas de CloudWatch mediante la consola de administración de CloudWatch, realice los pasos que se indican a continuación.

1. Inicie sesión en la AWS Management Console. y abra la consola de Amazon DocumentDB en https://console.aws.amazon.com/cloudwatch.

2. En el panel de navegación, seleccione Metrics (Métricas). A continuación, en la lista de nombres de servicios, elija DocDB.

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

4. 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.

   2. 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.

   3. 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.

      

Using the AWS CLI

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

Parámetros

• --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 exclusiva 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

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

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

Dimensión	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.

Monitoreo de Opcounters

Las métricas de Opcounter tienen un valor distinto de cero (normalmente ~ 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.

Monitorización de conexiones a bases de datos

Cuando vea el número de conexiones mediante comandos del motor de base de datos como db.runCommand( { serverStatus: 1 }), es posible que vea hasta 10 conexiones más de las que ve en DatabaseConnections a través de 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.