하루보탬

n8n 자체 호스팅 환경에서의 시스템 작업 모니터링 및 시각화

하루보탬 편집팀

A row of Cisco HyperFlex servers mounted in a metal rack in a data center.

n8n을 자체 호스팅하는 모든 에디션에서 Prometheus를 통해 Grafana에 연결함으로써 시스템 작업(maintenance jobs) 상태를 모니터링하고 시각화할 수 있습니다.

대표 참고 사진 출처: Btrs · 사진 원본 · CC-BY-SA-4.0 · 원본 변경 없음. 참고 사진이며 제품 사용·성능의 증거가 아닙니다.

Grafana를 활용한 시스템 작업 모니터링

n8n은 데이터 정리 및 압축을 수행하는 시스템 작업에 대해 실행 기간, 마지막 성공 여부, 진행 중인 작업, 건너뛴 작업, 타이머 지연 등의 지표를 제공합니다.

이러한 시스템 작업 관련 지표를 시각화하기 위해 Prometheus 인스턴스를 통해 Grafana를 연결하는 방식을 활용합니다.

이 기능은 모든 에디션의 자체 호스팅 환경에서 지원되지만, n8n Cloud 버전에서는 /metrics 엔드포인트를 사용할 수 없습니다.

모니터링 도구 구성: n8n(자체 호스팅) -> Prometheus -> Grafana 순서로 연결하여 시스템 작업 지표를 시각화합니다.
모니터링 도구 구성
설명 도해 · 하루보탬 Studio
배포 환경에 따른 기능 가용성: 자체 호스팅 / n8n Cloud; 모든 에디션 지원 / 지원되지 않음
배포 환경에 따른 기능 가용성 — 공식 자료를 정리한 자체 제작 도해입니다.
설명 도해 · 하루보탬 Studio

근거: Visualize metrics with Grafana

모니터링을 위한 필수 설정 및 환경 변수

시스템 작업 관련 지표를 포함하여 모니터링하려면 N8N_METRICS_INCLUDE_SYSTEM_TASK_METRICS 환경 변수를 활성화해야 합니다.

먼저 n8n에서 Prometheus metrics 엔드포인트가 활성화되어 있는지 확인한 후, Grafana를 연결하여 데이터를 시각화할 수 있습니다.

제공된 자료에서 실제 인스턴스 복구, 성능, 비용에 대한 검증은 확인되지 않습니다.

모니터링 활성화 단계: 1. n8n에서 Prometheus metrics 엔드포인트 활성화 → 2. N8N_METRICS_INCLUDE_SYSTEM_TASK_METRICS 환경 변수 설정 → 3. Grafana를 통해 Prometheus에 연결하여 대시보드 확인
모니터링 활성화 단계 — 공식 자료를 정리한 자체 제작 도해입니다.
설명 도해 · 하루보탬 Studio
시스템 작업 지표 포함 조건: N8N_METRICS_INCLUDE_SYSTEM_TASK_METRICS 설정 시 run-duration, last-success, in-flight, skip, timer-lag 지표가 포함됩니다.
시스템 작업 지표 포함 조건 — 공식 자료를 정리한 자체 제작 도해입니다.
설명 도해 · 하루보탬 Studio
모니터링 구축을 위한 다음 단계: 자체 호스팅 환경인지 확인하고, n8n 설정에 시스템 작업 지표 포함 환경 변수를 추가한 후 Grafana 대시보드를 구성하십시오.
모니터링 구축을 위한 다음 단계 — 공식 자료를 정리한 자체 제작 도해입니다.
설명 도해 · 하루보탬 Studio

근거: Visualize metrics with Grafana

적용 조건과 확인 범위
  • 공식 문서에 명시된 자체호스팅 운영 범위와 백업에 포함·제외되는 대상을 구분한다.
  • 실제 인스턴스 복구·성능·비용을 검증했다고 주장하지 않는다.
  • 지원 범위: n8n Cloud에서는 /metrics 엔드포인트를 사용할 수 없음
  • 설정 조건: 시스템 작업 관련 지표를 포함하려면 N8N_METRICS_INCLUDE_SYSTEM_TASK_METRICS 환경 변수 활성화 필요
  • 데이터 범위: 제공된 자료에서 실제 인스턴스 복구, 성능, 비용에 대한 검증은 확인되지 않음

확인일: 2026-10-01T00:58:50.309798+00:00