리소스 맵

리소스 맵은 n8n 인스턴스의 프로젝트·폴더·워크플로·크레덴셜을 구조와 관계로 탐색하고, LLM 토큰 사용량, Error Workflow 설정, AI 기반 워크플로 분석까지 같은 화면 흐름에서 확인하는 운영 도구입니다.

리소스 맵 열기와 인스턴스 선택

1. 사이드바에서 리소스 맵을 선택합니다.
2. 하위 메뉴에서 Structure, Relation, Token Usage, Error Workflow 또는 AI Insight를 선택합니다.
3. 화면 왼쪽 위의 인스턴스 선택기에서 확인할 n8n 인스턴스를 선택합니다.
4. 인스턴스 이름 옆 상태 점과 n8n 버전을 확인합니다.

공통 탐색 도구

• 자동 새로고침: 자동 꺼짐, 10초, 30초, 1분, 5분 중에서 선택합니다. 선택값은 브라우저에 저장됩니다.
• 검색: 프로젝트, 폴더, 워크플로, 크레덴셜 이름을 입력하고 결과를 선택하면 해당 위치로 이동합니다.
• 범위 필터: All, Project, Personal로 조직 프로젝트와 개인 영역을 구분합니다.
• 상태 필터: 오류, Archived, Published 조건으로 표시 대상을 줄입니다.
• 태그 필터: Structure에서 태그를 검색하고 여러 개 선택합니다. 선택한 태그 중 하나라도 가진 워크플로가 표시됩니다.
• Data truncated: 안전 표시 한도를 넘으면 일부 데이터만 그려졌다는 배너가 표시됩니다. 검색과 필터로 범위를 줄입니다.

Structure — 구조 탐색

Structure는 자동화 자산이 어디에 속하는지 보여줍니다. 왼쪽 위의 Overview / Graph 전환 버튼으로 전체 요약과 계층 그래프를 오갈 수 있습니다.

Overview의 Card 모드

1. Overview를 선택하고 오른쪽의 Card를 선택합니다.
2. 상단 집계에서 Projects, Workflows, Active, With Errors, Credentials 수를 확인합니다.
3. 프로젝트 카드의 Workflows, Active, Errors, 폴더·크레덴셜 수와 최근 오류를 확인합니다.
4. 프로젝트 카드를 선택하면 Graph 모드로 전환되고 해당 프로젝트가 화면 중심에 배치됩니다.

Overview의 List 모드

1. Overview 오른쪽에서 List를 선택합니다.
2. 프로젝트 행의 펼치기 아이콘을 선택해 폴더와 워크플로를 단계적으로 펼칩니다.
3. 워크플로 아이콘으로 오류, 활성, 비활성 상태를 구분하고 Archived 배지를 확인합니다.
4. Archived N을 선택해 보관된 워크플로 표시 여부를 전환합니다.
5. 프로젝트 아래의 Credentials 목록에서 소유 크레덴셜을 확인합니다.

Graph 모드

1. Graph를 선택합니다.
2. 마우스 휠로 확대·축소하고 빈 공간을 드래그해 이동합니다.
3. 미니맵에서 현재 보고 있는 위치와 전체 그래프 범위를 확인합니다.
4. 프로젝트, 폴더, 워크플로 또는 크레덴셜 노드를 선택해 상세 패널을 엽니다.
5. Explorer는 권한 없음 숨김으로 잠긴 프로젝트 표시 여부를 바꿀 수 있습니다.

상세 패널 사용

Graph 또는 Relation에서 노드를 선택하면 오른쪽에 상세 패널이 열립니다. 패널 왼쪽 경계를 드래그하면 폭을 조절할 수 있고, X 또는 빈 영역 선택으로 닫습니다.

워크플로를 선택한 경우

• Detail: 오류, Published/Unpublished, Archived 상태와 생성·수정 정보를 확인합니다.
• n8n에서 열기: 원본 워크플로 편집 화면으로 이동합니다.
• 워크플로 구조 보기: n8n 노드 구성을 읽기 전용 캔버스로 엽니다.
• 실행 오류: 오류 분류, 실패 위치와 n8n 실행 이력 바로가기를 확인합니다.
• Error Workflow: 설정 여부를 확인하고 미설정이면 관리 화면으로 이동합니다.
• 관계: 사용 크레덴셜과 호출하는 서브워크플로를 선택해 해당 노드로 이동합니다.
• AI Workflow: 분석 또는 재분석을 실행하고 오류·개선 요약을 확인합니다.

