En la décima clase del curso de Google Apps Script vamos a aprender a supervisar procesos programados con logs y alertas.
Una automatización aporta valor cuando sigue funcionando sin supervisión constante, pero necesitamos saber qué procesó y cómo reaccionó ante un fallo. Cerraremos el curso con un sistema que programa tareas, evita ejecuciones simultáneas y conserva evidencias útiles.
Programaremos el proceso, provocaremos un fallo controlado y revisaremos el registro y las alertas. ¡Cerramos el círculo!
Esta clase está incluida en la suscripción a todos los cursos.
Aquí reunimos muchas piezas del curso en un sistema preparado para operar. La función de preparación crea o reutiliza la hoja, añade tres tareas de demostración y guarda el identificador y el correo de alertas en propiedades del script. La función principal genera un ID para relacionar todas las evidencias, distingue si el origen fue manual o temporal y solicita un bloqueo. Si otra instancia ya está trabajando, registra la omisión en lugar de permitir que ambas modifiquen las mismas filas.
Cada tarea pendiente pasa a completada una sola vez y conserva número de intentos, última ejecución y detalle. La pestaña Registro añade inicio, ID, origen, estado, cantidad procesada, duración y mensaje. Al mismo tiempo, Logger y la consola producen entradas estructuradas que podemos desplegar desde Ejecuciones. La tabla es el historial funcional decidido por nosotros; la sección técnica conserva cada invocación del proyecto, su duración, su estado y los registros asociados aunque la hoja esté cerrada.
Para probar el recorrido negativo programamos una marca que falla únicamente en la siguiente ejecución y añadimos otra tarea pendiente. El activador encuentra el error, lo registra, envía un correo y vuelve a lanzar la excepción para que la plataforma marque la fila como fallida. Un minuto después la marca ya no existe, el proceso vuelve a entrar y completa el trabajo. Recuperarse no significa borrar el fallo, sino conservar su evidencia y conseguir que las siguientes ejecuciones continúen correctamente.
Como ejercicio podemos ampliar las tareas de demostración con un proceso real de nuestro negocio y aumentar el intervalo del activador a una frecuencia razonable. Podemos añadir al correo un enlace a la hoja, medir tiempos máximos o diferenciar errores recuperables. Conviene comparar Información general, Historial del proyecto, Ejecuciones del proyecto y Mis ejecuciones: cada pantalla responde a una pregunta distinta sobre configuración, cambios de código, actividad concreta o visión global de nuestra cuenta.
Si surge alguna duda al crear el activador, interpretar los registros, relacionar un ID o comprobar la recuperación después de una alerta, podemos contar con el equipo de soporte que está al otro lado de la intranet.