Métricas e dimensões do DynamoDB

Quando você interage com o DynamoDB, ele envia as métricas e as dimensões ao CloudWatch.

As saídas do DynamoDB consumiram o throughput provisionado por períodos de um minuto. O ajuste de escala automático é acionado quando a capacidade consumida ultrapassa a meta de utilização configurada em dois minutos consecutivos. Os alarmes do CloudWatch podem ter um pequeno atraso de até alguns minutos antes de acionar o ajuste de escala automático. Esse atraso garante uma avaliação precisa da métrica do CloudWatch. Se os picos de throughput consumidos tiverem mais de um minuto de intervalo, o ajuste de escala automático poderá não ser acionado. Da mesma forma, um evento de redução de escala verticalmente pode ocorrer quando 15 pontos de dados consecutivos estão abaixo da meta de utilização. Nos dois casos, depois que o ajuste de escala automático é acionado, a API UpdateTable é invocada. Depois, leva alguns minutos para atualizar a capacidade provisionada da tabela ou do índice. Durante esse período, todas as solicitações que excederem a capacidade provisionada anterior das tabelas terão controle de utilização.

Visualizar métricas e dimensões

O CloudWatch exibe as seguintes métricas do DynamoDB:

Métricas do DynamoDB

Nem todas as estatísticas, como Média ou Soma, são aplicáveis a todas as métricas. No entanto, todos esses valores estão disponíveis por meio do console do Amazon DynamoDB ou usando o console do CloudWatch, AWS CLI ou AWS SDKs para todas as métricas.

Na tabela a seguir, cada métrica tem um conjunto de estatísticas válidas aplicáveis a essa métrica.

AccountMaxReads

O número máximo de unidades de capacidade de leitura que podem ser usadas por uma conta. Esse limite não se aplica a tabelas sob demanda nem a índices secundários globais.

Unidades: Count

Estatística válida:

AccountMaxTableLevelReads

O número máximo de unidades de capacidade de leitura que podem ser usadas por uma tabela ou um índice secundário global de uma conta. Em relação a tabelas sob demanda, esse valor limita o máximo de unidades de solicitação de leitura que uma tabela ou um índice secundário global pode usar.

Unidades: Count

Estatística válida:

AccountMaxTableLevelWrites

O número máximo de unidades de capacidade de gravação que podem ser usadas por uma tabela ou um índice secundário global de uma conta. Em relação a tabelas sob demanda, esse valor limita o máximo de unidades de solicitação de gravação que uma tabela ou um índice secundário global pode usar.

Unidades: Count

Estatística válida:

AccountMaxWrites

O número máximo de unidades de capacidade de gravação que podem ser usadas por uma conta. Esse limite não se aplica a tabelas sob demanda nem a índices secundários globais.

Unidades: Count

Estatística válida:

AccountProvisionedReadCapacityUtilization

O percentual de unidades de capacidade de leitura provisionada utilizadas por uma conta.

Unidades: Percent

Estatística válida:

AccountProvisionedWriteCapacityUtilization

A porcentagem de unidades de capacidade de gravação provisionada utilizadas por uma conta.

Unidades: Percent

Estatística válida:

AgeOfOldestUnreplicatedRecord

O tempo decorrido desde que um registro que ainda deve ser replicado para o fluxo de dados do Kinesis apareceu pela primeira vez na tabela do DynamoDB.

Unidades: Milliseconds

Dimensões: TableName, DelegatedOperation

Estatística válida:

ConditionalCheckFailedRequests

O número de tentativas de executar gravações condicionais que tiveram falha. As operações PutItem, UpdateItem e DeleteItem permitem que você forneça uma condição lógica que deve ser avaliada como true antes que a operação possa prosseguir. Se essa condição for avaliada como false, ConditionalCheckFailedRequests será incrementado em uma unidade. ConditionalCheckFailedRequests também será incrementado em uma unidade para as instruções PartiQL Update e Delete em que uma condição lógica é fornecida e essa condição é avaliada como false.

Unidades: Count

Dimensões: TableName

Estatística válida:

ConsumedChangeDataCaptureUnits

