문서 버전
주제 선택
기능 · 관리

n8n 인스턴스 연동

DB·Metrics·API·Log Streaming 연결과 상태 검증을 관리합니다.

워크스페이스 설정의 연동 화면에서 Nelper가 분석할 n8n 환경의 DB, Metrics, API와 Log Streaming 연결을 관리합니다. 인스턴스 관리는 Owner/Admin만 수행합니다.

연동 구성

연결목적필수 여부
PostgreSQL워크플로·프로젝트·폴더·크레덴셜·실행 이력 조회필수
n8n URL원본 워크플로·크레덴셜·실행 바로가기필수
Metrics API버전, 업타임, Heap, Event Loop, RSS 등 런타임 지표선택
n8n API KeyError Workflow 할당, 정책 자동 게시 해제 등 변경 기능기능별
Log Streaming실행 상태, 오류·감사·LLM 이벤트의 실시간 수집기능별
AI Addon워크플로 오류·개선 AI 분석선택
n8n 연동 설정
인스턴스 상태, API Key, 이벤트, 메트릭과 AI Addon을 관리하는 연동 화면

검증과 모니터링

DB 연결 테스트, 스키마 재스캔, API Key 등록·교체·삭제와 권한 검증을 제공합니다. 이벤트 통계와 최근 이벤트를 확인하고 기간·이벤트명으로 원본 JSON payload를 조회합니다. Metrics는 60초 주기로 갱신됩니다.

n8n API Key
API Key 등록과 필수 권한 검증
이벤트 로그
기간·이벤트명 필터와 원본 payload

Live Runs 설정 진단

Resource Map의 Live Runs는 n8n Webhook destination을 30초마다, 화면으로 돌아올 때마다 다시 읽고 미설정, 비활성화, Workflow 이벤트 미선택, Node 이벤트 미선택과 정상 상태를 구분합니다. Workflow Events의 Started, Success, Failed가 있어야 실행 수명 주기가 실시간으로 반영되며, Node Executions의 Started까지 선택하면 현재 실행 중인 노드도 표시됩니다. 실행 ID는 연결된 n8n의 실행 상세로 바로 이동합니다.

Live Runs 설정 진단
현재 n8n Log Streaming 선택 상태와 필요한 조치를 구분해 보여주는 Live Runs