크레덴셜·프로젝트·폴더를 선택한 경우

• 크레덴셜은 타입, n8n 바로가기, 사용 워크플로와 프로젝트를 표시합니다.
• OpenAI, Anthropic, Google 계열 LLM 크레덴셜은 최근 30일 호출 이력을 함께 표시합니다.
• 프로젝트와 폴더는 하위 워크플로·폴더·크레덴셜 수와 프로젝트 멤버 역할을 표시합니다.

Relation — 관계 그래프

1. 리소스 맵 하위 메뉴에서 Relation을 선택합니다.
2. Layers에서 Sub-workflow, Cred Sharing, Cred Usage 관계를 켜거나 끕니다.
3. 노드를 선택하면 직접 연결된 이웃만 선명해지고 나머지는 흐려집니다.
4. 선의 범례로 Contains, Sub-workflow, Cred Sharing, Cred Usage를 구분합니다.
5. ESC 또는 빈 공간을 선택해 강조를 해제합니다.

Token Usage — LLM 토큰 사용량

1. Token Usage를 열고 기간을 최근 7일, 30일, 90일 또는 직접 선택으로 지정합니다.
2. 총 토큰, 예상 비용, 호출 수, 워크플로 수, LLM 크레덴셜 수를 확인합니다.
3. 모델별 토큰 사용량 차트에서 상위 모델의 추이를 비교합니다.
4. 워크플로별 토큰 사용량 표의 행을 선택해 토큰 이벤트 모달을 엽니다.
5. 실행, 크레덴셜, 모델, 합계 토큰, 예상 비용, 노드와 발생 시각을 확인합니다.
6. 크레덴셜 이름을 선택하면 Structure에서 해당 크레덴셜 위치로 이동합니다.

• 과거 이벤트 반영: 저장된 LLM 웹훅 이벤트를 다시 파싱합니다. 중복 데이터는 만들지 않습니다.
• 누락 크레덴셜 복구: 이벤트의 크레덴셜 정보를 보정합니다. 인스턴스별로 한 번만 실행합니다.

Error Workflow — 실패 대응 설정

Error Workflow는 다른 워크플로가 실패했을 때 Error Trigger로 시작해 Slack, 이메일 또는 후속 처리 로직을 실행하는 n8n 워크플로입니다.

1. 먼저 n8n에서 Error Trigger로 시작하는 Error Workflow를 만들고 Published 상태로 게시합니다.
2. Nelper 설정 → 연동에서 해당 인스턴스의 n8n API Key를 등록하고 연결 검증을 완료합니다.
3. 리소스 맵 → Error Workflow에서 인스턴스를 선택합니다.
4. 전체, 미설정, 설정 완료, 설정 비율 요약을 확인합니다.
5. 프로젝트, 활성 상태, 검색어와 설정 상태 필터로 대상을 좁힙니다.
6. 개별 행의 드롭다운에서 사용할 Published Error Workflow를 선택합니다.
7. 여러 워크플로를 선택한 경우 일괄 할당 영역에서 공통 Error Workflow를 선택하고 적용합니다.
8. 완료 결과와 실패 사유를 확인하고 필요하면 n8n 원본에서 설정을 검증합니다.

AI Insight — 워크플로 AI 분석

1. 설정 → 연동에서 AI Workflow Addon URL과 API Secret을 저장합니다.
2. Health Check를 통과한 다음 Addon 활성화 토글을 켭니다.
3. 리소스 맵 → AI Insight에서 인스턴스를 선택합니다.
4. 요약 카드와 심각도 분포, 개선 카테고리, 주의 워크플로 Top 3를 확인합니다.
5. 프로젝트, 검색, 심각도, 분석 상태로 목록을 필터링합니다.
6. 행의 분석, 재분석 또는 재시도를 선택합니다.
7. 행을 선택해 워크플로 캔버스에서 오류 포인트와 개선 제안 위치를 확인합니다.