Dimensiones y métricas de DynamoDB - Amazon DynamoDB
Visualización de métricas y dimensionesDescripción de las métricas y dimensiones de DynamoDB

Dimensiones y métricas de DynamoDB

Cuando se interactúa con DynamoDB, este envía métricas y dimensiones a CloudWatch.

Las salidas de DynamoDB consumieron el rendimiento aprovisionado durante periodos de un minuto. El escalado automático se activa cuando la capacidad consumida supera el objetivo de utilización configurado durante dos minutos consecutivos. Es posible que las alarmas de CloudWatch tarden unos minutos antes de desencadenar el escalado automático. Este retraso garantiza una evaluación precisa de las métricas de CloudWatch. Si los picos de rendimiento consumidos están separados por más de un minuto, es posible que no se desencadene el escalado automático. Del mismo modo, se puede producir un evento de reducción vertical cuando 15 puntos de datos consecutivos sean inferiores a la utilización objetivo. En cualquier caso, tras desencadenar el escalado automático, se invoca la API UpdateTable. La actualización de la capacidad aprovisionada para la tabla o el índice puede tardar unos minutos. Durante este periodo, cualquier solicitud que supere la capacidad aprovisionada previamente de las tablas se limita.

Visualización de métricas y dimensiones

CloudWatch muestra las siguientes métricas para DynamoDB:

Métricas de DynamoDB

nota

Amazon CloudWatch acumula estas métricas a intervalos de un minuto:

  • ConditionalCheckFailedRequests

  • ConsumedReadCapacityUnits

  • ConsumedWriteCapacityUnits

  • ReadAccountLimitThrottleEvents

  • ReadKeyRangeThroughputThrottleEvents

  • ReadMaxOnDemandThroughputThrottleEvents

  • ReadProvisionedThroughputThrottleEvents

  • ReadThrottleEvents

  • ReturnedBytes

  • ReturnedItemCount

  • ReturnedRecordsCount

  • SuccessfulRequestLatency

  • SystemErrors

  • TimeToLiveDeletedItemCount

  • ThrottledRequests

  • TransactionConflict

  • UserErrors

  • WriteAccountLimitThrottleEvents

  • WriteKeyRangeThroughputThrottleEvents

  • WriteMaxOnDemandThroughputThrottleEvents

  • WriteProvisionedThroughputThrottleEvents

  • WriteThrottleEvents

Para todas las otras métricas de DynamoDB, la granularidad de acumulación es de cinco minutos.

No todas las estadísticas, tales como Average (Media) o Sum (Suma), son aplicables a todas las métricas. Sin embargo, todos estos valores están disponibles a través de la consola de Amazon DynamoDB o mediante la consola de CloudWatch, la AWS CLI o los SDK de AWS para todas las métricas.

En la siguiente lista, cada métrica tiene un conjunto de estadísticas válidas que son aplicables a esa métrica.

AccountMaxReads

Número máximo de unidades de capacidad de lectura que puede utilizar una cuenta. Este límite no se aplica a las tablas bajo demanda ni a los índices secundarios globales.

Unidades: Count

Estadísticas válidas:

  • Maximum: la cantidad máxima de unidades de capacidad de lectura que puede utilizar una cuenta.

AccountMaxTableLevelReads

La cantidad máxima de unidades de capacidad de lectura que puede utilizar una tabla o un índice secundario global de una cuenta. Para tablas bajo demanda, este límite es el tope máximo de unidades de solicitud de lectura que puede utilizar una tabla o un índice secundario global.

Unidades: Count

Estadísticas válidas:

  • Maximum: la cantidad máxima de unidades de capacidad de lectura que puede utilizar una tabla o un índice secundario global de la cuenta.

AccountMaxTableLevelWrites

La cantidad máxima de unidades de capacidad de escritura que puede utilizar una tabla o un índice secundario global de una cuenta. Para tablas bajo demanda, este límite es el tope máximo de unidades de solicitud de escritura que puede utilizar una tabla o un índice secundario global.

Unidades: Count

Estadísticas válidas:

  • Maximum: la cantidad máxima de unidades de capacidad de escritura que puede utilizar una tabla o un índice secundario global de la cuenta.

AccountMaxWrites

La cantidad máxima de unidades de capacidad de escritura que puede utilizar una cuenta. Este límite no se aplica a las tablas bajo demanda ni a los índices secundarios globales.

Unidades: Count

Estadísticas válidas:

  • Maximum: la cantidad máxima de unidades de capacidad de escritura que puede utilizar una cuenta.

AccountProvisionedReadCapacityUtilization

El porcentaje de unidades de capacidad de lectura aprovisionadas utilizadas por su cuenta.

Unidades: Percent

Estadísticas válidas:

  • Maximum: el porcentaje máximo de unidades de capacidad de lectura aprovisionadas utilizadas por la cuenta.

  • Minimum: el porcentaje mínimo de unidades de capacidad de lectura aprovisionadas utilizadas por la cuenta.

  • Average: el porcentaje promedio de unidades de capacidad de lectura aprovisionadas utilizadas por la cuenta. La métrica se publica a intervalos de cinco minutos. Por lo tanto, si ajusta rápidamente las unidades de capacidad de lectura aprovisionadas, es posible que esta estadística no refleje el promedio real.

