시트 변경 감지, 폴링으로 짜면 놓치고 두 번 돕니다

Pipedeck 실제 화면

작성자

카테고리:

변경 감지, 폴링으로 짰다가 놓치고 두 번 돌았던 이야기

구글 시트에 값이 바뀌면 자동으로 뭔가 일어나게 만들고 싶은 순간은 늘 온다. 나는 주문 접수 시트가 바뀌면 슬랙으로 알림이 오고, 상태가 “완료”로 바뀌면 다음 처리가 돌아가는 흐름을 짜고 싶었다. 구글 시트 변경 감지 자동화 세팅하는 법을 검색하면 대부분 트리거 종류 소개에서 끝난다. 정작 내가 당한 건 세팅이 아니라 세팅한 다음이었다.

폴링 간격 사이에 사라진 수정 한 건

처음엔 서버에서 5분 폴링으로 시트를 읽어오는 방식을 썼다. 잘 돌았다. 그러다 어느 날 로그를 열어보니 처리 기록이 한 건 비어 있었다. 같은 셀에 값을 넣었다가 1분 만에 다른 값으로 고쳐진 경우였다. 폴링 사이에 수정이 거듭되면 나중 값만 보이고 이전 값은 보이지 않는다. 고객이 먼저 알려줬으면 하는 그런 상황이었는데, 다행히 실측 데이터를 매일 확인하는 습관이 있어서 로그에서 먼저 발견했다.

그 다음엔 반대로 onEdit 트리거로 갈아탔다가 이번엔 한 건이 두 번 처리됐다. 놓치느냐, 두 번 돌느냐. 이 글은 그 두 삽질을 정리한 세팅 순서다.

변경 감지 3가지 방식, 어떤 게 안전한가

변경 감지란 시트의 값이 바뀐 사실을 시스템이 스스로 알아채고 등록된 처리를 실행하는 구조를 말한다. 감지 방식은 크게 이벤트 방식과 폴링 방식으로 나뉜다.

onEdit 단순 트리거 vs 설치형 트리거

단순 트리거는 스크립트에 onEdit(e) 함수를 선언만 하면 돌아간다. 세팅이 제일 간단한 대신 제약이 많다. 외부 API 호출이 막히는 경우가 있고, 내가 겪은 이중 실행도 여기서 시작됐다. 설치형 트리거는 편집 이벤트뿐 아니라 값 변경(change), 시트 수정(form submit)까지 붙일 수 있고 권한 승인을 거치므로 할 수 있는 일이 더 많다. 요즘은 무조건 설치형으로 시작한다.

시간 트리거 폴링: 느리지만 놓침이 적은 이유

폴링은 주기적으로 시트 전체를 읽어서 이전 상태와 비교한다. 느린 건 맞는데, 읽는 시점의 최종 값을 기준으로 비교하므로 “중간에 뭘 지나갔는지”가 궁금하지 않은 작업이라면 오히려 흔들리지 않는다. 상태가 “대기”에서 “완료”로 바뀌었는지만 보면 되는 파이프라인엔 이 방식이 맞았다.

외부 API 폴링: 서버에서 돌릴 때만 쓰는 이유

원클립AI 쪽 서비스를 돌리면서 Apps Script를 벗어나 서버에서 Sheets API로 읽는 구조로 넘어간 적이 있다. 판단 기준은 단순했다. 처리 로직이 이미 서버 코드에 있는데 시트 감지만 스크립트에 두면 장애 지점이 둘로 늘어난다. 감지와 처리를 한곳에 두느냐가 기준이지 성능이 아니었다.

방식 놓침 위험 중복 위험 비용
onEdit 단순 트리거 동시 편집 병합 시 있음 있음 무료
설치형 트리거 있음 있음, 제어 가능 무료
시간 트리거 폴링 폴링 간격 사이 변경은 최종값만 봄 거의 없음 실행 할당량 소모
외부 API 폴링 위와 같음 거의 없음 API 읽기 호출수 소모

왜 두 번 실행되거나 아예 안 잡히는가

두 번 실행의 원인: 이벤트 중복 발화와 재시도

onEdit는 사람이 생각하는 “수정 한 번”과 다르게 발화한다. 셀에 타이핑하는 동안 편집 이벤트가 여러 번 잡히는 경우가 있고, 동시에 여러 사용자가 입력하면 이벤트가 병합되거나 쪼개져서 전달된다. 여기에 실행 실패 후 재시도가 겹치면 같은 처리가 두 번 돈다. 나는 알림이 두 번 오는 걸 보고 나서야 알았다.

놓침의 원인: 폴링 간격과 동시 편집 병합