O número de unidades de captura de dados de alteração consumidas.

Unidades: Count

Dimensões: TableName, DelegatedOperation

Estatística válida:

ConsumedReadCapacityUnits

O número de unidades de capacidade de leitura consumidas ao longo do período especificado para a capacidade provisionada e sob demanda para que você possa acompanhar quanto do throughput foi usado. Você pode recuperar a capacidade de leitura total consumida para uma tabela e todos os seus índices secundários globais ou para um índice secundário global específico. Para obter mais informações, consulte Modo de capacidade de Leitura/Gravação.

A dimensão TableName retorna o ConsumedReadCapacityUnits para a tabela, mas não para nenhum índice secundário global. Para visualizar ConsumedReadCapacityUnits para um índice secundário global, você deve especificar TableName e GlobalSecondaryIndexName.

Unidades: Count

Dimensões: TableName, GlobalSecondaryIndexName

Estatística válida:

ConsumedWriteCapacityUnits

O número de unidades de capacidade de gravação consumidas ao longo do período especificado para a capacidade provisionada e sob demanda para que você possa acompanhar quanto do throughput foi usado. Você pode recuperar a capacidade de gravação total consumida para uma tabela e todos os seus índices secundários globais ou para um índice secundário global específico. Para obter mais informações, consulte Modo de capacidade de Leitura/Gravação.

A dimensão TableName retorna o ConsumedWriteCapacityUnits para a tabela, mas não para nenhum índice secundário global. Para visualizar ConsumedWriteCapacityUnits para um índice secundário global, você deve especificar TableName e GlobalSecondaryIndexName.

Unidades: Count

Dimensões: TableName, GlobalSecondaryIndexName

Estatística válida:

FailedToReplicateRecordCount

Número de registros que o DynamoDB não conseguiu replicar no fluxo de dados do Kinesis.

Unidades: Count

Dimensões: TableName, DelegatedOperation

Estatística válida:

MaxProvisionedTableReadCapacityUtilization

O percentual da capacidade de leitura provisionada utilizada pela tabela de leitura provisionada mais alta ou pelo índice secundário global de uma conta.

Unidades: Percent

Estatística válida:

MaxProvisionedTableWriteCapacityUtilization

A porcentagem da capacidade de gravação provisionada utilizada pela tabela de gravação provisionada mais alta ou pelo índice secundário global de uma conta.

Unidades: Percent

Estatística válida:

OnDemandMaxReadRequestUnits

O número de unidades de solicitação de leitura sob demanda especificado para uma tabela ou um índice secundário global.

Para visualizar OnDemandMaxReadRequestUnits referente a uma tabela, é necessário especificar TableName. Para visualizar OnDemandMaxReadRequestUnits para um índice secundário global, você deve especificar TableName e GlobalSecondaryIndexName.

Unidades: contagem

Dimensões: TableName, GlobalSecondaryIndexName

Estatística válida:

OnDemandMaxWriteRequestUnits

O número de unidades de solicitação de gravação sob demanda especificado para uma tabela ou um índice secundário global.

Para visualizar OnDemandMaxWriteRequestUnits referente a uma tabela, é necessário especificar TableName. Para visualizar OnDemandMaxWriteRequestUnits para um índice secundário global, você deve especificar TableName e GlobalSecondaryIndexName.

Unidades: Count

Dimensões: TableName, GlobalSecondaryIndexName

Estatística válida:

OnlineIndexConsumedWriteCapacity

O número de unidades de capacidade de gravação consumidas ao adicionar um novo índice secundário global a uma tabela. Se a capacidade de gravação do índice for muito baixa, a atividade de gravação de entrada durante a fase de alocação poderá ser limitada. Isso pode aumentar o tempo necessário para criar o índice. Você deve monitorar essa estatística enquanto o índice está sendo criado para determinar se a capacidade de gravação do índice está subprovisionada.

É possível ajustar a capacidade de gravação do índice usando a operação UpdateTable, mesmo enquanto o índice ainda está sendo construído.

A métrica ConsumedWriteCapacityUnits para o índice não inclui o throughput de gravação consumido durante a criação do índice.