AccountProvisionedWriteCapacityUtilization

El porcentaje de unidades de capacidad de escritura aprovisionadas utilizadas por su cuenta.

Unidades: Percent

Estadísticas válidas:

  • Maximum: el porcentaje máximo de unidades de capacidad de escritura aprovisionadas utilizadas por la cuenta.

  • Minimum: el porcentaje mínimo de unidades de capacidad de escritura aprovisionadas utilizadas por la cuenta.

  • Average: el porcentaje promedio de unidades de capacidad de escritura aprovisionadas utilizadas por la cuenta. La métrica se publica a intervalos de cinco minutos. Por lo tanto, si ajusta rápidamente las unidades de capacidad de escritura aprovisionadas, es posible que esta estadística no refleje el promedio real.

AgeOfOldestUnreplicatedRecord

Ha aparecido por primera vez en la tabla DynamoDB el tiempo transcurrido desde que un registro que aún no se ha replicado en el flujo de datos de Kinesis.

Unidades: Milliseconds

Dimensiones: TableName, DelegatedOperation

Estadísticas válidas:

  • Maximum.

  • Minimum.

  • Average.

CondicionalCheckFailedRequests

Cantidad de intentos fallidos para realizar escrituras condicionales. La operaciones PutItem, UpdateItem, y DeleteItem le permiten proporcionar una condición lógica que debe evaluarse como true (verdadera) antes de que la operación pueda continuar. Si se evalúa esta condición como false (falso), ConditionalCheckFailedRequests se incrementa en uno. ConditionalCheckFailedRequests también se incrementa en uno para las instrucciones PartiQL Update (actualizar) y Delete (eliminar) donde se proporciona una condición lógica y esa condición se evalúa como false (falso).

nota

Una escritura condicional fallida dará lugar a un error HTTP 400 (solicitud errónea). Estos eventos se reflejan en la métrica ConditionalCheckFailedRequests, pero no en la métrica UserErrors.

Unidades: Count

Dimensiones: TableName

Estadísticas válidas:

  • Minimum

  • Maximum

  • Average

  • SampleCount

  • Sum

ConsumedChangeDataCaptureUnits

La cantidad de unidades de captura de datos de cambio consumidas.

Unidades: Count

Dimensiones: TableName, DelegatedOperation

Estadísticas válidas:

  • Minimum

  • Maximum

  • Average

ConsumedReadCapacityUnits

La cantidad de unidades de capacidad de lectura usadas durante el periodo de tiempo especificado, tanto para capacidad aprovisionada como para capacidad bajo demanda, para que pueda saber cuánto rendimiento se usa. Puede recuperar la capacidad total de lectura consumida para una tabla y todos sus índices secundarios globales, o para un índice secundario global determinado. Para obtener más información, consulte Modo de capacidad de lectura/escritura.

La dimensión TableName devuelve la ConsumedReadCapacityUnits para la tabla, pero no para los índices secundarios globales. Para ver la ConsumedReadCapacityUnits para un índice secundario global, debe especificar tanto TableName como GlobalSecondaryIndexName.

nota

Esto significa que es posible que los picos cortos e intensos en el consumo de capacidad que duren solo un segundo no se reflejen con precisión en el gráfico de CloudWatch, lo que podría provocar una tasa de consumo aparente más baja durante ese minuto.

Utilice la estadística Sum para calcular el rendimiento consumido. Por ejemplo, obtenga el valor Sum en un lapso de un minuto y divídalo por el número de segundos en un minuto (60) para calcular el promedio ConsumedReadCapacityUnits por segundo. Puede comparar el valor calculado con el valor de rendimiento aprovisionado que le proporciona a DynamoDB.

Unidades: Count

Dimensiones: TableName, GlobalSecondaryIndexName

Estadísticas válidas:

  • Minimum: la cantidad mínima de unidades de capacidad de lectura consumidas por cualquier solicitud individual a la tabla o al índice.

  • Maximum: la cantidad máxima de unidades de capacidad de lectura consumidas por cualquier solicitud individual a la tabla o al índice.

  • Average: la capacidad de lectura promedio por solicitud consumida.

    nota

    El valor Average está influenciado por periodos de inactividad donde el valor de la muestra será cero.

  • Sum: el total de unidades de capacidad de lectura consumidas. Esta es la estadística más útil para la métrica ConsumedReadCapacityUnits.

  • SampleCount: representa la frecuencia con la que se emite la métrica. Incluso las tablas sin tráfico tendrán SampleCount emitido regularmente, pero los valores de muestra serán siempre cero.

    nota

    El valor SampleCount está influenciado por periodos de inactividad donde el valor de la muestra será cero.

ConsumedWriteCapacityUnits

La cantidad de unidades de capacidad de escritura usadas durante el periodo de tiempo especificado, tanto para capacidad aprovisionada como para capacidad bajo demanda, para que pueda saber cuánto rendimiento se usa. Puede recuperar la capacidad total de escritura consumida para una tabla y todos sus índices secundarios globales, o para un índice secundario global determinado. Para obtener más información, consulte Modo de capacidad de lectura/escritura.

