Parametri e dimensioni di DynamoDB

Quando interagisci con DynamoDB, invia metriche e dimensioni a. CloudWatch

Visualizzazione di parametri e dimensioni

CloudWatch visualizza le seguenti metriche per DynamoDB:

Parametri di DynamoDB

Nota

Amazon CloudWatch aggrega questi parametri a intervalli di un minuto:

• ConditionalCheckFailedRequests

• ConsumedReadCapacityUnits

• ConsumedWriteCapacityUnits

• ReadThrottleEvents

• ReturnedBytes

• ReturnedItemCount

• ReturnedRecordsCount

• SuccessfulRequestLatency

• SystemErrors

• TimeToLiveDeletedItemCount

• ThrottledRequests

• TransactionConflict

• UserErrors

• WriteThrottleEvents

Per tutti i parametri di DynamoDB, la granularità dell'aggregazione è di cinque minuti.

Non tutte le statistiche, come Average (Media) o Sum (Somma), si applicano a tutti i parametri. Tuttavia, tutti questi valori sono disponibili tramite la console Amazon DynamoDB o utilizzando CloudWatch la console AWS CLI o gli SDK per tutte le AWS metriche.

Nella tabella seguente ciascun parametro presenta un elenco di statistiche valide applicabile a quel parametro.

AccountMaxLegge

Il numero massimo di unità di capacità di lettura che possono essere utilizzate da un account. Questo limite non si applica alle tabelle su richiesta o agli indici secondari globali.

Unità: Count

Statistiche valide:

• Maximum: il numero massimo di unità di capacità di lettura che possono essere utilizzate da un account.

AccountMaxTableLevelLegge

Il numero massimo di unità di capacità di lettura che possono essere utilizzate da una tabella o un indice secondario globale di un account. Per le tabelle su richiesta, questo limite limita il numero massimo di unità di richiesta di lettura che una tabella o un indice secondario globale possono utilizzare.

Unità: Count

Statistiche valide:

• Maximum: il numero massimo di unità di capacità di lettura che possono essere utilizzate da una tabella o un indice secondario globale di un account.

AccountMaxTableLevelScrive

Il numero massimo di unità di capacità di scrittura che possono essere utilizzate da una tabella o un indice secondario globale di un account. Per le tabelle su richiesta, questo limite limita il numero massimo di unità di richiesta di scrittura che una tabella o un indice secondario globale possono utilizzare.

Unità: Count

Statistiche valide:

• Maximum: il numero massimo di unità di capacità di scrittura che possono essere utilizzate da una tabella o un indice secondario globale di un account.

AccountMaxScrive

Il numero massimo di unità di capacità di scrittura che possono essere utilizzate da un account. Questo limite non si applica alle tabelle su richiesta o agli indici secondari globali.

Unità: Count

Statistiche valide:

• Maximum: il numero massimo di unità di capacità di scrittura che possono essere utilizzate da un account.

AccountProvisionedReadCapacityUtilizzo

La percentuale di unità di capacità di lettura assegnata utilizzate dall'account.

Unità: Percent

Statistiche valide:

• Maximum: la percentuale massima di unità di capacità di lettura assegnata utilizzate dall'account.

• Minimum: la percentuale minima di unità di capacità di lettura assegnata utilizzate dall'account.

• Average: la percentuale minima di unità di capacità di lettura assegnata utilizzate dall'account. Il parametro viene pubblicato ad intervalli di cinque minuti. Pertanto, se si modificano rapidamente le unità di capacità di lettura assegnata, questa statistica potrebbe non corrispondere alla media reale.

AccountProvisionedWriteCapacityUtilizzo

La percentuale di unità di capacità di scrittura assegnata utilizzate dall'account.

Unità: Percent

Statistiche valide:

• Maximum: la percentuale massima di unità di capacità di scrittura assegnata utilizzate dall'account.

• Minimum: la percentuale minima di unità di capacità di scrittura assegnata utilizzate dall'account.

• Average: la percentuale media di unità di capacità di scrittura assegnata utilizzate dall'account. Il parametro viene pubblicato ad intervalli di cinque minuti. Pertanto, se si modificano rapidamente le unità di capacità di scrittura assegnata, questa statistica potrebbe non corrispondere alla media reale.

AgeOfOldestUnreplicatedRecord

Il tempo trascorso da quando un record ancora da replicare in Kinesis Data Streams è apparso per la prima volta nella tabella DynamoDB.

Unità: Milliseconds

Dimensioni: TableName, DelegatedOperation