Unidades: Count

Dimensões: TableName, GlobalSecondaryIndexName

Estatística válida:

OnlineIndexPercentageProgress

A porcentagem de conclusão quando um novo índice secundário global está sendo adicionado a uma tabela. O DynamoDB deve primeiro alocar recursos para o novo índice e, em seguida, alocar atributos da tabela para o índice. Para tabelas grandes, esse processo pode ser demorado. Você deve monitorar essa estatística para visualizar o progresso relativo à medida que o DynamoDB constrói o índice.

Unidades: Count

Dimensões: TableName, GlobalSecondaryIndexName

Estatística válida:

OnlineIndexThrottleEvents

O número de eventos de limitação de gravação que ocorrem ao adicionar um novo índice secundário global a uma tabela. Esses eventos indicam que a criação do índice levará mais tempo para ser concluída, pois a atividade de gravação de entrada está excedendo throughput de gravação provisionado do índice.

É possível ajustar a capacidade de gravação do índice usando a operação UpdateTable, mesmo enquanto o índice ainda está sendo construído.

A métrica WriteThrottleEvents para o índice não inclui eventos de controle de utilização ocorridos durante a criação do índice.

Unidades: Count

Dimensões: TableName, GlobalSecondaryIndexName

Estatística válida:

PendingReplicationCount

Métrica para Global Tables versão 2017.11.29 (herdada) (somente tabelas globais). O número de atualizações de itens que foram gravadas em uma tabela de réplica, mas ainda não foram gravadas em outra réplica na tabela global.

Unidades: Count

Dimensões: TableName, ReceivingRegion

Estatística válida:

ProvisionedReadCapacityUnits

O número de unidades de capacidade de leitura provisionada para uma tabela ou um índice secundário global. A dimensão TableName retorna o ProvisionedReadCapacityUnits para a tabela, mas não para nenhum índice secundário global. Para visualizar ProvisionedReadCapacityUnits para um índice secundário global, você deve especificar TableName e GlobalSecondaryIndexName.

Unidades:Count

Dimensões: TableName, GlobalSecondaryIndexName

Estatística válida:

ProvisionedWriteCapacityUnits

O número de unidades de capacidade de gravação provisionada para uma tabela ou um índice secundário global.

A dimensão TableName retorna o ProvisionedWriteCapacityUnits para a tabela, mas não para nenhum índice secundário global. Para visualizar ProvisionedWriteCapacityUnits para um índice secundário global, você deve especificar TableName e GlobalSecondaryIndexName.

Unidades: Count

Dimensões: TableName, GlobalSecondaryIndexName

Estatística válida:

ReadThrottleEvents

Solicitações ao DynamoDB que excedem as unidades de capacidade de leitura provisionada para uma tabela ou um índice secundário global.

Uma única solicitação pode resultar em vários eventos. Por exemplo, um BatchGetItem que lê 10 itens é processado como 10 eventos GetItem. Para cada evento, ReadThrottleEvents será incrementado em uma unidade se esse evento for limitado. A métrica ThrottledRequests para todo o BatchGetItem não será incrementada, a menos que todos os 10 dos eventos GetItemsejam limitados.

A dimensão TableName retorna o ReadThrottleEvents para a tabela, mas não para nenhum índice secundário global. Para visualizar ReadThrottleEvents para um índice secundário global, você deve especificar TableName e GlobalSecondaryIndexName.

Unidades: Count

Dimensões: TableName, GlobalSecondaryIndexName

Estatística válida:

ReplicationLatency

(Esta métrica é para tabelas globais do DynamoDB.) O tempo decorrido entre um item atualizado aparecer no fluxo do DynamoDB para uma tabela-réplica e aparecer em outra réplica na tabela global.

Unidades: Milliseconds

Dimensões: TableName, ReceivingRegion

Estatística válida:

ReturnedBytes

O número de bytes retornados por operações GetRecords (Amazon DynamoDB Streams) durante o período especificado.

Unidades: Bytes

Dimensões: Operation, StreamLabel, TableName