La dimensión TableName devuelve la ConsumedWriteCapacityUnits para la tabla, pero no para los índices secundarios globales. Para ver la ConsumedWriteCapacityUnits para un índice secundario global, debe especificar tanto TableName como GlobalSecondaryIndexName.

nota

Utilice la estadística Sum para calcular el rendimiento consumido. Por ejemplo, obtenga el valor de Sum en un lapso de un minuto y divídalo por el número de segundos de un minuto (60) para calcular el promedio de ConsumedWriteCapacityUnits por segundo (reconociendo que en este promedio no se ponen de manifiesto los picos grandes pero breves en la actividad de escritura que se hayan producido durante ese minuto). Puede comparar el valor calculado con el valor de rendimiento aprovisionado que le proporciona a DynamoDB.

Unidades: Count

Dimensiones: TableName, GlobalSecondaryIndexName

Estadísticas válidas:

  • Minimum: la cantidad mínima de unidades de capacidad de escritura consumidas por cualquier solicitud individual a la tabla o al índice.

  • Maximum: la cantidad máxima de unidades de capacidad de escritura consumidas por cualquier solicitud individual a la tabla o al índice.

  • Average: la capacidad de escritura promedio por solicitud consumida.

    nota

    El valor Average está influenciado por periodos de inactividad donde el valor de la muestra será cero.

  • Sum: el total de unidades de capacidad de escritura consumidas. Esta es la estadística más útil para la métrica ConsumedWriteCapacityUnits.

  • SampleCount: representa la frecuencia con la que se emite la métrica. Incluso las tablas sin tráfico tendrán SampleCount emitido regularmente, pero los valores de muestra serán siempre cero.

    nota

    El valor SampleCount está influenciado por periodos de inactividad donde el valor de la muestra será cero.

FailedToReplicateRecordCount

Número de registros que DynamoDB no ha podido replicar en el flujo de datos de Kinesis.

Unidades: Count

Dimensiones: TableName, DelegatedOperation

Estadísticas válidas:

  • Sum

MaxProvisionedTableReadCapacityUtilization

El porcentaje de capacidad de lectura aprovisionado usado por la tabla de lectura con mayor aprovisionamiento o el índice secundario global de una cuenta.

Unidades: Percent

Estadísticas válidas:

  • Maximum: el porcentaje máximo de unidades de capacidad de lectura aprovisionadas utilizadas por la tabla de lectura con mayor aprovisionamiento o el índice secundario global de una cuenta.

  • Minimum: el porcentaje mínimo de unidades de capacidad de lectura aprovisionadas utilizadas por la tabla de lectura con mayor aprovisionamiento o el índice secundario global de una cuenta.

  • Average: el porcentaje promedio de unidades de capacidad de lectura aprovisionadas utilizadas por la tabla de lectura con mayor aprovisionamiento o el índice secundario global de la cuenta. La métrica se publica a intervalos de cinco minutos. Por lo tanto, si ajusta rápidamente las unidades de capacidad de lectura aprovisionadas, es posible que esta estadística no refleje el promedio real.

MaxProvisionedTableWriteCapacityUtilization

El porcentaje de capacidad de escritura aprovisionada utilizada por la tabla de escritura con mayor aprovisionamiento o el índice secundario global de una cuenta.

Unidades: Percent

Estadísticas válidas:

  • Maximum: el porcentaje máximo de unidades de capacidad de escritura aprovisionadas utilizadas por la tabla de escritura con mayor aprovisionamiento o el índice secundario global de una cuenta.

  • Minimum: el porcentaje mínimo de unidades de capacidad de escritura aprovisionadas utilizadas por la tabla de escritura con mayor aprovisionamiento o el índice secundario global de una cuenta.

  • Average: el porcentaje promedio de unidades de capacidad de escritura aprovisionadas utilizadas por la tabla de escritura con mayor aprovisionamiento o el índice secundario global de la cuenta. La métrica se publica a intervalos de cinco minutos. Por lo tanto, si ajusta rápidamente las unidades de capacidad de escritura aprovisionadas, es posible que esta estadística no refleje el promedio real.

OnDemandMaxReadRequestUnits

La cantidad de unidades de solicitud de lectura bajo demanda especificadas para una tabla o un índice secundario global.

Para ver OnDemandMaxReadRequestUnits para una tabla, debe especificar TableName. Para ver la OnDemandMaxReadRequestUnits para un índice secundario global, debe especificar tanto TableName como GlobalSecondaryIndexName.

Unidades: recuento

Dimensiones: TableName, GlobalSecondaryIndexName

Estadísticas válidas:

  • Minimum: la configuración mínima para las unidades de solicitud de lectura bajo demanda. Si utiliza UpdateTable para aumentar las unidades de solicitud de lectura, esta métrica muestra el valor mínimo de ReadRequestUnits bajo demanda durante este periodo de tiempo.

  • Maximum: la configuración máxima para las unidades de solicitud de lectura bajo demanda. Si utiliza UpdateTable para reducir las unidades de solicitud de lectura, esta métrica muestra el valor máximo de ReadRequestUnits bajo demanda durante este periodo de tiempo.

  • Average: el promedio de unidades de solicitud de lectura bajo demanda. La métrica OnDemandMaxReadRequestUnits se publica a intervalos de cinco minutos. Por lo tanto, si ajusta rápidamente las unidades de solicitud de lectura bajo demanda, es posible que esta estadística no refleje el promedio real.

