Métricas e dimensões do DynamoDB - Amazon DynamoDB

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

nota

O Amazon CloudWatch agrega essas métricas em intervalos de um minuto:

  • ConditionalCheckFailedRequests

  • ConsumedReadCapacityUnits

  • ConsumedWriteCapacityUnits

  • ReadThrottleEvents

  • ReturnedBytes

  • ReturnedItemCount

  • ReturnedRecordsCount

  • SuccessfulRequestLatency

  • SystemErrors

  • TimeToLiveDeletedItemCount

  • ThrottledRequests

  • TransactionConflict

  • UserErrors

  • WriteThrottleEvents

Para todas as métricas do DynamoDB, a granularidade de agregação é de cinco minutos.

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:

  • Maximum: o número máximo de unidades de capacidade de leitura que podem ser usadas por uma conta.

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:

  • Maximum: o número máximo de unidades de capacidade de leitura que podem ser usadas por uma tabela ou um índice secundário global da conta.

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:

  • Maximum: 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 da conta.

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:

  • Maximum: o número máximo de unidades de capacidade de gravação que podem ser usadas por uma conta.

AccountProvisionedReadCapacityUtilization

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

Unidades: Percent

Estatística válida:

  • Maximum: o percentual máximo de unidades de capacidade de leitura provisionada utilizadas pela conta.

  • Minimum: o percentual mínimo de unidades de capacidade de leitura provisionada utilizadas pela conta.

  • Average: o percentual médio de unidades de capacidade de leitura provisionada utilizadas pela conta. A métrica é publicada para 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.

AccountProvisionedWriteCapacityUtilization

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

Unidades: Percent

Estatística válida:

  • Maximum: a porcentagem máxima de unidades de capacidade de gravação provisionada utilizadas pela conta.

  • Minimum: a porcentagem mínima de unidades de capacidade de gravação provisionada utilizadas pela conta.

  • Average: a porcentagem média de unidades de capacidade de gravação provisionada utilizadas pela conta. A métrica é publicada para 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.

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:

  • Maximum.

  • Minimum.

  • Average.

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.

nota

Uma gravação condicional com falha resultará em um erro HTTP 400 (Solicitação inválida). Esses eventos são refletidos na métricaConditionalCheckFailedRequests, mas não na métrica UserErrors.

Unidades: Count

Dimensões: TableName

Estatística válida:

  • Minimum

  • Maximum

  • Average

  • SampleCount

  • Sum

ConsumedChangeDataCaptureUnits

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

Unidades: Count

Dimensões: TableName, DelegatedOperation

Estatística válida:

  • Minimum

  • Maximum

  • Average

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.

nota

No Amazon DynamoDB, a métrica de capacidade consumida é relatada ao CloudWatch em intervalos de um minuto como valor médio. Isso significa que picos curtos e intensos no consumo de capacidade que duram apenas um segundo podem não ser refletidos com precisão no grafo do CloudWatch, o que pode indicar uma menor taxa de consumo aparente naquele minuto.

Use a estatística Sum para calcular o throughput consumido. Por exemplo, obtenha o valor Sum ao longo de um intervalo de um minuto e divida-o pelo número de segundos em um minuto (60) para calcular a média de ConsumedReadCapacityUnits por segundo. Você pode comparar o valor calculado com o valor do throughput provisionado fornecido ao DynamoDB.

Unidades: Count

Dimensões: TableName, GlobalSecondaryIndexName

Estatística válida:

  • Minimum: o número mínimo de unidades de capacidade de leitura consumidas por qualquer solicitação individual para a tabela ou o índice.

  • Maximum: o número máximo de unidades de capacidade de leitura consumidas por qualquer solicitação individual para a tabela ou o índice.

  • Average: a capacidade de leitura por solicitação média consumida.

    nota

    O valor Average é influenciado por períodos de inatividade em que o valor da amostra será zero.

  • Sum: o total de unidades de capacidade de leitura consumidas. Essa é a estatística mais útil para a métrica ConsumedReadCapacityUnits.

  • SampleCount: o número de solicitações de leitura para o DynamoDB. Exibirá 0 se nenhuma capacidade de leitura tiver sido consumida.

    nota

    O valor SampleCount é influenciado por períodos de inatividade em que o valor da amostra será zero.

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.

nota

Use a estatística Sum para calcular o throughput consumido. Por exemplo, apure o valor Sum ao longo de um intervalo de um minuto e divida-o pelo número de segundos em um minuto (60) para calcular a ConsumedWriteCapacityUnits média por segundo (reconhecendo que essa média não destaca picos grandes, mas picos breves na atividade de gravação que ocorreram durante esse minuto). Você pode comparar o valor calculado com o valor do throughput provisionado fornecido ao DynamoDB.

Unidades: Count

Dimensões: TableName, GlobalSecondaryIndexName

Estatística válida:

  • Minimum: o número mínimo de unidades de capacidade de gravação consumidas por qualquer solicitação individual para a tabela ou o índice.

  • Maximum: o número máximo de unidades de capacidade de gravação consumidas por qualquer solicitação individual para a tabela ou o índice.

  • Average: a capacidade de gravação por solicitação média consumida.

    nota

    O valor Average é influenciado por períodos de inatividade em que o valor da amostra será zero.

  • Sum: o total de unidades de capacidade de gravação consumidas. Essa é a estatística mais útil para a métrica ConsumedWriteCapacityUnits.

  • SampleCount: o número de solicitações de gravação para o DynamoDB, mesmo que nenhuma capacidade de gravação tenha sido consumida.

    nota

    O valor SampleCount é influenciado por períodos de inatividade em que o valor da amostra será zero.

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:

  • Sum

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:

  • Maximum: a porcentagem máxima de unidades de capacidade de leitura provisionada utilizada pela tabela de leitura provisionada mais alta ou pelo índice secundário global de uma conta.

  • Minimum: a porcentagem mínima de unidades de capacidade de leitura provisionada utilizada pela tabela de leitura provisionada mais alta ou pelo índice secundário global de uma conta.

  • Average: a porcentagem média de unidades capacidade de leitura provisionada utilizadas pela tabela de gravação provisionada mais alta ou pelo índice secundário global da conta. A métrica é publicada para 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.

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:

  • Maximum: a porcentagem máxima de unidades capacidade de gravação provisionada utilizadas pela tabela de gravação provisionada mais alta ou pelo índice secundário global de uma conta.

  • Minimum: a porcentagem mínima de unidades capacidade de gravação provisionada utilizadas pela tabela de gravação provisionada mais alta ou pelo índice secundário global de uma conta.

  • Average: a porcentagem média de unidades capacidade de gravação provisionada utilizadas pela tabela de gravação provisionada mais alta ou pelo índice secundário global da conta. A métrica é publicada para 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.

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:

  • Minimum: a configuração mais baixa para unidades de solicitação de leitura sob demanda. Se você usar UpdateTable para aumentar as unidades de solicitação de leitura, essa métrica mostrará o valor mais baixo de ReadRequestUnits sob demanda durante esse período.

  • Maximum: a configuração mais alta para unidades de solicitação de leitura sob demanda. Se você usar UpdateTable para reduzir as unidades de solicitação de leitura, essa métrica mostrará o valor mais alto de ReadRequestUnits sob demanda durante esse período.

  • Average: a média de unidades de solicitação de leitura sob demanda. A métrica OnDemandMaxReadRequestUnits é publicada para intervalos de cinco minutos. Portanto, se você ajustar rapidamente as unidades de solicitação de leitura sob demanda, essa estatística poderá não refletir a média real.

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:

  • Minimum: a configuração mais baixa para unidades de solicitação de gravação sob demanda. Se você usar UpdateTable para aumentar as unidades de solicitação de gravação, essa métrica mostrará o valor mais baixo de WriteRequestUnits sob demanda durante esse período.

  • Maximum: a configuração mais alta para unidades de solicitação de gravação sob demanda. Se você usar UpdateTable para reduzir as unidades de solicitação de gravação, essa métrica mostrará o valor mais alto de WriteRequestUnits sob demanda durante esse período.

  • Average: a média de unidades de solicitação de gravação sob demanda. A métrica OnDemandMaxWriteRequestUnits é publicada para intervalos de cinco minutos. Portanto, se você ajustar rapidamente as unidades de solicitação de gravação sob demanda, essa estatística poderá não refletir a média real.

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.

nota

Essa métrica poderá não ser emitida se a fase de preenchimento do novo índice secundário global for concluída rapidamente (menos de alguns minutos), o que poderá ocorrer se a tabela base tiver poucos ou nenhum item para preencher no índice.

Unidades: Count

Dimensões: TableName, GlobalSecondaryIndexName

