사용량 한도 및 알림

워크스페이스, 프로젝트, 멤버, 그룹, 액세스 토큰에 크레딧 사용량 한도와 잔액 부족 알림을 설정하세요. 임계값에 도달하면 알림을 받거나 사용을 차단할 수 있습니다.

워크스페이스의 크레딧은 모든 멤버와 프로젝트가 함께 쓰기 때문에 프로젝트나 멤버 하나가 계획보다 많은 크레딧을 쓸 수 있습니다. Usage limits & alerts를 사용하면 워크스페이스 owner와 admin이 이런 지출을 통제할 수 있습니다. 크레딧 임계값을 정하고, 적용 대상을 고르고, 임계값에 도달했을 때 알림을 보낼지, 이후 사용을 차단할지, 둘 다 할지 결정합니다.

Workspace settings → Usage limits & alerts에서 열 수 있으며, 모든 유료 플랜에서 사용할 수 있습니다.

사용량 한도와 알림을 쓰는 이유

한도와 알림은 공유 크레딧을 위한 안전장치이므로 잔액을 직접 지켜보지 않아도 됩니다. 다음과 같은 용도로 사용하세요.

• 멤버, 프로젝트, 워크스페이스 전체가 하루 또는 한 달에 쓸 수 있는 크레딧에 상한 두기
• 누구도 차단하지 않고, 사용량이 임계값에 도달하면 이메일이나 인앱 알림 받기
• 한도에 도달하면 빌드를 차단하거나, 배포된 앱의 Lovable Cloud, AI 기능, 종량제 커넥터 요청을 일시 중지하기
• 모든 프로젝트나 모든 멤버에 기본 한도를 정하고, 필요한 곳에만 개별 재정의 두기
• 부서나 프로젝트 팀 같은 그룹의 모든 사람에게 사용량 한도 적용하기
• 워크스페이스 크레딧 잔액이 정한 양 아래로 떨어지면 경고를 받아, 앱이 일시 중지되기 전에 크레딧 충전하기
• 액세스 토큰으로 인증한 요청이 쓸 수 있는 크레딧에 상한 두기
• 한도에 도달한 멤버가 한도 상향을 요청하게 하고, 그 요청을 직접 승인하거나 거부하기

사전 요구사항

한도를 설정하기 전에 워크스페이스와 역할이 다음 조건을 충족하는지 확인하세요.

• 한도와 알림을 만들려면 유료 플랜이 필요합니다.
• 워크스페이스 owner와 admin만 한도와 알림을 만들고, 편집하고, 삭제할 수 있습니다.
• editor는 페이지를 열어 워크스페이스 한도, 기본 한도, 자신과 자신의 프로젝트에 적용되는 한도를 볼 수 있지만 아무것도 변경할 수 없습니다.

한도와 알림의 작동 방식

모든 규칙은 네 가지 선택으로 구성됩니다. 임계값(크레딧 양), 적용 범위(scope, 감시 대상), 크레딧 유형(집계할 사용량 종류), 동작(알림, 차단 또는 둘 다)입니다.

두 종류의 규칙

사용량 한도는 쓴 크레딧을 감시하고, 잔액 부족 알림은 남은 크레딧을 감시합니다.

사용량 한도의 임계값은 항상 크레딧 양입니다. 잔액 부족 알림의 임계값은 크레딧 양이나 워크스페이스에 지급된 크레딧 대비 비율로 정할 수 있습니다. 잔액 부족 알림은 사용을 차단하지 않습니다.

적용 범위

각 한도는 하나의 적용 범위에 적용됩니다.

프로젝트와 사용자에는 모두에게 적용되는 기본(default) 한도와 개별 프로젝트나 멤버에 대한 특정 한도를 함께 만들 수 있습니다. 기본 한도는 공유 풀이 아니라 프로젝트나 멤버마다 각자의 허용량을 줍니다. 예를 들어 프로젝트 기본 한도가 100크레딧이면 모든 프로젝트가 각각 최대 100크레딧까지 쓸 수 있습니다. 활성화된 특정 한도는 조건이 일치하는 기본 한도만 재정의합니다. 크레딧 유형과 기간이 같아야 하므로 일일 Build 한도는 월간 Build 기본 한도를 대체하지 않습니다. 다른 크레딧 유형이나 기간의 기본 한도는 계속 적용됩니다.

그룹 한도는 공유 그룹 예산이 아니라 현재 멤버 각자에게 별도 허용량을 줍니다. 누군가를 그룹에 추가하거나 그룹에서 제거하면 그 사람에게 적용되는 한도도 바뀝니다.

크레딧 유형

