비용·사용량 관리

설정 → 비용·사용량에서 n8n 라이선스 사용량·비용과 Nelper AI 비용을 나눠서 봅니다. Owner와 Admin만 사용할 수 있습니다.

먼저 알아 둘 말

n8n 라이선스는 계약 기간 동안 실행할 수 있는 횟수가 정해져 있습니다. 이 페이지는 그 횟수를 얼마나 썼고 얼마나 남았는지 보는 방법을 설명합니다.

n8n 2.10 이상을 지원합니다. 이 숫자는 운영 판단을 돕는 값이며 청구서를 대신하지 않습니다. 정확한 금액은 n8n에서 받은 청구 내역으로 확인합니다.

숫자는 언제 바뀌나요

이럴 때는 여기를 보세요

n8n 라이선스 설정

1. 비용·사용량에서 n8n 라이선스 탭을 열고 상단에서 인스턴스를 선택합니다.
2. 오른쪽 위 n8n 비용 설정을 선택합니다.
3. 계약 이력의 최초 계약에 계약 시작 일시와 계약 종료 일시(KST)를 입력합니다. 시작 일시를 고르면 종료 일시는 1년 뒤로 채워지며, 1년이 아닌 계약은 직접 고칩니다. 비워 둘 수 없습니다.
4. 계약 기간 비용(EUR), 포함 실행 횟수, 초과 단가(EUR/건)를 입력합니다.
5. 계약 중에 실행 수를 더 샀다면 추가 구매를 등록합니다.
6. 다음 계약을 미리 등록하려면 + 갱신 계약 추가를 선택합니다. 기존 계약은 그대로 유지되고 새 시작 시각에 누적과 한도가 자동으로 전환됩니다.
7. 트라이얼 기간이 있으면 트라이얼 일시의 시작과 종료를, 원화 환산이 필요하면 환율을 입력합니다.
8. 저장을 선택합니다.

계약 기간과 갱신 규칙

• 각 계약은 시작 시각을 포함하고 종료 시각을 포함하지 않습니다. 시작 일시를 고르면 다음 해 같은 시각이 종료 기본값이며, 2월 29일에 시작하면 다음 해 3월 1일입니다.
• 갱신 계약의 시작 일시는 이전 계약 종료 시각이 기본값이자 최솟값입니다. 더 늦추면 그 사이가 계약 공백으로 표시되고 공백 기간 실행은 차감하지 않습니다. 계약은 서로 겹칠 수 없습니다.
• 계약 사이 공백과 마지막 계약 종료 뒤의 실행은 계약 외로 분류됩니다.
• 다른 관리자가 먼저 저장한 뒤 저장하면 덮어쓰지 않고 새로고침 안내가 표시됩니다.

추가 구매

계약 안에 구매 일시, 실행 수, 금액, 메모를 등록합니다. 예를 들어 포함 600,000건 계약에서 100,000건을 더 사면 한도가 포함 600,000 + 추가 구매 100,000 = 700,000건으로 표시됩니다. 한도는 구매한 시각부터 늘어나고, 구매 전에 이미 발생한 초과 비용은 없어지지 않습니다. 구매 금액은 구매한 기간의 비용에 한 번 더해집니다.

사용량 기준점

n8n에서 받은 사용량 보고나 청구 내역의 값이 있을 때 씁니다. Nelper를 뒤늦게 연결해 초기 사용량이 불확실하면 이 값으로 누적을 확정할 수 있습니다. 예를 들어 11월 1일 00:00 기준 120,000건을 등록하면 누적은 120,000건에 그 뒤 사용량을 더한 값이 됩니다.

1. n8n 라이선스 탭의 인스턴스 또는 그룹 카드에서 사용량 막대 범례 오른쪽의 기준점 등록을 선택합니다.
2. 기준 시각(KST), 이번 계약 사용량, 필요하면 출처 메모를 입력합니다.
3. 기준점 바로 저장을 선택합니다. 창 아래 저장은 누르지 않아도 됩니다.

• 라이선스 그룹을 쓰면 모든 멤버의 합계를 그룹에 한 번만 등록합니다.
• 기준점은 계약 누적, 남은 실행, 초과를 확정합니다. 연결 전 날짜별 사용량과 프로젝트별 내역을 만들어 주지는 않습니다.
• 등록하면 범례에 기준 시각까지 등록 N건 · 참고 Insights M건 대비 +D건이 표시되고, 기준점 수정과 기준점 삭제가 나타납니다. 삭제하면 청구 기록과 Insights로 다시 계산합니다.
• 버튼은 범례가 표시되는 계약, 즉 이미 기준점이 있거나 Insights로 채운 구간이 있는 계약에서 보입니다. 등록·수정·삭제는 감사로그에 남습니다.

라이선스 알림

1. 설정 화면이나 Execution Monitor에서 라이선스 알림 설정을 선택합니다.
2. 알림 사용과 알림 기준(75%, 90%, 100%)을 확인합니다. 저장 전 기본값은 사용, 세 기준 모두 켜짐, 이메일 꺼짐입니다.
3. 메일도 받으려면 이메일 알림을 켜고 받는 사람(활성 Owner/Admin, 최대 20명)과 수신자 확인을 체크합니다.
4. 저장을 선택합니다.

• 제목은 n8n 라이선스 사용량 N% 도달 또는 n8n 라이선스 한도 초과입니다. 약 5분마다 확인한 사용량으로 판단합니다.
• 같은 기준은 계약당 한 번 울립니다. 여러 기준을 동시에 넘으면 가장 높은 기준만 전달하고, 추가 구매로 기준 아래로 내려가면 다시 울릴 수 있습니다.
• 메일 발송이 실패하면 자동으로 재시도하고, 끝내 실패하면 Nelper 알림으로 알려 줍니다.
• 설정 변경과 발송 결과는 감사로그에 남습니다.
• 그룹에 속한 인스턴스는 그룹 범위로 설정합니다.

라이선스 그룹으로 실행 한도 공유

운영, 개발, 스테이징처럼 여러 n8n 인스턴스를 쓰지만 n8n 라이선스는 하나로 계약한 경우가 있습니다. 이때는 포함 실행 횟수도 인스턴스마다 따로가 아니라 전부 합쳐 하나입니다.

라이선스 그룹은 그 상황을 그대로 옮긴 것입니다. 계약을 그룹에 한 번만 등록하고 인스턴스를 연결하면, 연결된 인스턴스의 청구 기준을 모두 더해 공용 한도에서 차감합니다. 인스턴스마다 같은 계약을 입력하고 남은 실행을 머릿속으로 빼서 합치던 일이 없어집니다.

예를 들어 포함 실행 100만 건짜리 계약 하나로 운영, 개발, 스테이징 세 인스턴스를 돌린다고 하면 화면은 이렇게 나뉩니다.

Owner와 Admin 가운데 비용 권한이 있는 사용자가 사용합니다. 설정 → 비용·사용량 → n8n 라이선스에서 범위를 전체 인스턴스로 두면 라이선스 그룹 섹션이 보입니다.

그룹 만들기

1. 라이선스 그룹 섹션의 그룹 만들기를 선택합니다.
2. 그룹 이름을 입력합니다. 계약서나 인스턴스 묶음을 알아볼 수 있는 이름을 씁니다.
3. 연결 인스턴스에서 이 라이선스를 함께 쓰는 인스턴스를 고릅니다. 고른 인스턴스마다 카드가 하나씩 생기고 적용 시작일을 정할 수 있습니다.
4. 이미 그 인스턴스에 계약을 입력해 두었다면 이 단계에서 계약 이력 가져오기를 먼저 선택합니다. 그대로 저장하면 적용 시작일 이후까지 이어지는 인스턴스 계약이 삭제됩니다.
5. 적용 시작일을 확인합니다. 이 날짜부터의 실행만 그룹 누적에 더해집니다. 기본값은 그룹의 현재 계약 시작일이고, 계약이 아직 없으면 오늘입니다.
6. 공용 계약 이력에서 + 계약 추가를 선택하고 계약 시작·종료 일시, 계약 기간 비용(EUR), 포함 실행 횟수, 초과 단가(EUR/건)를 입력합니다.
7. 공용 비용 기준에 환율(EUR → KRW)과 트라이얼 일시를 입력합니다. 두 값은 그룹 전체에 적용됩니다.
8. 저장을 선택합니다.