Estatística válida:

  • Minimum

  • Maximum

  • Average

  • SampleCount

  • Sum

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:

  • Minimum

  • Maximum

  • Average

  • SampleCount

  • Sum

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:

  • Minimum

  • Maximum

  • Average

  • SampleCount

  • Sum

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:

  • Average

  • Sample Count

  • Sum

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:

  • Minimum: a configuração mais baixa para a capacidade de leitura provisionada. Se você usar UpdateTable para aumentar a capacidade de leitura, esta métrica mostrará o valor mais baixo de ReadCapacityUnits provisionado durante esse período.

  • Maximum: a configuração mais alta para a capacidade de leitura provisionada. Se você usar UpdateTable para diminuir a capacidade de leitura, esta métrica mostrará o valor mais alto de ReadCapacityUnits provisionado durante esse período.

  • Average: a capacidade média de leitura provisionada. A métrica ProvisionedReadCapacityUnits é publicada para 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.

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:

  • Minimum: a configuração mais baixa para capacidade de gravação provisionada. Se você usar UpdateTable para aumentar a capacidade de gravação, esta métrica mostrará o valor mais baixo de WriteCapacityUnits provisionado durante esse período.

  • Maximum: a configuração mais alta para a capacidade de gravação provisionada. Se você usar UpdateTable para diminuir a capacidade de gravação, esta métrica mostrará o valor mais alto de WriteCapacityUnits provisionado durante esse período.

  • Average: a capacidade média de gravação provisionada. A métrica ProvisionedWriteCapacityUnits é publicada para 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.

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:

  • SampleCount

  • Sum

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:

  • Average

  • Minimum

  • Maximum

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:

  • Minimum

  • Maximum

  • Average

  • SampleCount

  • Sum

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:

  • Minimum

  • Maximum

  • Average

  • SampleCount

  • Sum

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:

  • Minimum

  • Maximum

  • Average

  • SampleCount

  • Sum

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:

  • O tempo decorrido para solicitações bem-sucedidas (Minimum, Maximum, Sum ou Average).

  • O número de solicitações bem-sucedidas (SampleCount).

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:

  • Minimum

  • Maximum

  • Average

  • SampleCount

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:

  • Sum

  • SampleCount

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:

  • Sum

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:

  • Minimum

  • Maximum

  • Average

  • SampleCount

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.

nota

Em uma solicitação de lote (BatchGetItem ou BatchWriteItem), ThrottledRequests será incrementado somente se houver limitação para cada uma das solicitações no lote.

Se qualquer solicitação individual dentro do lote for limitada, uma das seguintes métricas será incrementada:

  • ReadThrottleEvents: para um evento GetItem limitado em BatchGetItem.

  • WriteThrottleEvents: para um evento PutItem ou DeleteItem limitado em BatchWriteItem.

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.

nota

Uma solicitação com limitação resultará em um código de status HTTP 400. Esses eventos são refletidos na métrica ThrottledRequests, mas não na métrica UserErrors.

Unidades: Count

Dimensões: TableName, Operation

Estatística válida:

  • Sum

  • SampleCount

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:

  • Sum: o número de solicitações rejeitadas em nível do item devido a conflitos de transação.

    nota

    Se várias solicitações de nível de item dentro de uma chamada para TransactWriteItems ou TransactGetItems foram rejeitadas, Sum será incrementado em uma unidade para cada solicitação Put, Update, Delete ou Get em nível de item.

  • SampleCount: o número de solicitações rejeitadas devido a conflitos de transação.

    nota

    Se várias solicitações de nível de item dentro de uma chamada para TransactWriteItems ou TransactGetItems forem rejeitadas, SampleCountsó será incrementado em uma unidade.

  • Min: o número mínimo de solicitações em nível de item rejeitadas em uma chamada para TransactWriteItems, TransactGetItems, PutItem, UpdateItem ou DeleteItem.

  • Max: o número máximo de solicitações em nível de item rejeitadas em uma chamada para TransactWriteItems, TransactGetItems, PutItem, UpdateItem ou DeleteItem.

  • Average: o número médio de solicitações em nível de item rejeitadas em uma chamada para TransactWriteItems, TransactGetItems, PutItem, UpdateItem ou DeleteItem.

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:

  • ResourceNotFoundException

  • ValidationException

  • TransactionConflict

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

  • ProvisionedThroughputExceededException: consulte a métrica ThrottledRequests nesta seção.

  • ConditionalCheckFailedException: consulte a métrica ConditionalCheckFailedRequests nesta seção.

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:

  • Sum

  • SampleCount

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:

  • Sum

  • SampleCount

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:

  • Minimum: o menor número de unidades de capacidade de gravação provisionadas durante um período.

  • Maximum: o maior número de unidades de capacidade de gravação provisionadas durante um período.

  • Average: o número médio de unidades de capacidade de gravação provisionadas durante um período.

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:

  • Minimum: o menor número de unidades de capacidade de leitura provisionadas durante um período.

  • Maximum: o maior número de unidades de capacidade de leitura provisionadas durante um período.

  • Average: o número médio de unidades de capacidade de leitura provisionadas durante um período.

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:

  • Minimum: o menor número de tabelas durante um período.

  • Maximum: o maior número de tabelas durante um período.

  • Average: o número médio de tabelas durante um período.

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:

  • Alterar captura de dados para o Kinesis Data Streams.

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:

  • PutItem

  • DeleteItem

  • UpdateItem

  • GetItem

  • BatchGetItem

  • Scan

  • Query

  • BatchWriteItem

  • TransactWriteItems

  • TransactGetItems

  • ExecuteTransaction

  • BatchExecuteStatement

  • ExecuteStatement

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

  • GetRecords

OperationType

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

  • Read

  • Write

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:

  • Inserir: PartiQLInsert

  • Selecionar: PartiQLSelect

  • Atualizar: PartiQLUpdate

  • Excluir: PartiQLDelete

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.