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
-
ReadThrottleEvents
-
ReturnedBytes
-
ReturnedItemCount
-
ReturnedRecordsCount
-
SuccessfulRequestLatency
-
SystemErrors
-
TimeToLiveDeletedItemCount
-
ThrottledRequests
-
TransactionConflict
-
UserErrors
-
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.
Lista de métricas disponibles
- AccountMaxReads
- AccountMaxTableLevelReads
- AccountMaxTableLevelWrites
- AccountMaxWrites
- AccountProvisionedReadCapacityUtilization
- AccountProvisionedWriteCapacityUtilization
- AgeOfOldestUnreplicatedRecord
- CondicionalCheckFailedRequests
- ConsumedChangeDataCaptureUnits
- ConsumedReadCapacityUnits
- ConsumedWriteCapacityUnits
- FailedToReplicateRecordCount
- MaxProvisionedTableReadCapacityUtilization
- MaxProvisionedTableWriteCapacityUtilization
- OnDemandMaxReadRequestUnits
- OnDemandMaxWriteRequestUnits
- OnlineIndexConsumedWriteCapacity
- OnlineIndexPercentageProgress
- OnlineIndexThrottleEvents
- PendingReplicationCount
- ProvisionedReadCapacityUnits
- ProvisionedWriteCapacityUnits
- ReadThrottleEvents
- ReplicationLatency
- ReturnedBytes
- ReturnedItemCount
- ReturnedRecordsCount
- SuccessfulRequestLatency
- SystemErrors
- TimeToLiveDeletedItemCount
- ThrottledPutRecordCount
- ThrottledRequests
- TransactionConflict
- UserErrors
- WriteThrottleEvents
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
En Amazon DynamoDB, la métrica de capacidad consumida se notifica a CloudWatch en intervalos de un minuto como un valor medio. 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étricaConsumedReadCapacityUnits
. -
SampleCount
: la cantidad de solicitudes de lectura a DynamoDB. Devuelve 0 si no se ha consumido capacidad de lectura.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étricaConsumedWriteCapacityUnits
. -
SampleCount
: la cantidad de solicitudes de escritura a DynamoDB, incluso si no se ha consumido capacidad de escritura.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 utilizaUpdateTable
para aumentar las unidades de solicitud de lectura, esta métrica muestra el valor mínimo deReadRequestUnits
bajo demanda durante este periodo de tiempo. -
Maximum
: la configuración máxima para las unidades de solicitud de lectura bajo demanda. Si utilizaUpdateTable
para reducir las unidades de solicitud de lectura, esta métrica muestra el valor máximo deReadRequestUnits
bajo demanda durante este periodo de tiempo. -
Average
: el promedio de unidades de solicitud de lectura bajo demanda. La métricaOnDemandMaxReadRequestUnits
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 utilizaUpdateTable
para aumentar las unidades de solicitud de escritura, esta métrica muestra el valor mínimo deWriteRequestUnits
bajo demanda durante este periodo de tiempo. -
Maximum
: la configuración máxima para las unidades de solicitud de escritura bajo demanda. Si utilizaUpdateTable
para reducir las unidades de solicitud de escritura, esta métrica muestra el valor máximo deWriteRequestUnits
bajo demanda durante este periodo de tiempo. -
Average
: el promedio de unidades de solicitud de escritura bajo demanda. La métricaOnDemandMaxWriteRequestUnits
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 utilizaUpdateTable
para aumentar la capacidad de lectura, esta métrica muestra el valor más bajo deReadCapacityUnits
aprovisionado durante este periodo de tiempo. -
Maximum
: la configuración más alta para la capacidad de lectura aprovisionada. Si utilizaUpdateTable
para reducir la capacidad de lectura, esta métrica muestra el valor más alto deReadCapacityUnits
aprovisionado durante este período de tiempo. -
Average
: la capacidad de lectura aprovisionada promedio. La métricaProvisionedReadCapacityUnits
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 utilizaUpdateTable
para aumentar la capacidad de escritura, esta métrica muestra el valor más bajo deWriteCapacityUnits
aprovisionado durante este período de tiempo. -
Maximum
: la configuración más alta para la capacidad de escritura aprovisionada. Si utilizaUpdateTable
para reducir la capacidad de escritura, esta métrica muestra el valor más alto deWriteCapacityUnits
aprovisionado durante este período de tiempo. -
Average
: la capacidad de escritura aprovisionada promedio. La métricaProvisionedWriteCapacityUnits
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.
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
oAverage
). -
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.
Unidades: Milliseconds
Dimensiones: TableName, Operation, StreamLabel
Estadísticas válidas:
-
Minimum
-
Maximum
-
Average
-
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.
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 eventoGetItem
limitado dentro deBatchGetItem
. -
WriteThrottleEvents
: para un eventoPutItem
oDeleteItem
limitado dentro deBatchWriteItem
.
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
oTransactGetItems
fueron rechazadas,Sum
se incrementa en uno para cada solicitud a nivel de elementoPut
,Update
,Delete
oGet
. -
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
oTransactGetItems
fueron rechazadas,SampleCount
solo se incrementa en uno. -
Min
: la cantidad mínima de solicitudes a nivel de elemento rechazadas dentro de una llamada aTransactWriteItems
,TransactGetItems
,PutItem
,UpdateItem
oDeleteItem
. -
Max
la cantidad máxima de solicitudes de nivel de elemento rechazadas dentro de una llamada aTransactWriteItems
,TransactGetItems
,PutItem
,UpdateItem
oDeleteItem
. -
Average
la cantidad promedio de solicitudes de nivel de elemento rechazadas dentro de una llamada aTransactWriteItems
,TransactGetItems
,PutItem
,UpdateItem
oDeleteItem
.
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
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.
Lista de métricas de uso disponibles
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.
Lista de dimensiones disponibles
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.