인스턴스에 넣어 둔 계약을 그룹으로 옮기기

이미 인스턴스마다 같은 계약을 입력해 둔 상태라면, 값을 다시 입력하지 않고 그대로 옮길 수 있습니다.

1. 그룹 만들기에서 인스턴스를 고르면, 옮길 계약이 있는 인스턴스 행에 계약 이력 가져오기가 나타납니다.
2. 그 버튼을 선택하면 해당 인스턴스의 계약 이력이 공용 계약 이력에 그대로 채워집니다. 환율과 트라이얼이 비어 있으면 함께 가져옵니다.
3. 값이 맞는지 확인하고 저장합니다.

남은 한도와 인스턴스별 사용량 확인

전체 인스턴스 화면의 그룹 카드에서 확인합니다. 자주 묻는 것부터 정리하면 다음과 같습니다.

멤버 인스턴스에서 달라지는 것

그룹에 속한 인스턴스를 선택하면 화면이 이렇게 바뀝니다.

• 비용 요약 자리에 공용 라이선스 그룹 카드가 표시되고, 계약과 한도는 그룹에서 관리하며 아래 수치는 그룹 한도와 이 인스턴스의 기여분이라는 안내가 함께 나옵니다.
• 오른쪽 위에 그룹 계약 설정이 생기고 n8n 비용 설정은 잠깁니다. 잠긴 버튼에 마우스를 올리면 어느 그룹이 계약을 관리하는지 알려 줍니다.
• 환율과 트라이얼을 인스턴스에서 직접 고치려면 먼저 그룹에서 빼야 합니다. 데이터 수집 설정은 그룹과 무관하게 인스턴스 화면의 데이터 수집 현황 카드에서 바꿉니다.
• 프로젝트별 분석은 그룹 기간 비용을 그룹 청구 기준 중 이 인스턴스가 차지한 비중으로 나눈 금액을 보여 줍니다. 표 아래 각주에 그룹 이름, 그룹 기간 비용과 이 인스턴스의 청구 기준이 그룹 전체의 몇 건 중 몇 건인지 나옵니다. 멤버 인스턴스의 배분 금액을 모두 더하면 그룹의 실제 비용과 같습니다. 이 금액은 인스턴스별 몫을 보는 용도라 전체 합계에 다시 더하지 않습니다. 프로젝트 비용과 Excel 내보내기도 같은 금액을 씁니다.

계약 갱신과 멤버 변경

• 각 계약은 계약 시작 일시(KST)부터 계약 종료 일시 직전까지입니다. 갱신할 때는 기존 계약을 고치지 말고 + 계약 추가로 새 계약을 넣습니다. 계약끼리 겹칠 수 없고, 계약 사이가 비어 있으면 그 기간의 실행은 차감하지 않습니다.
• 인스턴스를 그룹에서 빼면 오늘부터 빠집니다. 어제까지의 기여는 그룹 누적에 그대로 남고, 오늘부터는 그 인스턴스 자체 계약으로 계산합니다. 계약을 그룹으로 옮겼다면 자체 계약이 없으므로 다시 입력할 때까지 누적과 남은 실행을 계산하지 않습니다.
• 기존 멤버의 적용 시작일을 바꾸면 그 사이 실행이 어느 쪽으로 옮겨 가는지 저장 전에 안내가 표시됩니다. 이전 값은 감사 로그에 남습니다.
• 뺐다가 다시 넣으면 적용 시작일 기본값이 마지막으로 뺀 날 이후로 잡힙니다. 그보다 앞선 날짜로 되돌리면 기간이 겹쳐 저장되지 않습니다.
• 그룹에 속한 인스턴스를 삭제하면 그 인스턴스의 멤버십도 함께 닫힙니다.
• 그룹 자체를 지우려면 카드의 그룹 관리 메뉴에서 그룹 삭제를 선택하고 확인 창에서 한 번 더 선택합니다.
• 다른 관리자가 먼저 저장했으면 덮어쓰지 않고 새로고침 안내가 표시됩니다.

