프로젝트 완성 : 에러 처리 & 안정화

📥 DAY 27 워크플로우 JSON 다운로드

이론5분

실습20분

미션5분

"내가 특별히 똑똑한 게 아니라, 단지 문제를 더 오래 붙잡고 있을 뿐이다."

— 알베르트 아인슈타인 (Albert Einstein, 물리학자)

🎯 오늘의 학습 목표

모든 외부 API 노드에 On Error와 Retry On Fail을 적용할 수 있다
에러 경로에 Sheets 기록 노드를 연결해 에러 로그를 자동 누적할 수 있다
워크플로우를 Active 전환 후 Execution History로 운영 상태를 모니터링할 수 있다

'AI이메일비서에러로그' 탭 생성

text

에러발생시각 | 에러발생노드 | 에러메시지 | 메일ID | 처리상태

✅ Active 전환 전 최종 점검 체크리스트

Gmail OAuth2 Credential 유효한가? (만료 여부 확인)
OpenAI API Key Credential 유효한가? (사용량 한도 여유 확인)
Slack Bot Token Credential 유효한가?
Google Sheets 탭 헤더가 올바르게 설정되어 있는가?
모든 노드 이름이 의미 있게 지정되어 있는가?
Switch 노드 Fallback 포트가 연결되어 있는가?
에러 경로가 모든 외부 API 노드에 연결되어 있는가?
Retry On Fail이 외부 API 노드에 모두 설정되어 있는가?
Error Workflow가 공용 에러 알림 워크플로우로 지정되어 있는가?
Timezone이 Asia/Seoul로 설정되어 있는가?

💡 Active 전환 후 처음 24시간은 2~3시간마다 Executions 탭을 확인하세요. 안정화 이후에는 에러 Slack 알림이 오는 경우에만 대응하면 돼요.

🛠️ 실습

STEP 1모든 외부 API 노드에 On Error 설정

각 노드 클릭 → Settings 탭 → On Error 값 설정 (위 표 참고)
설정 후 각 노드에 빨간 error 출력 포트 생성 확인
캡처: n8n_day27_on_error_settings.png

STEP 2Retry On Fail 설정

각 외부 API 노드 → Settings 탭 → Retry On Fail: ON
Max Tries·Wait 값 입력 (위 표 참고)
캡처: n8n_day27_retry_settings.png

STEP 3에러 경로 구성

Gmail Get Message error 포트 → Edit Fields(에러 정보 정리) → Sheets(에러 로그 기록)
OpenAI error 포트 → Edit Fields(에러 정보 정리) → Sheets(에러 로그 기록)
기타 노드 에러 포트 → 공통 Sheets 에러 로그 노드로 합류
캡처: n8n_day27_error_paths.png

에러 정보 Edit Fields 매핑

text

에러발생노드:  'Gmail Get Message'  (Fixed)
에러메시지:    {{ $json.error.message }}
에러발생시각:  {{ $now.toISO() }}
메일ID:        {{ $('Gmail Trigger').item.json.id }}

STEP 4Error Workflow 연결 및 Active 전환

워크플로우 Settings → Error Workflow: 공용 에러 알림 워크플로우 선택
최종 점검 체크리스트 10개 항목 모두 확인
Publish(Active) 버튼 클릭
테스트 이메일 3통 발송 후 Executions 탭 확인
캡처: n8n_day27_active_production.png

🚀 오늘의 미션

워크플로우 Active 전환 직후 테스트 이메일 3통을 발송해보세요 (긴급 1통 / 일반 1통 / 광고 1통)
10분 후 Executions 탭에서 3건의 실행 이력 생성 확인 후 캡처 (파일명: n8n_day27_mission_first_run.png)
48시간 후 아래 리뷰 항목을 채워보세요
총 실행 횟수 / 성공·실패 건수 / 분류 결과별 건수 / Slack 알림 수신 건수 / Gmail Draft 저장 건수 / 가장 많이 발생한 에러

📋 워크플로우 임포트 방법

위 버튼으로 JSON 파일을 다운로드합니다.
n8n 캔버스 오른쪽 상단 ⋯ → Import from file 클릭
다운로드한 JSON 파일을 선택하면 워크플로우가 즉시 열립니다.
빨간 느낌표(!)가 보이면 Credentials을 본인 계정으로 재연결하세요.

💡 먼저 직접 만들어보고, 막혔을 때 정답지로만 활용하세요!

n8n 계정이 없으신가요?n8n 무료 시작하기 ↗

← DAY 26
프로젝트 구현 3단계 : 답장 초안 자동 작성 목차로 DAY 28 →
프로젝트 고도화 : 나만의 기능 추가