n8n UI 완전 정복 — 캔버스, 실행 로그, 데이터 뷰

n8n의 가장 큰 매력은 시각적 에디터다. 코드를 한 줄도 쓰지 않고 노드를 드래그해서 연결하면 워크플로우가 완성된다. 하지만 이 에디터를 제대로 알아야 생산성이 폭발한다.

워크플로우 에디터 전체 구조

n8n을 열고 "Add Workflow(새 워크플로우 만들기)"를 클릭하면 에디터 화면이 나타난다. 큰 영역 4개로 나뉜다.

┌─────────────────────────────────────────────────────┐
│  ❶ 상단 바 (Workflow Name, Save, Execute, Share)    │
├─────────────────────────────────────────────────────┤
│                                                     │
│                ❷ 캔버스 (Canvas)                    │
│           노드를 배치하고 연결하는 공간              │
│                                                     │
│                    [Node A] ──▶ [Node B]            │
│                                                     │
│                                                     │
├─────────────────────────────────────────────────────┤
│  ❸ 노드 패널 (우측): 노드 선택 시 설정 패널 표시   │
├─────────────────────────────────────────────────────┤
│  ❹ 실행 로그 (하단): 실행 결과, 에러 확인           │
└─────────────────────────────────────────────────────┘

하나씩 자세히 살펴보자.

❶ 상단 바 — 워크플로우 관리

상단 바에는 워크플로우를 관리하는 핵심 기능이 모여 있다.

요소	단축키	설명
워크플로우 이름	—	클릭해서 이름 변경
Save	`Ctrl+S`	워크플로우 저장
Execute Workflow	`Ctrl+Enter`	전체 워크플로우 실행
Share	—	팀원과 워크플로우 공유
Active 토글	—	워크플로우 활성화/비활성화 (프로덕션 실행 ON/OFF)
설정(⚙️)	—	에러 핸들링, 타임존, 태그 등

Active 토글이란?

워크플로우를 만들었다고 자동으로 실행되는 것이 아니다. Active 토글을 ON으로 설정해야 트리거가 감지되어 자동 실행된다.

비활성 상태 (OFF)  →  에디터에서 수동 실행만 가능
활성 상태 (ON)     →  트리거 이벤트 발생 시 자동 실행

💡 개발 중에는 OFF, 완성 후 테스트까지 마치면 ON으로 전환하는 것이 안전하다.

❷ 캔버스 — 노드의 무대

캔버스는 n8n의 핵심이다. 여기서 노드를 배치하고, 연결하고, 데이터 흐름을 설계한다.

캔버스 조작

동작	조작 방법
화면 이동	마우스 우클릭 드래그 또는 스크롤
줌 인/아웃	`Ctrl` + 마우스 휠
전체 보기	`Ctrl+Shift+1` (모든 노드가 보이게 줌 조정)
노드 선택	클릭
다중 선택	`Shift` + 클릭 또는 드래그로 범위 선택
노드 복사	`Ctrl+C` → `Ctrl+V`
노드 삭제	`Delete` 또는 `Backspace`
실행 취소	`Ctrl+Z`
다시 실행	`Ctrl+Shift+Z`

노드 추가하기

노드를 추가하는 방법은 3가지다.

+ 버튼 클릭: 캔버스 빈 공간에서 + 버튼 클릭
기존 노드에서 연결: 노드 오른쪽의 커넥터 점을 드래그
단축키: Tab 키를 누르면 노드 검색 패널이 열린다

💡 가장 빠른 방법: Tab으로 검색 패널을 열고, 노드 이름을 바로 타이핑하자. 마우스보다 훨씬 빠르다.

노드 연결하기

노드 간 연결은 커넥터(Connector) 로 이루어진다.

[Node A] ●────────────▶ ● [Node B]
        출력(Output)     입력(Input)

출력 포트(오른쪽 점): 이 노드의 결과 데이터가 나가는 곳
입력 포트(왼쪽 점): 이전 노드의 데이터가 들어오는 곳
출력 포트에서 드래그를 시작하여 입력 포트에 놓으면 연결 완성

하나의 노드 출력을 여러 노드의 입력에 연결할 수 있다 (데이터 복제). 반대로, 여러 노드의 출력을 하나의 입력에 연결할 수도 있다 (Merge 패턴).

                    ┌──▶ [Slack 알림]
[Webhook] ──▶ [IF] ─┤
                    └──▶ [Email 전송]

노드 비활성화

특정 노드를 일시적으로 건너뛰고 싶을 때는 비활성화할 수 있다.

노드 우클릭 → "Deactivate"
또는 노드 선택 후 D 키

비활성화된 노드는 흐릿하게 표시되며, 실행 시 건너뛴다. 디버깅할 때 매우 유용하다.

❸ 노드 설정 패널 — 상세 구성

캔버스에서 노드를 더블 클릭하면 오른쪽에 설정 패널이 열린다.

설정 패널은 노드 종류에 따라 다르지만, 공통적으로 3개의 탭이 있다.

Parameters (파라미터) 탭

노드의 핵심 설정이 여기 있다. 예를 들어 HTTP Request 노드라면:

필드	설명
Method	GET, POST, PUT, DELETE 등
URL	요청할 API 주소
Authentication	인증 방식 선택
Send Body	요청 본문 포함 여부
Send Headers	커스텀 헤더 추가

Settings (설정) 탭

모든 노드에 공통으로 적용되는 설정:

설정	설명
On Error	에러 시 동작: Stop / Continue / Retry
Retry on Fail	실패 시 재시도 횟수와 간격
Notes	이 노드에 대한 메모 (다른 사람이 이해하기 쉽게)
Execute Once	여러 아이템이 들어와도 1번만 실행

Output (출력) 탭

노드 실행 후 결과 데이터를 보여준다. 3가지 뷰로 전환할 수 있다.

데이터 3대 뷰 — JSON, Table, Schema

노드를 실행하면 결과 데이터가 출력된다. n8n은 이 데이터를 3가지 뷰로 볼 수 있다.

1. Table 뷰

가장 직관적인 뷰. 스프레드시트처럼 행과 열로 데이터를 보여준다.

| name     | email              | age |
|----------|--------------------|-----|
| 홍길동   | [email protected]   | 30  |
| 김철수   | [email protected]    | 25  |

언제 쓰나: 구조화된 데이터를 한눈에 파악할 때. 대부분의 경우 Table 뷰가 가장 편하다.

2. JSON 뷰

원본 JSON 데이터를 그대로 보여준다. 개발자에게 가장 친숙한 형태.

[
  {
    "name": "홍길동",
    "email": "[email protected]",
    "age": 30
  },
  {
    "name": "김철수",
    "email": "[email protected]",
    "age": 25
  }
]

언제 쓰나: 중첩 객체, 배열 등 복잡한 데이터 구조를 정확히 확인할 때. Expression 작성 시 JSON 경로를 확인할 때.

3. Schema 뷰

데이터의 구조(스키마)만 보여준다. 값은 보이지 않고, 어떤 필드가 있는지와 타입만 표시.

name     string
email    string
age      number
address  object
  ├─ city    string
  └─ zip     string

언제 쓰나: API 응답 구조를 처음 파악할 때. "이 데이터에 어떤 필드가 있지?"를 빠르게 확인할 때.

💡 팁: Schema 뷰에서 필드를 클릭하면 해당 필드의 Expression({{ $json.name }})이 자동으로 클립보드에 복사된다. 설정 패널에 바로 붙여넣으면 된다.

실행 로그 — 디버깅의 핵심

워크플로우를 실행하면 하단에 실행 로그가 나타난다.

실행 방법

방법	설명
Execute Workflow (`Ctrl+Enter`)	전체 워크플로우 실행
Execute Node	특정 노드만 단독 실행 (노드 우클릭 → "Test step")
Pin Data	테스트 데이터를 고정하여 반복 실행 시 사용

실행 결과 확인

각 노드 위에 초록색 체크(✅) 또는 빨간색 X(❌)가 표시된다.

[Webhook] ✅ ──▶ [IF 분기] ✅ ──▶ [Slack] ❌
  1 item          1 item         Error!

✅ 초록색: 성공. 아이템 수가 함께 표시된다.
❌ 빨간색: 실패. 클릭하면 에러 메시지를 확인할 수 있다.

실행 이력 (Executions)

좌측 메뉴의 Executions에서 과거 실행 기록을 확인할 수 있다.

열	설명
Status	Success / Error / Running
Started At	실행 시작 시각
Execution Time	소요 시간
Mode	Manual (수동) / Trigger (자동)