Statistiche valide:

• Maximum.

• Minimum.

• Average.

ConditionalCheckFailedRequests

Il numero di tentativi di esecuzione di scritture condizionali non riusciti. Le operazioni PutItem, UpdateItem e DeleteItem consentono di fornire una condizione logica che deve essere considerata true affinché l'operazione possa procedere. Se questa condizione restituisce il valore false, ConditionalCheckFailedRequests viene incrementato di uno. Anche ConditionalCheckFailedRequests viene incrementato di uno per le istruzioni PartiQL Update and Delete in cui viene fornita una condizione logica e tale condizione restituisce il valore false.

Nota

Una scrittura condizionale non riuscita comporterà un errore HTTP 400 (Richiesta errata). Questi eventi si riflettono nel parametro ConditionalCheckFailedRequests ma non nel parametro UserErrors.

Unità: Count

Dimensioni: TableName

Statistiche valide:

• Minimum

• Maximum

• Average

• SampleCount

• Sum

ConsumedChangeDataCaptureUnità

Il numero di unità di acquisizione dati di modifica consumate.

Unità: Count

Dimensioni: TableName, DelegatedOperation

Statistiche valide:

• Minimum

• Maximum

• Average

ConsumedReadCapacityUnits

Numero di unità di capacità di lettura utilizzate nel periodo di tempo specificato per la capacità sia in provisioning che on-demand, in modo da tenere traccia quanta velocità di trasmissione effettiva viene utilizzata. È possibile recuperare la capacità di lettura totale consumata per una tabella e tutti i relativi indici secondari globali o per un determinato indice secondario globale. Per ulteriori informazioni, consulta Modalità per la capacità di lettura e scrittura.

La dimensione TableName restituisce il parametro ConsumedReadCapacityUnits per la tabella, ma non per gli indici secondari globali. Per visualizzare il parametro ConsumedReadCapacityUnits per un indice secondario globale, è necessario specificare anche i parametri TableName e GlobalSecondaryIndexName.

Nota

In Amazon DynamoDB, la metrica della capacità consumata viene riportata CloudWatch a intervalli di un minuto come valore medio. Ciò significa che picchi brevi e intensi nel consumo di capacità che durano solo un secondo potrebbero non essere rispecchiati con precisione nel CloudWatch grafico, portando potenzialmente a un tasso di consumo apparente inferiore per quel minuto.

Utilizza la statistica Sum per calcolare la velocità effettiva consumata. Ad esempio, ottieni il valore Sum su un intervallo di un minuto e dividilo per il numero di secondi in un minuto (60) per calcolare il parametro medio ConsumedReadCapacityUnits al secondo. È possibile confrontare il valore calcolato con il valore di velocità effettiva assegnato fornito da DynamoDB.

Unità: Count

Dimensioni: TableName, GlobalSecondaryIndexName

Statistiche valide:

• Minimum: il numero minimo di unità di capacità di lettura utilizzate da qualsiasi richiesta individuale alla tabella o all'indice.

• Maximum: il numero massimo di unità di capacità di lettura utilizzate da qualsiasi richiesta individuale alla tabella o all'indice.

• Average: la capacità di lettura media per richiesta consumata.

  Nota

  Il valore Average è influenzato dai periodi di inattività in cui il valore del campione sarà zero.

• Sum: le unità di capacità di lettura totali consumate. Questa è la statistica più utile per il parametro ConsumedReadCapacityUnits.

• SampleCount— Il numero di richieste di lettura a DynamoDB. Restituisce 0 se non è stata consumata alcuna capacità di lettura.

  Nota

  Il valore SampleCount è influenzato dai periodi di inattività in cui il valore del campione sarà zero.

ConsumedWriteCapacityUnits

Numero di unità di capacità di scrittura utilizzate nel periodo di tempo specificato per la capacità sia in provisioning che on-demand, in modo da tenere traccia quanta velocità di trasmissione effettiva viene utilizzata. È possibile recuperare la capacità di scrittura totale consumata per una tabella e tutti i relativi indici secondari globali o per un determinato indice secondario globale. Per ulteriori informazioni, consulta Modalità per la capacità di lettura e scrittura.

La dimensione TableName restituisce il parametro ConsumedWriteCapacityUnits per la tabella, ma non per gli indici secondari globali. Per visualizzare il parametro ConsumedWriteCapacityUnits per un indice secondario globale, è necessario specificare anche i parametri TableName e GlobalSecondaryIndexName.

Nota