OnDemandMaxWriteRequestUnits

La cantidad de unidades de solicitud de escritura bajo demanda especificadas para una tabla o un índice secundario global.

Para ver OnDemandMaxWriteRequestUnits para una tabla, debe especificar TableName. Para ver la OnDemandMaxWriteRequestUnits para un índice secundario global, debe especificar tanto TableName como GlobalSecondaryIndexName.

Unidades: Count

Dimensiones: TableName, GlobalSecondaryIndexName

Estadísticas válidas:

  • Minimum: la configuración mínima para las unidades de solicitud de escritura bajo demanda. Si utiliza UpdateTable para aumentar las unidades de solicitud de escritura, esta métrica muestra el valor mínimo de WriteRequestUnits bajo demanda durante este periodo de tiempo.

  • Maximum: la configuración máxima para las unidades de solicitud de escritura bajo demanda. Si utiliza UpdateTable para reducir las unidades de solicitud de escritura, esta métrica muestra el valor máximo de WriteRequestUnits bajo demanda durante este periodo de tiempo.

  • Average: el promedio de unidades de solicitud de escritura bajo demanda. La métrica OnDemandMaxWriteRequestUnits se publica a intervalos de cinco minutos. Por lo tanto, si ajusta rápidamente las unidades de solicitud de escritura bajo demanda, es posible que esta estadística no refleje el promedio real.

OnlineIndexConsumedWriteCapacity

La cantidad de unidades de capacidad de escritura consumidas al agregar un nuevo índice secundario global a una tabla. Si la capacidad de escritura del índice es demasiado baja, es posible que se limite la actividad de escritura entrante durante la fase de replicación. Esto puede incrementar el tiempo que se tarda en crear el índice. Debe monitorear esta estadística mientras se está creando el índice para determinar si la capacidad de escritura del índice no está suficientemente aprovisionada.

Puede ajustar la capacidad de escritura del índice mediante la operación UpdateTable, incluso durante la creación del índice.

La métrica ConsumedWriteCapacityUnits para el índice no incluye el rendimiento de escritura consumido durante la creación del índice.

nota

Es posible que esta métrica no se emita si la fase de reposición del nuevo índice secundario global se completa rápidamente (en menos de unos minutos), lo que puede ocurrir si la tabla base tiene pocos o ningún elemento que reponer en el índice.

Unidades: Count

Dimensiones: TableName, GlobalSecondaryIndexName

Estadísticas válidas:

  • Minimum

  • Maximum

  • Average

  • SampleCount

  • Sum

OnlineIndexPercentageProgress

El porcentaje de finalización cuando se agrega un nuevo índice secundario global a una tabla. DynamoDB primero debe asignar recursos para el nuevo índice y, a continuación, rellenar los atributos de la tabla en el índice. Para tablas grandes, este proceso puede llevar mucho tiempo. Debe monitorear esta estadística para ver el progreso relativo a medida que DynamoDB crea el índice.

Unidades: Count

Dimensiones: TableName, GlobalSecondaryIndexName

Estadísticas válidas:

  • Minimum

  • Maximum

  • Average

  • SampleCount

  • Sum

OnlineIndexThrottleEvents

La cantidad de eventos de limitación de escritura que se producen al agregar un nuevo índice secundario global a una tabla. Estos eventos indican que la creación del índice tardará más en completarse, ya que la actividad de escritura entrante excede el rendimiento de escritura aprovisionado del índice.

Puede ajustar la capacidad de escritura del índice mediante la operación UpdateTable, incluso durante la creación del índice.

La métrica WriteThrottleEvents para el índice no incluye ningún evento de limitación que se produzca durante la creación del índice.

Unidades: Count

Dimensiones: TableName, GlobalSecondaryIndexName

Estadísticas válidas:

  • Minimum

  • Maximum

  • Average

  • SampleCount

  • Sum

PendingReplicationCount

Métrica para Versión 2017.11.29 (heredada) de las tablas globales (solo tablas globales). La cantidad de actualizaciones de elementos que se escriben en la réplica de tabla pero que todavía no se han escrito en otra réplica de la tabla global.

Unidades: Count

Dimensiones: TableName, ReceivingRegion

Estadísticas válidas:

  • Average

  • Sample Count

  • Sum

ProvisionedReadCapacityUnits

La cantidad de unidades de capacidad de lectura aprovisionadas para una tabla o un índice secundario global. La dimensión TableName devuelve la ProvisionedReadCapacityUnits para la tabla, pero no para los índices secundarios globales. Para ver la ProvisionedReadCapacityUnits para un índice secundario global, debe especificar tanto TableName como GlobalSecondaryIndexName.

Unidades: Count

Dimensiones: TableName, GlobalSecondaryIndexName

