Supervisión de Amazon DocumentDB con CloudWatch - Amazon DocumentDB

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

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.

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.

Métricas de utilización de recursos

Métrica Descripción
BackupRetentionPeriodStorageUsed La cantidad total de almacenamiento de copias de seguridad en GiB utilizada para admitir la función de point-in-time restauración dentro del período 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 flujos 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.

Métricas de 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.

NVMe-métricas de instancias respaldadas

Métrica Descripción
NVMeStorageCacheHitRatio El porcentaje de solicitudes que atiende la caché por niveles.
FreeNVMeStorage La cantidad de almacenamiento efímero NVMe disponible.
ReadIOPSNVMeStorage El número promedio de operaciones de E/S de lectura en disco para almacenamiento efímero. NVMe
ReadLatencyNVMeStorage El tiempo promedio que tarda cada operación de E/S de lectura en disco para 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 operaciones de E/S de escritura en disco en un almacenamiento efímero. NVMe
WriteLatencyNVMeStorage El tiempo promedio que tarda cada operación de E/S de escritura en disco para 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 de 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 a TTLMonitor en un período de un minuto.

Métricas de 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.
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

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

Métricas del 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 vea un aumento 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 La cantidad de créditos de CPU sobrantes que se gastan para mantener el rendimiento de la CPU cuando el valor de CPUCredit saldo 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.

Visualización CloudWatch de datos

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 AWS Management Console

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 AWS Management Console consola de Amazon DocumentDB en https://console.aws.amazon.com /docdb.

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

    DocumentDB clusters list showing two clusters with their identifiers and roles.
  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 se debe generar un gráfico para cada métrica, los CloudWatchgrá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 yWriteIOPS. ReadIOPS

    Dos de las 18 CloudWatch métricas de la consola de Amazon DocumentDB, writeiops y readiops.
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 AWS Management Console consola de Amazon DocumentDB en. https://console.aws.amazon.com/cloudwatch

  2. En el panel de navegación, seleccione 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.

      Para filtrar una métrica, coloca el cursor sobre la métrica y selecciona “Añadir a la búsqueda”.
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.

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 ú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

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 utilizar la CloudWatch consola para recuperar los datos de Amazon DocumentDB filtrados 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.

Supervisión de métricas de Opcounter

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.

Supervisión de conexiones a bases de datos

Al ver el número de conexiones mediante comandos del motor de base de datos, por ejemplodb.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.