실행 기록을 클릭하면 해당 시점의 노드별 데이터를 그대로 재현해서 볼 수 있다. 이것은 디버깅에 매우 강력한 기능이다.

노드의 종류

n8n의 노드는 크게 세 가지로 분류된다.

1. 트리거 노드 (Trigger)

워크플로우를 시작시키는 노드. 모든 워크플로우에 반드시 1개 이상 있어야 한다.

트리거	설명
Schedule Trigger	일정 시간마다 실행 (매시간, 매일 등)
Webhook	외부에서 HTTP 요청이 오면 실행
Email Trigger (IMAP)	새 이메일 수신 시 실행
n8n Form Trigger	사용자가 폼을 제출하면 실행
Chat Trigger	채팅 인터페이스에서 메시지 입력 시 실행
Manual Trigger	사용자가 직접 "Execute" 버튼을 누르면 실행

2. 액션 노드 (Action)

데이터를 처리하는 노드. 외부 서비스 호출, 데이터 변환 등.

카테고리	예시
통신	Slack, Gmail, Telegram, Discord
데이터	Google Sheets, Notion, Airtable
개발	GitHub, GitLab, HTTP Request
데이터베이스	PostgreSQL, MySQL, MongoDB
AI	OpenAI, Anthropic, Google AI
변환	Code, Set, Convert, Crypto

3. 플로우 노드 (Flow)

워크플로우의 흐름을 제어하는 노드.

노드	설명
IF	조건에 따라 true/false로 분기
Switch	여러 조건 중 하나로 라우팅
Merge	여러 흐름을 하나로 합치기
Split In Batches	대량 데이터를 묶음 단위로 처리
Wait	일정 시간 대기 후 진행
Loop Over Items	아이템마다 반복 실행

필수 단축키 모음

효율을 10배 높이는 단축키를 모았다. 자주 쓰는 것부터 익히자.

동작	Mac	Windows/Linux
노드 검색/추가	`Tab`	`Tab`
워크플로우 저장	`⌘+S`	`Ctrl+S`
전체 실행	`⌘+Enter`	`Ctrl+Enter`
실행 취소	`⌘+Z`	`Ctrl+Z`
다시 실행	`⌘+⇧+Z`	`Ctrl+Shift+Z`
노드 복사	`⌘+C`	`Ctrl+C`
노드 붙여넣기	`⌘+V`	`Ctrl+V`
노드 삭제	`Delete`	`Delete`
노드 비활성화	`D`	`D`
전체 보기 (줌 리셋)	`⌘+⇧+1`	`Ctrl+Shift+1`
워크플로우 목록	`⌘+⇧+O`	`Ctrl+Shift+O`

💡 가장 중요한 3개: Tab(노드 추가), ⌘+S(저장), ⌘+Enter(실행). 이 셋만 외워도 마우스 사용이 절반으로 줄어든다.

워크플로우 설정 (Settings)

워크플로우 이름 옆의 ⚙️ 아이콘 또는 우측 상단 메뉴에서 워크플로우 전체 설정을 관리한다.

설정	설명
Error Workflow	이 워크플로우가 실패 시 실행할 에러 핸들러 워크플로우 지정
Timezone	이 워크플로우의 시간 기준 (기본: 서버 타임존)
Save Execution Data	실행 데이터를 저장할지 여부 (디스크 관리)
Timeout	워크플로우 전체 실행 제한 시간
Tags	워크플로우 분류용 태그

📝 정리

[x] 에디터 구조: 상단 바 + 캔버스 + 노드 패널 + 실행 로그, 4대 영역
[x] 캔버스 조작: Tab으로 노드 추가, 드래그로 연결, D로 비활성화
[x] 데이터 3대 뷰: Table(직관), JSON(상세), Schema(구조 파악)
[x] 실행 방법: Ctrl+Enter 전체 실행, 노드별 단독 실행, Pin Data로 테스트
[x] 노드 3종류: Trigger(시작), Action(처리), Flow(흐름 제어)
[x] 핵심 단축키 3개: Tab, ⌘+S, ⌘+Enter

다음 편 예고

4편: 첫 번째 워크플로우 — Schedule + HTTP Request로 날씨 알림 만들기

이론은 충분하다. 이제 직접 만들어보자! Schedule Trigger와 HTTP Request 노드를 조합해 매일 아침 날씨를 자동으로 알려주는 워크플로우를 단계별로 따라 만든다.