Estadísticas válidas:

  • Minimum: la configuración más baja para la capacidad de lectura aprovisionada. Si utiliza UpdateTable para aumentar la capacidad de lectura, esta métrica muestra el valor más bajo de ReadCapacityUnits aprovisionado durante este periodo de tiempo.

  • Maximum: la configuración más alta para la capacidad de lectura aprovisionada. Si utiliza UpdateTable para reducir la capacidad de lectura, esta métrica muestra el valor más alto de ReadCapacityUnits aprovisionado durante este período de tiempo.

  • Average: la capacidad de lectura aprovisionada promedio. La métrica ProvisionedReadCapacityUnits se publica a intervalos de cinco minutos. Por lo tanto, si ajusta rápidamente las unidades de capacidad de lectura aprovisionadas, es posible que esta estadística no refleje el promedio real.

ProvisionedWriteCapacityUnits

La cantidad de unidades de capacidad de escritura aprovisionadas para una tabla o un índice secundario global.

La dimensión TableName devuelve la ProvisionedWriteCapacityUnits para la tabla, pero no para los índices secundarios globales. Para ver la ProvisionedWriteCapacityUnits para un índice secundario global, debe especificar tanto TableName como GlobalSecondaryIndexName.

Unidades: Count

Dimensiones: TableName, GlobalSecondaryIndexName

Estadísticas válidas:

  • Minimum: la configuración más baja para la capacidad de escritura aprovisionada. Si utiliza UpdateTable para aumentar la capacidad de escritura, esta métrica muestra el valor más bajo de WriteCapacityUnits aprovisionado durante este período de tiempo.

  • Maximum: la configuración más alta para la capacidad de escritura aprovisionada. Si utiliza UpdateTable para reducir la capacidad de escritura, esta métrica muestra el valor más alto de WriteCapacityUnits aprovisionado durante este período de tiempo.

  • Average: la capacidad de escritura aprovisionada promedio. La métrica ProvisionedWriteCapacityUnits se publica a intervalos de cinco minutos. Por lo tanto, si ajusta rápidamente las unidades de capacidad de escritura aprovisionadas, es posible que esta estadística no refleje el promedio real.

ReadAccountLimitThrottleEvents

El número de solicitudes de lectura limitadas debido a los límites de la cuenta.

Unidades: Count

Dimensiones: TableName, GlobalSecondaryIndexName

Estadísticas válidas:

  • Sum: el número total de eventos limitados.

  • SampleCount: número de casos de limitación.

  • Minimum: número mínimo de eventos limitados en un ejemplo determinado.

  • Maximum: número máximo de eventos limitados en un ejemplo determinado.

ReadKeyRangeThroughputThrottleEvents

El número de solicitudes de lectura limitadas debido a los límites de las particiones.

Unidades: Count

Dimensiones: TableName, GlobalSecondaryIndexName

Estadísticas válidas:

  • Sum: el número total de eventos limitados.

  • SampleCount: número de casos de limitación.

  • Minimum: número mínimo de eventos limitados en un ejemplo determinado.

  • Maximum: número máximo de eventos limitados en un ejemplo determinado.

ReadMaxOnDemandThroughputThrottleEvents

El número de solicitudes de lectura limitadas debido al rendimiento máximo bajo demanda.

Unidades: Count

Dimensiones: TableName, GlobalSecondaryIndexName

Estadísticas válidas:

  • Sum: el número total de eventos limitados.

  • SampleCount: número de casos de limitación.

  • Minimum: número mínimo de eventos limitados en un ejemplo determinado.

  • Maximum: número máximo de eventos limitados en un ejemplo determinado.

ReadProvisionedThroughputThrottleEvents

El número de solicitudes de lectura limitadas debido a los límites de rendimiento aprovisionados.

Unidades: Count

Dimensiones: TableName, GlobalSecondaryIndexName

Estadísticas válidas:

  • Sum: el número total de eventos limitados.

  • SampleCount: número de casos de limitación.

  • Minimum: número mínimo de eventos limitados en un ejemplo determinado.

  • Maximum: número máximo de eventos limitados en un ejemplo determinado.

ReadThrottleEvents

Solicitud a DynamoDB que exceden a las unidades de capacidad de lectura aprovisionadas para una tabla o un índice secundario global.

Una sola solicitud puede dar lugar a múltiples eventos. Por ejemplo, un BatchGetItem que lea 10 elementos se procesa como 10 eventos de GetItem. Para cada evento, ReadThrottleEvents se incrementa en uno si ese evento está limitado. La métrica ThrottledRequests para todo el BatchGetItem no se incrementa a menos que se limiten los 10 eventos de GetItem.

La dimensión TableName devuelve la ReadThrottleEvents para la tabla, pero no para los índices secundarios globales. Para ver la ReadThrottleEvents para un índice secundario global, debe especificar tanto TableName como GlobalSecondaryIndexName.

Unidades: Count

Dimensiones: TableName, GlobalSecondaryIndexName

Estadísticas válidas:

  • SampleCount

  • Sum

ReplicationLatency

(Esta métrica es para tablas globales de DynamoDB). El tiempo transcurrido entre la aparición de un elemento actualizado en la transmisión de DynamoDB para una réplica de tabla y la aparición de ese elemento en otra réplica de la tabla global.

Unidades: Milliseconds

Dimensiones: TableName, ReceivingRegion

Estadísticas válidas:

  • Average

  • Minimum

  • Maximum

ReturnedBytes

La cantidad de bytes devueltos por operaciones GetRecords (Amazon DynamoDB Streams) durante el periodo de tiempo especificado.