폴링 놓침은 구조적이다. 읽는 사이 값이 거듭 바뀌면 중간 값은 그냥 없던 게 된다. 반대로 이벤트 방식의 놓침은 이벤트 자체가 유실되거나 병합되는 데서 온다. 둘의 원인이 다르니 대책도 다르다. 폴링은 “최종값 기준으로 멱등하게”, 이벤트는 “중복 발화를 걸러내게” 짜야 한다.

멱등성 처리: 마지막 처리값·체크섬·LockService

내가 정착한 구조는 세 가지다. 마지막 처리값을 시트 어딘가에 남기고, 행 전체의 체크섬을 비교하고, 처리 시작 시 락을 건다.

function onChangeCheck(e) {
  const lock = LockService.getScriptLock();
  if (!lock.tryLock(1000)) return; // 이미 돌고 있으면 건너뜀
  try {
    const sh = e.source.getActiveSheet();
    const row = sh.getActiveRange().getRow();
    const vals = sh.getRange(row, 1, 1, 5).getValues().join("|");
    const key = "row_" + row;
    const last = PropertiesService.getScriptProperties().getProperty(key);
    if (last === vals) return; // 이전 처리값과 같으면 중복 실행
    PropertiesService.getScriptProperties().setProperty(key, vals);
    doProcess(row, vals); // 실제 처리
  } finally {
    lock.releaseLock();
  }
}

체크섬을 저장하는 시점을 처리 “전”에 둘지 “후”에 둘지는 취향 문제가 아니다. 전에 두면 처리가 실패해도 재시도를 안 하고, 후에 두면 실패 시 같은 행이 다시 잡힌다. 나는 실패 재시도를 원해서 후에 두는 편이다.

Pipedeck 실제 화면

여러 명이 동시에 수정하는 시트, 놓침 없이 감지하는 법

편집 권한 구조부터 점검하기

동시 수정 문제의 절반은 권한 구조에서 온다. 편집자 전원이 아무 셀이나 고칠 수 있는 시트에서는 감지 코드가 아무리 좋아도 원본이 흔들린다. 입력받는 열과 상태 관리하는 열을 분리하고, 상태 열은 스크립트만 바꾸게 해 두었다.

예약 발화·지연 처리로 순서 보장하기

이벤트가 잡히자마자 처리하지 말고 몇 초 뒤에 돌리는 식으로 미뤄서 연속 편집을 하나로 모으는 방식도 쓴다. 구현은 간단하게, 처리 대상 행을 임시 시트에 쌓아 두고 시간 트리거가 주기적으로 비우는 구조다. 이벤트 즉시성은 포기하는 대신 중복이 확 줄었다.

동시 입력 테스트 시나리오 재현법

운영 중 실제로 쓰는 테스트 절차다. 시크릿 탭 2개로 같은 시트를 열고, 두 계정(구글 계정 하나 더 만들면 된다)이 같은 행의 다른 셀을 동시에 고친다. 그다음 로그 시트를 열어 감지 기록과 실제 편집 이력을 한 줄씩 대조한다. 이 테스트로 이벤트 병합으로 인한 놓침을 재현해서, 재현이 안 되면 세팅을 믿는 게 아니라 테스트를 더 해 본다.

Pipedeck 실제 화면

세팅 순서와 테스트, 이렇게 짰다

1~6단계 세팅 순서

  1. 로그 시트부터 만든다. 감지 시각, 행, 값, 체크섬을 남긴다.
  2. 감지 함수를 짠다. 이 단계에선 처리 없이 로그만 쌓는다.
  3. 설치형 트리거를 붙인다. 편집 이벤트로 시작한다.
  4. 위의 멱등성 코드(락 + 체크섬)를 넣는다.
  5. 동시 입력 테스트를 시크릿 탭 2개로 돌린다.
  6. 통과하면 알림 연결(슬랙 webhook 등)하고 처리 로직을 붙인다.

테스트 체크리스트와 통과 기준

  • 같은 셀 두 번 편집 시 로그 1줄 추가, 처리 1회
  • 두 사용자 동시 편집 시 두 변경 모두 로그에 존재
  • 트리거 수동 실행 시 이전 처리 재실행 안 함
  • 실패 시뮬레이션(처리 함수에 임의 에러) 후 재시도 동작 확인

운영 시작 후 1주일 확인 습관

세팅하고 끝이 아니다. 무인으로 돌리는 서비스가 있는 나는 주 1회 로그 시트를 열어서 감지 건수와 처리 건수가 같은지 세어 본다. 숫자가 안 맞으면 원인을 그 주에 찾는다. 서버 크론을 70개 넘게 돌리는 입장에서 이 점검 루틴은 안 빼먹는 편이다.

Pipedeck 실제 화면

무료로 쓸 때 한계, 어디서 터지는가

