Dado que la versión 5.5 de PHP ya no es compatible con la comunidad, recomendamos que las apps nuevas usen el entorno de ejecución de PHP 7.

Lee y escribe registros de aplicación

Descripción general

Cuando se envía una solicitud a tu aplicación, App Engine escribe de forma automática un registro de solicitud. Durante el manejo de la solicitud, la aplicación también puede escribir registros de aplicación. En esta página, aprenderás cómo escribir registros de aplicación desde la tuya, cómo ver los registros en Google Cloud Console y cómo interpretar los datos de registros de solicitudes que App Engine escribe durante la solicitud.

Para obtener más información sobre cómo descargar datos de registro, consulta Descripción general de las exportaciones de registros.

Registros de solicitud frente a registros de aplicación

Existen dos categorías de datos de registro: los registros de solicitudes y los registros de aplicación. App Engine escribe de forma automática un registro de solicitud por cada solicitud que tu aplicación controla, que contiene información como el ID del proyecto y la versión HTTP, entre otras.

Cómo escribir registros de aplicación

Cuando llamas a la función de PHP integrada syslog(), debes escribir los registros mediante la API de PHP de registros. Por ejemplo:

if (authorizedUser()) {
  echo '<p>Welcome authorized user</p>';
  syslog(LOG_INFO, 'Authorized access');
} else {
  echo 'Go away unauthorized user<p />';
  syslog(LOG_WARNING, "Unauthorized access");
}

No es necesario que llames a openlog() o closelog() antes de escribir en syslog. Se ignorarán las llamadas a estas funciones.

Formato de URL de registro en Google Cloud Console

Observa la siguiente URL de muestra para ver un ejemplo del formato de la URL de registro en Cloud Console:

https://console.cloud.google.com/logs?filters=request_id:000000db00ff00ff827e493472570001737e73686966746361727331000168656164000100

Lee registros en la Console

Si deseas ver los registros escritos por aplicaciones que se ejecutan en el entorno estándar, usa el visor de registros.

Si deseas filtrar las entradas de registros por etiqueta o búsqueda de texto en el visor de registros, consulta Filtros básicos de registros. Si deseas escribir filtros de registros avanzados mediante expresiones que especifiquen un conjunto de entradas de cualquier cantidad de registros, consulta Filtros de registros avanzados.

Un registro característico de App Engine contiene datos en formato de registro combinado Apache, junto con algunos campos especiales de App Engine, como figura en el siguiente registro de muestra:

192.0.2.0 - test [27/Jun/2014:09:11:47 -0700] "GET / HTTP/1.1" 200 414
"http://www.example.com/index.html"
Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/35.0.1916.153 Safari/537.36"
"1-dot-calm-sylph-602.appspot.com" ms=195 cpu_ms=42 cpm_usd=0.000046
loading_request=1 instance=00c61b117cfeb66f973d7df1b7f4ae1f064d app_engine_release=1.9.82

Cómo entender los campos de registro de solicitud

En la siguiente tabla, se muestran los campos en orden de aparición junto con una descripción:

Orden del campo Nombre del campo ¿Siempre presente? Descripción
1 Dirección del cliente Dirección IP de cliente. Ejemplo: 192.0.2.0
2 Identidad RFC 1413 No Identidad RFC 1413 del cliente. Casi siempre es el carácter -
3 Usuario No Solo presente si la app usa la API de usuarios y si el usuario ya accedió. Este valor es la parte del “sobrenombre” de la Cuenta de Google, por ejemplo, si la Cuenta de Google es test@example.com, el sobrenombre que se registra en este campo es test.
4 Marca de tiempo Marca de tiempo de la solicitud. Ejemplo: [27/Jun/2014:09:11:47 -0700].
5 String de consulta de la solicitud Primera línea de la solicitud; contiene el método, la ruta y la versión HTTP. Ejemplo: GET / HTTP/1.1
6 Código de estado HTTP Código de estado HTTP que se muestra. Ejemplo: 200.
7 Tamaño de la respuesta Tamaño de la respuesta en bytes. Ejemplo: 414.
8 Ruta del referente No En caso de que no haya referente, el registro no contendrá una ruta, sino solo -. Ejemplo de ruta del referente: "http://www.example.com/index.html".
9 Usuario-agente Identifica el navegador y el sistema operativo para el servidor web. Ejemplo: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/35.0.1916.153 Safari/537.36
10 Nombre de host El nombre de host que el cliente usa para conectarse a la aplicación de App Engine. Ejemplo: (1-dot-calm-sylph-602.appspot.com).
11 Tiempo real transcurrido Tiempo real total expresado en milisegundos que App Engine dedica a la solicitud. Esta duración no incluye el tiempo que transcurre entre que el cliente y el servidor ejecutan la instancia de la aplicación. Ejemplo: ms=195.
12 Milisegundos de la CPU Milisegundos de la CPU obligatorios para completar la solicitud. Es la cantidad de milisegundos que la CPU dedica en ejecutar el código de la aplicación, expresado en términos de una CPU de modelo de referencia de 1.2 GHz Intel x86. Si la CPU que se usa en realidad es más rápida que este modelo de referencia, los milisegundos pueden ser más que el tiempo real definido con anterioridad. Ejemplo: cpu_ms=42.
13 Código de salida No Presente solo si la instancia se cerró tras recibir la solicitud. Su formato es exit_code=XXX, en el que XXX es un número de 3 dígitos que corresponde a la razón por la que se cerró la instancia. Los códigos de salida no se documentan, ya que su objetivo principal es ayudar a Google a encontrar y solucionar problemas.
14 Costo estimado OBSOLETO. Costo estimado de 1,000 solicitudes como esta, en USD. Ejemplo: cpm_usd=0.000046
15 Nombre de la lista de tareas en cola No El nombre de la lista de tareas en cola usado. Presente solo si la solicitud usó una lista de tareas en cola. Ejemplo: queue_name=default.
16 Nombre de la tarea No El nombre de la tarea que se ejecutó en la lista de tareas en cola para esta solicitud. Presente solo si el resultado de la solicitud fue poner en cola una tarea. Ejemplo: task_name=7287390692361099748.
17 Cola pendiente No Solo está presente si una solicitud estuvo algún tiempo en una cola pendiente. Si existen muchas de estas en tus registros o si los valores son altos, eso podría indicar que necesitas más instancias para entregar el tráfico. Ejemplo: pending_ms=195.
18 Solicitud de carga No Presente solo si la solicitud es una solicitud de carga. Esto significa que se tuvo que iniciar una instancia. Lo ideal es que tus instancias funcionen bien por el mayor tiempo posible y que entreguen una gran cantidad de solicitudes antes de reciclarse y tener que iniciarse de nuevo. Eso implica que no deberías ver demasiadas de estas en tus registros. Ejemplo: loading_request=1.
19 Instancia Identificador único para la instancia que controla la solicitud. Ejemplo: instance=00c61b117cfeb66f973d7df1b7f4ae1f064d.
20 Versión La versión de actualización de App Engine vigente que se usa en App Engine de producción: 1.9.82

Cuotas y límites

Tu aplicación se ve afectada por las siguientes cuotas relacionadas con los registros:

  • Datos de registros recuperados mediante la API de registros
  • Asignación y retención de transferencia de registro

Cuota correspondiente a los datos recuperados

Los primeros 100 megabytes de datos de registro recuperados por día mediante las llamadas a la API de registros son gratuitos. Los datos que superen los 100 megabytes generarán cargos de $0.12 por GB.

Asignación de transferencia de registros

Google Cloud's operations suite proporciona el registro para apps de App Engine. Consulta Precios de Google Cloud's operations suite para obtener más información sobre los límites y los costos de los registros. Para el almacenamiento a largo plazo de registros, puedes exportar registros desde Google Cloud's operations suite a Cloud Storage, BigQuery y Pub/Sub.