Estatística válida:

ReturnedItemCount

A quantidade de itens retornados por operações Query, Scan ou ExecuteStatement (selecionar) durante o período especificado.

O número de itens retornados não necessariamente é o mesmo que o número de itens avaliados. Por exemplo, suponha que você tenha solicitado um Scan em uma tabela ou um índice que tinha 100 itens, mas especificou um FilterExpressionque reduziu os resultados para que apenas 15 itens fossem retornados. Nesse caso, a resposta de Scan conteria um ScanCount de 100 e um Count de 15 itens retornados.

Unidades: Count

Dimensões: TableName, Operation

Estatística válida:

ReturnedRecordsCount

O número de registros de fluxo retornados por operações GetRecords (Amazon DynamoDB Streams) durante o período especificado.

Unidades: Count

Dimensões: Operation, StreamLabel, TableName

Estatística válida:

SuccessfulRequestLatency

As solicitações bem-sucedidas para o DynamoDB ou Amazon DynamoDB Streams durante o período especificado. O SuccessfulRequestLatency pode fornecer dois tipos diferentes de informações:

SuccessfulRequestLatency reflete a atividade somente no DynamoDB ou no Amazon DynamoDB Streams e não leva em conta a latência da rede nem a atividade no lado do cliente.

Unidades: Milliseconds

Dimensões: TableName, Operation, StreamLabel

Estatística válida:

SystemErrors

As solicitações ao DynamoDB ou Amazon DynamoDB Streams que geram um código de status HTTP 500 durante o período especificado. Um HTTP 500 geralmente indica um erro de serviço interno.

Unidades: Count

Dimensões: TableName, Operation

Estatística válida:

TimeToLiveDeletedItemCount

A quantidade de itens excluídos por vida útil (TTL) durante o período especificado. Essa métrica ajuda a monitorar a taxa de exclusões de TTL em sua tabela.

Unidades: Count

Dimensões: TableName

Estatística válida:

ThrottledPutRecordCount

Número de registros que foram suprimidos pelo seu fluxo de dados do Kinesis devido a capacidade insuficiente do Kinesis Data Streams.

Unidades: Count

Dimensões: TableName, DelegateDoperation

Estatística válida:

ThrottledRequests

Solicitações ao DynamoDB que excedem os limites de throughput provisionado em um recurso (como uma tabela ou um índice).

ThrottledRequests será incrementado em uma unidade se um evento em uma solicitação exceder o limite de throughput provisionado. Por exemplo, se você atualizar um item em uma tabela com índices secundários globais, haverá vários eventos — uma gravação na tabela e uma gravação em cada índice. Se um ou mais desses eventos for limitado, ThrottledRequests será incrementado em uma unidade.

Para ter uma ideia sobre qual evento está controlando a utilização de uma solicitação, compare ThrottledRequests com ReadThrottleEvents e WriteThrottleEvents para a tabela e seus índices.

Unidades: Count

Dimensões: TableName, Operation

Estatística válida:

TransactionConflict

Solicitações em nível de item rejeitadas devido a conflitos transacionais entre solicitações concorrentes nos mesmos itens. Para obter mais informações, consulte Tratamento de conflitos de transações no DynamoDB.

Unidades: Count

Dimensões: TableName

Estatística válida:

UserErrors

Solicitações ao DynamoDB ou Amazon DynamoDB Streams que geram um código de status HTTP 400 durante o período especificado. Um código HTTP 400 geralmente indica um erro no lado do cliente, como uma combinação inválida de parâmetros, uma tentativa de atualizar uma tabela inexistente ou uma assinatura de solicitação incorreta.

Alguns exemplos de exceções que registrarão em log métricas relacionadas a UserErrors:

Todos esses eventos são refletidos na métrica UserErrors, com exceção de:

UserErrors representa o agregado de erros HTTP 400 para solicitações do DynamoDB ou do Amazon DynamoDB Streams para a região da AWS atual e a conta da AWS atual.

Unidades: Count

Estatística válida:

WriteThrottleEvents

Solicitações ao DynamoDB que excedem as unidades de capacidade de gravação provisionada para uma tabela ou um índice secundário global.

