콘텐츠로 이동
📣 인포그랩에서 OpenAI 기술 기반으로 자체 개발한 자동화 번역 프로그램을 통해 n8n 공식 문서의 한글판을 국내 최초로 제공합니다.

Error Trigger 노드#

Error Trigger 노드를 사용하여 오류 워크플로를 생성할 수 있습니다. 다른 연결된 워크플로가 실패할 때, 이 노드는 실패한 워크플로 및 오류에 대한 세부정보를 수집하고 오류 워크플로를 실행합니다.

사용법#

  1. 새로운 워크플로를 생성하고, 첫 번째 노드로 Error Trigger 노드를 추가합니다.
  2. 워크플로에 Error Handler 등의 적절한 이름을 지정합니다.
  3. 저장(Save) 을 선택합니다.
  4. 오류 워크플로를 사용할 워크플로에서 다음 단계를 수행합니다:
    1. 옵션(Options) 옵션 메뉴 아이콘 > 설정(Settings) 을 선택합니다.
    2. 오류 워크플로(Error workflow) 항목에서 방금 생성한 워크플로를 선택합니다. 예를 들어, Error Handler 이름을 사용했다면 Error Handler 를 선택합니다.
    3. 저장(Save) 을 선택합니다.

이제 해당 워크플로에서 오류가 발생하면 연결된 오류 처리 워크플로가 실행됩니다.

다음 사항에 유의하세요:

  • 워크플로가 Error Trigger 노드를 사용하는 경우, 워크플로를 활성화할 필요가 없습니다.
  • 워크플로에 Error Trigger 노드가 포함되어 있는 경우, 기본적으로 해당 워크플로는 스스로를 오류 워크플로로 사용합니다.
  • 수동으로 워크플로를 실행할 때 오류 워크플로를 테스트할 수 없습니다. Error Trigger는 자동 워크플로에서 오류가 발생할 때만 실행됩니다.

템플릿 및 예제#

Browse 오류 트리거 integration templates, or search all templates

관련 리소스#

Stop And Error 노드를 사용하여 Error Trigger에 사용자 정의 메시지를 보낼 수 있습니다.

n8n 워크플로의 오류 워크플로에 대해 더 읽어보세요.

오류 데이터#

Error Trigger 노드에서 기본적으로 수신하는 오류 데이터는 다음과 같습니다:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
[
	{
		"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"
		}
	}
]

모든 정보가 항상 포함되지만, 다음 경우에는 예외가 있습니다:

  • execution.id: 실행 데이터가 데이터베이스에 저장된 경우에만 포함됩니다. 메인 워크플로의 트리거 노드에서 오류가 발생하면 실행이 시작되지 않으므로 이 값이 존재하지 않습니다.
  • execution.url: 실행 데이터가 데이터베이스에 저장된 경우에만 포함됩니다. 메인 워크플로의 트리거 노드에서 오류가 발생하면 실행이 시작되지 않으므로 이 값이 존재하지 않습니다.
  • execution.retryOf: 이전 실패한 실행을 재시도하는 경우에만 포함됩니다.

오류가 메인 워크플로의 트리거 노드에서 발생한 경우, 이후 단계에서 발생한 오류와는 다른 데이터 구조를 가집니다. 이 경우, execution{} 내부의 정보가 줄어들고, 대신 trigger{} 내부에 더 많은 정보가 포함됩니다.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
  "trigger": {
    "error": {
      "context": {},
      "name": "WorkflowActivationError",
      "cause": {
        "message": "",
        "stack": ""
      },
      "timestamp": 1654609328787,
      "message": "",
      "node": {
        . . . 
      }
    },
    "mode": "trigger"
  },
  "workflow": {
    "id": "",
    "name": ""
  }
}
인포레터에서 최신 DevOps 트렌드를 격주로 만나보세요!