한도는 모든 크레딧 사용량을 감시하거나 특정 종류의 사용량만 감시할 수 있습니다.

들여쓰기는 이 표와 대화상자에서 유형이 어떻게 포함되는지 보여 줍니다. Build와 Run은 General의 일부이고, Cloud, AI, Connectors는 Run의 일부입니다. 상위 유형에 건 한도는 그 아래의 모든 사용량을 포함하므로, General 한도는 모든 사용량을 집계하고 Run 한도는 Cloud, AI, 커넥터 사용량을 집계합니다.

기간

각 사용량 한도는 두 가지 기간 중 하나를 기준으로 사용량을 집계합니다.

잔액 부족 알림에는 기간이 없습니다. 항상 현재 잔액을 임계값과 비교합니다.

사용량 한도 만들기

모든 사용량 한도는 같은 대화상자에서 만듭니다.

크레딧 유형이나 기간이 다르다면 같은 적용 범위에 여러 한도를 설정할 수 있습니다. 예를 들어 같은 프로젝트에 월간 Build 한도와 일일 Cloud 한도를 함께 둘 수 있습니다. 적용 범위, 크레딧 유형, 기간이 기존 한도와 같은 한도를 만들면 두 번째 한도가 추가되지 않습니다. 대신 Overwrite existing limit 확인 창에 현재 한도의 양과 동작이 표시되고, 확인하면 기존 한도가 새 설정으로 바뀝니다. 덮어쓰는 한도가 사용을 차단하고 새 한도는 차단하지 않는다면 차단 설정이 그대로 이어집니다. 한도의 차단을 멈추려면 덮어쓰지 말고 한도를 편집하세요.

현재 기간의 사용량이 이미 입력한 양에 도달한 상태라면, 활성화된 차단 한도는 저장하는 즉시 차단을 시작합니다. Lovable은 먼저 경고하고 무엇이 차단되거나 일시 중지되는지 설명한 뒤, 확인을 위해 BLOCK을 입력하도록 요청합니다.

잔액 부족 알림 만들기

잔액 부족 알림은 크레딧이 바닥나기 전에 경고합니다. 자동 충전이 비활성화되어 있어 크레딧이 없으면 배포된 앱이 일시 중지되는 경우에 특히 유용합니다.

잔액이 임계값 아래로 떨어지면 Lovable이 알림을 보내므로 제때 크레딧을 추가할 수 있습니다.

각 알림은 임계값, 알림 채널과 수신자, 활성화 스위치, 편집·삭제 메뉴와 함께 목록에 표시됩니다. 알림을 삭제하지 않고 비활성화하려면 스위치를 사용하세요.

임계값을 다르게 해 잔액 알림을 여러 개 설정할 수 있습니다. 예를 들어 50%에서 조기 경고를, 25크레딧에서 긴급 경고를 받을 수 있습니다. 이미 알림이 있는 임계값에 알림을 만들면 기존 알림을 덮어씁니다. Lovable이 확인을 요청한 뒤 기존 알림 설정을 새 설정으로 바꿉니다.

Enterprise 워크스페이스에는 처음부터 지급된 크레딧의 25%와 10%에서 울리는 이메일 잔액 알림 두 개가 있습니다. 직접 만든 알림처럼 편집하거나 비활성화하거나 삭제할 수 있습니다.

한도가 트리거되면 일어나는 일

알림

알림은 한도에 선택한 채널로 전송됩니다. 두 채널 모두 워크스페이스 owner와 admin에게 알림을 보내며, 한도와 가장 직접 관련된 사람에게도 알림이 갑니다. 사용자 한도와 그룹 한도는 해당 멤버, 프로젝트 한도는 프로젝트를 만든 사람, 액세스 토큰 한도는 토큰 소유자입니다. 인앱 알림은 알림 패널에 Usage limits & alerts로 돌아가는 링크와 함께 표시됩니다.

차단 한도는 임계값의 80%에서 Approaching 상태가 됩니다. 페이지 상단의 Requires attention 카드에 Approaching limits로 표시되며, 아직 사용이 차단되지는 않습니다. 한도에 알림도 설정되어 있다면 Lovable이 선택한 채널로 조기 경고를 보냅니다.

Lovable은 각 알림을 한 번만 보냅니다. 차단 한도가 Approaching에 도달할 때 경고를, 한도가 트리거될 때 주 알림을 보냅니다. 한도가 같은 상태에 머무는 동안에는 다시 알림을 보내지 않습니다.

차단

차단 한도에 도달하면 해당 사용이 멈춥니다. 워크스페이스 한도와 프로젝트 한도에서는 대화상자의 차단 스위치 이름이 선택한 크레딧 유형에 따라 달라집니다.

• Build 한도(Block building)는 한도가 적용되는 사람이 Lovable에게 앱 빌드나 편집을 요청하지 못하게 합니다.
• Cloud 한도(Pause Cloud)는 한도가 적용되는 프로젝트에서 데이터베이스, 스토리지, 백엔드 서비스 같은 Lovable Cloud 기능을 일시 중지합니다.
• AI 한도(Pause AI)는 한도가 적용되는 프로젝트의 앱 안에서 AI 기능을 일시 중지합니다.
• Connectors 한도(Pause connectors)는 한도가 적용되는 프로젝트의 앱에서 나가는 종량제 커넥터 요청을 일시 중지합니다.
• Run 한도(Pause Cloud and AI features and connector requests)는 한도가 적용되는 프로젝트에서 Cloud 기능, AI 기능, 종량제 커넥터 요청을 일시 중지합니다.
• General 한도(Block all usage)는 앱 빌드와 실행을 포함해 해당 적용 범위의 모든 크레딧 사용을 차단합니다.

액세스 토큰 한도에서는 스위치 이름이 대신 Block Cloud usage, Block AI usage, Block Run usage로 표시됩니다. 이 스위치는 어떤 프로젝트도 일시 중지하지 않고 해당 토큰으로 보낸 요청만 차단합니다.

Lovable에서 빌드를 막는 것은 Block building과 Block all usage뿐입니다. 나머지 차단 한도는 배포된 앱의 기능을 일시 중지하거나 토큰의 요청을 차단할 뿐이므로 누구나 계속 빌드할 수 있습니다.

기본 한도는 프로젝트별, 멤버별로 적용됩니다. 한 프로젝트가 프로젝트 기본 한도에 도달하면 그 프로젝트만 차단되거나 일시 중지되고, 같은 기본 한도가 적용되는 다른 프로젝트는 계속 작동합니다. 범위가 가장 넓은 것은 워크스페이스 한도로, 도달하면 워크스페이스의 모든 프로젝트에 영향을 줍니다.

한도에 도달한 사람에게는 해당 한도의 이름과 차단된 내용을 알려 주는 메시지가 표시됩니다. 워크스페이스 owner와 admin에게는 한도를 관리하는 옵션이 표시되고, 그 밖의 사람에게는 owner나 admin에게 문의하라는 안내가 표시됩니다.

차단은 기간이 초기화되거나, 한도가 올라가거나, 차단이 비활성화되거나, 한도가 삭제될 때까지 유지됩니다. 크레딧을 추가하거나 플랜을 업그레이드해도 사용량 차단은 풀리지 않습니다. 한도는 해당 기간에 이미 사용한 크레딧을 집계하며, 크레딧을 추가해도 그 수치는 바뀌지 않기 때문입니다.

한도 상향 요청

차단 한도에 도달한 멤버는 하던 작업을 떠나지 않고 더 높은 한도를 요청할 수 있습니다. 한도가 요청을 지원하면 한도 도달 메시지에 Request an increase가 포함됩니다. 멤버는 **New limit (credits)**와 선택 사항인 사유를 입력한 다음 Send request를 선택합니다. 메시지에 Request sent가 표시되어 요청이 전송되었음을 알려 줍니다. 요청이 검토를 기다리는 동안 다시 요청하면 Request already pending이 표시됩니다.

워크스페이스 owner와 admin은 Limit increase requested 알림을 받습니다. 요청은 Usage limits & alerts의 Requests 탭에서 검토하며, 이 탭에는 대기 중인 요청 수가 표시됩니다. 각 요청에는 요청자의 이름과 이메일 주소, 현재 양과 요청한 양, 전송 시점, 사유가 나옵니다. 요청을 거부하려면 Deny를, 한도를 올리려면 Approve를 선택합니다. 승인하면 Approve usage limit increase 대화상자가 열리고 **How long should the new limit apply?**라고 묻습니다.

• Indefinitely는 admin이 변경하거나 제거할 때까지 새 양을 유지합니다.
• Until end of usage period는 한도를 일시적으로 올립니다. 표시된 날짜(UTC)까지 적용된 뒤 구성된 한도로 돌아갑니다. 대화상자에서 이 옵션이 미리 선택되어 있으며, 승인 버튼에 정확한 날짜가 표시됩니다.

일시적으로 상향된 한도의 행에는 Temporary until 배지가 표시됩니다. 배지에는 한도가 구성된 값으로 돌아가는 날짜가 나오고, 배지에 마우스를 올리면 상향된 양이 표시됩니다. 탭의 필터를 사용해 지난 요청을 적용 범위와 상태(Pending, Approved, Denied, Cancelled)별로 검토할 수 있습니다.