Utilizza la statistica Sum per calcolare la velocità effettiva consumata. Ad esempio, ottenete il Sum valore nell'arco di un minuto e dividetelo per il numero di secondi in un minuto (60) per calcolare la media ConsumedWriteCapacityUnits al secondo (riconoscendo che questa media non evidenzia eventuali picchi ampi ma brevi nell'attività di scrittura verificatisi durante quel minuto). È possibile confrontare il valore calcolato con il valore di velocità effettiva assegnato fornito da DynamoDB.

Unità: Count

Dimensioni: TableName, GlobalSecondaryIndexName

Statistiche valide:

• Minimum: il numero minimo di unità di capacità di scrittura utilizzate da qualsiasi richiesta individuale alla tabella o all'indice.

• Maximum: il numero massimo di unità di capacità di scrittura utilizzate da qualsiasi richiesta individuale alla tabella o all'indice.

• Average: la capacità di scrittura media per richiesta consumata.

  Nota

  Il valore Average è influenzato dai periodi di inattività in cui il valore del campione sarà zero.

• Sum: le unità di capacità di scrittura totali consumate. Questa è la statistica più utile per il parametro ConsumedWriteCapacityUnits.

• SampleCount: il numero di richieste di scrittura a DynamoDB, anche se non è stata utilizzata alcuna capacità di scrittura.

  Nota

  Il valore SampleCount è influenzato dai periodi di inattività in cui il valore del campione sarà zero.

FailedToReplicateRecordConta

Il numero di registri che DynamoDB non è riuscito a replicare nel flusso dei dati Kinesis.

Unità: Count

Dimensioni: TableName, DelegatedOperation

Statistiche valide:

• Sum

MaxProvisionedTableReadCapacityUtilization

La percentuale di unità di capacità di lettura assegnata utilizzata dalla tabella di lettura assegnata più elevata o dall'indice secondario globale di un account.

Unità: Percent

Statistiche valide:

• Maximum: la percentuale massima di unità di capacità di lettura assegnata utilizzate dalla tabella di lettura assegnata più elevata o dall'indice secondario globale di un account.

• Minimum: la percentuale minima di unità di capacità di lettura assegnata utilizzate dalla tabella di lettura assegnata più elevata o dall'indice secondario globale di un account.

• Average: la percentuale media di unità di capacità di lettura assegnata utilizzata dalla tabella di lettura assegnata più elevata o dall'indice secondario globale dell'account. Il parametro viene pubblicato ad intervalli di cinque minuti. Pertanto, se si modificano rapidamente le unità di capacità di lettura assegnata, questa statistica potrebbe non corrispondere alla media reale.

MaxProvisionedTableWriteCapacityUtilization

La percentuale di capacità di scrittura assegnata utilizzata dalla tabella di scrittura assegnata più elevata o dall'indice secondario globale di un account.

Unità: Percent

Statistiche valide:

• Maximum: la percentuale massima di capacità di scrittura assegnata utilizzata dalla tabella di scrittura assegnata più elevata o dall'indice secondario globale di un account.

• Minimum: la percentuale minima di capacità di scrittura assegnata utilizzata dalla tabella di scrittura assegnata più elevata o dall'indice secondario globale di un account.

• Average: la percentuale media di capacità di scrittura assegnata utilizzata dalla tabella di scrittura assegnata più elevata o dall'indice secondario globale di un account. Il parametro viene pubblicato ad intervalli di cinque minuti. Pertanto, se si modificano rapidamente le unità di capacità di scrittura assegnata, questa statistica potrebbe non corrispondere alla media reale.

OnDemandMaxReadRequestUnits

Il numero di unità di richiesta di lettura su richiesta specificate per una tabella o un indice secondario globale.

OnDemandMaxReadRequestUnitsPer visualizzare una tabella, è necessario specificareTableName. Per visualizzare il parametro OnDemandMaxReadRequestUnits per un indice secondario globale, è necessario specificare anche i parametri TableName e GlobalSecondaryIndexName.

Unità: numero

Dimensioni: TableName, GlobalSecondaryIndexName

Statistiche valide:

• Minimum— L'impostazione più bassa per le unità di richiesta di lettura su richiesta. Se si utilizza UpdateTable per aumentare le unità di richiesta di lettura, questa metrica mostra il valore più basso di on-demand ReadRequestUnits durante questo periodo di tempo.

• Maximum— L'impostazione massima per le unità di richiesta di lettura su richiesta. Se si utilizza UpdateTable per ridurre le unità di richiesta di lettura, questa metrica mostra il valore più alto di on-demand ReadRequestUnits durante questo periodo di tempo.