Unidades: Bytes

Dimensiones: Operation, StreamLabel, TableName

Estadísticas válidas:

  • Minimum

  • Maximum

  • Average

  • SampleCount

  • Sum

ReturnedItemCount

La cantidad de elementos devueltos por las operaciones Query, Scan o ExecuteStatement (selecto) durante el periodo de tiempo especificado.

La cantidad de elementos devueltos no es necesariamente igual a la cantidad de elementos evaluados. Por ejemplo, suponga que solicitó un Scan en una tabla o en un índice que tenía 100 elementos, pero especificó un FilterExpression que redujo los resultados de modo que solo se devolvieron 15 artículos. En este caso, la respuesta de Scan va a contener un ScanCount de 100 y un Count de 15 artículos devueltos.

Unidades: Count

Dimensiones: TableName, Operation

Estadísticas válidas:

  • Minimum

  • Maximum

  • Average

  • SampleCount

  • Sum

ReturnedRecordsCount

La cantidad de registros de transmisión devueltos por las operaciones GetRecords (Amazon DynamoDB Streams) durante el periodo de tiempo especificado.

Unidades: Count

Dimensiones: Operation, StreamLabel, TableName

Estadísticas válidas:

  • Minimum

  • Maximum

  • Average

  • SampleCount

  • Sum

SuccessfulRequestLatency

La latencia de las solicitudes correctas a DynamoDB o Amazon DynamoDB Streams durante el periodo de tiempo especificado. SuccessfulRequestLatency puede proporcionar dos tipos distintos de información:

  • El tiempo transcurrido para las solicitudes correctas (Minimum, Maximum, Sum, Average o Percentile).

  • El número de solicitudes realizadas correctamente (SampleCount).

SuccessfulRequestLatency refleja la actividad solo dentro de DynamoDB o Amazon DynamoDB Streams y no tiene en cuenta la latencia de la red ni la actividad del cliente.

nota

Para analizar valores de percentiles personalizados (como p99,9), puede introducir manualmente el percentil deseado (por ejemplo, p99,9) en el campo de estadísticas de métricas de CloudWatch. Esto le permite evaluar las distribuciones de latencia más allá de los percentiles predeterminados que aparecen en la lista desplegable.

Unidades: Milliseconds

Dimensiones: TableName, Operation, StreamLabel

Estadísticas válidas:

  • Minimum

  • Maximum

  • Sum

  • Average

  • Percentile

  • SampleCount

SystemErrors

Las solicitudes a DynamoDB o Amazon DynamoDB Streams que generan un código de estado HTTP 500 durante el periodo de tiempo especificado. Un código HTTP 500 normalmente indica un error de servicio interno.

nota

Cuando DynamoDB devuelve un error del sistema (HTTP 500), la mayoría de los AWS SDK realizan automáticamente un número configurable de reintentos. Si el problema se resuelve durante un reintento, la aplicación continúa sin detectar el error y es posible que note un aumento de la latencia percibida por parte del cliente. Si el error persiste después de todos los reintentos, se propaga al código de la aplicación.

Unidades: Count

Dimensiones: TableName, Operation

Estadísticas válidas:

  • Sum

  • SampleCount

TimeToLiveDeletedItemCount

La cantidad de elementos eliminados por Time to Live (TTL, periodo de vida) durante el periodo de tiempo especificado. Esta métrica le ayuda a monitorear la tasa de eliminaciones de TTL en la tabla.

Unidades: Count

Dimensiones: TableName

Estadísticas válidas:

  • Sum

ThrottledPutRecordCount

El número de registros que se han visto limitados por el flujo de datos de Kinesis debido a la insuficiente capacidad de Kinesis Data Streams.

Unidades: Count

Dimensiones: TableName, DelegatedOperation

Estadísticas válidas:

  • Minimum

  • Maximum

  • Average

  • SampleCount

ThrottledRequests

Solicitudes a DynamoDB que exceden los límites de rendimiento aprovisionado en un recurso (tales como una tabla o un índice).

Se incrementa ThrottledRequests en uno si algún evento de la solicitud supera el límite de rendimiento aprovisionado. Por ejemplo, si actualiza un elemento de una tabla con índices secundarios globales, hay varios eventos: una escritura en la tabla y una escritura en cada uno de los índices. Si uno o más de estos eventos están limitados, entonces ThrottledRequests se incrementa en uno.

nota

En una solicitud por lotes (BatchGetItem o BatchWriteItem), ThrottledRequests solo se incrementa si todas las solicitudes en el lote están limitadas.

Si se limita cualquier solicitud individual dentro del lote, se incrementa una de las siguientes métricas:

  • ReadThrottleEvents: para un evento GetItem limitado dentro de BatchGetItem.

  • WriteThrottleEvents: para un evento PutItem o DeleteItem limitado dentro de BatchWriteItem.

Para obtener información sobre qué evento está limitando controladamente la solicitud, compare ThrottledRequests con ReadThrottleEvents y WriteThrottleEvents para la tabla y sus índices.

nota

Una solicitud limitada dará como resultado un código de estado HTTP 400. Tales eventos se reflejan en la métrica ThrottledRequests, pero no en la métrica UserErrors.

Unidades: Count

Dimensiones: TableName, Operation

