앱스 스크립트 트리거가 늦는 이유: 실행 시간과 한도 확인법

왜 늦을까?

매일 아침 자동으로 도는 스크립트, 정해 둔 시각에 소식이 없으면 어디부터 봐야 할까요?

앱스 스크립트의 시간 기반 트리거는 정각 실행을 보장하지 않습니다. 시간 설정과 실행 기록, 트리거를 만든 계정부터 나눠 확인해 보세요.

본문의 세 사진은 시간 확인과 코드 작업을 보여 주는 예시 자료사진이며, 실제 Apps Script 화면은 아닙니다.

시간을 표시하는 모니터 예시 사진

시트 정리나 알림처럼 자동화가 편리한 만큼, 작동하지 않는 이유도 한 가지로 단정하기 어렵습니다. 아래 내용은 2026년 11월 17일 확인한 구글 공식 문서를 바탕으로 정리했습니다.

오전 9시 설정,
정각은 아닙니다

구글은 매일 오전 9시 트리거를 만들면 오전 9시부터 10시 사이의 시각을 선택할 수 있다고 설명합니다. 이후 매일 약 24시간 간격을 유지한다는 예시입니다.

코드의 nearMinute로 분을 지정해도 해당 분 전후 15분 범위로 설명돼 있습니다. 따라서 정확히 9시 00분 00초가 필요한 작업에는 정각 보장 장치로 생각하면 안 됩니다.

프로젝트 시간대와 트리거 설정도 함께 확인하세요. 스크립트에 지정된 시간대와 기대하는 지역 시간이 다르면 생각한 시간과 다르게 보일 수 있습니다. 코드에서 별도로 시간대를 지정했는지도 살펴보면 좋겠습니다.

시작 시각은 트리거가 일을 시작한 때이고 소요시간은 끝날 때까지 걸린 시간입니다. 늦게 시작한 것과 오래 실행된 것은 다른 문제입니다.

실행된 건지,
실패한 건지

앱스 스크립트 편집기 왼쪽의 실행 기록을 열어 해당 시각의 실행과 오류 메시지를 확인해 보세요. 실행 자체가 보이지 않는 경우와 실행은 됐지만 오류로 끝난 경우는 점검 방향이 다릅니다.

코드와 디버깅 도구 예시 사진

실행 기록에서 시작 시각과 상태를 먼저 나눠 보세요. 아래는 원인을 단정하지 않고 다음 확인 지점을 찾기 위한 점검표입니다.

상황먼저 확인할 것
늦게 시작시작 시각, 시간대와 트리거 설정
실행 기록 없음대상 시간과 생성 계정의 트리거·권한
실행 후 오류실패 상태와 오류 메시지·할당량
중복 발송각 계정의 트리거, 재실행과 발송 기록

설치형 트리거는 파일을 연 사람이 아니라 트리거를 만든 계정의 권한으로 실행됩니다. 공유 프로젝트라면 어떤 계정이 만들었고 그 계정에 필요한 권한이 남아 있는지 확인해야 합니다.

다른 계정이 만든 트리거는 현재 계정에서 보이지 않을 수 있습니다. 목록이 비어 보인다고 곧바로 중복 등록하기보다 생성 계정을 확인하는 편이 안전하죠. 설치형 트리거 오류에는 구글이 실패 요약 메일을 보내지만, 부가기능의 설치형 트리거는 예외라고 안내합니다.

자주 돌릴수록
한도도 살펴요

코드와 성능 그래프 예시 사진

구글의 현재 할당량 표에는 개인 계정의 트리거 총 실행 시간이 하루 90분, 스크립트 한 번의 실행 제한이 6분으로 안내돼 있습니다. Workspace 계정의 하루 트리거 총 실행 시간은 6시간입니다. 한도는 변경될 수 있습니다.

가정 계산으로 5분마다 실행되고 한 번에 20초가 걸리면 하루 288회, 합계 96분입니다. 같은 시간이 걸리는 작업을 10분마다 실행하면 144회, 합계 48분이 됩니다. 두 값은 실제 구글 실행 측정이 아니라 24시간 빠짐없이 실행된다고 가정한 단순 산술입니다.

실제 사용량은 매 실행 시간과 다른 작업에 따라 달라집니다. 첫 요청부터 24시간이 지나 할당량이 초기화된다는 공식 설명도 확인하세요. 간격을 늘려도 기한에 문제가 없는지, 같은 계정의 다른 자동화가 있는지도 함께 살펴야 합니다.

중복 발송이 걱정된다면 동시 실행을 막는 잠금과 완료 기록을 구분하세요. LockService는 보호 구간이 동시에 실행되는 충돌을 막지만, 이후 재실행의 중복까지 기억하지는 않습니다.

작업별 고유 키와 완료 기록을 확인하는 설계가 도움이 됩니다. 다만 발송 직후 기록 전에 실패하면 재시도 시 중복될 수 있어 잠금과 기록만으로 정확히 한 번 발송을 보장하지는 않습니다. 테스트 데이터와 별도 확인 절차를 권합니다.

워니워닝의 마지막 코멘트

시간 오차, 실행 실패, 계정 권한, 할당량은 각각 따로 확인해야 합니다. 먼저 실행 기록을 보고 트리거를 추가할지 결정하면 원인을 더 좁힐 수 있습니다.

자동화의 편리함은 실행 결과를 확인할 방법까지 준비했을 때 더 오래 갑니다. 정각이 중요한 일은 해당 도구의 보장 범위와 별도 모니터링 방법을 확인해 주세요.

참고 자료: Google 설치형 트리거 · Google 서비스 할당량 · 시간 트리거 설정 · LockService

#앱스스크립트 #트리거

목록으로

이 블로그 검색

Copyright © The ISSUEFEED. All rights reserved.
새 글 소식을 RSS로 받아보세요 AI 활용법, 비개발자의 앱 개발기, 직장인 투자일기를 꾸준히 기록합니다.
RSS로 구독하기