Guía: Cómo consultar los logs de la aplicación

Para consultar los logs hay dos opciones que se detallan a continuación.

Opción A: Ingresar a la consola web de AWS y consultar el detalle de razones

Esta opción dará links para abrir la consola web de AWS y poder consultar el detalle de cada contenedor fácilmente.

1. Ejecutar el comando de hosting aws_console. Este comando indicará un URL especial para autentificarse y otros para abrir el detalle del estado de tareas y contenedores.
   
   

   hosting/hosting aws_web_console

2. Se mostrarán  en la terminal los siguientes links:

   1. Link que proveerá autentificación automática en AWS con las credenciales de tu proyecto
   2. Link para ver el detalle de tareas y contenedores en ejecución y todos los logs relaciones (tanto para producción como staging)
   3. Link directo para los logs de cada proyecto (tanto para producción como staging)
3. Abre el link #1 para autentificarte.
   
   
4. Después abre el link #2 (el de producción o staging según necesites) y se abrirá una pantalla que tiene las tareas ejecutándose. Usualmente debe haber una sola tarea en ejecución pero si hay tareas que se estén reintentando, habrá otras que indican "Stopped" como status:
   
5. Si hacs click sobre "Stopped" te indicará el motivo del fallo del arranque:

   
   
   

6. Para profundizar, haz click en el link de task (en este ejemplo "6d8e2e41bc45416cb28e1ab1f06f3b2b..."):
   
   
   
7. Se abrirá el detalle de todos los contenedores y cada uno con su estado:
8. Si hay uno que diga "Exit code: X" en el estado quiere decir que terminó abnormalmente. 
   
   Selecciona:
   
   
   
   
   
   1. El tab de Logs (#1 en screenshot)
      
      
   2. El contenedor (#2 en screenshot)
      
      
   3. El rango de tiempo (#3 en screenshot)
      
      
   4. Ve el detalle de errores (#4 en screenshot):
      
      
      

Opción B: Streaming en tiempo real (costo adicional)

Este camino permite hacer streaming de los logs en tiempo casi-real conforme se van generando. Esto es útil cuando se están monitoreando logs de la aplicación en vivo para diagnosticar algún problema. 

La desventaja de este acercamiento es que tiene costo por minuto ($0.01 USD/minuto, así que una hora sale a $0.6 USD), así que conviene usarlo únicamente cuando aporte un beneficio real y no dejarlo corriendo cuando no se utilice.

Para usarlo ejecutar el comando de hosting aws_logs indicando el ambiente. Por ejemplo:

hosting/hosting aws_stream_logs production

Esto te mostrará una pantalla donde irán apareciendo los logs conforme se creen y desde allí mismo tienes controles como resaltar búsquedas, formatear JSON y scrolling. Sales de esta vista con ESCAPE o CONTROL-C: