Cache

La técnica de almacenamiento en caché consiste en guardar temporalmente los datos en un componente más eficaz para acelerar el acceso a la información. A continuación, cada vez que se solicitan algunos datos y están presentes en la memoria caché, la latencia al acceder a ellos es extremadamente baja.

En situaciones de alta demanda, con un gran volumen de peticiones, el uso de almacenamiento en caché trae ganancias sustanciales de rendimiento. El API Manager implementa la funcionalidad de almacenamiento en caché para cualquier operación (del método HTTP GET) de una API.

El interceptor Cache Write, cuando se inserta en el flujo de respuesta (response) de una operación GET determinada, creará una memoria caché basada en la configuración informada. A partir de la segunda petición, el sistema utilizará la respuesta almacenada en la memoria. Para habilitar esto, agregue un interceptor Cache Read en el flujo de petición (request):

Cuando se configura el almacenamiento en caché, se pueden incluir atributos de header o de URL para determinar la entrada de caché que se debe utilizar, además de la hora de expiración de los datos almacenados en caché (tiempo de vida).

El interceptor Cache Read es responsable de identificar una memoria caché existente mediante el nombre de caché (cache name) informado. Cuando se envía una petición a una operación almacenada en caché, el interceptor identifica la memoria caché e inserta la respuesta guardada en la llamada. Esto significa una ganancia de rendimiento, ya que no es necesario enviar la petición al servidor.

El interceptor Cache Invalidation es responsable de invalidar una memoria caché determinada, en función del nombre de caché informado. Cuando se inserta en una operación determinada, el sistema buscará y eliminará la memoria caché.

Las respuestas de los datos de caché no tienen que ser siempre las mismas, pueden variar en función de los elementos predefinidos. La clave de caché identifica las diferentes respuestas almacenadas. Todos los elementos de la petición (URL, headers, parámetros de consulta, etc.) que influyen en la respuesta deben formar parte de la clave. Los elementos que no influyen en la respuesta se pueden dejar fuera.

Para informar cómo se debe formar la clave de caché, el administrador debe rellenar dos campos, después de seleccionar el interceptor Cache Write en el flujo de respuesta (response):

Al capturar la memoria caché para las respuestas existentes, el gateway solo tendrá en cuenta las direcciones URL que son exactamente las mismas que las solicitadas. Esto significa que una regla que configura la memoria caché del recurso /products no establece la memoria caché del recurso /products/{id}; de hecho, para la API, ambos son dos recursos completamente separados.

Tenga en cuenta, sin embargo, que si se crea una regla de almacenamiento en caché para el recurso /products/{id}, el gateway almacenará en caché diferentes respuestas a /products/123 y /products/456, como se espera. Esto significa que peticiones a productos populares a menudo se servirán desde la memoria caché, mientras que los productos menos vistos no estarán en la memoria caché y las peticiones se dirigirán directamente al servidor.

Las reglas anteriores sobre los headers y los parámetros de consulta que forman parte de la memoria caché se aplican también a los recursos, como /products/{id}.

Cada regla de caché especifica un período de tiempo en el que la memoria caché se considera válida. Después de este tiempo, las respuestas en esta memoria caché se descartan. Tenga en cuenta que los valores ​están en segundos; normalmente, las cachés de respuesta de APIs pueden durar de unos segundos a unas pocas horas, no más que esto.

Internamente, el gateway tiene un límite práctico a la cantidad de bytes que puede almacenar en la memoria. El propósito de esto es proteger la propia infraestructura del gateway, de modo que una respuesta demasiado grande no ocupará la memoria durante demasiado tiempo. En general, este límite es lo suficientemente grande como para acomodar muchas llamadas de tamaño razonable; pero si se alcanza el umbral, las nuevas respuestas solo se almacenarán después de que se eliminen algunas.

La memoria caché se actualiza cuando expira su tiempo de vida y se realiza una petición para una operación que tiene los interceptores Cache Write y Cache Read en su flujo. Para deshabilitar una memoria caché, inserte un interceptor Cache Invalidation con el mismo nombre de caché en una operación.