• EnglishEspañol日本語한국어Português
  • Inicia sesiónComenzar ahora

Te ofrecemos esta traducción automática para facilitar la lectura.

En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.

Crea una propuesta

Protección contra sobrecarga de API: manejo de errores 429

Para responder rápidamente a su API de llamada REST, incluso cuando otros clientes realizan consultas que consumen mucho tiempo, New Relic incluye protección contra sobrecargas en la API.

Si está consultando una cantidad de datos lo suficientemente grande como para consumir recursos significativos, el código de respuesta y los encabezados de la API indicarán que ha excedido la capacidad disponible para su clave de API. Esta es una condición rara que la mayoría de los clientes nunca verán. Solo lo verán los clientes cuyo uso de API requiera muchos recursos.

Los clientes estarán limitados a 1000 llamadas API por minuto.

Respuestas API

En funcionamiento normal, la API no agrega ningún estado de protección contra sobrecargas a las respuestas. No es necesario realizar ninguna acción.

Durante el intervalo de tiempo reporting period , New Relic rastrea el impacto de cada solicitud de API en nuestro sistema.

Estos son los casos típicos que pueden activar la protección contra sobrecarga o la limitación de velocidad:

  • Una clave de API que estás utilizando ha superado el número máximo de solicitudes por minuto.
  • Nuestro sistema generalmente está sobrecargado y necesitamos que algunas cuentas reduzcan sus informes.

En el caso de que se produzca una limitación de velocidad, sucederán las siguientes cosas:

  • La API de llamada adicional fallará con el código de estado HTTP 429 (demasiadas solicitudes).
  • Los encabezados y el cuerpo de las respuestas HTTP pueden contener o no más información sobre el error.
  • La llamada API se permitirá nuevamente al final del período del informe.

Encabezados

Estos son los encabezados HTTP que aparecerán en las respuestas de API si ha excedido el límite individual de su clave de API:

Encabezado de sobrecarga

Significado

X-RateLimit-Limit

Número máximo de solicitudes por minuto.

X-RateLimit-Remaining

Número de solicitudes restantes en este período.

X-RateLimit-Reset

Timestamp UNIX (número de segundos desde el 1 de enero de 1970) cuando finaliza el período de informe actual. Las solicitudes de API serán respondidas después de este tiempo.

X-RateLimit-Docs

Hipervínculo a este documento para que tenga información adicional de inmediato.

Estos son los encabezados HTTP que aparecerán en las respuestas de la API si hay un problema general del sistema:

Encabezado de sobrecarga

Significado

Retry-After

Número de segundos hasta que debas volver a intentarlo.

Ejemplo

Aquí hay un ejemplo de solicitud de API que indica que la persona que llama ha consumido todos los recursos disponibles y que se permitirán más llamadas API nuevamente al mediodía del 1 de febrero de 2016:

curl -X GET 'https://api.newrelic.com/v2/applications.json' \
     -H "Api-Key:$API_KEY" -i
HTTP/1.1 429 Too Many Requests
Content-Type: application/json
...
X-RateLimit-Docs: https://docs.newrelic.com/docs/apis/rest-api-v2/requirements/api-overload-protection-preventing-429-errors
X-RateLimit-Reset: 1454313600
X-RateLimit-Remaining: 0
X-RateLimit-Limit: 1000

{}

Prevención de errores de limitación de velocidad

La solución más sencilla para un error 429 es esperar hasta que finalice el período del informe antes de enviar su próxima solicitud de API. Sin embargo, con una gestión cuidadosa de su consulta, puede evitar errores de protección contra sobrecargas en primer lugar.

Si sabe que enviará muchas consultas que consumirán muchos recursos, puede realizar una de las siguientes medidas preventivas:

  • Envía tu consulta con menos frecuencia; en particular, consulte con menos frecuencia que una vez por minuto (la frecuencia de actualización de los datos del agente).
  • Almacene en caché los datos de New Relic en lugar de solicitarlos desde la API cada vez.
  • Utilice la técnica basada en cursor si debe solicitar nombres métricos y los resultados de salida en varias páginas.
Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.