CH04 · 정리 & 표준화

4-2. 에러 트리거 일괄 등록 — 모든 워크플로우에 안전망 씌우기

워크플로우 이름을 정리했으니, 이번에는 눈에 보이지 않는 곳을 표준화합니다. 바로 에러 처리입니다. 워크플로우가 조용히 실패하고 있는데 아무도 모른다면, 그것이 가장 위험한 상황입니다.


1. 조용한 실패 — 가장 위험한 자동화

자동화의 핵심 가치는 "사람이 신경 쓰지 않아도 알아서 돌아간다"입니다. 반대로 말하면, 사람이 신경을 안 쓰기 때문에 실패해도 모르는 상황이 생깁니다.

매일 아침 구글 시트 데이터를 슬랙으로 보내는 워크플로우가 있다고 가정합니다. 어느 날 구글 시트 API 권한이 만료되면서 워크플로우가 실패합니다. 슬랙 메시지가 오지 않는다는 사실을 누군가 알아챌 때까지 며칠이 걸릴 수 있습니다.

워크플로우가 5개라면 수동으로 확인할 수 있습니다. 50개, 100개라면 매일 아침 Executions 탭을 열어 하나하나 확인하는 것은 불가능합니다.


2. n8n의 에러 처리 시스템 — Error Workflow

n8n에는 이 문제를 해결하는 내장 기능이 있습니다. 바로 Error Workflow 입니다.

각 워크플로우의 settings 안에 errorWorkflow 필드가 있습니다. 여기에 에러 처리 전용 워크플로우의 ID를 등록해 두면, 해당 워크플로우가 실패할 때마다 n8n이 자동으로 그 에러 처리 워크플로우를 실행합니다.

에러 처리 워크플로우 안에서는 슬랙 알림, 이메일 발송, DB 로그 저장 등 원하는 후속 조치를 자유롭게 구성할 수 있습니다.


3. 마스터 에러 워크플로우 개념

마스터 에러 워크플로우는 모든 워크플로우의 에러를 한 곳에서 수집하는 중앙 집중형 에러 처리 워크플로우입니다.

구조는 다음과 같습니다.

STEP 1

Error Trigger 노드: 에러 발생 시 자동 실행되는 시작점

STEP 2

Set 노드: 에러 메시지, 실패한 워크플로우 이름, 실패 시각을 정리

STEP 3

Slack 노드: 정리된 에러 정보를 담당자 채널로 알림 발송

이 마스터 에러 워크플로우 하나만 만들어 두면, 나머지 모든 워크플로우의 settings.errorWorkflow에 이 ID만 넣으면 됩니다. 어떤 워크플로우가 실패하든 알림이 한 곳으로 모입니다.

일반 워크플로우 N개실패 발생
errorWorkflow 트리거
마스터 에러 워크플로우Error Trigger → Set → Slack

4. 문제는 "등록하는 과정"

마스터 에러 워크플로우를 만드는 것은 한 번이면 끝납니다. 하지만 기존 50개 워크플로우에 이 에러 워크플로우를 하나씩 등록하려면, 웹 에디터에서 워크플로우를 열고 → Settings 탭으로 이동하고 → Error Workflow를 선택하고 → 저장하는 작업을 50번 반복해야 합니다.

이 반복 작업을 Claude에게 맡기면 명령 한 줄로 끝납니다.


5. 실습 — "모든 워크플로우에 에러 트리거를 등록해줘"

Claude Code를 띄우고 다음 프롬프트를 입력합니다.

모든 워크플로우에 에러 트리거를 등록해줘.
마스터 에러 워크플로우 ID는 "abc123"이야.
이미 등록된 건 건너뛰고, 없는 것만 등록해줘.

Claude는 다음 순서로 작업합니다.

STEP 1

n8n_list_workflows 로 전체 워크플로우 ID 목록을 확인합니다.

STEP 2

각 워크플로우에 대해 n8n_get_workflow 를 호출해 settings를 조회하고, errorWorkflow 값이 이미 있는지 확인합니다.

STEP 3

errorWorkflow가 설정되지 않은 워크플로우를 등록 대상으로 추려냅니다.

조사 결과:
- 전체 워크플로우: 15개
- 에러 워크플로우 이미 등록: 4개 (건너뜀)
- 에러 워크플로우 미등록: 11개 (등록 대상)

등록 대상 목록:
1. [마케팅] 리드 수집 알림 (Webhook)
2. [개발] GitHub PR 알림 (Webhook)
3. [영업] 일일 매출 리포트 (Schedule)
...

11개 워크플로우에 에러 워크플로우를 등록할까요?

6. 일괄 등록 실행과 결과 확인

확인을 하면 Claude가 n8n_update_partial_workflow 도구로 각 워크플로우의 settings에 errorWorkflow 값을 추가합니다.

핵심. 부분 업데이트(Partial Update)이므로 노드나 연결선은 건드리지 않고, settings 객체의 errorWorkflow 필드만 추가합니다.

[1/11] [마케팅] 리드 수집 알림 - errorWorkflow 등록 완료
[2/11] [개발] GitHub PR 알림 - errorWorkflow 등록 완료
...
[11/11] 등록 완료.

결과 리포트:
- 성공: 11개
- 실패: 0개
- 건너뜀 (이미 등록): 4개
- 전체 워크플로우 중 에러 워크플로우 등록률: 15/15 (100%)

이제 어떤 워크플로우가 실패해도 마스터 에러 워크플로우가 자동 실행되어 담당자에게 알림이 갑니다. 실패를 모르고 넘어가는 일이 사라집니다.


7. 마무리

마스터 에러 워크플로우 하나 만들어두고, Claude에게 "전부 등록해줘"라고 말하면 끝납니다. 웹 에디터에서 50번 클릭할 작업이 프롬프트 한 줄로 해결됩니다.

다음 클립에서는 워크플로우를 분류하고 정리하는 방법을 다룹니다. 활성/비활성 상태를 점검하고, 더 이상 사용하지 않는 워크플로우를 찾아내는 실습을 진행합니다.

다음 클립
4-3. 워크플로우 분류 & 정리 — 태그, 폴더, 비활성 감지
이어보기 →