가이드 · 보기

실행 모니터

실행 현황과 이상 감지, n8n 청구 기준으로 계산한 라이선스 사용량과 시간·일·월 차감 추이를 확인합니다.

Execution Monitor는 n8n 운영 실행을 실시간으로 보여 주고, 실행 횟수가 갑자기 늘거나 한 실행이 지나치게 오래 걸리면 감지해 알립니다. 리소스 맵의 Execution Monitor에서 엽니다.

화면 구성

탭	내용
실행 현황	진행 중인 실행과 최근 실행 분포를 워크플로별로 확인합니다.
이상 감지	감지 기준을 설정하고 현재 이상 징후와 지난 이력을 확인합니다.
라이선스 사용량	Owner/Admin 전용. n8n 라이선스 계약의 포함 실행이 오늘 얼마나 차감됐고 계약 기간 누적이 어디까지 왔는지 실시간으로 확인합니다.

감지 대상은 스케줄·웹훅·트리거로 시작한 운영 실행입니다. 에디터에서 직접 실행한 워크플로와 서브워크플로 내부 실행은 집계에서 제외됩니다.

튜토리얼로 따라 해 보기

화면 상단의 튜토리얼을 선택하면 단계별 안내가 시작됩니다. 안내는 설명만 하는 것이 아니라 실제 화면을 따라가며 필요한 버튼과 입력란을 차례로 짚어 줍니다.

각 단계에서 지금 봐야 할 영역을 강조 표시하고, 왜 그 값을 정하는지 함께 설명합니다.
입력이 필요한 단계에서는 예시 값을 미리 채워 둡니다. 저장하기 전에는 아무것도 실제로 등록되지 않습니다.
진행 표시줄로 남은 단계를 확인하고, 이전으로 되돌아가거나 닫기로 언제든 중단할 수 있습니다.

감지 기준 두 가지

기준	감지 조건	설정 범위
실행 횟수	정한 이동 구간 안에서 시작한 운영 실행이 기준 횟수를 넘을 때	1~60분 구간, 1~1,000,000회
실행 시간	한 실행이 기준 시간을 넘겨 계속될 때	1분~30일

감지 켜기

리소스 맵에서 Execution Monitor를 열고 이상 감지 탭을 선택합니다.
기준 입력하고 켜기를 선택합니다. 이미 설정한 적이 있으면 감지 설정입니다.
규칙 추가를 선택합니다.
기준으로 실행 횟수 또는 실행 시간을 고릅니다.
적용 범위를 인스턴스 전체, 개인 프로젝트 전체, 특정 프로젝트, 프로젝트 하위 폴더 중에서 선택합니다. 프로젝트나 폴더를 고르면 검색으로 대상을 찾습니다.
임계치를 입력합니다. 실행 횟수는 집계 구간(분)과 횟수를, 실행 시간은 기준 시간을 지정합니다.
이메일 수신자를 입력하고 추가를 선택합니다. 규칙당 최대 20명입니다.
규칙 추가로 규칙을 목록에 넣습니다. 필요하면 규칙을 더 만듭니다.
상단의 활성 토글을 켜고 저장을 선택합니다.

기준·적용 범위·이메일 수신자를 규칙별로 설정하는 감지 규칙 화면 — 기준과 범위를 조합해 규칙을 만들고 규칙별 수신자를 지정하는 설정 화면

저장 전에 적용 미리보기에서 지금 기준이 활성 워크플로 몇 개에 적용되는지 확인할 수 있습니다. 규칙을 모두 지우고 저장하면 감지가 꺼집니다.

감지 상태 확인

감지를 켜면 요약 줄에서 전체 규칙 수와 기준별 개수, 현재 이상 징후, 마지막 확인 시각, 감시 중 실행, 이메일 수신 규칙, 감시 커버리지를 확인합니다.

규칙과 감시 커버리지, 현재 이상 징후를 보여주는 실행 이상 감지 화면 — 규칙·커버리지·현재 상태를 한 줄로 요약하는 이상 감지 화면

감시 커버리지: 활성 워크플로 가운데 실행 횟수·실행 시간 기준이 적용된 수입니다.
현재 이상 징후: 지금 기준을 넘고 있는 건입니다. 기준 아래로 내려가면 회복 확인을 거쳐 이력으로 넘어갑니다.
이상 징후 이력: 종료된 징후를 최근 30건까지 보여 줍니다.

감지된 이상 징후를 워크플로·프로젝트와 함께 보여주는 화면 — 기준을 넘은 워크플로와 감지값을 보여 주는 현재 이상 징후

감지를 처음 켜면 최신 실행 범위를 먼저 확인한 뒤 새 실행부터 감시합니다. 입력한 임계치는 바로 적용되며, 평소 실행량과 비교하는 값은 데이터가 하루 쌓인 뒤부터 표시됩니다.

알림과 메일

기준을 넘으면 이상 감지 화면과 Nelper 알림에 동시에 표시됩니다. 알림 제목은 실행 횟수 급증일 때 워크플로 실행 횟수 급증, 장시간 실행일 때 장시간 실행 감지입니다.