Apps Script 실행 할당량과 트리거 개수 제한

무료 계정은 트리거를 계정당 90개까지 만들 수 있다. 스크립트 하나에 트리거 여러 개가 가능하니 세팅하다 보면 은근히 찬다. 실행 시간 할당량도 있어서 폴링을 짧게 돌리면 거기부터 먼저 닿는다.

Sheets API 읽기 호출수와 폴링 비용 계산

외부 폴링은 읽기 호출수를 잡아먹는다. 폴링 주기를 반으로 줄이면 호출수는 두 배다. 감지 지연을 1분 단위로 줄이고 싶어질 때마다 나는 호출수 계산부터 다시 한다. 시트 한 번 읽을 때 필요한 호출이 몇 건인지 실측해 보고 주기를 정했다.

한계에 닿았을 때의 증상과 대안

내가 본 증상은 트리거가 조용히 안 돌거나, 실행 실패 이메일이 쌓이는 식이었다. 에러 메시지가 명확하게 “한도 초과”라고 오지 않아서 원인 찾는 데 애먹었다. 대안은 단순하다. 시트를 여러 개로 쪼개지 말고 감지 스크립트를 하나로 합쳐서 트리거 수를 줄이고, 폴링 주기를 늘린다. 이 구조가 부담스러워지면 그때 서버 폴링으로 넘어가면 된다. 반대로 이 방법을 쓰지 말아야 할 때도 있다. 초 단위 반응이 필요하거나 하루에 수백 회 폴링해야 하는 용도라면 무료 구간이 아니라 애초에 설계를 다르게 해야 한다.

정리: 오늘 세팅하고 나서 할 일 3가지

상황별 한 줄 답부터. 나 혼자 쓰는 시트면 설치형 편집 트리거, 여럿이 동시에 고치면 시간 트리거 폴링 + 체크섬, 처리 로직이 서버에 있으면 서버 폴링. 이 순서로 고르면 크게 틀리지 않는다.

오늘 할 일은 이렇다. 첫째, 로그 시트를 만들고 감지만 쌓는 함수를 돌려 본다. 둘째, 시크릿 탭 2개로 동시 편집 테스트를 한 번 돌린다. 셋째, 주간 점검 일정을 캘린더에 넣는다.

필요한 질문 다섯 개만 남긴다.

  • 중복 실행은 왜 생기나? 이벤트 중복 발화와 재시도가 겹쳐서다.
  • 놓침은 왜 생기나? 폴링 간격 사이 변경이 덮어쓰이거나 이벤트가 병합돼서다.
  • 가장 간단한 방지법은? 체크섬 비교와 LockService다.
  • 동시 편집 테스트는? 시크릿 탭 2개로 같은 행을 고치고 로그를 대조한다.
  • 무료 한계는 어디서 터지나? 트리거 90개와 실행 할당량, API 읽기 호출수다.

다음 글에서는 감지 이후에 붙이는 알림·처리 파이프라인 쪽을 다룰 예정이다. 실패한 세팅도 포함해서 그대로 적는다. 내가 굴리는 서비스와 자동화 기록은 wallenstein.dev에 있다.


글쓴이 정보

1인 빌더 아일리고가 씁니다. 잘된 것도 망한 것도 적습니다. 영상은 제가 만든 ClipSquare 에서 나옵니다.

자주 나오는 질문

구글 시트 변경 감지는 onEdit 트리거와 폴링 중 뭐가 안전한가요?

정답은 하나로 정할 수 없고 놓침과 중복 중 어느 쪽이 더 치명적인지로 고릅니다. 최종값만 보면 되는 파이프라인이면 시간 트리거 폴링이, 입력 즉시 반응해야 하면 설치형 트리거에 중복 방지 처리를 얹는 게 낫습니다. 단순 onEdit보다는 권한 승인을 거치는 설치형 트리거로 시작하세요.

구글 시트 자동화가 두 번 실행되는 이유는 뭔가요?

onEdit 이벤트가 사람이 생각하는 ‘수정 한 번’과 다르게 발화하기 때문입니다. 타이핑 중 편집 이벤트가 여러 번 잡히거나 동시 편집에서 이벤트가 병합·분할되고, 여기에 실패 후 재시도까지 겹치면 같은 처리가 두 번 돕니다. 마지막 처리값 비교와 LockService 락으로 걸러낼 수 있습니다.

폴링 방식으로 구글 시트를 감지하면 수정을 놓칠 수 있나요?

놓칩니다. 폴링 사이에 같은 셀이 거듭 수정되면 최종값만 보이고 중간 값은 기록에서 사라집니다. 중간값이 필요한 작업이면 이벤트 방식을 쓰고, 최종값 기준으로 멱등하게 처리하도록 짜야 합니다.