오늘 차감이 어느 워크플로에서 나왔는지까지 보려면 리소스 맵의 Execution Monitor에서 라이선스 사용량 탭을 엽니다. 그룹에 속한 인스턴스에서는 그 탭도 그룹 한도를 기준으로 표시됩니다.

상태 표시와 값이 비어 있을 때

숫자가 범위로 보일 때

예를 들어 한도 150,000건에 확인된 누적 100,000건, 날짜 미확정 5,000건이면 미확정분이 모두 계약 안일 때 45,000건, 모두 계약 전일 때 50,000건이 남습니다. 화면에는 최소 45,000건과 최대 50,000건으로 표시됩니다. 초과를 피하려면 최소를 보세요.

수집되지 않은 날짜가 있을 때

• 수집 데이터가 통째로 빠진 날짜는 n8n Insights의 집계로 채워 비용과 배분에 반영합니다. 실행 모드 분석에는 이렇게 채운 일수가 표시되며, 이 날짜의 비운영 실행 수는 알 수 없어 제외합니다. 일부 날짜만 채운 경우에도 수집된 날짜의 모드별 내역은 그대로 보여 줍니다.
• n8n이 Insights 기록을 멈춘 뒤의 날을 Nelper 일별 기록으로 채우는 보완은 n8n 2.10에서만 동작합니다.
• Insights 집계로도 실행을 계약·트라이얼·그룹 가입 기간별로 나눌 수 없으면 잘못된 금액 대신 비용을 계산할 수 없습니다. 수집 데이터를 확인하고 다시 조회해 주세요. 안내가 표시됩니다. 데이터 수집 현황에서 재수집한 뒤 다시 조회합니다.
• 재수집이 비정상 종료되면 자동으로 재개되지 않으니 다시 실행합니다.

n8n 비용 현황 확인

• 전체 인스턴스: 라이선스 계약 합산, 라이선스 그룹, 프로젝트별 사용 순위, 인스턴스별 현황을 차례로 봅니다.
• 인스턴스별 현황: 계약 비용, 포함 실행, 계약 누적 차감, 선택 월 청구 기준, 월 비용, 전월 대비와 누적 초과를 비교합니다. 제목 옆 도움말에서 숫자의 출처를 확인합니다.
• 개별 인스턴스: 계약 요약, 선택 기간 실행 분류, 프로젝트·프로젝트 그룹별 분석, 비운영 모드, 데이터 수집 현황을 확인합니다.
• 새로고침은 화면을 떠나지 않고 값을 갱신합니다. 실패하면 이전 값을 유지하고 다시 시도를 보여 줍니다.

계약 기간 요약과 실행 분류

개별 인스턴스의 요약은 달력 연도가 아니라 현재 계약 기간을 기준으로 계약 비용, 누적 차감 실행, 남은 포함 실행, 사용률을 보여 줍니다. 막대에서 분홍은 연결 전 Insights로 센 몫, 파랑은 연결 후 n8n 카운터로 센 몫입니다. 월 비용은 기본료 + 초과로 나눠 보여 주고, 추가 구매가 있으면 함께 표시합니다.

선택 기간 실행 분류는 실행을 계약 외, 트라이얼, 청구 기준으로 나눕니다. 트라이얼을 먼저 분류하고, 그 밖에서 등록된 계약 안의 실행만 청구 기준입니다. 계약 외와 트라이얼 실행은 비용, 포함 한도 소진, 프로젝트·프로젝트 그룹 비용 배분에서 제외합니다. Excel 내보내기도 같은 기준을 씁니다.

Insights 대조

n8n 화면에서 보는 Insights 숫자와 Nelper 숫자가 다를 때 어디서 차이가 났는지 찾는 기능입니다. 요약 카드의 Insights 대조 한 줄에서 차이를 보고, 워크플로별 보기에서 워크플로별로 확인합니다. Nelper가 정시마다 읽기 시작한 뒤의 구간만 비교하므로 계약 전체의 차이는 아닙니다.

비운영 모드와 수집 현황

비운영 모드 (비과금)는 수동·테스트 실행과 서브워크플로·내부 실행을 보여 줍니다. 이 실행은 청구 기준에서 제외합니다. Error Trigger 실행은 n8n 2.27까지 차감되고 2.28부터 차감되지 않습니다.

프로젝트별·그룹별 분석