워크플로 실행 횟수 급증 알림이 표시된 Nelper 알림 목록 — 감지 즉시 Nelper 알림으로도 전달되는 실행 이상

감지 워크플로·프로젝트·시각과 조치 안내를 담은 알림 메일 — 감지값·설정 기준·적용 범위와 이동 링크를 담아 수신자에게 발송되는 알림 메일

메일은 실제로 걸린 규칙에 등록한 수신자에게만 발송됩니다. 수신자를 비워 두면 메일 없이 인앱 알림만 생성됩니다. 메일에는 감지된 워크플로와 프로젝트, 인스턴스와 감지 시각, 현재 감지값과 설정 기준, 먼저 확인할 항목, Nelper와 n8n으로 이동하는 링크가 담깁니다. 설정 화면의 메일 예시 보기로 발송 전에 미리 확인할 수 있습니다.

메일이 오지 않으면 워크스페이스 → 이메일에서 SMTP 메일 서버 설정을 확인합니다. 메일 서버가 설정되지 않은 환경에서는 인앱 알림만 생성됩니다.

라이선스 사용량 탭

설정 → 비용·사용량에 등록한 n8n 라이선스 계약을 기준으로, 포함 실행 한도가 오늘 얼마나 차감됐고 계약 기간 누적이 어디까지 왔는지 실시간으로 보여 줍니다. Owner/Admin만 볼 수 있으며, 오른쪽 위 n8n 비용 설정으로 계약 편집 화면을 바로 엽니다. 인스턴스가 라이선스 그룹에 속해 있으면 버튼이 그룹 계약 설정으로 바뀝니다.

계약 기간 누적 차감에서 현재 계약의 누적 차감, 포함 한도, 남은 실행, 사용률과 계약 시작·종료 시각을 확인합니다. 누적은 n8n이 라이선스 청구에 쓰는 실행 수를 읽으며 계산식(전일 확정 + 오늘 실시간 = 현재 누적)이 카드 아래에 표시됩니다.
Insights 비교 타일에서 청구 기준과 Insights의 차이를 보고 워크플로별 보기로 어디서 났는지 확인합니다.
기간별 차감 추이에서 오늘, 7일, 이번 달, 계약 기간 또는 직접 설정 기간을 고르고 시간·일·월 단위를 바꿔 차감과 제외 실행을 비교합니다. 시간 단위는 최대 31일까지 조회할 수 있습니다.
오늘 실행 정합성에서 전체 완료, 차감, 제외 수와 실행 방식별 구성을 확인합니다. 제외에는 수동 실행, 서브워크플로 내부 실행, 계약 외·트라이얼 기간 실행이 포함됩니다.
오늘 차감 상위 워크플로와 전체 보기로 워크플로별 차감 건수와 비중을 확인하고, 이름·프로젝트·폴더로 검색합니다.
최근 차감 실행에서 최신 10건의 완료 시각, 워크플로, 프로젝트·폴더, 실행 방식, 결과를 보고 실행 ID로 n8n을 바로 엽니다.

계약 기간 누적 차감, 남은 실행, Insights 비교, 기간별 차감 추이, 오늘 실행 정합성이 보이는 라이선스 사용량 탭 — 계약 누적과 오늘 차감을 한 화면에서 봅니다. 숫자는 데모 환경 값입니다

기간별 차감 추이 읽기

기간과 단위는 궁금한 내용에 맞춰 고릅니다.

알고 싶은 것	기간	단위
오늘 어느 시간대에 몰렸나	오늘	시간
이번 주 하루 사용량은 일정한가	7일	일
연결 전후를 포함한 전체 흐름	계약 기간	일 또는 월
특정 기간의 합계	직접 설정	일

오늘을 시간 단위로 본 막대. 파랑은 차감, 회색은 제외입니다 — 오늘을 시간 단위로 보면 차감이 몰리는 시간대가 보입니다

최근 7일을 일 단위로 본 막대와 선택 기간 차감 합계 — 최근 7일을 일 단위로 본 차감과 제외

계약 기간을 일 단위로 본 막대. 분홍 Insights 구간과 파랑 청구 기준 구간이 이어집니다 — 계약 기간을 일 단위로 보면 연결 전 Insights 구간과 연결 후 청구 기준 구간이 이어집니다

표시	뜻
파랑	n8n 카운터로 확인한 청구 기준입니다
분홍	Insights 또는 일별 기록으로 채운 몫입니다. 주 단위 기록만 남은 기간은 Insights 주간 막대 하나로 그 주 전체에 걸쳐 그립니다
청록	등록한 사용량 기준점입니다
회색	제외된 실행입니다. 근거가 일부면 최소 N건으로 표시합니다
확인된 차감 없음	그 기간을 확인할 근거가 없다는 뜻입니다. 0건이라는 뜻이 아닙니다
값이 커서 막대 윗부분을 잘라 그렸습니다	유난히 큰 막대를 잘라 다른 막대도 읽히게 합니다. 실제 값은 옆에 적습니다
날짜 미확정 N건 별도	선택 기간 안에 돌았는지 모르는 수량입니다. 합계에 넣지 않습니다
어느 날인지 모르는 N건 포함	선택 기간 합계에는 있지만 막대로 나누지 못한 수량입니다