• Average— Le unità medie di richiesta di lettura su richiesta. Il parametro OnDemandMaxReadRequestUnits viene pubblicato a intervalli di cinque minuti. Pertanto, se si modificano rapidamente le unità di richiesta di lettura su richiesta, questa statistica potrebbe non riflettere la media reale.

OnDemandMaxWriteRequestUnits

Il numero di unità di richiesta di scrittura su richiesta specificate per una tabella o un indice secondario globale.

OnDemandMaxWriteRequestUnitsPer visualizzare una tabella, è necessario specificareTableName. Per visualizzare il parametro OnDemandMaxWriteRequestUnits per un indice secondario globale, è necessario specificare anche i parametri TableName e GlobalSecondaryIndexName.

Unità: Count

Dimensioni: TableName, GlobalSecondaryIndexName

Statistiche valide:

• Minimum— L'impostazione più bassa per le unità di richiesta di scrittura su richiesta. Se si utilizza UpdateTable per aumentare le unità di richiesta di scrittura, questa metrica mostra il valore più basso di on-demand WriteRequestUnits durante questo periodo di tempo.

• Maximum— L'impostazione massima per le unità di richiesta di scrittura su richiesta. Se si utilizza UpdateTable per ridurre le unità di richiesta di scrittura, questa metrica mostra il valore più alto di on-demand WriteRequestUnits durante questo periodo di tempo.

• Average— Le unità medie di richiesta di scrittura su richiesta. Il parametro OnDemandMaxWriteRequestUnits viene pubblicato a intervalli di cinque minuti. Pertanto, se modifichi rapidamente le unità di richiesta di scrittura su richiesta, questa statistica potrebbe non riflettere la media reale.

OnlineIndexConsumedWriteCapacità

Il numero di unità di capacità di scrittura consumate quando si aggiunge un nuovo indice secondario globale a una tabella. Se la capacità di scrittura dell'indice è troppo bassa, l'attività di scrittura in entrata durante la fase di backfill potrebbe essere ridotta. Ciò può aumentare il tempo necessario per creare l'indice. È consigliabile monitorare questa statistica durante la creazione dell'indice per determinare se la capacità di scrittura dell'indice è stata sottofornita.

È possibile regolare la capacità di scrittura dell'indice utilizzando l'operazione UpdateTable anche mentre l'indice è ancora in fase di creazione.

La ConsumedWriteCapacityUnits metrica per l'indice non include la velocità effettiva di scrittura utilizzata durante la creazione dell'indice.

Nota

Questo parametro non può essere emesso se la fase di backfill del nuovo indice secondario globale viene completata rapidamente (meno di pochi minuti), cosa che può verificarsi se la tabella di base contiene pochi o nessun elemento nell'indice da sottoporre al backfill.

Unità: Count

Dimensioni: TableName, GlobalSecondaryIndexName

Statistiche valide:

• Minimum

• Maximum

• Average

• SampleCount

• Sum

OnlineIndexPercentageProgress

La percentuale di completamento quando un nuovo indice secondario globale viene aggiunto a una tabella. DynamoDB deve prima allocare le risorse per il nuovo indice e quindi eseguire il backfill degli attributi dalla tabella nell'indice. Per tabelle di grandi dimensioni, questo processo potrebbe richiedere molto tempo. È necessario monitorare questa statistica per visualizzare l'avanzamento relativo man mano che DynamoDB crea l'indice.

Unità: Count

Dimensioni: TableName, GlobalSecondaryIndexName

Statistiche valide:

• Minimum

• Maximum

• Average

• SampleCount

• Sum

OnlineIndexThrottleEvents

Il numero di eventi di limitazione di scrittura che si verificano quando si aggiunge un nuovo indice secondario globale a una tabella. Questi eventi indicano che il completamento della creazione dell'indice richiederà più tempo, poiché l'attività di scrittura in ingresso supera la velocità effettiva di scrittura prevista per l'indice.

È possibile regolare la capacità di scrittura dell'indice utilizzando l'operazione UpdateTable anche mentre l'indice è ancora in fase di creazione.

La WriteThrottleEvents metrica dell'indice non include gli eventi di accelerazione che si verificano durante la creazione dell'indice.

Unità: Count

Dimensioni: TableName, GlobalSecondaryIndexName

Statistiche valide:

• Minimum

• Maximum

• Average

• SampleCount

• Sum

PendingReplicationConta