Estadísticas válidas:

  • Sum

  • SampleCount

TransactionConflict

Solicitudes a nivel de elemento rechazadas debido a conflictos transaccionales entre solicitudes simultáneas en los mismos elementos. Para obtener más información, consulte Gestión de conflictos de transacciones en DynamoDB.

Unidades: Count

Dimensiones: TableName

Estadísticas válidas:

  • Sum: la cantidad de solicitudes a nivel de elemento rechazadas debido a conflictos de transacciones.

    nota

    Si varias solicitudes a nivel de elemento dentro de una llamada a TransactWriteItems o TransactGetItems fueron rechazadas, Sum se incrementa en uno para cada solicitud a nivel de elemento Put, Update, Delete o Get.

  • SampleCount: la cantidad de solicitudes rechazadas debido a conflictos de transacciones.

    nota

    Si varias solicitudes al nivel de elemento dentro de una llamada a TransactWriteItems o TransactGetItems fueron rechazadas, SampleCount solo se incrementa en uno.

  • Min: la cantidad mínima de solicitudes a nivel de elemento rechazadas dentro de una llamada a TransactWriteItems, TransactGetItems, PutItem, UpdateItem o DeleteItem.

  • Max la cantidad máxima de solicitudes de nivel de elemento rechazadas dentro de una llamada a TransactWriteItems, TransactGetItems, PutItem, UpdateItem o DeleteItem.

  • Average la cantidad promedio de solicitudes de nivel de elemento rechazadas dentro de una llamada a TransactWriteItems, TransactGetItems, PutItem, UpdateItem o DeleteItem.

UserErrors

Solicitudes a DynamoDB o Amazon DynamoDB Streams que generan un código de estado HTTP 400 durante el periodo de tiempo especificado. Un código HTTP 400 normalmente indica un error del lado del cliente, como una combinación de parámetros no válida, un intento de actualizar una tabla inexistente o una firma de solicitud incorrecta.

Algunos ejemplos de excepciones que registrarán métricas relacionadas con UserErrors serían:

  • ResourceNotFoundException

  • ValidationException

  • TransactionConflict

Todos estos eventos se reflejan en la métrica UserErrors, a excepción de los siguientes elementos:

  • ProvisionedThroughputExceededException: consulte la métrica ThrottledRequests en esta sección.

  • ConditionalCheckFailedException: consulte la métrica ConditionalCheckFailedRequests en esta sección.

UserErrors representa la suma de errores HTTP 400 para las solicitudes de DynamoDB o Amazon DynamoDB Streams para la región de AWS y la cuenta de AWS actuales.

Unidades: Count

Estadísticas válidas:

  • Sum

  • SampleCount

WriteAccountLimitThrottleEvents

El número de solicitudes de escritura limitadas debido a los límites de la cuenta.

Unidades: Count

Dimensiones: TableName

Estadísticas válidas:

  • Sum: el número total de eventos limitados.

  • SampleCount: número de casos de limitación.

  • Minimum: número mínimo de eventos limitados en un ejemplo determinado.

  • Maximum: número máximo de eventos limitados en un ejemplo determinado.

WriteKeyRangeThroughputThrottleEvents

El número de solicitudes de escritura limitadas debido a los límites de las particiones.

Unidades: Count

Dimensiones: TableName, GlobalSecondaryIndexName

Estadísticas válidas:

  • Sum: el número total de eventos limitados.

  • SampleCount: número de casos de limitación.

  • Minimum: número mínimo de eventos limitados en un ejemplo determinado.

  • Maximum: número máximo de eventos limitados en un ejemplo determinado.

WriteMaxOnDemandThroughputThrottleEvents

El número de solicitudes de escritura se ha limitado debido al rendimiento máximo bajo demanda.

Unidades: Count

Dimensiones: TableName, GlobalSecondaryIndexName

Estadísticas válidas:

  • Sum: el número total de eventos limitados.

  • SampleCount: número de casos de limitación.

  • Minimum: número mínimo de eventos limitados en un ejemplo determinado.

  • Maximum: número máximo de eventos limitados en un ejemplo determinado.

WriteProvisionedThroughputThrottleEvents

El número de solicitudes de escritura limitadas debido a los límites de rendimiento aprovisionados.

Unidades: Count

Dimensiones: TableName, GlobalSecondaryIndexName

Estadísticas válidas:

  • Sum: el número total de eventos limitados.

  • SampleCount: número de casos de limitación.

  • Minimum: número mínimo de eventos limitados en un ejemplo determinado.

  • Maximum: número máximo de eventos limitados en un ejemplo determinado.

WriteThrottleEvents

Solicitudes a DynamoDB que exceden las unidades de capacidad de escritura aprovisionadas para una tabla o un índice secundario global.

Una sola solicitud puede dar lugar a múltiples eventos. Por ejemplo, una solicitud PutItem en una tabla con tres índices secundarios globales daría como resultado cuatro eventos: la escritura de la tabla y la escritura de cada uno de los tres índices. Para cada evento, la métrica WriteThrottleEvents se incrementa en uno si ese evento está limitado. Para una sola solicitud PutItem, si alguno de los eventos está limitado, ThrottledRequests también se incrementa en uno. Para BatchWriteItem, la métrica ThrottledRequests para toda la BatchWriteItem no se incrementa a menos que se limiten todos los eventos PutItem o DeleteItem.

