Cómo se manejan las solicitudes

En este documento se describe cómo tu aplicación de App Engine recibe solicitudes y envía respuestas. Para obtener más detalles, consulta la referencia de Encabezados de solicitud y respuestas.

Si la aplicación usa servicios, puedes direccionar solicitudes a un servicio específico o a una versión específica de ese servicio. Para obtener más información sobre cómo direccionar el servicio, consulta Cómo enrutar solicitudes.

Cómo controlar las solicitudes

La aplicación se encarga de iniciar un servidor web y controlar las solicitudes. Puedes usar cualquier marco de trabajo web que esté disponible para tu lenguaje de desarrollo.

App Engine ejecuta varias instancias de tu aplicación, y cada una tiene su propio servidor web para manejar solicitudes. Estas pueden enrutarse a cualquier instancia, por lo que las solicitudes consecutivas del mismo usuario no necesariamente se envían a la misma instancia. Una instancia puede manejar varias solicitudes al mismo tiempo. La cantidad de instancias se puede ajustar automáticamente a medida que cambia el tráfico. También puedes cambiar la cantidad de solicitudes simultáneas que puede controlar una instancia. Para esto, configura el elemento max_concurrent_requests en tu archivo app.yaml.

El entorno de ejecución de Go para App Engine utiliza el paquete http estándar como una interfaz entre tu programa de Go y los servidores de App Engine. Cuando App Engine recibe una solicitud web para tu aplicación, invoca al controlador http.Handler asociado a la URL de la solicitud.

En el siguiente ejemplo, se muestra una aplicación completa de Go que envía una string HTML hard-coded al usuario:


package hello

import (
	"fmt"
	"net/http"
)

func init() {
	http.HandleFunc("/", hello)
}

func hello(w http.ResponseWriter, r *http.Request) {
	fmt.Fprintf(w, "<h1>Hello, world</h1>")
}

Cuotas y límites

App Engine asigna recursos a tu aplicación de manera automática a medida que el tráfico aumenta. Sin embargo, esto se limita con las siguientes restricciones:

  • App Engine reserva la capacidad de ajuste de escala automático para aplicaciones con latencia baja a fin de que la aplicación responda a las solicitudes en menos de un segundo. Las aplicaciones con latencia muy alta, por ejemplo, las de más de un segundo por solicitud para varias solicitudes y capacidad de procesamiento alta requieren asistencia nivel Plata, Oro o Platino. Los clientes con este nivel de asistencia pueden comunicarse con su representante de asistencia para solicitar el aumento de sus límites de capacidad de procesamiento.

  • Las aplicaciones estrechamente vinculadas a la CPU también pueden incurrir en alguna latencia adicional para compartir recursos de manera eficaz con otras aplicaciones en el mismo servidor. Las solicitudes para archivos estáticos están exentas de estos límites de capacidad de latencia.

Cada solicitud que entra a la aplicación se tiene en cuenta para los límites de Solicitudes. Los datos enviados en respuesta a una solicitud se tienen en cuenta para el límite de Ancho de banda de salida (facturable).

Tanto las solicitudes HTTP como las HTTPS (seguras) se tienen en cuenta para los límites de Solicitudes, Ancho de banda de entrada (facturable) y Ancho de banda de salida (facturable). La página Detalles de cuota de GCP Console también informa las solicitudes seguras, el ancho de banda de entrada seguro y el ancho de banda de salida seguro como valores individuales para fines informativos. Solo las solicitudes HTTPS se tienen en cuenta para estos valores. Para obtener más información, consulta la página de Cuotas.

Los siguientes límites se aplican específicamente al uso de los controladores de solicitudes:

Límite Importe
tamaño de la solicitud 32 megabytes
tamaño de la respuesta 32 megabytes
duración de la solicitud 60 segundos
cantidad total máxima de archivos (archivos estáticos y de la aplicación) 10,000 en total
1,000 por directorio
tamaño máximo de un archivo de la aplicación 32 megabytes
tamaño máximo de un archivo estático 32 megabytes
tamaño total máximo de todos los archivos estáticos y de la aplicación el primer (1) gigabyte es gratuito
$0.026 por gigabyte al mes después del primer (1) gigabyte

Límites de la respuesta

