이유를 찾아 대시보드를 열었을 때 나는 당황할 수밖에 없었습니다. 보통 문제가 생기면 메일로 경고가 오거나 에러율이 치솟아야 하는데, 화면에 표시된 에러 기록은 너무나도 깨끗했습니다. 조용히 멈춰버린 자동화의 정체를 파헤치며 겪은 이번 트러블슈팅 경험과 중요한 인사이트를 공유하고자 합니다.
오류율 0%라는 통계의 치명적인 함정
문제를 해결하기 위해 가장 먼저 구글 앱스 스크립트 트러블슈팅의 첫 단계인 대시보드 상태를 면밀히 분석했습니다. 놀랍게도 화면에 표시된 오류율은 완벽한 0% 상태를 유지하고 있었습니다. 만약 스크립트 내부 코드에 버그가 생겼거나 외부 API 호출이 실패했다면 분명 빨간색 에러 로그가 가득했어야 마땅했습니다.
하지만 화면에는 그 어떤 경고 표시도 없었고, 시스템은 지극히 정상적인 것처럼 나를 속이고 있었습니다. 이상한 예감이 들어 각 스크립트의 상세 실행 이력을 하나씩 대조해 보기 시작했습니다. 그리고 곧바로 결정적인 단서를 찾아낼 수 있었습니다.
바로 각 트리거의 최종 실행 시각이 이틀이 훨씬 넘는 시간 동안 단 한 번도 갱신되지 않은 채 과거에 멈춰 있었던 것입니다. 에러를 내며 멈춘 것이 아니라, 트리거 실행 자체가 완전히 스킵되어 동작하지 않은 상태였습니다. 이것이 바로 내가 겪은 GAS 트리거 정지의 조용한 실체였습니다.
원인은 IT Story 프로젝트의 권한 재승인 대기
트리거가 실행조차 되지 않은 구체적인 원인을 찾기 위해 네 개의 프로젝트 내부 설정을 샅샅이 파고들었습니다. 결국 범인은 엉뚱한 곳에서 발견되었습니다. 내가 마이그레이션 용도로 별도 관리하고 있던 'IT Story' 프로젝트가 문제의 발단이었습니다.
해당 스크립트에 들어가 보니 구글 측의 보안 정책 강화 혹은 접근 토큰 만료로 인해 스크립트 권한 재승인을 요구하는 알림이 걸려 있었습니다. 사용자의 직접적인 승인이 떨어지기 전까지는 트리거가 작동하지 않도록 완전히 잠겨 버린 상태였습니다.
더욱 재미있는 사실은 그 이후에 일어났습니다. 문제가 된 IT Story 프로젝트에 들어가 권한을 수동으로 재승인해 주자마자, 놀랍게도 아무런 조치도 취하지 않았던 나머지 3개의 블로그 자동화 트리거까지 모두 자연스럽게 복구되어 다시 정상적으로 돌기 시작했습니다. 하나의 프로젝트에 걸린 승인 대기 상태가 계정 내 전체 자동화 흐름에 예기치 못한 병목이나 영향을 주었던 모양입니다.
조용한 정지를 대비하는 자동화 모니터링 교훈
이번 삽질은 나에게 뼈아프지만 강력한 교훈을 남겨 주었습니다. 많은 개발자와 운영자들이 자동화 시스템을 구축한 뒤 대시보드의 에러 경고 메일이나 오류율 그래프 수치만 믿고 시스템이 정상 작동한다고 과신하곤 합니다. 하지만 이번처럼 스크립트 권한 재승인 문제로 트리거 자체가 스킵되는 경우에는 에러 카운트 자체가 올라가지 않아 오류율이 평온한 상태로 유지됩니다.
결국 조용한 정지를 잡아내기 위해서 우리가 진짜 주목해야 할 지표는 오류율이 아니라 바로 최종 실행 시각입니다. 시스템이 약속된 주기에 맞춰 꾸준히 발자국을 남기고 있는지 주기적으로 체크하는 프로세스가 필요합니다.
가장 완벽한 자동화는 만드는 것에서 끝나는 것이 아니라, 실패의 신호조차 보내지 못하고 죽어버리는 예외 상황까지 꼼꼼하게 모니터링하는 것임을 다시금 깨달았습니다. 혹시 여러분이 돌리고 있는 구글 앱스 스크립트도 겉으로는 평온해 보이지만 속으로는 멈춰 있지는 않은지, 지금 바로 최종 실행 시각을 점검해 보시기 바랍니다.