Diagnosi della limitazione (della larghezza di banda della rete)

Quando l’applicazione subisce una limitazione (della larghezza di banda della rete), DynamoDB fornisce informazioni dettagliate sulle eccezioni e metriche CloudWatch mirate per aiutare a diagnosticare questi eventi.

In questa sezione viene presentato un approccio sistematico alla comprensione degli eventi di limitazione (della larghezza di banda della rete) nelle applicazioni DynamoDB. Viene mostrato come interpretare le eccezioni di limitazione (della larghezza di banda della rete), correlarle alle metriche CloudWatch per informazioni più approfondite e capire quali modifiche potrebbero ridurre questo tipo di limitazione nelle applicazioni DynamoDB.

Funzionamento delle eccezioni di limitazione (della larghezza di banda della rete)

Quando DynamoDB limita sottopone a limitazione (della larghezza di banda della rete) una richiesta, restituisce eccezioni specifiche con informazioni diagnostiche dettagliate. Ad esempio, in Java, queste includono ProvisionedThroughputExceededException, RequestLimitExceeded o ThrottlingException.

Ogni eccezione include ThrottlingReasons una raccolta di dati ThrottlingReason singoli contenenti due campi chiave per aiutare a identificare e comprendere la limitazione (della larghezza di banda della rete):

Il campo del motivo segue un modello coerente che aiuta a capire esattamente cosa sta succedendo:

L’ARN della risorsa identifica esattamente quale tabella o quale indice sono sottoposti a limitazione (della larghezza di banda della rete):

Esempi di motivi di limitazione (della larghezza di banda della rete) completa:

In questo modo è possibile identificare esattamente quale risorsa viene sottoposta a limitazione (della larghezza di banda della rete), che tipo di operazione l’ha causata e perché si è verificata la limitazione.

Eccezioni di esempio

Esempio 1: superamento della capacità allocata su un GSI

{
    "ThrottlingReasons": [
        {
            "reason": "IndexWriteProvisionedThroughputExceeded",
            "resource": "arn:aws:dynamodb:us-west-2:123456789012:table/CustomerOrders/index/OrderDateIndex"
        }
    ],
    "awsErrorDetails": {
        "errorCode": "ProvisionedThroughputExceeded",
        "errorMessage": "The level of configured provisioned throughput for the index was exceeded",
        "serviceName": "DynamoDB",
        "sdkHttpResponse": {
            "statusText": "Bad Request",
            "statusCode": 400
        }
    }
}

In questo esempio, l’applicazione riceve una ProvisionedThroughputExceededException con il motivo IndexWriteProvisionedThroughputExceeded. Alle scritture su OrderDateIndex viene applicata una limitazione (della larghezza di banda della rete) perché l’utilizzo di scrittura ha superato la capacità di scrittura allocata configurata del GSI.

Esempio 2: superamento del throughput massimo on demand

{
    "ThrottlingReasons": [
        {
            "reason": "TableReadMaxOnDemandThroughputExceeded",
            "resource": "arn:aws:dynamodb:us-east-1:123456789012:table/UserSessions"
        }
    ],
    "awsErrorDetails": {
        "errorMessage": "Throughput exceeds the maximum OnDemandThroughput configured on table or index",
        "errorCode": "ThrottlingException",
        "serviceName": "DynamoDB",
        "sdkHttpResponse": {
            "statusText": "Bad Request",
            "statusCode": 400
        }
    }
}

In questo esempio, le letture dalla tabella UserSessions subiscono una limitazione (della larghezza di banda della rete) perché superano il limite massimo di throughput on demand configurato nella tabella.

Framework di diagnosi della limitazione (della larghezza di banda della rete) di DynamoDB

Quando l’applicazione riscontra una limitazione (della larghezza di banda della rete), segui questa procedura per diagnosticare e risolvere il problema.

Fase 1: analizzare i dettagli di ThrottlingReason

Fase 2: identificare e analizzare le metriche CloudWatch correlate

Fase 3: identificare le chiavi con limitazione (della larghezza di banda della rete) e i tassi di accesso elevati con Contributor Insights di CloudWatch (per la limitazione relativa alle partizioni)

Se sono stati identificati problemi relativi alle partizioni nella Fase 1 (come errori KeyRangeThroughputExceeded), Contributor Insights di CloudWatch per DynamoDB può aiutare a diagnosticare quali chiavi specifiche generano traffico e registrano eventi di limitazione (della larghezza di banda della rete) nella tabella o nell’indice.

Per informazioni dettagliate sull’attivazione e l’utilizzo di Contributor Insights di CloudWatch, consulta Using CloudWatch Contributor Insights for DynamoDB.

Fase 4: determinare la soluzione appropriata

Dopo aver diagnosticato la causa specifica della limitazione (della larghezza di banda della rete), implementa la soluzione consigliata in base al contesto specifico. La soluzione appropriata dipende da diversi fattori, tra cui lo scenario di limitazione (della larghezza di banda della rete), la modalità di capacità della tabella, le decisioni di progettazione delle chiavi e delle tabelle, i modelli di accesso e l’efficienza delle query, la configurazione degli indici globali e secondari, l’architettura generale del sistema e i punti di integrazione.

Per soluzioni dettagliate per affrontare gli scenari di limitazione (della larghezza di banda della rete) specifici, consulta la sezione Guida alla risoluzione della limitazione (della larghezza di banda della rete) in DynamoDB. Questa risorsa fornisce strategie di correzione mirate personalizzate in base al particolare motivo di limitazione (della larghezza di banda della rete) e alla configurazione della modalità di capacità.

Fase 5: monitorare i progressi