1. 전체 인스턴스 표에서 분석할 인스턴스 이름을 선택합니다.
2. 프로젝트별 분석에서 프로젝트별 또는 그룹별을 선택합니다.
3. 프로젝트별 청구 기준, 비율과 배분 비용을 확인합니다.
4. 그룹별에서는 프로젝트 그룹 트리의 하위 값을 포함한 합계와 미지정·미확인 항목을 확인합니다.

그룹별 분석은 리소스 거버넌스에서 설정한 프로젝트 그룹을 사용합니다. 프로젝트 그룹 기능이 없거나 그룹을 만들지 않은 환경에서는 프로젝트별 분석을 사용합니다.

기간별 Excel 다운로드

1. 개별 인스턴스의 프로젝트별 분석에서 엑셀 다운로드를 선택합니다.
2. 최근 수집 월, 이전 월, 최근 3개월·6개월, 올해 중 빠른 기간을 선택하거나 시작 월과 종료 월을 직접 고릅니다.
3. 화면에 표시된 실제 시작일·종료일과 개월 수를 확인합니다.
4. 다운로드를 선택합니다.

• 한 파일에 기간 요약, 프로젝트별 분석과 그룹별 분석을 함께 담습니다.
• 이번 달을 포함하면 종료일은 전일까지입니다.
• 전체 인스턴스 보기의 전체 엑셀 다운로드는 화면의 조회 월과 집계 시각으로 요약, 프로젝트별, 그룹별 내역을 한 파일에 담습니다. 화면의 최신 수치를 모두 읽은 뒤 내려받을 수 있습니다.
• 그룹별 시트는 프로젝트 그룹 기능이 활성화된 환경에서 제공됩니다.

LLM 연동 상태 확인

Anthropic API 키는 선택 항목입니다. 키가 없으면 AI 화면에 등록 안내가 표시되고 AI 외 기능은 그대로 쓸 수 있습니다. 키를 등록한 뒤에는 서비스를 재시작합니다.

1. Nelper AI 비용 탭을 엽니다.
2. 상단 LLM 연동 카드에서 정상·일시 불안정·연동 실패·자동 확인 불가 상태와 마지막 확인 시각을 확인합니다.
3. 즉시 다시 점검하려면 다시 확인을 선택합니다.
4. 정보 아이콘에 마우스를 올려 자동 점검 주기와 장애 판정 기준을 확인합니다.

Claude API 크레딧 사용률

1. Nelper AI 비용 탭을 엽니다.
2. Claude API 크레딧 사용률, 잔여 금액, 추정 사용액과 총 충전액을 확인합니다.
3. 임계값 도달 시 이메일 알림을 켜고 퍼센트를 입력합니다.
4. 수신 이메일을 쉼표로 구분해 입력합니다. 비워두면 활성 Owner/Admin을 대상으로 합니다.

충전 이력 입력

1. Anthropic 콘솔에서 실제 충전일과 충전 금액(USD)을 확인합니다.
2. 충전일, 금액과 선택 메모를 입력합니다.
3. 충전 내역 추가를 선택합니다.
4. 잘못 입력한 항목은 해당 행의 삭제를 선택하고 확인합니다.

충전 이력 합계가 크레딧 사용률 게이지의 총 충전액으로 사용됩니다.

기능별 월 사용 한도

1. 각 기능의 월 한도에 조직 전체 허용 횟수를 입력합니다.
2. 무제한으로 운영할 기능은 입력칸을 비웁니다.
3. 한도 저장을 선택합니다.
4. 이번 달 사용량과 잔여 횟수를 확인합니다.

실행 비용 분석

• 전체 통계에서 총 비용, 실행 횟수, 평균 비용/실행과 총 토큰을 확인합니다.
• 일별·주별·월별과 최근 7일·30일·90일 조합으로 추이를 비교합니다.
• 실행 내역에서 Agent, 모델, 상태, 토큰, 비용과 소요 시간을 확인합니다.
• 행을 펼쳐 Planner, Data, Chart, Insight Agent별 토큰과 비용을 확인합니다.

AI 비용은 실측 토큰과 모델 단가를 곱한 추정치입니다. 실제 청구액과 수 % 차이가 날 수 있습니다.