La dimensión TableName devuelve la WriteThrottleEvents para la tabla, pero no para los índices secundarios globales. Para ver la WriteThrottleEvents para un índice secundario global, debe especificar tanto TableName como GlobalSecondaryIndexName.

Unidades: Count

Dimensiones: TableName, GlobalSecondaryIndexName

Estadísticas válidas:

  • Sum

  • SampleCount

Métricas de uso

Las métricas de uso de CloudWatch le permiten administrar el uso de forma proactiva mediante la visualización de métricas en la consola de CloudWatch, la creación de paneles personalizados, la detección de cambios en la actividad con la detección de anomalías de CloudWatch y la configuración de alarmas que le avisan cuando el uso se acerca a un umbral.

DynamoDB también integra estas métricas de uso con Service Quotas. Puede usar CloudWatch para administrar el uso de las cuotas de servicio de la cuenta. Para obtener más información acerca, consulte Visualización de las cuotas de servicio y configuración de alarmas.

AccountProvisionedWriteCapacityUnits

La suma de las unidades de capacidad de escritura aprovisionadas para todas las tablas e índices secundarios globales de una cuenta.

Unidades: Count

Estadísticas válidas:

  • Minimum: el menor número de unidades de capacidad de escritura aprovisionadas durante un periodo de tiempo.

  • Maximum: el mayor número de unidades de capacidad de escritura aprovisionadas durante un periodo de tiempo.

  • Average: el número promedio de unidades de capacidad de escritura aprovisionadas durante un periodo de tiempo.

Esta métrica se publica a intervalos de cinco minutos. Por lo tanto, si ajusta rápidamente las unidades de capacidad de escritura aprovisionadas, es posible que esta estadística no refleje el promedio real.

AccountProvisionedReadCapacityUnits

La suma de las unidades de capacidad de lectura aprovisionadas para todas las tablas e índices secundarios globales de una cuenta.

Unidades: Count

Estadísticas válidas:

  • Minimum: el menor número de unidades de capacidad de lectura aprovisionadas durante un periodo de tiempo.

  • Maximum: el mayor número de unidades de capacidad de lectura aprovisionadas durante un periodo de tiempo.

  • Average: el número promedio de unidades de capacidad de lectura aprovisionadas durante un periodo de tiempo.

Esta métrica se publica a intervalos de cinco minutos. Por lo tanto, si ajusta rápidamente las unidades de capacidad de lectura aprovisionadas, es posible que esta estadística no refleje el promedio real.

TableCount

Número de tablas de activas de una cuenta.

Unidades: Count

Estadísticas válidas:

  • Minimum: el menor número de tablas durante un periodo de tiempo.

  • Maximum: el mayor número de tablas durante un periodo de tiempo.

  • Average: el número promedio de tablas durante un periodo de tiempo.

Descripción de las métricas y dimensiones de DynamoDB

Las métricas de DynamoDB se identifican por los valores de la cuenta, el nombre de la tabla, el nombre del índice secundario global o la operación. Puede usar la consola de CloudWatch para recuperar los datos de DynamoDB junto con cualquier dimensión de la siguiente tabla.

DelegatedOperation

Esta dimensión limita los datos a las operaciones que DynamoDB realiza en su nombre. Las siguientes operaciones están capturadas:

  • Cambie la captura de datos para Kinesis Data Streams

GlobalSecondaryIndexName

Esta dimensión limita los datos a un índice secundario global de una tabla. Si especifica GlobalSecondaryIndexName, también debe especificar TableName.

Operación

Esta dimensión limita los datos a una de las siguientes operaciones de DynamoDB:

  • PutItem

  • DeleteItem

  • UpdateItem

  • GetItem

  • BatchGetItem

  • Scan

  • Query

  • BatchWriteItem

  • TransactWriteItems

  • TransactGetItems

  • ExecuteTransaction

  • BatchExecuteStatement

  • ExecuteStatement

Además, puede limitar los datos a la siguiente operación de Amazon DynamoDB Streams:

  • GetRecords

OperationType

Esta dimensión limita los datos a uno de los siguientes tipos de operaciones:

  • Read

  • Write

Esta dimensión se emite para las solicitudes ExecuteTransaction y BatchExecuteStatement.

Verbo

Esta dimensión limita los datos a una de los siguientes verbos PartiQL de DynamoDB:

  • Inserte: PartiQLInsert

  • Seleccionar: PartiQLSelect

  • Actualizar: PartiQLUpdate

  • Eliminar: PartiQLDelete

Esta dimensión se emite para la operación ExecuteStatement.

ReceivingRegion

Esta dimensión limita los datos a una región de AWS particular. Se utiliza con métricas procedentes de réplicas de tablas dentro de una tabla global de DynamoDB.

StreamLabel

Esta dimensión limita los datos a una etiqueta de transmisión específica. Se utiliza con métricas procedentes de operaciones GetRecords de Amazon DynamoDB Streams.

TableName

Esta dimensión limita los datos a una tabla específica. Este valor puede ser cualquier nombre de tabla en la región actual y la cuenta AWS actual.