Metrica per Tabelle globali versione 2017.11.29 (Legacy) (solo tabelle globali). Il numero di aggiornamenti degli elementi scritti in una tabella di replica, ma che non sono stati ancora scritti in un'altra replica nella tabella globale.

Unità: Count

Dimensioni: TableName, ReceivingRegion

Statistiche valide:

• Average

• Sample Count

• Sum

ProvisionedReadCapacityUnits

Il numero di unità di capacità in lettura assegnata per una tabella o un indice secondario globale. La dimensione TableName restituisce il parametro ProvisionedReadCapacityUnits per la tabella, ma non per gli indici secondari globali. Per visualizzare il parametro ProvisionedReadCapacityUnits per un indice secondario globale, è necessario specificare anche i parametri TableName e GlobalSecondaryIndexName.

Unità: Count

Dimensioni: TableName, GlobalSecondaryIndexName

Statistiche valide:

• Minimum: l'impostazione più bassa per la capacità di lettura assegnata. Se si utilizza UpdateTable per aumentare la capacità di lettura, questo parametro mostra il valore più basso di ReadCapacityUnits assegnato durante questo periodo di tempo.

• Maximum: l'impostazione più alta per la capacità di lettura assegnata. Se si utilizza UpdateTable per aumentare la capacità di lettura, questo parametro mostra il valore più alto di ReadCapacityUnits assegnato durante questo periodo di tempo.

• Average: la capacità media di lettura assegnata. Il parametro ProvisionedReadCapacityUnits viene pubblicato a intervalli di cinque minuti. Pertanto, se si modificano rapidamente le unità di capacità di lettura assegnata, questa statistica potrebbe non corrispondere alla media reale.

ProvisionedWriteCapacityUnits

Il numero di unità di capacità di scrittura assegnata per una tabella o un indice secondario globale.

La dimensione TableName restituisce il parametro ProvisionedWriteCapacityUnits per la tabella, ma non per gli indici secondari globali. Per visualizzare il parametro ProvisionedWriteCapacityUnits per un indice secondario globale, è necessario specificare anche i parametri TableName e GlobalSecondaryIndexName.

Unità: Count

Dimensioni: TableName, GlobalSecondaryIndexName

Statistiche valide:

• Minimum: l'impostazione più bassa per la capacità di scrittura assegnata. Se si utilizza UpdateTable per aumentare la capacità di scrittura, questo parametro mostra il valore più basso di WriteCapacityUnits assegnato durante questo periodo di tempo.

• Maximum: l'impostazione più alta per la capacità di scrittura assegnata. Se si utilizza UpdateTable per aumentare la capacità di scrittura, questo parametro mostra il valore più alto di WriteCapacityUnits assegnato durante questo periodo di tempo.

• Average: la capacità media di scrittura assegnata. Il parametro ProvisionedWriteCapacityUnits viene pubblicato a intervalli di cinque minuti. Pertanto, se si modificano rapidamente le unità di capacità di scrittura assegnata, questa statistica potrebbe non corrispondere alla media reale.

ReadThrottleEventi

Richieste a DynamoDB che superano le unità di capacità di lettura assegnata per una tabella o un indice secondario globale.

Una singola richiesta può comportare più eventi. Ad esempio, un parametro BatchGetItem che legge 10 elementi viene elaborato come 10 eventi GetItem. Per ogni evento, un parametro ReadThrottleEvents viene incrementato di uno se quell'evento è limitato. Il parametro ThrottledRequests per l'intero BatchGetItem non viene incrementato a meno che non vengano limitati tutti e 10 gli eventi GetItem.

La dimensione TableName restituisce il parametro ReadThrottleEvents per la tabella, ma non per gli indici secondari globali. Per visualizzare il parametro ReadThrottleEvents per un indice secondario globale, è necessario specificare anche i parametri TableName e GlobalSecondaryIndexName.

Unità: Count

Dimensioni: TableName, GlobalSecondaryIndexName

Statistiche valide:

• SampleCount

• Sum

ReplicationLatency

Questo parametro è per le tabelle globali DynamoDB. Il tempo trascorso tra un elemento aggiornato visualizzato nel flusso DynamoDB per una tabella di replica e l'elemento visualizzato in un'altra replica nella tabella globale.

Unità: Milliseconds

Dimensioni: TableName, ReceivingRegion

Statistiche valide:

• Average

• Minimum

• Maximum

ReturnedBytes

Il numero di byte restituiti dalle operazioni GetRecords(Amazon DynamoDB Streams) durante il periodo di tempo specificato.

