구글 시트, 텔레그램, 지메일을 활용한 강력한 오류 처리 및 알림 설정 - n8n 워크플로우

• 자동화 엔지니어: 즉각적인 오류 확인이 필요한 중요 프로덕션 n8n 워크플로우 자동화를 운영하는 사용자.


• 데브옵스 전문가: 자동화 실패에 대한 중앙 집중식 로그가 필요한 모든 사람.


• 기술팀: 시스템 오작동에 대해 이중화된 알림(이메일 및 채팅)을 요구하는 그룹.


• 안정성 추구 사용자: 장애 허용(fault tolerance)을 위한 강력하고 재사용 가능한 n8n 템플릿을 찾는 모든 사람.

안정적인 n8n 워크플로우 실행을 유지하는 것은 매우 중요합니다. 이 전문 n8n 템플릿은 모든 자동화에서 발생하는 실행 실패를 모니터링하고 추적하는 과제를 해결합니다. 오류 포착을 위해 설계된 전용 n8n 트리거 노드를 활용하여, 모든 실패한 실행이 즉시 기록되고 에스컬레이션되도록 보장합니다.

이 설정은 두 가지 이점을 제공합니다. 소급 분석 및 감사를 위한 구글 시트에 영구적인 로깅과, 텔레그램 및 지메일을 통한 즉각적이고 실행 가능한 알림입니다. 이처럼 매우 안정적인 n8n 워크플로우는 실행 로그를 지속적으로 수동으로 확인할 필요를 없애주어 팀이 근본 원인 파악에 더 집중할 수 있게 합니다. 이는 다수의 미션 크리티컬(mission-critical) n8n 자동화를 관리하는 모든 전문가에게 필수적인 구성 요소입니다.

이 n8n 워크플로우는 사용자의 n8n 인스턴스 내 다른 활성 워크플로우에서 발생하는 실행 실패 시에만 작동합니다. 고유한 오류 트리거(Error Trigger) n8n 노드에서 시작됩니다.

1. 트리거: 다른 n8n 워크플로우가 실패하면 오류 트리거(Error Trigger) n8n 노드가 활성화되어 오류 메시지, 실패한 n8n 노드 이름, 실행 URL을 포함한 전체 실행 컨텍스트를 캡처합니다.


2. 병렬 로깅: 첫 번째 브랜치는 오류 데이터를 즉시 구글 시트(Google Sheets) n8n 노드로 보냅니다. 이 노드는 주요 세부 정보(타임스탬프, 워크플로우 이름, 오류 메시지, 실패 노드)를 중앙 집중식 '오류 로그' 스프레드시트에 기록하고 상태(STATUS)를 '신규(NEW)'로 설정합니다.


3. 알림 설정: 동시에 두 번째 브랜치는 필드 편집(Edit Fields (Set)) n8n 노드를 실행합니다. 여기서 사용자는 telegramChatID와 수신자 toEmail 주소에 대한 특정 값을 정의합니다. 이러한 중앙 집중화는 n8n 템플릿을 쉽게 유지 관리할 수 있게 합니다.


4. 즉시 알림 (텔레그램): 데이터는 텔레그램(Telegram) n8n 노드로 전달되어 워크플로우 이름, 실행 URL 및 정확한 오류 메시지를 포함하는 상세한 경고 메시지를 구성하여 미리 정의된 채팅 ID로 전송됩니다.


5. 중복 알림 (지메일): 마지막으로, 실행은 지메일(Gmail) n8n 노드로 계속 진행됩니다. 이 노드는 지정된 수신자에게 포괄적인 이메일 경고를 보내어 중요 오류 알림이 여러 채널을 통해 수신되도록 보장합니다. 이 완전한 n8n 워크플로우는 중요한 오류가 누락되지 않도록 합니다.

이 포괄적인 오류 처리 n8n 워크플로우를 배포하려면 다음 단계를 따르십시오.

1. 가져오기: 제공된 JSON을 복사하여 n8n 인스턴스의 '새로 만들기(New)' 메뉴 -> 'JSON에서 가져오기(Import from JSON)'를 통해 가져옵니다.


2. 자격 증명 설정:

1. 활성화: n8n 워크플로우를 저장하고 활성화합니다. 이제 다른 실패하는 n8n 자동화로부터 오류를 수신할 준비가 되었습니다.

이 n8n 템플릿은 안정적인 모니터링을 위해 여러 전문 n8n 노드 유형을 활용합니다.

오류 트리거 (n8n 트리거):
기능: 이 고유한 n8n 트리거 노드는 n8n 인스턴스 설정에서 연결된 다른 모든 워크플로우의 실행 오류를 캡처하도록 설계되었습니다. 오류 처리 프로세스를 시작합니다.
주요 구성: 매개변수가 필요하지 않으며, 활성화는 외부 워크플로우 실패에 대한 순수한 반응 기반입니다.

오류 기록 (구글 시트 n8n 노드):
기능: 오류 로깅을 위해 전용 구글 시트에 새 행을 추가합니다. 이는 감사 추적(audit trail)을 제공합니다.
주요 구성: 오류 트리거에서 가져온 동적 데이터를 사용하여 워크플로우(Workflow) ({{ $json.workflow.name }}), 오류 메시지(Error Message) ({{ $json.execution.error.message }}), 노드(Node) ({{ $json.execution.error.node.name }})와 같은 열을 채웁니다.

필드 편집 (Set n8n 노드):
기능: 알림 메커니즘에 필요한 정적 변수(telegramChatID 및 toEmail)를 저장하여 이러한 민감한 매개변수를 쉽게 업데이트할 수 있도록 합니다.
주요 구성: 다운스트림 사용을 위해 두 개의 문자열 할당을 정의합니다.

채널 알림 (텔레그램 n8n 노드):
기능: 텔레그램 채널/채팅으로 즉각적이고 구조화된 텍스트 알림을 보냅니다.
주요 구성: 메시지 텍스트는 초기 오류 트리거 n8n 노드에서 데이터를 가져오기 위해 중첩된 표현식을 사용하며, 버그 세부 정보(예: 실행 URL, 노드 이름)를 명확하게 제시합니다.

이메일 전송 (지메일 n8n 노드):
기능: 오류에 대한 최종적이고 공식적인 이메일 알림을 전송합니다.
* 주요 구성: 필드 편집(Edit Fields) n8n 노드에 정의된 이메일({{ $('Edit Fields').item.json.toEmail }})을 수신자로 사용하며, 실패한 n8n 워크플로우를 상세히 설명하는 제목을 사용합니다.