Eventos de la aplicación de almacenamiento de registros con Java

En esta parte del tutorial de Bookshelf para Java, se muestra cómo una aplicación puede incorporar un almacenamiento de registros detallado para ayudar a detectar, depurar y supervisar problemas potenciales.

Esta página forma parte de un tutorial de varias páginas. Para empezar en orden y consultar las instrucciones de configuración, ve a la aplicación Bookshelf de Java.

Ejecutar la aplicación en la máquina local

Para ejecutar la aplicación de forma local, sigue estos pasos:

  1. En el directorio getting-started-java/bookshelf/5-logging, introduce el siguiente comando para iniciar un servidor web local:

    mvn -Plocal clean jetty:run-exploded -DprojectID=[YOUR-PROJECT-ID]
  2. En el navegador web, ve a http://localhost:8080

Desplegar la aplicación en el entorno flexible de App Engine

  1. Introduce este comando para desplegar la aplicación:

    mvn appengine:deploy -DprojectID=YOUR-PROJECT-ID
    
  2. Introduce la siguiente dirección en el navegador web. Sustituye [YOUR_PROJECT_ID] por el ID del proyecto:

    https://[YOUR_PROJECT_ID].appspot-preview.com
    

Si actualizas la aplicación, puedes desplegar la versión actualizada al introducir el mismo comando que utilizaste para desplegar la aplicación por primera vez. El nuevo despliegue crea una nueva versión de la aplicación y la promociona a la versión predeterminada. Las versiones anteriores de la aplicación se mantienen, al igual que las instancias de VM asociadas. Ten en cuenta que todas estas versiones de aplicaciones e instancias de VM son recursos facturables.

Si eliminas las versiones no predeterminadas de la aplicación, puedes reducir los costes.

Para eliminar una versión de la aplicación, sigue las instrucciones a continuación:

  1. En GCP Console, dirígete a la página Versiones de App Engine.

    Ir a la página de Versiones

  2. Haz clic en la casilla de verificación junto a la versión de app no predeterminada que deseas borrar.
  3. Haz clic en el botón Borrar en la parte superior de la página para borrar la versión de la app.

Si quieres obtener información completa sobre cómo limpiar los recursos facturables, consulta la sección sobre limpiar los recursos en el último paso de este tutorial.

Ver registros

Mientras la aplicación Bookshelf se ejecuta, escribe los datos de almacenamiento de registros que se recopilan y se ponen a disposición en la consola de GCP. Puedes usar las herramientas de supervisión de registros en la consola de GCP para analizar los registros directamente. Si quieres un análisis más detallado, puedes usar la consola de GCP para emitir o importar los registros de la aplicación en BigQuery, o exportarlos a un segmento de Cloud Storage.

Almacenamiento de registros en la consola

Estructura de la aplicación

El siguiente diagrama muestra cómo la aplicación gestiona el almacenamiento de registros cuando se implementa en el entorno flexible de App Engine.

Eestructura de muestra de almacenamiento de registros: entorno flexible de App Engine

El siguiente diagrama muestra cómo la aplicación gestiona el almacenamiento de registros cuando se despliega en Google Compute Engine, que se explica en el último paso del tutorial.

Estructura de muestra de almacenamiento de registros - Compute Engine

Información sobre el código

Hay muchos paquetes de almacenamiento de registros de Java que son compatibles con el entorno flexible de App Engine. En esta muestra, se usa java.util.logging, ya que es la más conocida. Cada clase necesita un Logger instanciado, de la siguiente manera:

private final Logger logger = Logger.getLogger(ReadBookServlet.class.getName());

El método log, toma un valor de Level y una cadena. Los valores posibles para el nivel son de FINEST, FINER, FINE, CONFIG, INFO, WARNING, y SERVERE. También se puede realizar el registro mediante el uso de uno de los siguientes métodos de atajo: config, info, warning o severe.

logger.log(Level.INFO, "Read book with id {0}", id);

Los niveles de almacenamiento de registros, que a menudo se establecen a partir de archivos de propiedades, también se pueden establecer y cambiar en app.yaml:

env_variables:    # Logging options
  JAVA_OPTS: >-
    -D.level=INFO

Información sobre la configuración del almacenamiento de registros

Cuando la aplicación de muestra se ejecuta en el entorno flexible de App Engine, Cloud Logging recopila automáticamente todo lo que se registra en stderr y stdout, y los coloca a disposición para que se puedan ver, buscar y exportar en el visualizador de registros de la consola de GCP.

En esta muestra, todos los registros se escriben en stderr/stdout.

Limpiar los recursos

Para evitar que los recursos utilizados en este tutorial se cobren en tu cuenta de Google Cloud Platform, sigue estas instrucciones:

Eliminar el proyecto

La forma más fácil de eliminar la facturación es eliminar el proyecto que has creado para el tutorial.

Para eliminar el proyecto, sigue las instrucciones a continuación:

  1. En la GCP Console, dirígete a la página Proyectos.

    Ir a la página Proyectos

  2. En la lista de proyectos, selecciona el proyecto que deseas borrar y haz clic en Borrar.
  3. En el cuadro de diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrar el proyecto.

Eliminar versiones no predeterminadas de la aplicación

Si no quieres eliminar el proyecto, puedes reducir los costes mediante la eliminación de versiones no predeterminadas de la aplicación.

Para eliminar una versión de la aplicación, sigue las instrucciones a continuación:

  1. En GCP Console, dirígete a la página Versiones de App Engine.

    Ir a la página de Versiones

  2. Haz clic en la casilla de verificación junto a la versión de app no predeterminada que deseas borrar.
  3. Haz clic en el botón Borrar en la parte superior de la página para borrar la versión de la app.

Eliminar el segmento de Cloud Storage

Para eliminar un segmento de Cloud Storage, sigue las instrucciones a continuación:

  1. En la GCP Console, dirígete al navegador de Cloud Storage.

    Ir al navegador de Cloud Storage

  2. Haz clic en la casilla de verificación junto al depósito que deseas borrar.
  3. Haz clic en el botón Borrar en la parte superior del depósito.

Siguientes pasos

Obtén información sobre cómo ejecutar la muestra de Bookshelf para Java en Compute Engine.

Obtén información sobre el uso de Java en el entorno estándar de App Engine.

Prueba otras funciones de Google Cloud Platform por tu cuenta. Echa un vistazo a nuestros tutoriales.

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