

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Metriche di monitoraggio in DynamoDB con Amazon CloudWatch
<a name="Monitoring-metrics-with-Amazon-CloudWatch"></a>

Puoi monitorare DynamoDB CloudWatch utilizzando, che raccoglie ed elabora i dati grezzi da DynamoDB in metriche leggibili quasi in tempo reale. Queste statistiche vengono mantenute per un periodo di tempo, per permettere l’accesso alle informazioni storiche e offrire una prospettiva migliore sulle prestazioni del servizio o dell’applicazione web. Per impostazione predefinita, i dati delle metriche DynamoDB vengono inviati automaticamente a. CloudWatch Per ulteriori informazioni, consulta [What is Amazon CloudWatch?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatch.html) e [conservazione dei parametri](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#metrics-retention) nella *Amazon CloudWatch User Guide*.

**Topics**
+ [Come si utilizzano i parametri di DynamoDB?](#How-do-I-use-DynamoDB-metrics)
+ [Visualizzazione delle CloudWatch metriche nella console](#Viewing-metrics-in-CloudWatch-console)
+ [Visualizzazione delle metriche nel AWS CLI](#Viewing-metrics-in-the-cli)
+ [Parametri e dimensioni di DynamoDB](metrics-dimensions.md)
+ [Creazione di CloudWatch allarmi in DynamoDB](Monitoring-metrics-creating-cloudwatch-alarms.md)

## Come si utilizzano i parametri di DynamoDB?
<a name="How-do-I-use-DynamoDB-metrics"></a>

I parametri forniti da DynamoDB offrono informazioni che possono essere analizzate in diversi modi. L'elenco seguente mostra alcuni usi comuni dei parametri. Questi suggerimenti sono solo introduttivi e non costituiscono un elenco completo.


**Come si utilizzano i parametri di DynamoDB?**  

|  In che modo?  |  Metriche pertinenti  | 
| --- | --- | 
|  Come faccio a monitorare la frequenza di eliminazioni TTL nella tabella?   |  È possibile monitorare `TimeToLiveDeletedItemCount` nel periodo di tempo specificato per tenere traccia della frequenza di eliminazioni TTL nella tabella. Per un esempio di applicazione senza server che utilizza la `TimeToLiveDeletedItemCount` metrica, consulta [Archiviazione automatica degli elementi su S3 utilizzando DynamoDB time to live (TTL)](https://aws.amazon.com/blogs/database/automatically-archive-items-to-s3-using-dynamodb-time-to-live-with-aws-lambda-and-amazon-kinesis-firehose/) con e Amazon Data Firehose. AWS Lambda   | 
|  Come faccio a determinare quanta parte del throughput allocato viene utilizzata?  |  È possibile monitorare `ConsumedReadCapacityUnits` o `ConsumedWriteCapacityUnits` nel periodo di tempo specificato per tenere traccia di quanto del throughput assegnato viene utilizzato.  | 
|  Come faccio a stabilire quali richieste superano le quote di throughput allocato di una tabella?  |  Il parametro `ThrottledRequests` viene incrementato di uno se qualsiasi evento in una richiesta supera le quote di throughput assegnato. Quindi, per scoprire quale evento limita una richiesta, confrontare `ThrottledRequests` con i parametri `ReadThrottleEvents` e `WriteThrottleEvents` della tabella e degli indici.  | 
|  Come faccio a stabilire se si sono verificati errori di sistema?  |  È possibile monitorare `SystemErrors` per determinare se eventuali richieste hanno causato un codice HTTP 500 (errore del server). In genere, questo parametro deve essere uguale a zero. In caso contrario, è opportuno analizzare la situazione.  | 
|  Come faccio a monitorare il valore di latenza per le operazioni sulle tabelle?  |  È possibile monitorare `SuccessfulRequestLatency` tenendo traccia della latenza media e della latenza mediana tramite metriche percentili (p50). I picchi di latenza occasionali non devono essere motivo di preoccupazione. Tuttavia, se la latenza media o p50 (mediana) è elevata, potrebbe esserci un problema di fondo da risolvere. Per ulteriori informazioni, consulta [Risoluzione dei problemi di latenza in Amazon DynamoDB](TroubleshootingLatency.md).  | 

## Visualizzazione delle CloudWatch metriche nella console
<a name="Viewing-metrics-in-CloudWatch-console"></a>

Le metriche vengono raggruppate prima in base al namespace del servizio e successivamente in base alle diverse combinazioni di dimensioni all’interno di ogni namespace.

**Per visualizzare le metriche nella console CloudWatch**

1. Apri la CloudWatch console all'indirizzo [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Nel pannello di navigazione, seleziona **Metriche, Tutte le metriche**.

1. Seleziona lo spazio dei nomi **DynamoDB**. È possibile anche selezionare lo spazio dei nomi **Utilizzo** per visualizzare le metriche di utilizzo di DynamoDB. Per informazioni sui parametri di utilizzo, consulta [parametri di utilizzo di AWS .](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Service-Quota-Integration.html) 

1. La scheda **Sfoglia** mostra tutte le metriche per tale dimensione nel namespace.

1. (Facoltativo) Per aggiungere il grafico metrico a una CloudWatch dashboard, scegli **Azioni, Aggiungi alla dashboard**. 

## Visualizzazione delle metriche nel AWS CLI
<a name="Viewing-metrics-in-the-cli"></a>

Per ottenere informazioni sulle metriche utilizzando il AWS CLI, utilizzare il CloudWatch comando. `list-metrics` Nell'esempio seguente, vengono elencati tutti i parametri nello spazio dei nomi `AWS/DynamoDB`.

```
1.                 aws cloudwatch list-metrics --namespace "AWS/DynamoDB"
```

Per ottenere statistiche sui parametri, utilizza il comando `get-metric-statistics`. Il seguente comando ottiene statistiche `ConsumedReadCapacityUnits` per la tabella `ProductCatalog` nel periodo specifico di 24 ore, con una granularità di 5 minuti.

```
aws cloudwatch get-metric-statistics —namespace AWS/DynamoDB \
     —metric-name ConsumedReadCapacityUnits \
     —start-time 2023-11-01T00:00:00Z \
     —end-time 2023-11-02T00:00:00Z \
     —period 360 \
     —statistics Average \
     —dimensions Name=TableName,Value=ProductCatalog
```

L'output di esempio viene visualizzato come segue:

```
{
    "Datapoints": [
        {
            "Timestamp": "2023-11-01T 09:18:00+00:00", 
            "Average": 20, 
            "Unit": "Count"
        }, 
        {
            "Timestamp": "2023-11-01T 04:36:00+00:00", 
            "Average": 22.5, 
            "Unit": "Count"
        }, 
        {
            "Timestamp": "2023-11-01T 15:12:00+00:00", 
            "Average": 20, 
            "Unit": "Count"
        }, ...
        {
            "Timestamp": "2023-11-01T 17:30:00+00:00", 
            "Average": 25, 
            "Unit": "Count"
        }
    ], 
    "Label": " ConsumedReadCapacityUnits "
}
```

# Parametri e dimensioni di DynamoDB
<a name="metrics-dimensions"></a>

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

DynamoDB fornisce il throughput allocato utilizzato per periodi di un minuto. La [scalabilità automatica](AutoScaling.md) si attiva quando la capacità consumata supera l'utilizzo previsto configurato per due minuti consecutivi. CloudWatch gli allarmi potrebbero avere un breve ritardo, fino a qualche minuto, prima di attivare il ridimensionamento automatico. Questo ritardo garantisce una valutazione metrica accurata CloudWatch . Se i picchi di throughput utilizzato distano più di un minuto, il dimensionamento automatico potrebbe non attivarsi. Analogamente, un evento di riduzione verticale può avvenire quando 15 punti dati consecutivi sono inferiori all’utilizzo di destinazione. In entrambi i casi, dopo i trigger di auto scaling, viene richiamata l'[UpdateTable](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html)API. Sono quindi necessari alcuni minuti per aggiornare la capacità allocata per la tabella o l’indice. Durante questo periodo, tutte le richieste che superano la capacità allocata precedente delle tabelle verranno sottoposte a limitazione (della larghezza di banda della rete).

## Visualizzazione di parametri e dimensioni
<a name="dynamodb-metrics-dimensions"></a>

CloudWatch visualizza le seguenti metriche per DynamoDB:

### Parametri di DynamoDB
<a name="dynamodb-metrics"></a>

**Nota**  
Amazon CloudWatch aggrega questi parametri a intervalli di un minuto:  
`ConditionalCheckFailedRequests`
`ConsumedReadCapacityUnits`
`ConsumedWriteCapacityUnits`
`ReadAccountLimitThrottleEvents`
`ReadKeyRangeThroughputThrottleEvents`
`ReadMaxOnDemandThroughputThrottleEvents`
`ReadProvisionedThroughputThrottleEvents`
`ReadThrottleEvents`
`ReturnedBytes`
`ReturnedItemCount`
`ReturnedRecordsCount`
`SuccessfulRequestLatency`
`SystemErrors`
`TimeToLiveDeletedItemCount`
`ThrottledRequests`
`TransactionConflict`
`UserErrors`
`WriteAccountLimitThrottleEvents`
`WriteKeyRangeThroughputThrottleEvents`
`WriteMaxOnDemandThroughputThrottleEvents`
`WriteProvisionedThroughputThrottleEvents`
`WriteThrottleEvents`
`FaultInjectionServiceInducedErrors`
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 la console o per tutte CloudWatch le AWS CLI metriche AWS SDKs . 

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

**Topics**<a name="available-metrics.title"></a>
+ [Parametri di DynamoDB](#dynamodb-metrics)
+ [AccountMaxReads](#AccountMaxReads)
+ [AccountMaxTableLevelReads](#AccountMaxTableLevelReads)
+ [AccountMaxTableLevelWrites](#AccountMaxTableLevelWrites)
+ [AccountMaxWrites](#AccountMaxWrites)
+ [AccountProvisionedReadCapacityUtilization](#AccountProvisionedReadCapacityUtilization)
+ [AccountProvisionedWriteCapacityUtilization](#AccountProvisionedWriteCapacityUtilization)
+ [AgeOfOldestUnreplicatedRecord](#AgeOfOldestUnreplicatedRecord)
+ [ConditionalCheckFailedRequests](#ConditionalCheckFailedRequests)
+ [ConsumedChangeDataCaptureUnits](#ConsumedChangeDataCaptureUnits)
+ [ConsumedReadCapacityUnits](#ConsumedReadCapacityUnits)
+ [ConsumedWriteCapacityUnits](#ConsumedWriteCapacityUnits)
+ [FailedToReplicateRecordCount](#FailedToReplicateRecordCount)
+ [MaxProvisionedTableReadCapacityUtilization](#MaxProvisionedTableReadCapacityUtilization)
+ [MaxProvisionedTableWriteCapacityUtilization](#MaxProvisionedTableWriteCapacityUtilization)
+ [OnDemandMaxReadRequestUnits](#OnDemandMaxReadRequestUnits)
+ [OnDemandMaxWriteRequestUnits](#OnDemandMaxWriteRequestUnits)
+ [OnlineIndexConsumedWriteCapacity](#OnlineIndexConsumedWriteCapacity)
+ [OnlineIndexPercentageProgress](#OnlineIndexPercentageProgress)
+ [OnlineIndexThrottleEvents](#OnlineIndexThrottleEvents)
+ [PendingReplicationCount](#PendingReplicationCount)
+ [ProvisionedReadCapacityUnits](#ProvisionedReadCapacityUnits)
+ [ProvisionedWriteCapacityUnits](#ProvisionedWriteCapacityUnits)
+ [ReadAccountLimitThrottleEvents](#ReadAccountLimitThrottleEvents)
+ [ReadKeyRangeThroughputThrottleEvents](#ReadKeyRangeThroughputThrottleEvents)
+ [ReadMaxOnDemandThroughputThrottleEvents](#ReadMaxOnDemandThroughputThrottleEvents)
+ [ReadProvisionedThroughputThrottleEvents](#ReadProvisionedThroughputThrottleEvents)
+ [ReadThrottleEvents](#ReadThrottleEvents)
+ [ReplicationLatency](#ReplicationLatency)
+ [ReturnedBytes](#ReturnedBytes)
+ [ReturnedItemCount](#ReturnedItemCount)
+ [ReturnedRecordsCount](#ReturnedRecordsCount)
+ [SuccessfulRequestLatency](#SuccessfulRequestLatency)
+ [SystemErrors](#SystemErrors)
+ [TimeToLiveDeletedItemCount](#TimeToLiveDeletedItemCount)
+ [ThrottledPutRecordCount](#ThrottledPutRecordCount)
+ [ThrottledRequests](#ThrottledRequests)
+ [TransactionConflict](#TransactionConflict)
+ [UserErrors](#UserErrors)
+ [WriteAccountLimitThrottleEvents](#WriteAccountLimitThrottleEvents)
+ [WriteKeyRangeThroughputThrottleEvents](#WriteKeyRangeThroughputThrottleEvents)
+ [WriteMaxOnDemandThroughputThrottleEvents](#WriteMaxOnDemandThroughputThrottleEvents)
+ [WriteProvisionedThroughputThrottleEvents](#WriteProvisionedThroughputThrottleEvents)
+ [WriteThrottleEvents](#WriteThrottleEvents)
+ [Parametri di utilizzo](#w2aac41c15c13b7c11)
+ [FaultInjectionServiceInducedErrors](#FaultInjectionServiceInducedErrors)

### AccountMaxReads
<a name="AccountMaxReads"></a>

Il numero massimo di unità di capacità di lettura che possono essere utilizzate da un account. Questo limite non si applica alle tabelle on demand 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.

### AccountMaxTableLevelReads
<a name="AccountMaxTableLevelReads"></a>

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 on demand, questo valore limita il numero massimo di unità di richiesta di lettura che possono essere utilizzate da una tabella o un indice secondario globale.

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.

### AccountMaxTableLevelWrites
<a name="AccountMaxTableLevelWrites"></a>

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 on demand, questo valore limita il numero massimo di unità di richiesta di scrittura che possono essere utilizzate da una tabella o un indice secondario globale.

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.

### AccountMaxWrites
<a name="AccountMaxWrites"></a>

Il numero massimo di unità di capacità di scrittura che possono essere utilizzate da un account. Questo limite non si applica alle tabelle on demand 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.

### AccountProvisionedReadCapacityUtilization
<a name="AccountProvisionedReadCapacityUtilization"></a>

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.

### AccountProvisionedWriteCapacityUtilization
<a name="AccountProvisionedWriteCapacityUtilization"></a>

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
<a name="AgeOfOldestUnreplicatedRecord"></a>

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
<a name="ConditionalCheckFailedRequests"></a>

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`

### ConsumedChangeDataCaptureUnits
<a name="ConsumedChangeDataCaptureUnits"></a>

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

Unità: `Count`

Dimensioni: `TableName, DelegatedOperation`

Statistiche valide:
+ `Minimum`
+ `Maximum`
+ `Average`

### ConsumedReadCapacityUnits
<a name="ConsumedReadCapacityUnits"></a>

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](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html).

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**  
 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`: rappresenta la frequenza con cui viene emessa la metrica. Anche per le tabelle con traffico pari a zero verrà emesso il `SampleCount`, ma i valori di esempio saranno sempre zero.
**Nota**  
Il valore `SampleCount` è influenzato dai periodi di inattività in cui il valore del campione sarà zero. 

### ConsumedWriteCapacityUnits
<a name="ConsumedWriteCapacityUnits"></a>

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](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html).

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`. La `Source` dimensione può restituire uno dei due valori: `Customer` e`GlobalTable`. Le scritture replicate avverranno `ConsumedWriteCapacityUnits` con l'origine`GlobalTable`, ma le scritture su tabelle regionali avranno `ConsumedWriteCapacityUnits` con l'origine`Customer`.

**Nota**  
Utilizza la statistica `Sum` per calcolare la velocità effettiva consumata. Ad esempio, recupera il valore `Sum` su un intervallo di un minuto e dividilo per il numero di secondi in un minuto (60) per calcolare le `ConsumedWriteCapacityUnits` medie al secondo (riconoscendo che questa media non evidenzia picchi elevati ma brevi nell’attività di scrittura che si è verificata durante quel minuto). È possibile confrontare il valore calcolato con il valore di velocità effettiva assegnato fornito da DynamoDB.

Unità: `Count`

Dimensioni: `TableName, GlobalSecondaryIndexName, Source`

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`: rappresenta la frequenza con cui viene emessa la metrica. Anche per le tabelle con traffico pari a zero verrà emesso il `SampleCount`, ma i valori di esempio saranno sempre zero.
**Nota**  
Il valore `SampleCount` è influenzato dai periodi di inattività in cui il valore del campione sarà zero.

### FailedToReplicateRecordCount
<a name="FailedToReplicateRecordCount"></a>

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

Unità: `Count`

Dimensioni: `TableName`, `DelegatedOperation`

Statistiche valide:
+ `Sum`

### MaxProvisionedTableReadCapacityUtilization
<a name="MaxProvisionedTableReadCapacityUtilization"></a>

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
<a name="MaxProvisionedTableWriteCapacityUtilization"></a>

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
<a name="OnDemandMaxReadRequestUnits"></a>

Il numero di unità di richiesta di lettura on demand specificato per una tabella o un indice secondario globale.

Per visualizzare le `OnDemandMaxReadRequestUnits` per una tabella è necessario specificare il `TableName`. 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 on demand. Se si utilizza `UpdateTable` per aumentare le unità di richiesta di lettura, questa metrica mostrerà il valore più basso di `ReadRequestUnits` on demand durante questo periodo di tempo.
+ `Maximum`: l’impostazione più alta per le unità di richiesta di lettura on demand. Se si utilizza `UpdateTable` per diminuire le unità di richiesta di lettura, questa metrica mostrerà il valore più alto di `ReadRequestUnits` on demand durante questo periodo di tempo.
+ `Average`: le unità medie di richiesta di lettura on demand. Il parametro `OnDemandMaxReadRequestUnits` viene pubblicato a intervalli di cinque minuti. Pertanto, se si modificano rapidamente le unità di capacità di lettura on demand, questa statistica potrebbe non riflettere la media reale.

### OnDemandMaxWriteRequestUnits
<a name="OnDemandMaxWriteRequestUnits"></a>

Il numero di unità di richiesta di scrittura on demand specificato per una tabella o un indice secondario globale.

Per visualizzare le `OnDemandMaxWriteRequestUnits` per una tabella è necessario specificare il `TableName`. 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 on demand. Se si utilizza `UpdateTable` per aumentare le unità di richiesta di scrittura, questa metrica mostrerà il valore più basso di `WriteRequestUnits` on demand durante questo periodo di tempo.
+ `Maximum`: l’impostazione più alta per le unità di richiesta di scrittura on demand. Se si utilizza `UpdateTable` per diminuire le unità di richiesta di scrittura, questa metrica mostrerà il valore più alto di `WriteRequestUnits` on demand durante questo periodo di tempo.
+ `Average`: le unità medie di richiesta di scrittura on demand. Il parametro `OnDemandMaxWriteRequestUnits` viene pubblicato a intervalli di cinque minuti. Pertanto, se si modificano rapidamente le unità di capacità di scrittura on demand, questa statistica potrebbe non riflettere la media reale.

### OnlineIndexConsumedWriteCapacity
<a name="OnlineIndexConsumedWriteCapacity"></a>

Si prevede che questa metrica mostri 0 durante la creazione dell'indice. Questa metrica mostrava in precedenza il numero di unità di capacità di scrittura consumate durante l'aggiunta di un nuovo indice secondario globale a una tabella.

Unità: `Count`

Dimensioni: `TableName, GlobalSecondaryIndexName`

Statistiche valide:
+ `Minimum`
+ `Maximum`
+ `Average`
+ `SampleCount`
+ `Sum`

### OnlineIndexPercentageProgress
<a name="OnlineIndexPercentageProgress"></a>

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
<a name="OnlineIndexThrottleEvents"></a>

Si prevede che questa metrica mostri 0 durante la creazione dell'indice. Questa metrica mostrava in precedenza il numero di eventi di accelerazione della scrittura che si verificano quando si aggiunge un nuovo indice secondario globale a una tabella. 

Unità: `Count`

Dimensioni: `TableName, GlobalSecondaryIndexName`

Statistiche valide:
+ `Minimum`
+ `Maximum`
+ `Average`
+ `SampleCount`
+ `Sum`

### PendingReplicationCount
<a name="PendingReplicationCount"></a>

Metrica per [Tabelle globali versione 2017.11.29 (Legacy)](globaltables.V1.md) (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
<a name="ProvisionedReadCapacityUnits"></a>

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
<a name="ProvisionedWriteCapacityUnits"></a>

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.

### ReadAccountLimitThrottleEvents
<a name="ReadAccountLimitThrottleEvents"></a>

Il numero di richieste di lettura sottoposte a limitazione (della larghezza di banda della rete) a causa dei limiti dell’account.

Unità: `Count`

Dimensioni: `TableName`, `GlobalSecondaryIndexName`

Statistiche valide:
+ `Sum`: numero totale di eventi sottoposti a limitazione (della larghezza di banda della rete).
+ `SampleCount`: numero di occorrenze di limitazione (della larghezza di banda della rete).
+ `Minimum`: numero minimo di eventi sottoposti a limitazione (della larghezza di banda della rete) in un dato campione.
+ `Maximum`: numero massimo di eventi sottoposti a limitazione (della larghezza di banda della rete) in un dato campione.

### ReadKeyRangeThroughputThrottleEvents
<a name="ReadKeyRangeThroughputThrottleEvents"></a>

Il numero di richieste di lettura sottoposte a limitazione (della larghezza di banda della rete) a causa dei limiti della partizione.

Unità: `Count`

Dimensioni: `TableName`, `GlobalSecondaryIndexName`

Statistiche valide:
+ `Sum`: numero totale di eventi sottoposti a limitazione (della larghezza di banda della rete).
+ `SampleCount`: numero di occorrenze di limitazione (della larghezza di banda della rete).
+ `Minimum`: numero minimo di eventi sottoposti a limitazione (della larghezza di banda della rete) in un dato campione.
+ `Maximum`: numero massimo di eventi sottoposti a limitazione (della larghezza di banda della rete) in un dato campione.

### ReadMaxOnDemandThroughputThrottleEvents
<a name="ReadMaxOnDemandThroughputThrottleEvents"></a>

Il numero di richieste di lettura sottoposte a limitazione (della larghezza di banda della rete) a causa del throughput massimo on demand.

Unità: `Count`

Dimensioni: `TableName`, `GlobalSecondaryIndexName`

Statistiche valide:
+ `Sum`: numero totale di eventi sottoposti a limitazione (della larghezza di banda della rete).
+ `SampleCount`: numero di occorrenze di limitazione (della larghezza di banda della rete).
+ `Minimum`: numero minimo di eventi sottoposti a limitazione (della larghezza di banda della rete) in un dato campione.
+ `Maximum`: numero massimo di eventi sottoposti a limitazione (della larghezza di banda della rete) in un dato campione.

### ReadProvisionedThroughputThrottleEvents
<a name="ReadProvisionedThroughputThrottleEvents"></a>

Il numero di richieste di lettura sottoposte a limitazione (della larghezza di banda della rete) a causa dei limiti di throughput allocato.

Unità: `Count`

Dimensioni: `TableName`, `GlobalSecondaryIndexName`

Statistiche valide:
+ `Sum`: numero totale di eventi sottoposti a limitazione (della larghezza di banda della rete).
+ `SampleCount`: numero di occorrenze di limitazione (della larghezza di banda della rete).
+ `Minimum`: numero minimo di eventi sottoposti a limitazione (della larghezza di banda della rete) in un dato campione.
+ `Maximum`: numero massimo di eventi sottoposti a limitazione (della larghezza di banda della rete) in un dato campione.

### ReadThrottleEvents
<a name="ReadThrottleEvents"></a>

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
<a name="ReplicationLatency"></a>

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
<a name="ReturnedBytes"></a>

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`

### ReturnedItemCount
<a name="ReturnedItemCount"></a>

Il numero di elementi restituiti dalle operazioni `Query`, `Scan` o`ExecuteStatement` (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`

### ReturnedRecordsCount
<a name="ReturnedRecordsCount"></a>

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`

### SuccessfulRequestLatency
<a name="SuccessfulRequestLatency"></a>

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 con esito positivo (`Minimum`, `Maximum`, `Sum`, `Average` o `Percentile`).
+ Il numero di richieste eseguite correttamente (`SampleCount`).

`SuccessfulRequestLatency` riflette l’attività solo all’interno di DynamoDB o dei flussi Amazon DynamoDB e non tiene conto della latenza di rete o dell’attività lato client. 

**Nota**  
Per analizzare i valori percentili personalizzati (come p99.9), puoi inserire manualmente il percentile desiderato (ad esempio, p99.9) nel campo delle statistiche metriche. CloudWatch Ciò consente di valutare le distribuzioni di latenza oltre i percentili predefiniti elencati nel menu a discesa.

Unità: `Milliseconds` 

Dimensioni: `TableName, Operation, StreamLabel`

Statistiche valide:
+ `Minimum`
+ `Maximum`
+ `Sum`
+ `Average`
+ `Percentile`
+ `SampleCount`

### SystemErrors
<a name="SystemErrors"></a>

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.

**Nota**  
Quando DynamoDB restituisce un errore di sistema (HTTP 500), esegue in modo automatico un AWS SDKs numero configurabile di tentativi. Se il problema si risolve durante la ripetizione di un tentativo, l’applicazione continua senza visualizzare l’errore e si potrebbe notare un aumento della latenza percepita sul lato client. Se l’errore persiste dopo tutte le ripetizioni di tentativi, si propaga al codice dell’applicazione. 

Unità: `Count`

Dimensioni: `TableName, Operation`

Statistiche valide:
+ `Sum`
+ `SampleCount`

### TimeToLiveDeletedItemCount
<a name="TimeToLiveDeletedItemCount"></a>

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
<a name="ThrottledPutRecordCount"></a>

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
<a name="ThrottledRequests"></a>

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
<a name="TransactionConflict"></a>

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](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transaction-apis.html#transaction-conflict-handling). 

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
<a name="UserErrors"></a>

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.

`UserErrors`rappresenta 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`

### WriteAccountLimitThrottleEvents
<a name="WriteAccountLimitThrottleEvents"></a>

Il numero di richieste di scrittura sottoposte a limitazione (della larghezza di banda della rete) a causa dei limiti dell’account.

Unità: `Count`

Dimensioni: `TableName`

Statistiche valide:
+ `Sum`: numero totale di eventi sottoposti a limitazione (della larghezza di banda della rete).
+ `SampleCount`: numero di occorrenze di limitazione (della larghezza di banda della rete).
+ `Minimum`: numero minimo di eventi sottoposti a limitazione (della larghezza di banda della rete) in un dato campione.
+ `Maximum`: numero massimo di eventi sottoposti a limitazione (della larghezza di banda della rete) in un dato campione.

### WriteKeyRangeThroughputThrottleEvents
<a name="WriteKeyRangeThroughputThrottleEvents"></a>

Il numero di richieste di scrittura sottoposte a limitazione (della larghezza di banda della rete) a causa dei limiti di partizione.

Unità: `Count`

Dimensioni: `TableName`, `GlobalSecondaryIndexName`

Statistiche valide:
+ `Sum`: numero totale di eventi sottoposti a limitazione (della larghezza di banda della rete).
+ `SampleCount`: numero di occorrenze di limitazione (della larghezza di banda della rete).
+ `Minimum`: numero minimo di eventi sottoposti a limitazione (della larghezza di banda della rete) in un dato campione.
+ `Maximum`: numero massimo di eventi sottoposti a limitazione (della larghezza di banda della rete) in un dato campione.

### WriteMaxOnDemandThroughputThrottleEvents
<a name="WriteMaxOnDemandThroughputThrottleEvents"></a>

Il numero di richieste di scrittura sottoposte a limitazione (della larghezza di banda della rete) a causa del throughput massimo on demand.

Unità: `Count`

Dimensioni: `TableName`, `GlobalSecondaryIndexName`

Statistiche valide:
+ `Sum`: numero totale di eventi sottoposti a limitazione (della larghezza di banda della rete).
+ `SampleCount`: numero di occorrenze di limitazione (della larghezza di banda della rete).
+ `Minimum`: numero minimo di eventi sottoposti a limitazione (della larghezza di banda della rete) in un dato campione.
+ `Maximum`: numero massimo di eventi sottoposti a limitazione (della larghezza di banda della rete) in un dato campione.

### WriteProvisionedThroughputThrottleEvents
<a name="WriteProvisionedThroughputThrottleEvents"></a>

Il numero di richieste di scrittura sottoposte a limitazione (della larghezza di banda della rete) a causa dei limiti di throughput allocato.

Unità: `Count`

Dimensioni: `TableName`, `GlobalSecondaryIndexName`

Statistiche valide:
+ `Sum`: numero totale di eventi sottoposti a limitazione (della larghezza di banda della rete).
+ `SampleCount`: numero di occorrenze di limitazione (della larghezza di banda della rete).
+ `Minimum`: numero minimo di eventi sottoposti a limitazione (della larghezza di banda della rete) in un dato campione.
+ `Maximum`: numero massimo di eventi sottoposti a limitazione (della larghezza di banda della rete) in un dato campione.

### WriteThrottleEvents
<a name="WriteThrottleEvents"></a>

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
<a name="w2aac41c15c13b7c11"></a>

I parametri di utilizzo CloudWatch consentono di gestire in modo proattivo l'utilizzo visualizzando i parametri nella CloudWatch console, creando dashboard personalizzati, rilevando i cambiamenti di attività con il rilevamento delle CloudWatch anomalie e configurando allarmi che avvisano 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 ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Quotas-Visualize-Alarms.html)

**Topics**<a name="ddb-usage-metrics.title"></a>
+ [AccountProvisionedWriteCapacityUnits](#w2aac41c15c13b7c11b9)
+ [AccountProvisionedReadCapacityUnits](#w2aac41c15c13b7c11c11)
+ [TableCount](#w2aac41c15c13b7c11c13)

#### AccountProvisionedWriteCapacityUnits
<a name="w2aac41c15c13b7c11b9"></a>

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.

#### AccountProvisionedReadCapacityUnits
<a name="w2aac41c15c13b7c11c11"></a>

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
<a name="w2aac41c15c13b7c11c13"></a>

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. 

### FaultInjectionServiceInducedErrors
<a name="FaultInjectionServiceInducedErrors"></a>

Le richieste a DynamoDB che generano un codice di stato HTTP 500 simulato durante il periodo di tempo specificato e durante il recupero a seguito dell'esperimento. AWS FIS 

Unità: `Count`

Dimensioni: `TableName`, `Operation`

Statistiche valide:
+ `Sum` 
+ `SampleCount` 

## Comprendere i parametri e le dimensioni per DynamoDB
<a name="ddb-understanding-metric-dimensions"></a>

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.

**Topics**<a name="available-metrics.title"></a>
+ [DelegatedOperation](#w2aac41c15c13b9b7)
+ [GlobalSecondaryIndexName](#w2aac41c15c13b9b9)
+ [Operation](#w2aac41c15c13b9c11)
+ [OperationType](#w2aac41c15c13b9c13)
+ [Verb](#w2aac41c15c13b9c15)
+ [ReceivingRegion](#w2aac41c15c13b9c17)
+ [StreamLabel](#w2aac41c15c13b9c19)
+ [TableName](#w2aac41c15c13b9c21)

### DelegatedOperation
<a name="w2aac41c15c13b9b7"></a>

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
<a name="w2aac41c15c13b9b9"></a>

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

### Operation
<a name="w2aac41c15c13b9c11"></a>

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
<a name="w2aac41c15c13b9c13"></a>

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
<a name="w2aac41c15c13b9c15"></a>

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
<a name="w2aac41c15c13b9c17"></a>

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
<a name="w2aac41c15c13b9c19"></a>

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
<a name="w2aac41c15c13b9c21"></a>

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.

# Creazione di CloudWatch allarmi in DynamoDB
<a name="Monitoring-metrics-creating-cloudwatch-alarms"></a>

Un [CloudWatch allarme](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) controlla una singola metrica in un periodo di tempo specificato ed esegue una o più azioni specifiche, in base al valore della metrica rispetto a una soglia nel tempo. L'operazione corrisponde all'invio di una notifica a un argomento di Amazon SNS o a una policy di Auto Scaling. Puoi anche aggiungere allarmi alle dashboard in modo da monitorare e ricevere avvisi sulle tue AWS risorse e applicazioni in più regioni. Non c'è limite al numero di allarmi che puoi creare. CloudWatch gli allarmi non richiamano azioni semplicemente perché si trovano in uno stato particolare; lo stato deve essere cambiato e mantenuto per un determinato numero di periodi. Per un elenco degli allarmi DynamoDB consigliati, consulta [Allarmi consigliati](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Best_Practice_Recommended_Alarms_AWS_Services.html#DynamoDB).

**Nota**  
È necessario specificare tutte le dimensioni richieste durante la creazione dell' CloudWatch allarme, poiché non CloudWatch verranno aggregate le metriche relative a una dimensione mancante. La creazione di un CloudWatch allarme con una dimensione mancante non genererà un errore durante la creazione dell'allarme.

Si supponga una tabella predisposta con cinque unità di capacità di lettura. Desideri ricevere una notifica prima di consumare l'intera capacità di lettura assegnata, quindi decidi di creare un CloudWatch allarme per ricevere una notifica quando la capacità consumata raggiunge l'80% di quella prevista per la tabella. È possibile creare allarmi nella CloudWatch console o utilizzando il.AWS CLI

## Creazione di un allarme nella console CloudWatch
<a name="monitoring-metrics-creating-an-alarm-cw-console"></a>

**Per creare un allarme nella CloudWatch console**

1. Accedi a Console di gestione AWS e apri la CloudWatch console all'indirizzo [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Nel pannello di navigazione, scegli **Alarms** (Allarmi), **All alarms** (Tutti gli allarmi).

1. Scegli **Crea allarme**.

1. Trova la riga con la tabella che desideri monitorare e **`ConsumeReadCapacityUnits`** nella colonna **Nome della metrica**. Seleziona la casella di spunta accanto a questa riga e scegli **Seleziona metrica**.

1. In **Specifica parametri e condizioni**, per **Statistica** seleziona **Somma**. Per **Periodo**, seleziona **1 minuto**.

1. In **Conditions** (Condizioni), specifica quanto segue:

   1. For **Threshold type (Tipo di soglia)**, scegli **Static (Statica)**.

   1. Per **Ogni volta che `ConsumedReadCapacityUnits` è**, seleziona **Maggiore/Uguale** e inserisci come soglia 240.

1. Scegli **Next (Successivo)**.

1. In **Notifica**, seleziona **`In alarm`** e seleziona un argomento SNS per notificare quando l’allarme è in stato `ALARM`.

1. Al termine, scegli **Apply** (Applica).

1. Inserisci un nome e una descrizione per l’allarme, quindi scegli **Next (Successivo)**.

1. In **Preview and create** (Visualizza anteprima e crea), conferma che le informazioni e le condizioni sono quelle desiderate, quindi scegli **Create alarm** (Crea allarme).

## Creazione di un allarme in AWS CLI
<a name="Monitoring-metrics-creating-an-alarm-cli"></a>

```
aws cloudwatch put-metric-alarm \
    -\-alarm-name ReadCapacityUnitsLimitAlarm \
    -\-alarm-description "Alarm when read capacity reaches 80% of my provisioned read capacity" \
    -\-namespace AWS/DynamoDB \
    -\-metric-name ConsumedReadCapacityUnits \
    -\-dimensions Name=TableName,Value=myTable \
    -\-statistic Sum \
    -\-threshold 240 \
    -\-comparison-operator GreaterThanOrEqualToThreshold \
    -\-period 60 \                           
    -\-evaluation-periods 1 \
    -\-alarm-actions arn:aws:sns:us-east-1:123456789012:capacity-alarm
```

Testa l'allarme.

```
aws cloudwatch set-alarm-state -\-alarm-name ReadCapacityUnitsLimitAlarm -\-state-reason "initializing" -\-state-value OK
```

```
aws cloudwatch set-alarm-state -\-alarm-name ReadCapacityUnitsLimitAlarm -\-state-reason "initializing" -\-state-value ALARM
```

## Altri AWS CLI esempi
<a name="Monitoring-metrics-more-cli-examples"></a>

La procedura seguente descrive come ricevere una notifica in caso di richieste che superano le quote di throughput allocato per una tabella.

1. Crea un argomento Amazon SNS. `arn:aws:sns:us-east-1:123456789012:requests-exceeding-throughput` Per ulteriori informazioni, consulta la pagina relativa alla [configurazione di Amazon Simple Notification Service](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html).

1. Crea l'allarme.

   ```
   aws cloudwatch put-metric-alarm \
           -\-alarm-name ReadCapacityUnitsLimitAlarm \
           -\-alarm-description "Alarm when read capacity reaches 80% of my provisioned read capacity" \
           -\-namespace AWS/DynamoDB \
           -\-metric-name ConsumedReadCapacityUnits \
           -\-dimensions Name=TableName,Value=myTable \
           -\-statistic Sum \
           -\-threshold 240 \
           -\-comparison-operator GreaterThanOrEqualToThreshold \
           -\-period 60 \                           
           -\-evaluation-periods 1 \
           -\-alarm-actions arn:aws:sns:us-east-1:123456789012:capacity-alarm
   ```

1. Testa l'allarme.

   ```
   aws cloudwatch set-alarm-state --alarm-name RequestsExceedingThroughputAlarm --state-reason "initializing" --state-value OK
   ```

   ```
   aws cloudwatch set-alarm-state --alarm-name RequestsExceedingThroughputAlarm --state-reason "initializing" --state-value ALARM
   ```

La procedura seguente descrive come ricevere una notifica in caso di errori di sistema.

1. Crea un argomento Amazon SNS. `arn:aws:sns:us-east-1:123456789012:notify-on-system-errors` Per ulteriori informazioni, consulta la pagina relativa alla [configurazione di Amazon Simple Notification Service](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html).

1. Crea l'allarme.

   ```
   aws cloudwatch put-metric-alarm \
       --alarm-name SystemErrorsAlarm \
       --alarm-description "Alarm when system errors occur" \
       --namespace AWS/DynamoDB \
       --metric-name SystemErrors \
       --dimensions Name=TableName,Value=myTable Name=Operation,Value=aDynamoDBOperation \
       --statistic Sum \
       --threshold 0 \
       --comparison-operator GreaterThanThreshold \
       --period 60 \
       --unit Count \
       --evaluation-periods 1 \
       --treat-missing-data breaching \
       --alarm-actions arn:aws:sns:us-east-1:123456789012:notify-on-system-errors
   ```

1. Testa l'allarme.

   ```
   aws cloudwatch set-alarm-state --alarm-name SystemErrorsAlarm --state-reason "initializing" --state-value OK
   ```

   ```
   aws cloudwatch set-alarm-state --alarm-name SystemErrorsAlarm --state-reason "initializing" --state-value ALARM
   ```