Saltar al contenido

¿Cómo evito la limitación controlada cuando llamo a PutMetricData en la API de CloudWatch?

5 minutos de lectura
0

Recibo el error "400 ThrottlingException" en las llamadas a la API PutMetricData en Amazon CloudWatch.

Descripción corta

La API PutMetricData publica puntos de datos de métricas en CloudWatch. CloudWatch limita las solicitudes de PutMetricData para cada cuenta de AWS por región de AWS. Cuando superas la cuota de la tasa de solicitudes de PutMetricData, CloudWatch devuelve el error "400 ThrottlingException" con el mensaje "Rate exceeded".

Para evitar limitaciones, reduce la tasa de llamadas de PutMetricData. Puedes agrupar las métricas en menos llamadas, distribuir las llamadas a lo largo del tiempo o cambiar al formato de métricas integrado.

Nota: Todas las llamadas de PutMetricData en una región se tienen en cuenta para la tasa de solicitudes. Esto incluye llamadas desde cualquier aplicación personalizada o de terceros, como el agente de CloudWatch, la interfaz de la línea de comandos de AWS (AWS CLI) y la consola de administración de AWS.

Resolución

Identificación del origen de la limitación

Entre los orígenes de alto volumen de llamadas de PutMetricData se incluyen el agente de CloudWatch, los agentes de supervisión de terceros, el código de aplicación personalizado y varias funciones de AWS Lambda que publican métricas al mismo tiempo.

Identifica el rol, el usuario o el servicio de AWS Identity and Access Management (IAM) que realiza la mayor cantidad de llamadas de PutMetricData.

Sigue estos pasos:

  1. Abre la consola de CloudTrail.
  2. En el panel de navegación, selecciona Historial de eventos.
  3. En Nombre del evento, selecciona PutMetricData.
  4. En Código de error, selecciona Limitación.
  5. Elige la columna Nombre de usuario y, a continuación, identifica el origen.

Comprobación de la tasa de llamadas de PutMetricData

Para comprobar qué tan cerca estás de tu cuota, sigue estos pasos:

  1. Abre la consola de CloudWatch.
  2. En el panel de navegación, elige Métricas y, a continuación, Todas las métricas.
  3. Elige Uso y, a continuación, para el filtro, elige Por recurso de AWS.
  4. En la lista de métricas, busca la fila en la que la dimensión de recursos es PutMetricData y la dimensión de servicio es CloudWatch.
  5. Compara el recuento de llamadas con tu cuota en la consola de Service Quotas.
  6. Establece una alarma de CloudWatch en el 80 % de tu cuota para recibir una notificación antes de que comience la limitación.

Métricas por lotes en una sola llamada a la API

Cada llamada de PutMetricData admite hasta 1000 métricas y 150 puntos de datos por métrica. Si tu aplicación envía una métrica por llamada a la API, combínalas en una sola llamada con hasta 1000 métricas.

Utiliza conjuntos de datos agregados previamente, como StatisticSet, para publicar valores agregados como Sum, Min, Max y SampleCount en lugar de puntos de datos individuales. Cuando se agrupan métricas, se reduce la cantidad de llamadas a PutMetricData por segundo.

Distribución de las llamadas y adición de una lógica de reintento

Si tu aplicación envía muchas llamadas al mismo tiempo, por ejemplo, cada minuto, agrega fluctuación para introducir un retraso aleatorio.

También puedes volver a intentar las llamadas fallidas a PutMetricData con fluctuación y retroceso exponencial. Si usas un SDK de AWS, la lógica de reintento ya está aplicada de forma predeterminada. Si utilizas clientes HTTP personalizados, agrega esta lógica manualmente. Para obtener más información, consulta Tiempos de espera, reintentos y retardo con fluctuación.

Uso del formato métrico incorporado para métricas de alto volumen

Si tu aplicación se acerca o supera de manera consistente la cuota de transacciones por segundo (TPS) de PutMetricData o publica métricas de muchos orígenes simultáneos, como cientos de invocaciones de Lambda, utiliza el formato métrico incorporado en lugar de PutMetricData. Con el formato métrico incorporado, las métricas se escriben como JSON estructurado en los registros de la aplicación. CloudWatch extrae automáticamente las métricas de los registros.

Uso del agente de CloudWatch para el procesamiento automático por lotes

Para evitar llamadas directas a PutMetricData desde tu código, utiliza StatsD o collectd para enviar métricas de forma local al agente de CloudWatch. El agente agrupa, agrega y reintenta automáticamente los envíos de métricas. Para obtener más información, consulta Recuperación de las métricas personalizadas con StatsD y Recuperación de las métricas personalizadas con collectd.

Reducción de la cardinalidad métrica

Si utilizas valores únicos como dimensiones, como los ID de solicitud o los ID de usuario, cada combinación única crea un flujo de métricas independiente que aumenta el volumen de llamadas a la API. Utiliza categorías más amplias como dimensiones, como el nombre del entorno o el nombre del servicio, en lugar de identificadores únicos como los ID de solicitud o los ID de usuario. Para un análisis de alta cardinalidad, utiliza Información de registros de CloudWatch.

Información relacionada

Referencia de la API de CloudWatch

Managing and monitoring API throttling in your workloads (Administración y supervisión de la limitación de API en las cargas de trabajo)

OFICIAL DE AWSActualizada hace 7 meses
1 comentario

This article was reviewed and updated on 2026-04-22.

EXPERTO

respondido hace un mes