에러 트리거

에러 트리거 (Error Trigger)

에러 트리거(Error Trigger) 노드로 에러 워크플로(error workflow)를 만들 수 있어요. 연결된 다른 워크플로가 실패하면, 이 노드는 실패한 워크플로와 오류에 대한 정보를 받아 에러 워크플로를 실행합니다.

사용법

1. 첫 노드로 에러 트리거를 둔 새 워크플로를 만듭니다.
2. 워크플로에 이름을 붙여요. 예를 들어 Error Handler(에러 처리기)라고 합니다.
3. 저장(Save) 을 선택합니다.
4. 이 에러 워크플로를 사용할 워크플로에서:
   1. 옵션(Options) > 설정(Settings) 을 선택합니다.
   2. 에러 워크플로(Error workflow) 에서 방금 만든 워크플로를 선택해요. 예를 들어 이름을 Error Handler로 지었다면 Error handler를 선택합니다.
   3. 저장을 선택합니다.

이제 이 워크플로에 오류가 나면 연결된 에러 워크플로가 실행됩니다.

• 에러 트리거 노드를 쓰는 워크플로는 게시(publish)하지 않아도 돼요.
• 워크플로에 에러 트리거 노드가 있으면, 기본적으로 그 워크플로가 자기 자신을 에러 워크플로로 사용합니다.
• 워크플로를 수동으로 실행할 때는 에러 워크플로를 테스트할 수 없어요.
• 에러 트리거는 자동 워크플로에 오류가 있을 때만 실행됩니다.

템플릿과 예시

에러 트리거 노드 문서 통합 템플릿 보기 또는 모든 템플릿 검색

관련 자료

정지 및 오류(Stop And Error) 노드로 에러 트리거에 커스텀 메시지를 보낼 수 있어요. n8n 워크플로의 에러 워크플로에 대해 더 읽어보세요.

에러 데이터

에러 트리거가 기본으로 받는 에러 데이터는 다음과 같습니다.

[
	{
		"execution": {
			"id": "231",
			"url": "https://n8n.example.com/execution/231",
			"retryOf": "34",
			"error": {
				"message": "Example Error Message",
				"stack": "Stacktrace"
			},
			"lastNodeExecuted": "Node With Error",
			"mode": "manual"
		},
		"workflow": {
			"id": "1",
			"name": "Example Workflow"
		}
	}
]

워크플로 활성화 실패 같은 특정 시나리오에서는 다른 데이터 구조가 나올 수 있어요.

{
  "trigger": {
    "error": {
      "context": {},
      "name": "WorkflowActivationError",
      "cause": {
        "message": "",
        "stack": ""
      },
      "timestamp": 1654609328787,
      "message": "",
      "node": {
        . . .
      }
    },
    "mode": "trigger"
  },
  "workflow": {
    "id": "",
    "name": ""
  }
}