업데이트 첫날에는 오늘 사용량이 실행 기록 기준으로 보일 수 있습니다. 다음 0시 수집 뒤에는 청구 기준으로 바뀝니다.

라이선스 그룹에 속한 인스턴스

여러 인스턴스가 하나의 실행 한도를 함께 쓰는 라이선스 그룹에 속해 있으면, 이 탭은 그룹 전체를 먼저 보여 주고 이 인스턴스는 그 안에서 얼마나 썼는지로 보여 줍니다. 한도가 그룹 하나이기 때문입니다.

그래서 이 인스턴스만의 남은 실행과 사용률은 표시하지 않습니다. 한도가 공용인데 인스턴스 하나로 잔여를 계산하면 실제보다 여유가 있는 것으로 읽히기 때문입니다. 남은 양을 알고 싶으면 항상 그룹 값을 보면 됩니다.

무엇을 보나	어디를 보나
그룹 전체가 얼마나 썼고 얼마나 남았나	맨 위 큰 숫자와 진행 막대입니다. 제목이 그룹 계약 기간 누적 차감 · 그룹 이름으로 표시되고, 막대 아래 사용률과 남은 건수에 그룹이 붙습니다. 오른쪽 타일의 그룹 남은 실행과 그룹 사용률도 같은 값입니다.
이 인스턴스가 그중 얼마를 썼나	막대 바로 아래 이 인스턴스 기여 문장입니다. 건수와 그룹 누적에서 차지하는 비율을 함께 보여 줍니다. 진행 막대에서도 이 인스턴스 몫만 진하게 칠해집니다.
오늘 이 인스턴스가 얼마나 썼나	오늘 실시간 (이 인스턴스)과 전일 확정 (이 인스턴스) 타일입니다. 라벨에 (이 인스턴스)가 붙은 값은 모두 이 인스턴스만의 수치입니다.
다른 인스턴스는 얼마나 썼나	막대 아래 범례에 인스턴스별 건수가 나옵니다. 인스턴스별 적용 기간까지 보려면 설정 → 비용·사용량의 그룹 카드를 엽니다.

카드 아래 계산식도 두 줄이 됩니다. 첫 줄은 이 인스턴스의 전일 확정과 오늘 실시간을 더해 누적 기여를 만들고, 둘째 줄은 인스턴스별 기여를 더해 그룹 누적을 만듭니다. 숫자가 어떻게 나왔는지 그대로 따라갈 수 있습니다.

계약을 고치려면 오른쪽 위 그룹 계약 설정을 선택합니다. 그룹에 속하지 않은 인스턴스에서는 같은 자리에 n8n 비용 설정이 표시됩니다.

그룹 합계를 아직 가져오는 중이거나 일부 인스턴스의 누적을 가져오지 못하면, 그 사실을 알리고 그룹 합계와 남은 실행을 비워 둡니다. 실제보다 낮은 값을 정상값처럼 보여 주지 않기 위해서입니다. 이때도 이 인스턴스 기여와 오늘 차감, 아래의 차감 추이와 워크플로 목록은 그대로 집계합니다.

그룹에서 뺐다가 다시 넣은 인스턴스는 계약 기간 줄에 적용 구간이 몇 개인지 함께 표시되고, 기여는 모든 구간을 더한 값입니다.

차감 기준

Webhook·Trigger·CLI·Retry·Evaluation 방식으로 시작한 운영 실행이 성공·오류·비정상 종료로 완료된 시점에 차감합니다. 진행 중 실행, 수동 실행, 서브워크플로 내부 실행은 차감하지 않습니다.
계약 외 기간과 트라이얼 기간의 실행은 완료돼도 차감하지 않고 제외로 집계합니다.
누적과 오늘·전일 값은 n8n이 라이선스 청구에 쓰는 실행 수를 읽습니다. 실행 기록 보존 설정과 관계없이 n8n이 센 값이라 실행 기록이 지워져도 낮아지지 않습니다. 저장 관측은 기본 5분 간격입니다.
수동, 서브워크플로, n8n 내부 실행은 제외합니다. Error Trigger 실행은 n8n 2.27까지 차감되고 2.28부터 차감되지 않습니다.
Log Streaming 완료 이벤트를 받으면 즉시 반영되고, 이벤트가 없으면 n8n DB를 5초마다 확인합니다. 상단 상태 배지에서 실시간 반영 여부와 기준 시각을 확인합니다.

라이선스 적용 일시(계약 시작 일시)가 설정되지 않은 인스턴스는 계약 누적과 남은 실행을 계산하지 않습니다. 계약이 끝났거나 아직 시작 전이면 그 상태를 알려 주고, 갱신 계약이 등록돼 있으면 새 계약 시작 시각부터 누적과 한도가 자동으로 전환됩니다.

이 문서가 도움이 되었나요?