기본 한도에 대한 요청을 승인해도 모든 대상의 기본 한도가 올라가지는 않습니다. 요청한 멤버나 프로젝트에만 적용되는 재정의가 만들어집니다. 그룹 한도와 액세스 토큰 한도는 상향 요청을 지원하지 않습니다.

기존 한도 관리

페이지는 두 섹션으로 구성됩니다. 위쪽 Workspace 섹션에는 Usage limits, Balance alerts, Requests 탭이 있습니다. 그 아래 Usage limits by scope 섹션에는 All, Projects, Users, Groups, Access tokens 탭이 있습니다. Requests와 Access tokens 탭은 owner와 admin에게만 표시되며, Groups와 Access tokens 탭을 쓰려면 Business 또는 Enterprise 플랜이 필요합니다.

한도가 트리거되었거나 임계값에 가까워지면 페이지 상단의 Requires attention 카드에 검토가 필요한 항목이 나열됩니다. Usage blocked 또는 Threshold reached 배지가 붙은 Usage limits, Threshold reached 배지가 붙은 Balance alerts, 그리고 Approaching limits입니다. 행의 Review 작업을 선택하면 해당 상태 필터가 적용된 탭이 열립니다.

한도 행 끝의 메뉴를 열면 다음 작업을 할 수 있습니다.

• 한도를 Edit합니다. Limit 필드의 양과 Behavior 설정을 변경할 수 있습니다. 적용 범위, 크레딧 유형, 기간은 생성 후 고정되므로 대화상자에 잠긴 상태로 표시됩니다. 이 값들을 바꾸려면 새 한도를 만드세요.
• 현재 기간에 사용량이 있는 특정 프로젝트나 멤버의 한도에서 View usage details를 선택합니다. 해당 프로젝트나 멤버로 필터링된 Usage details가 열려 한도에 집계된 사용량을 확인할 수 있습니다.
• Enabled 스위치로 한도를 삭제하지 않고 비활성화합니다. 상태가 Disabled로 표시됩니다.
• 한도를 Delete합니다.

기본 한도가 적용되는 특정 프로젝트나 멤버에는 그 한도가 상속된 행으로 표시됩니다. 상속된 행을 편집해도 기본 한도는 바뀌지 않으며, 변경 사항을 저장하면 해당 프로젝트나 멤버에 대한 재정의가 만들어집니다. 상속된 한도를 비활성화하거나 삭제하려면 기본 한도 자체를 관리하세요.

특정 한도를 찾으려면 Usage limits by scope 탭의 검색 상자를 사용하세요. 검색은 한도의 적용 대상과 일치하는 항목을 찾습니다. 멤버의 이름이나 이메일, 프로젝트 이름, 그룹 이름이나 그룹 멤버, 액세스 토큰 이름으로 검색할 수 있습니다.

한도 자체의 설정으로 목록을 좁히려면 Filters 메뉴를 여세요. 사용량 한도에는 다음 필터가 있습니다.

• Status: Approaching(사용량이 경고 수준에 도달함), Triggered(사용량이 임계값에 도달함), Disabled. Usage limits by scope 섹션의 탭에는 Active(활성화되어 있고 사용량이 아직 경고 수준 미만)도 있습니다.
• Period: Monthly 또는 Daily
• Credit type: General, Build, Run, Cloud, AI, Connectors

Balance alerts 탭은 상태로만 필터링하며, 트리거된 상태를 Threshold reached라고 부릅니다.

특정 한도에는 임계값 대비 현재 사용량이 표시되고, 기본 한도 행에는 임계값만 표시됩니다. 트리거되어 사용을 차단하는 한도에는 Triggered 대신 Blocking 배지가 표시됩니다.

제한 사항

한도를 계획할 때 다음 제약을 염두에 두세요.

• 워크스페이스 하나에 한도를 최대 500개까지 만들 수 있습니다.
• 한도는 하나의 워크스페이스 안에서만 적용됩니다. 여러 워크스페이스의 지출을 통제하려면 각 워크스페이스에 한도를 만드세요.
• 사용량이 기록된 뒤에 한도가 평가되므로, 차단이 적용되기 전에 사용량이 하드 한도를 약간 넘을 수 있습니다.
• 액세스 토큰 한도는 토큰별로 적용됩니다. 대화상자에는 모든 액세스 토큰에 한 번에 적용되는 기본 한도가 없습니다.

FAQ

관련 주제

• 크레딧 및 사용량
• 워크스페이스 관리자 설정
• People 탭에서 워크스페이스 멤버 관리
• Lovable 변경 로그
• FAQ