Uma única solicitação pode resultar em vários eventos. Por exemplo, uma solicitação PutItem em uma tabela com três índices secundários globais resultaria em quatro eventos: a gravação da tabela e cada uma das três gravações do índice. Para cada evento, a métrica WriteThrottleEvents será incrementada em uma unidade se esse evento for limitado. Para solicitações PutItem individuais, se houver limitação para qualquer um dos eventos, ThrottledRequests também será incrementado em uma unidade. Para BatchWriteItem, a métrica ThrottledRequests para todo o BatchWriteItem não será incrementada, a menos que todos os eventos PutItem ou DeleteItem individuais tenham limitação.

A dimensão TableName retorna o WriteThrottleEvents para a tabela, mas não para nenhum índice secundário global. Para visualizar WriteThrottleEvents para um índice secundário global, você deve especificar TableName e GlobalSecondaryIndexName.

Unidades: Count

Dimensões: TableName, GlobalSecondaryIndexName

Estatística válida:

Métricas de uso

As métricas de uso no CloudWatch permitem gerenciar o uso visualizando proativamente métricas no console do CloudWatch, criando painéis personalizados, detectando alterações na atividade com a detecção de anomalias do CloudWatch e configurando alarmes que avisam quando o uso se aproxima de um limite.

O DynamoDB também integra essas métricas de uso ao Service Quotas. É possível usar o CloudWatch para gerenciar o uso das service quotas por sua conta. Para obter mais informações, consulte Visualizar service quotas e definir alarmes.

AccountProvisionedWriteCapacityUnits

A soma de unidades de capacidade de gravação provisionadas para todos os índices secundários globais e tabelas de uma conta.

Unidades: Count

Estatística válida:

A métrica é publicada em intervalos de cinco minutos. Portanto, se você ajustar rapidamente as unidades de capacidade de gravação provisionada, essa estatística poderá não refletir a média real.

AccountProvisionedReadCapacityUnits

A soma de unidades de capacidade de leitura provisionadas para todos os índices secundários globais e tabelas de uma conta.

Unidades: Count

Estatística válida:

A métrica é publicada em intervalos de cinco minutos. Portanto, se você ajustar rapidamente as unidades de capacidade de leitura provisionada, essa estatística poderá não refletir a média real.

TableCount

O número de tabelas ativas de uma conta.

Unidades: Count

Estatística válida:

Informações sobre métricas e dimensões para o DynamoDB

As métricas para o DynamoDB são qualificadas de acordo com os valores para a conta, nome da tabela, nome do índice secundário global ou operação. Você pode usar o console do CloudWatch para recuperar dados do DynamoDB em qualquer uma das dimensões da tabela abaixo.

DelegatedOperation

Essa dimensão limita os dados às operações que o DynamoDB executa em seu nome. As seguintes operações são capturadas:

GlobalSecondaryIndexName

Esta dimensão limita os dados a um índice secundário global em uma tabela. Se você especificar GlobalSecondaryIndexName, também deverá especificar TableName.

Operation

Esta dimensão limita os dados a uma das seguintes operações do DynamoDB:

Além disso, você pode limitar os dados à seguinte operação do Amazon DynamoDB Streams:

OperationType

Esta dimensão limita os dados a um dos seguintes tipos de operação:

Esta dimensão é emitida para solicitações ExecuteTransaction e BatchExecuteStatement.

Verb

Esta dimensão limita os dados a um dos seguintes verbos PartiQL do DynamoDB:

Essa dimensão é emitida para a operação ExecuteStatement.

ReceivingRegion

Esta dimensão limita os dados a uma região da AWS específica. Ela é usada com métricas provenientes de tabelas de réplica em uma tabela global do DynamoDB.

StreamLabel

Esta dimensão limita os dados a um rótulo de fluxo específico. Ela é usada com métricas provenientes de operações GetRecords do Amazon DynamoDB Streams

TableName

Esta dimensão limita os dados a uma tabela específica. Este valor pode ser qualquer nome de tabela na região atual e na conta da AWS atual.