자동화 로그 없으면 고장 원인 못 찾습니다

로그 없이 고장 원인 못 찾는 상황 일러스트

작성자

카테고리:

로그 없이 고장 나면 무슨 일이 벌어지나

지금 서버에 크론이 70개, 노트북에 9개 돌고 있다. 그중 하나가 어느 날부터 조용히 죽었다. 알림도 없고 에러도 안 남고, 그냥 결과물이 안 나오는 상태로 사흘을 보냈다. 나중에 알고 보니 외부 API 응답 형식이 바뀐 거였는데, 실행 기록이 남는 쪽 도구는 7일 지나면 히스토리가 지워지는 플랜이었다. 원인을 확인하려던 시점엔 이미 흔적이 없었다.

‘어제까진 됐는데’의 공포

자동화 고장에서 제일 무서운 건 에러 메시지가 아니라 아무것도 안 뜨는 거다. 코드를 고친 적도 없고, 설정을 만진 적도 없는데 결과만 사라졌다. 이 상태에서 스스로에게 던지는 질문은 늘 같다. “뭐가 바뀌었지?” 그런데 답을 줄 기록이 없다.

실행 히스토리가 7일만 남는다는 함정

Zapier나 Make 같은 노코드 도구는 실행 기록을 남겨주는데, 무료·하위 플랜은 보관 기간이 짧다. 보통 일주일에서 2주 정도면 지워진다. 고장을 하루이틀 안에 알아차리면 몰라도, 무인으로 돌리는 크론은 며칠씩 방치되기 쉽다. 기록이 지워진 뒤에 뒤지면 그때부터는 추측의 영역이다.

원인 추적에 3일 날린 이야기

그 사건 때는 결국 원인 후보를 하나씩 수동으로 돌려보면서 좁혔다. 로그만 있었으면 첫 실행 실패 시각과 에러 문구 한 줄로 끝날 일이었다. 그 다음 날, 돌아가는 자동화에 전부 로그를 달기 시작했다.

무엇을, 어디에, 얼마나 남기면 되나

로그는 6항목이면 충분하다

개발자식 로깅을 따라 하다가 포기하는 사람을 많이 봤다. 나도 처음엔 요청 본문 전체를 다 남기려다가 관리가 안 돼서 접었다. 지금은 이 6개만 남긴다.

  • 실행 시각
  • 성공 여부 (성공/실패)
  • 트리거 이름 (어떤 자동화인지)
  • 입력값 요약 (앞 50자 정도)
  • 에러 메시지 원문
  • 소요 시간

자동화 실행 로그는 원인 추적용 흔적이지 감사용 데이터가 아니기 때문에, 실패 시점과 에러 문구를 알 수 있는 최소 항목만 남기면 복구 목적으론 부족하지 않다.

저장 위치 3종: 시트 vs 도구 히스토리 vs 별도 저장소

나는 구글 시트로 시작했다. 도구 히스토리는 플랜에 종속되니까 도구를 바꾸거나 플랜을 내리면 함께 사라진다. 시트는 내 계정에 남으니 플랜과 상관없다. 다만 시트도 그대로 두면 안 된다. 실제로 만 행 단위로 쌓이니까 시트가 눈에 띄게 느려졌고, 그때 로그 시트를 자동화별로 분리하고 성공 로그는 자동 삭제하도록 정리했다. 서버에서 돌리는 크론은 파일로 떨어뜨린다.

성공 로그와 실패 로그는 보관 기간을 다르게

성공 기록은 사실 최근 것만 있으면 된다. 나는 성공 로그는 짧게, 실패 로그는 오래 남기는 기준으로 삼았다. 실패 쪽이 문제의 역사라서 오래 보관할 가치가 있고, 성공 쪽은 ‘마지막으로 언제 됐나’만 확인하면 되니까 짧아도 된다.

노코드 도구를 쓸 때도 로그를 따로 남겨야 하나

왜 기본 실행 히스토리만으로 부족한가

앞서 말한 보관 기간 문제에 더해서, 유료 플랜을 내리는 순간 과거 기록 조회 자체가 막히는 경우가 있다. 도구 안에만 기록이 있으면 도구와 함께 사라진다.

Zapier·Make에서 3분 만에 로그 남기는 법

방법은 하나다. 마지막 스텝에 ‘구글 시트에 행 추가’를 붙인다. 컬럼 순서는 이렇게.

실행시각 | 결과 | 자동화이름 | 입력요약 | 에러메시지 | 소요시간(초)

성공 라우트와 실패 라우트 각각에 이 스텝을 달아두면 실패만 별도 시트로 모이게 만들 수도 있다. 에러 핸들링 기능을 켜면 실패 시에도 다음 스텝이 실행되니까, 그 브랜치에 로그 스텝을 넣으면 된다.

노코드 전용 주의사항: 민감값 마스킹