Las respuestas dinámicas se limitan a 32 MB. Si un controlador de secuencia de comandos genera una respuesta superior a este límite, el servidor envía una respuesta vacía con un código de estado 500 “Error interno del servidor”. Este límite no se aplica para las respuestas que entregan datos de Blobstore o Cloud Storage.

Encabezados de solicitud

Una solicitud HTTP nueva incluye los encabezados HTTP que envía el cliente. Por motivos de seguridad, los proxies intermedios limpian o modifican algunos encabezados antes de que lleguen a la aplicación.

Para obtener más información, consulta la referencia de Encabezados de solicitud.

Respuestas a solicitudes

App Engine llama al controlador con un valor Request y un ResponseWriter y, luego, espera a que el controlador le escriba a ResponseWriter y devuelva una respuesta. Cuando el controlador devuelve una respuesta, los datos en el búfer interno del ResponseWriter se envían al usuario.

Este procedimiento es prácticamente igual a cuando escribes programas normales de Go que usan el paquete http.

Se aplican límites a la respuesta que generas y la respuesta se puede modificar antes de que regrese al cliente.

Para obtener más información, consulta la referencia de Respuestas a solicitudes.

Respuestas a transmisión

App Engine no admite la transmisión de respuestas, donde los datos se envían en fragmentos graduales al cliente mientras se procesa una solicitud. Todos los datos de tu código se recopilan como se describió anteriormente y se envían como una respuesta HTTP simple.

Compresión de la respuesta

Si el cliente envía encabezados HTTP con la solicitud original que indican que el cliente puede aceptar contenido comprimido (en formato Gzip), App Engine comprime automáticamente los datos de respuesta del controlador y adjunta los encabezados de respuesta adecuados. El servicio usa los encabezados de solicitud Accept-Encoding y User-Agent para determinar si el cliente puede recibir respuestas comprimidas de manera confiable.

Los clientes personalizados pueden indicar la posibilidad de recibir respuestas comprimidas si especifican los encabezados Accept-Encoding y User-Agent con el valor gzip. El Content-Type de la respuesta también se usa para determinar si es adecuado usar la compresión. Por lo general, los tipos de contenido basado en texto están comprimidos, mientras que los tipos de contenido binario no lo están.

Cuando App Engine comprime automáticamente las respuestas, se agrega el encabezado Content-Encoding a la respuesta.

Cómo especificar un plazo para la solicitud

Un controlador de solicitudes tiene un tiempo limitado para generar y mostrar una respuesta a una solicitud, normalmente alrededor de 60 segundos. Una vez que se alcanza el plazo, el controlador de solicitudes se interrumpe. Cuando un controlador de solicitudes de Go supera el plazo, se termina su proceso y el entorno de ejecución muestra un "Error interno del servidor" HTTP 500 al cliente.

Aunque una solicitud puede tardar hasta 60 segundos en mostrar una respuesta, App Engine está optimizado para aplicaciones con solicitudes de corta duración, normalmente las que tardan unos cientos de milisegundos. Una aplicación eficiente responde rápidamente a la mayoría de las solicitudes. Si una aplicación no puede hacerlo, no escalará bien con la infraestructura de App Engine.

Consulta Cómo tratar DeadlineExceededErrors para conocer las causas comunes de los errores DeadlineExceededError y las soluciones alternativas recomendadas.

Registro

El paquete log tiene las funciones Debugf, Infof, Warningf, Errorf y Criticalf, que imprimen mensajes en los registros de tu aplicación. Puedes ver y analizar registros en GCP Console mediante Stackdriver Logging.

En el siguiente ejemplo, se muestra un controlador HTTP que construye un appengine.Context a partir de *http.Request y registra la URL solicitada.


package hello

import (
	"net/http"

	"google.golang.org/appengine"
	"google.golang.org/appengine/log"
)

func init() {
	http.HandleFunc("/", Logger)
}

func Logger(w http.ResponseWriter, r *http.Request) {
	ctx := appengine.NewContext(r)
	log.Infof(ctx, "Requested URL: %v", r.URL)
}

Entorno

El entorno de ejecución de Go proporciona acceso a información sobre el entorno mediante la interfaz appengine.Context. Consulta la referencia del paquete appengine para obtener más información.

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Entorno estándar de App Engine para Go