Diagnóstico de limitación

Cuando la aplicación experimenta limitación, DynamoDB proporciona información detallada sobre las excepciones y métricas específicas de CloudWatch para ayudarle a diagnosticar estos eventos.

En esta sección, se presenta un enfoque sistemático para entender los eventos de limitación en las aplicaciones de DynamoDB. Muestra cómo interpretar las excepciones de limitación, correlacionarlas con las métricas de CloudWatch para obtener información más detallada y comprender qué cambios reducirían la limitación en las aplicaciones de DynamoDB.

Comprensión de las excepciones de limitación

Cuando DynamoDB limita una solicitud, devuelve excepciones específicas con información de diagnóstico detallada. Por ejemplo, en Java, estas incluyen ProvisionedThroughputExceededException, RequestLimitExceeded o ThrottlingException.

Cada excepción incluye ThrottlingReasons, una recopilación de ThrottlingReason individuales que contiene dos campos clave para ayudarle a identificar y comprender la limitación:

El campo motivo sigue un patrón coherente que le ayuda a entender exactamente lo que está sucediendo:

El ARN del recurso identifica exactamente qué tabla o índice se está limitando:

Ejemplos de motivos de limitación total:

Esto ayuda a identificar exactamente qué recurso se está limitando, qué tipo de operación lo provocó y por qué se produjo la limitación.

Excepciones de ejemplo

Ejemplo 1: se ha superado la capacidad aprovisionada en 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
        }
    }
}

En este ejemplo, la aplicación recibe una ProvisionedThroughputExceededException con el motivo IndexWriteProvisionedThroughputExceeded. Las escrituras en el OrderDateIndex se están limitando porque el consumo de escritura ha superado la capacidad de escritura aprovisionada configurada para el GSI.

Ejemplo 2: Se ha superado el rendimiento máximo bajo demanda

{
    "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
        }
    }
}

En este ejemplo, las lecturas de la tabla UserSessions se están limitando porque superan el límite máximo de rendimiento bajo demanda configurado en la tabla.

Marco de diagnóstico de limitación de DynamoDB

Cuando la aplicación encuentre limitaciones, siga estos pasos para diagnosticar y resolver el problema.

Paso 1: analizar los detalles de ThrottlingReason

Paso 2: identificar y analizar las métricas de CloudWatch relacionadas

Paso 3: identificar las claves limitadas y las tasas de acceso altas mediante CloudWatch Contributor Insights (para limitación relacionada con particiones)

Si identificó problemas relacionados con las particiones en el paso 1 (por ejemplo, errores KeyRangeThroughputExceeded), CloudWatch Contributor Insights para DynamoDB puede ayudarlo a diagnosticar qué claves específicas generan tráfico y experimentan eventos de limitación en la tabla o índice.

Para obtener más información sobre cómo habilitar y usar CloudWatch Contributor Insights, consulte Uso de CloudWatch Contributor Insights para DynamoDB.

Paso 4: determinar la solución adecuada

Tras diagnosticar la causa específica de la limitación, implemente la solución recomendada en función del contexto específico. La solución adecuada depende de varios factores, incluyendo el escenario de limitación, el modo de capacidad de la tabla, las decisiones de diseño de la tabla y las claves, los patrones de acceso y la eficiencia de las consultas, la configuración de índices globales y secundarios, y la arquitectura general del sistema y los puntos de integración.

Para obtener soluciones detalladas que aborden los escenarios de limitación específicos, consulte la sección Guía de resolución de limitación de DynamoDB. Este recurso proporciona estrategias de corrección específicas personalizadas según el motivo concreto de la limitación y la configuración del modo de capacidad.

Paso 5: supervisar el progreso