실수했던 게 있다. 입력요약에 고객 이메일과 전화번호가 그대로 찍히게 둔 적이 있다. 로그 시트는 권한 관리가 헐거워지기 쉬워서, 개인정보가 통째로 쌓이는 구조는 위험하다. 그때부터 이메일은 앞부분만, 전화번호는 뒷자리만 남기고 나머지는 별표로 바꿔서 저장한다.

로그에 무엇을 얼마나 남길지 정리하는 모습

로그가 쌓이면 생기는 비용·용량 문제와 정리 루틴

시트 로그 만 행이 넘을 때 벌어지는 일

행 수가 커지면 시트가 느려진다. 열 때 오래 걸리고 필터도 버벅거린다. 나는 자동화별로 시트를 나누고, 성공 로그는 오래된 행을 지우는 정리 자동화를 하나 더 달아놨다. 로그를 관리하는 자동화도 필요해지는 시점이 온다는 걸 처음엔 몰랐다.

로그 로테이션: 매주 10분 정리 루틴

캘린더에 매주 월요일 아침 10분짜리 반복 일정을 넣어뒀다. 하는 일은 단순하다. 실패 로그 시트 열어서 새로 쌓인 실패가 있는지 보고, 있으면 그 주 안에 원인 처리하고 메모 한 줄 달아둔다. 10분 루틴이 없으면 실패 로그는 쌓이기만 하는 무덤이 된다.

남기면 안 되는 것들

  • 개인정보 원문 (이름, 전화번호, 이메일 전체, 주소)
  • API 키, 토큰, 비밀번호가 포함된 요청 원문
  • 수 메가짜리 페이로드 전체 (요약만 남긴다)
노코드 자동화에 로그 따로 남기기 개념

실패했을 때 로그로 원인 찾는 5분 순서

1분: 마지막 성공 지점 찾기

로그 시트를 시간 역순으로 정렬한다. 마지막 성공 시각과 첫 실패 시각 사이가 사건 발생 구간이다. 대부분의 원인은 이 사이에 무언가 바뀐 것이다.

2분: 입력값·트리거 변경 확인

실패 행의 입력요약을 마지막 성공 행과 나란히 놓고 비교한다. 필드가 비어 있거나 형식이 달라진 경우가 여기서 잡힌다. 입력이 같으면 다음 단계로 간다.

나머지: 외부 API·권한 확인 후 재실행

에러메시지 원문을 그대로 검색해본다. 401이면 토큰 만기, 429면 요청 과다, 응답 파싱 에러면 외부 쪽 형식 변경일 확률이 높다. 외부 상태 페이지를 확인하고, 권한 재발급이 필요하면 갱신한 뒤 재실행한다.

순서 보는 것 판별
1분 마지막 성공 시각 사건 발생 구간 확정
2분 입력요약 비교 내 쪽 변경인지 확인
3~5분 에러 원문 + 외부 상태 외부 문제면 대기, 권한이면 갱신 후 재실행

앞서 말한 크론 사건과 같은 패턴의 장애가 이후 한 번 더 생겼는데, 이때는 로그의 첫 실패 시각과 에러 문구를 보고 외부 API 형식 변경을 바로 확인했다. 사흘 걸리던 일이 로그 열어보고 몇 분 만에 끝났다.

로그로 고장 원인 찾는 5분 순서 일러스트

한계와 예외: 로그를 남겨도 못 찾는 경우

외부 서비스 장애는 로그로도 답이 없다

로그는 내 쪽 상태만 기록한다. 외부 서비스가 죽어 있으면 실패 기록만 줄지어 쌓일 뿐, 원인은 상대 상태 페이지에서 확인해야 한다.

간헐적 실패는 재현이 먼저다

한 번은 특정 시간대에만 실패하는 크론이 있었다. 로그의 실행 시각 컬럼을 보고 나서야 실패가 특정 시간에 몰려 있다는 걸 알았다. 그 시간대 요청 과다였던 것으로 좁혔는데, 이런 건 로그가 ‘후보’를 줄 뿐 최종 확인은 재현이다. 로그는 만능이 아니라 후보 제거 도구라는 게 지금의 결론이다.

오늘 밤 하면 되는 3가지

  1. 구글 시트 하나 만들고 헤더 6항목 복사: 실행시각 | 결과 | 자동화이름 | 입력요약 | 에러메시지 | 소요시간
  2. 돌아가는 자동화 각각의 마지막에 ‘시트에 행 추가’ 스텝 붙이기. 실패 시 알림(텔레그램이든 이메일이든)도 같이 한 스텝 달기
  3. 캘린더에 주간 로그 정리 반복 일정 등록. 실패 로그만 열어보면 되니 10분이면 충분하다

나는 지금 이 방식으로 블로그 자동 파이프라인 포함 서버의 크론을 전부 관리한다. 블로그 글 한 편이 만들어져 공개되기까지 13~15분이 걸리는 그 파이프라인도 매 실행마다 6항목 로그를 남긴다. 만들어 굴리는 것들은 wallenstein.dev에 정리해뒀다. 로그 달기 전에 고장 나면 이 글의 앞부분처럼 사흘을 버리게 된다. 오늘 밤에 붙이자.


글쓴이 정보

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