n8n 대시보드 구성 방법 및 모니터링 활용법 정리
워크플로우 자동화 툴인 n8n은 다양한 API와 서비스를 연결하여 작업을 자동화할 수 있는 오픈소스 기반의 유용한 도구입니다. 특히 운영 중인 워크플로우의 실행 상태나 오류 여부를 실시간으로 파악하려면 대시보드 기능이 매우 중요합니다. 이번 글에서는 n8n에서 대시보드를 구성하고 모니터링하는 방법을 알아보겠습니다.
n8n 대시보드란?
n8n 대시보드는 워크플로우 실행 상태, 에러 발생률, 리소스 사용량 등을 시각적으로 확인할 수 있는 기능입니다. 기본적으로는 Enterprise Edition 또는 외부 모니터링 툴 연동을 통해 구축해야 하며, 커뮤니티 버전에서는 `/metrics` 엔드포인트를 활용해 Prometheus + Grafana로 직접 대시보드를 구성</strong할 수 있습니다.
👉 n8n 공식사이트: https://n8n.io
n8n 대시보드 구성 방식
1. n8n Enterprise 대시보드
- n8n.cloud 또는 유료 Enterprise Self-hosting 사용자 대상
- 시각화된 실행 내역, 에러 로그, 워크플로우 통계 제공
- 사용자별 실행 건수 및 트래픽 관리 가능
2. Prometheus + Grafana 연동
- n8n의 `/metrics` 엔드포인트에서 실행 지표 수집
- Prometheus로 데이터 수집 → Grafana로 시각화
- 무료로 고급 모니터링 대시보드 구성 가능
👉 모니터링 공식 가이드: n8n 서버 모니터링 문서
설정 방법 요약
1. n8n 실행 시 metrics 활성화
- 도커 또는 CLI에서
--metrics플래그 설정 - 예:
n8n start --metrics
2. Prometheus 설정
- Prometheus 설정 파일에 n8n의 metrics endpoint 추가
scrape_configs항목에 n8n URL 기입
3. Grafana에서 대시보드 구성
- Prometheus를 데이터 소스로 연결
- 기존 템플릿 또는 커스텀 대시보드 생성
주요 모니터링 항목
- 워크플로우 실행 횟수
- 실패한 실행 건수
- 실시간 실행 중인 워크플로우 수
- CPU / 메모리 사용량 (Grafana 연동 시)
주의사항 및 팁
- 커뮤니티 버전은 기본 UI 대시보드를 제공하지 않음
- 정확한 데이터 수집을 위해 SSL 및 포트 설정 주의
- Enterprise 사용자는 GUI 기반 모니터링 가능
- 워크플로우 단위별 성능 분석 시 태그 활용 권장
마무리
n8n은 뛰어난 자동화 기능을 갖춘 오픈소스 플랫폼이지만, 실제 운영 환경에서는 대시보드 구성이 매우 중요합니다. Enterprise 유료 사용자뿐 아니라 오픈소스 사용자도 Prometheus와 Grafana를 연동하면 고급 대시보드 환경을 구축할 수 있습니다. 모니터링은 안정적인 서비스 운영의 핵심이니, 지금 바로 구성해보세요!
대시보드 설정 관련 경험담은 n8n 공식 커뮤니티나 GitHub Discussions 등에서 참고하실 수 있습니다.