Unità: Bytes

Dimensioni: Operation, StreamLabel, TableName

Statistiche valide:

• Minimum

• Maximum

• Average

• SampleCount

• Sum

ReturnedItemConta

Il numero di elementi restituiti dalle operazioni Query, Scan oExecuteStatement (select) operazioni durante il periodo di tempo specificato.

Il numero di elementi restituito non coincide necessariamente con il numero di elementi valutati. Si supponga, ad esempio, di aver richiesto un parametro Scan su una tabella o un indice che conteneva 100 elementi, ma di aver specificato un parametro FilterExpression che ha ristretto i risultati in modo che venissero restituiti solo 15 elementi. In questo caso, la risposta dal parametro Scan conterrà un parametro ScanCount di 100 e un parametro Count con 15 elementi restituiti.

Unità: Count

Dimensioni: TableName, Operation

Statistiche valide:

• Minimum

• Maximum

• Average

• SampleCount

• Sum

ReturnedRecordsConta

Il numero di record di flusso restituiti dalle operazioni GetRecords (Amazon DynamoDB Streams) durante il periodo di tempo specificato.

Unità: Count

Dimensioni: Operation, StreamLabel, TableName

Statistiche valide:

• Minimum

• Maximum

• Average

• SampleCount

• Sum

SuccessfulRequestLatenza

La latenza delle richieste a DynamoDB o ai flussi Amazon DynamoDB con esito positivo durante il periodo di tempo specificato. SuccessfulRequestLatency può fornire due tipi diversi di informazioni:

• Il tempo trascorso per le richieste riuscite (Minimum, Maximum, Sum oppure Average).

• Il numero di richieste eseguite correttamente (SampleCount).

SuccessfulRequestLatencyriflette l'attività solo all'interno di DynamoDB o Amazon DynamoDB Streams e non considera la latenza di rete o l'attività lato client.

Unità: Milliseconds

Dimensioni: TableName, Operation, StreamLabel

Statistiche valide:

• Minimum

• Maximum

• Average

• SampleCount

SystemErrors

Le richieste a DynamoDB o Amazon DynamoDB Streams che generano un codice di stato HTTP 500 durante il periodo di tempo specificato. Un codice HTTP 500 indica in genere un errore di servizio interno.

Unità: Count

Dimensioni: TableName, Operation

Statistiche valide:

• Sum

• SampleCount

TimeToLiveDeletedItemCount

Il numero di elementi eliminati in base alla durata (TTL, Time to Live) nel periodo di tempo specificato. Questo parametro consente di monitorare la frequenza di eliminazioni TTL nella tabella.

Unità: Count

Dimensioni: TableName

Statistiche valide:

• Sum

ThrottledPutRecordCount

Il numero di record che sono stati limitati dal flusso dei dati Kinesis a causa della capacità insufficiente di Kinesis Data Streams.

Unità: Count

Dimensioni: TableName, DelegatedOperation

Statistiche valide:

• Minimum

• Maximum

• Average

• SampleCount

ThrottledRequests

Le richieste a DynamoDB che superano i limiti di velocità effettiva assegnata su una risorsa (ad esempio una tabella o un indice).

ThrottledRequests viene incrementato di uno se qualsiasi evento in una richiesta supera il limite di velocità effettiva assegnata. Ad esempio, se si aggiorna un elemento in una tabella con indici secondari globali, sono presenti più eventi, ovvero una scrittura nella tabella e una scrittura in ciascun indice. Se uno o più di questi eventi sono limitati, il parametro ThrottledRequests viene incrementato di uno.

Nota

In una richiesta batch (BatchGetItem o BatchWriteItem), il parametro ThrottledRequests viene incrementato solo se ogni richiesta nel batch è limitata.

Se qualsiasi singola richiesta all'interno del batch è limitata, viene incrementato uno dei seguenti parametri:

• ReadThrottleEvents: per un evento GetItem limitato in BatchGetItem.

• WriteThrottleEvents: per un evento PutItem o DeleteItem limitato in BatchWriteItem.

Per scoprire quale evento limita una richiesta, confrontare ThrottledRequests con i parametri ReadThrottleEvents e WriteThrottleEvents della tabella e i relativi indici.

Nota

Una richiesta limitata comporterà un codice di stato HTTP 400. Tutti questi eventi si riflettono nel parametro ThrottledRequests ma non nel parametro UserErrors.

Unità: Count

Dimensioni: TableName, Operation

Statistiche valide:

• Sum

• SampleCount

TransactionConflict

Le richieste a livello di elemento vengono rifiutate a causa di conflitti di transazioni tra richieste simultanee sugli stessi elementi. Per ulteriori informazioni, consulta Gestione dei conflitti nelle transazioni in DynamoDB.

Unità: Count

Dimensioni: TableName

Statistiche valide:

• Sum: il numero di richieste a livello di elemento rifiutate a causa di conflitti di transazione.

  Nota

  Se più richieste a livello di elemento all'interno di una chiamata ai parametri TransactWriteItems o TransactGetItems sono state rifiutate, il parametro Sum viene incrementato di uno per ogni richiesta di Put, Update, Delete oppure di Get a livello di elemento.

• SampleCount: il numero di richieste rifiutate a causa di conflitti di transazione.

  Nota

  Se più richieste a livello di elemento all'interno di una chiamata ai parametri TransactWriteItems o TransactGetItems sono state rifiutate, il parametro SampleCount viene incrementato di uno.

• Min: il numero minimo di richieste a livello di elemento rifiutate all'interno di una chiamata ai parametri TransactWriteItems, TransactGetItems, PutItem, UpdateItem oppure DeleteItem.

• Max: il numero massimo di richieste a livello di elemento rifiutate all'interno di una chiamata ai parametri TransactWriteItems, TransactGetItems, PutItem, UpdateItem oppure DeleteItem.

• Average: il numero medio di richieste a livello di elemento rifiutate all'interno di una chiamata ai parametri TransactWriteItems, TransactGetItems, PutItem, UpdateItem oppure DeleteItem.

UserErrors

Le richieste a DynamoDB o Amazon DynamoDB Streams che generano un codice di stato HTTP 400 durante il periodo di tempo specificato. Un codice HTTP 400 in genere indica un errore sul lato client, ad esempio una combinazione non valida di parametri, un tentativo di aggiornamento di una tabella inesistente o una firma della richiesta non corretta.

Alcuni esempi di eccezioni che registreranno le metriche di log relative a UserErrors:

• ResourceNotFoundException

• ValidationException

• TransactionConflict

Tutti questi eventi si riflettono nel parametro UserErrors, ad eccezione di quanto segue:

• ProvisionedThroughputExceededException— Vedi la ThrottledRequests metrica in questa sezione.

• ConditionalCheckFailedException— Vedi la ConditionalCheckFailedRequests metrica in questa sezione.

UserErrorsrappresenta l'aggregato degli errori HTTP 400 per le richieste DynamoDB o Amazon DynamoDB Streams per la regione corrente e l'account corrente. AWS AWS

Unità: Count

Statistiche valide:

• Sum

• SampleCount

WriteThrottleEventi

Le richieste a DynamoDB che superano le unità di capacità di scrittura assegnata per una tabella o un indice secondario globale.

Una singola richiesta può comportare più eventi. Ad esempio, una richiesta PutItem su una tabella con tre indici secondari globali produce quattro eventi: la tabella di scrittura e ciascuna delle tre scritture sull'indice. Per ogni evento, il parametro WriteThrottleEvents viene incrementato di uno se quell'evento è limitato. Per le singole richieste PutItem, se uno qualsiasi degli eventi è limitato, il parametro ThrottledRequests viene incrementato di uno. Per BatchWriteItem, il parametro ThrottledRequests per l'intero BatchWriteItem non viene incrementato a meno che non siano limitati tutti i singoli eventi PutItem o DeleteItem.

La dimensione TableName restituisce il parametro WriteThrottleEvents per la tabella, ma non per gli indici secondari globali. Per visualizzare il parametro WriteThrottleEvents per un indice secondario globale, è necessario specificare anche i parametri TableName e GlobalSecondaryIndexName.

Unità: Count

Dimensioni: TableName, GlobalSecondaryIndexName

Statistiche valide:

• Sum

• SampleCount

Parametri di utilizzo

Le metriche di utilizzo CloudWatch consentono di gestire in modo proattivo l'utilizzo visualizzando le metriche nella CloudWatch console, creando dashboard personalizzate, rilevando i cambiamenti di attività con il rilevamento delle CloudWatch anomalie e configurando allarmi che avvisano l'utente quando l'utilizzo si avvicina a una soglia.

DynamoDB integra anche queste metriche di utilizzo con Service Quotas. Puoi utilizzarlo per gestire l'utilizzo delle quote di servizio da parte del tuo CloudWatch account. Per ulteriori informazioni, vedere Visualizzazione delle service quotas e impostazione degli avvisi

