Configura solicitudes de preparación para mejorar el rendimiento

Puedes usar solicitudes de preparación para reducir la latencia de respuestas y solicitudes durante la carga del código de tu app en una instancia recién creada.

Con frecuencia, App Engine necesita cargar el código de tu app en una instancia nueva. La carga de una instancia puede suceder en las siguientes situaciones:

  • Cuando vuelves a implementar una versión de tu app.
  • Cuando se crean nuevas instancias debido a que la carga de solicitudes supera la capacidad del conjunto actual de instancias en ejecución.
  • Cuando se realizan reparaciones y mantenimiento de la infraestructura subyacente o del hardware físico.

Cuando cargas el código de tu app en una instancia nueva, pueden generarse solicitudes de carga. Las solicitudes de carga pueden provocar una mayor latencia de solicitudes para tus usuarios. Puedes evitar esta latencia si usas solicitudes de preparación. Estas cargan el código de tu app en una instancia nueva antes de que le lleguen solicitudes reales.

Si habilitaste las solicitudes de preparación en tu aplicación, App Engine intenta detectar cuándo esta necesita una instancia nueva y envía una solicitud de preparación para inicializarla. Sin embargo, estos intentos de detección no funcionan en todos los casos. Por eso, es posible que encuentres solicitudes de carga incluso si habilitaste las solicitudes de preparación en tu app. Por ejemplo, si tu app no entrega tráfico, la primera solicitud que reciba siempre será una solicitud de carga, no una solicitud de preparación.

Las solicitudes de preparación usan horas de instancia como cualquier otra solicitud para tu aplicación de App Engine. En la mayoría de los casos en los que se habilitan las solicitudes de preparación, no se observa un aumento en las horas de instancia porque la aplicación simplemente se inicializa con una solicitud de preparación en lugar de una de carga. Tu uso de horas de instancia puede aumentar si decides hacer más trabajo, como almacenar datos en caché de forma previa durante una solicitud de preparación. Si configuras un mínimo de instancias inactivas, es posible que encuentres solicitudes de preparación cuando esas instancias se inicien por primera vez, pero seguirán disponibles después de ese momento.

La solicitud de preparación predeterminada causa que todos los archivos JAR se indexen en la memoria y, además, inicializa tu aplicación y tus filtros.

Habilita las solicitudes de preparación

El programador de App Engine, que controla el ajuste de escala automático de las instancias según la configuración proporcionada por el usuario, usa las solicitudes de preparación. En el entorno de ejecución de Java en App Engine, las solicitudes de preparación están habilitadas de forma predeterminada y, por lo tanto, App Engine emite solicitudes GET a /_ah/warmup, lo que te permite responder y, luego, inicializar el código de tu aplicación según sea necesario. Puedes responder a las solicitudes de preparación con uno de los siguientes métodos:

Con un servlet <load-on-startup>
La forma más fácil de proporcionar una lógica de preparación es marcar tus propios servlets como <load-on-startup> en el archivo de configuración web.xml.
Con un ServletContextListener
Te permite ejecutar una lógica personalizada antes de que se invoque cualquiera de tus servlets a través de una solicitud de preparación o una solicitud de carga.
Con un servlet de preparación personalizado
Con un servlet de preparación personalizado puedes invocar el método service del servlet solo durante una solicitud de preparación, en lugar de hacerlo durante las solicitudes de carga.

Puede que necesites implementar tu propio controlador para /_ah/warmup según el método que elijas.

Antes de comenzar

Si las solicitudes de preparación están habilitadas, el programador inicia instancias cuando determina que se necesitan más. El programador usa solicitudes de preparación para iniciar tu app, por lo que las verás en los registros incluso si tu aplicación no procesa esas solicitudes de preparación.

Ten en cuenta que no hay garantía de que se llame a las solicitudes de preparación. En algunas situaciones, se envían solicitudes de carga en su lugar (por ejemplo, si la instancia es la primera que se inicia o si el tráfico aumenta de manera repentina). Sin embargo, si las solicitudes de preparación están habilitadas, el sistema hará todo lo posible para enviar las solicitudes a instancias que ya estén preparadas.

En Java 8, las solicitudes de preparación están habilitadas de forma predeterminada. Para habilitarlas, agrega - warmup a la directiva inbound_services en appengine-web.xml. Las solicitudes de preparación están habilitadas de forma predeterminada, por lo que solo deberás habilitarlas de manera explícita si implementaste una aplicación con anterioridad que tuviera las solicitudes de preparación inhabilitadas en appengine-web.xml. Si este fuera el caso, debes establecer el valor <warmup-requests-enabled> como true y, luego, volver a implementar.

Con un servlet <load-on-startup>

La forma más fácil de proporcionar una lógica de preparación es marcar tus propios servlets como <load-on-startup> en web.xml. Este método no requiere cambios en el código de tu aplicación y, además, inicializa todos los servlets especificados cuando tu aplicación se inicializa.

En tu archivo web.xml, agrega el elemento <load-on-startup>1</load-on-startup> a tu elemento <servlet> para los servlets que quieras cargar en el inicio. Por ejemplo:

<servlet>
  <servlet-name>my-servlet</servlet-name>
  <servlet-class>com.company.MyServlet</servlet-class>
  <load-on-startup>1</load-on-startup>
</servlet>

Estas líneas cargan la clase de servlet especificada y, además, invocan el método init() del servlet. La solicitud de preparación inicializa los servlets especificados antes de inspeccionar cualquier solicitud en tiempo real. Sin embargo, si no existe ninguna solicitud de preparación, los servlets especificados en <load-on-startup> se registrarán en la primera solicitud a una nueva instancia, lo que dará como resultado una solicitud de carga. Como ya mencionamos, puede que App Engine no genere una solicitud de preparación cada vez que tu app necesite una nueva instancia.

Con un ServletContextListener

Si cuentas con una lógica personalizada que desees ejecutar antes de que se invoquen tus servlets, sigue estos pasos:

  1. Registra un ServletContextListener en tu archivo web.xml.

    <listener>
      <listener-class>com.company.MyListener</listener-class>
    </listener>
    
  2. Proporciona una clase junto con tu servlet y un código de filtro:

    public class MyListener implements ServletContextListener {
      public void contextInitialized(ServletContextEvent event) {
        // This will be invoked as part of a warmup request, or
        // the first user request if no warmup request was invoked.
      }
      public void contextDestroyed(ServletContextEvent event) {
        // App Engine does not currently invoke this method.
      }
    }
    

El ServletContextListener se ejecuta durante la solicitud de preparación. Si no hay ninguna solicitud de preparación, se ejecuta en la primera solicitud a una nueva instancia. Puede dar como resultado solicitudes de carga.

Con un servlet de preparación personalizado

El servlet de preparación personalizado invoca el método service del servlet solo durante una solicitud de preparación. Colocar las operaciones lógicas costosas en un servlet de preparación personalizado te ayuda a reducir el tiempo de carga de las solicitudes de carga.

A fin de crear un servlet de preparación personalizado, solo debes anular la definición compilada del servlet para _ah_warmup en web.xml:

<servlet>
  <servlet-name>_ah_warmup</servlet-name>
  <servlet-class>com.company.MyWarmupServlet</servlet-class>
</servlet>
¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Entorno estándar de App Engine para Java 8