Elenco di parametri di utilizzo disponibili

• AccountProvisionedWriteCapacityUnità
• AccountProvisionedReadCapacityUnità
• TableCount

AccountProvisionedWriteCapacityUnità

La somma di unità di capacità in scrittura assegnata per tutte le tabelle e gli indici secondari globali di un account.

Unità: Count

Statistiche valide:

• Minimum - Il numero più basso di unità di capacità in scrittura assegnato durante un periodo di tempo.

• Maximum - Il numero più elevato di unità di capacità in scrittura assegnato durante un periodo di tempo.

• Average - Il numero medio di unità di capacità di scrittura assegnato durante un periodo di tempo.

Questa metrica viene pubblicata a intervalli di cinque minuti. Pertanto, se si modificano rapidamente le unità di capacità di scrittura assegnata, questa statistica potrebbe non corrispondere alla media reale.

AccountProvisionedReadCapacityUnità

La somma di unità di capacità in lettura assegnata per tutte le tabelle e gli indici secondari globali di un account.

Unità: Count

Statistiche valide:

• Minimum - Il numero più basso di unità di capacità in lettura assegnato durante un periodo di tempo.

• Maximum - Il numero più elevato di unità di capacità in lettura assegnato durante un periodo di tempo.

• Average - Il numero medio di unità di capacità di lettura assegnato durante un periodo di tempo.

Questa metrica viene pubblicata a intervalli di cinque minuti. Pertanto, se si modificano rapidamente le unità di capacità di lettura assegnata, questa statistica potrebbe non corrispondere alla media reale.

TableCount

Il numero di tabelle attive di un account.

Unità: Count

Statistiche valide:

• Minimum - Il numero più basso di tabelle durante un periodo di tempo.

• Maximum - Il numero più alto di tabelle durante un periodo di tempo.

• Average - Il numero medio di tabelle durante un periodo di tempo.

Comprendere i parametri e le dimensioni per DynamoDB

I parametri per DynamoDB sono qualificati mediante i valori dell'account, il nome della tabella, il nome dell'indice secondario globale o l'operazione. Puoi utilizzare la CloudWatch console per recuperare i dati DynamoDB lungo una qualsiasi delle dimensioni nella tabella seguente.

Elenco di dimensioni disponibili

• DelegatedOperation
• GlobalSecondaryIndexName
• Operazione
• OperationType
• Verb
• ReceivingRegion
• StreamLabel
• TableName

DelegatedOperation

Questa dimensione limita i dati alle operazioni eseguite da DynamoDB per conto tuo. Vengono catturate le seguenti operazioni:

• Modificare l'acquisizione dei dati per Kinesis Data Streams.

GlobalSecondaryIndexName

Questa dimensione limita i dati a un indice secondario globale su una tabella. Se si specifica GlobalSecondaryIndexName, è necessario specificare anche TableName.

Operazione

Questa dimensione limita i dati a uno dei seguenti verbi PartiQL di DynamoDB:

• PutItem

• DeleteItem

• UpdateItem

• GetItem

• BatchGetItem

• Scan

• Query

• BatchWriteItem

• TransactWriteItems

• TransactGetItems

• ExecuteTransaction

• BatchExecuteStatement

• ExecuteStatement

Inoltre, è possibile limitare i dati alla seguente operazione di Amazon DynamoDB Streams:

• GetRecords

OperationType

Questa dimensione limita i dati a uno dei seguenti tipi di operazione:

• Read

• Write

Questa dimensione viene emessa per le richieste ExecuteTransaction e BatchExecuteStatement.

Verb

Questa dimensione limita i dati a uno dei seguenti verbi PartiQL di DynamoDB:

• Inserimento: PartiQLInsert

• Selezionare: PartiQLSelect

• Aggiornare: PartiQLUpdate

• Eliminare: PartiQLDelete

Questa dimensione viene emessa per l'operazione ExecuteStatement.

ReceivingRegion

Questa dimensione limita i dati a una particolare regione. AWS Viene utilizzata con i parametri provenienti da tabelle di replica all'interno di una tabella globale DynamoDB.

StreamLabel

Questa dimensione limita i dati a un'etichetta di flusso specifica. Viene utilizzata con i parametri provenienti dalle operazioni GetRecords di Amazon DynamoDB Streams.

TableName

Questa dimensione limita i dati a una tabella specifica. Questo valore può essere qualsiasi nome di tabella nella regione corrente e nell' AWS account corrente.