InfoGrab DocsInfoGrab Docs

GitLab Credits 대시보드

요약

GitLab Credits 대시보드는 GitLab Credits 사용량에 관한 정보를 표시합니다. 크레딧 소비 관리를 돕기 위해 GitLab은 청구 계정에 연결된 Customers Portal 사용자에게 다음 정보를 이메일로 보냅니다.

공식 파트너 견적·라이선스 상담

인포그랩은 GitLab 공식 파트너입니다. 라이선스 견적, 갱신, 도입 상담은 인포그랩에 문의하세요. 라이선스 상담 신청 →

히스토리
  • GitLab 18.7에서 도입되었습니다.
  • 결과 정렬 기능이 GitLab 18.10에서 도입되었습니다.

GitLab Credits 대시보드는 GitLab Credits 사용량에 관한 정보를 표시합니다. 대시보드에서 크레딧 소비량을 모니터링하고, 추세를 추적하며, 사용 패턴을 파악할 수 있습니다.

크레딧 소비 관리를 돕기 위해 GitLab은 청구 계정에 연결된 Customers Portal 사용자에게 다음 정보를 이메일로 보냅니다.

  • 월간 크레딧 사용량 요약
  • 크레딧 사용량이 50%, 80%, 100%에 도달했을 때의 알림

대시보드는 Customers Portal과 GitLab에서 접근할 수 있습니다. GitLab Dedicated에서는 Customers Portal과 인스턴스 관리자에게 대시보드가 제공됩니다. 그룹 및 개인 크레딧 사용량 보기는 GitLab.com에서만 사용할 수 있습니다.

Note

사용량 데이터는 실시간으로 표시되지 않습니다. 데이터가 대시보드에 주기적으로 동기화되므로, 사용량 데이터는 실제 소비 후 몇 시간 이내에 표시됩니다. 즉, 대시보드에는 최근 사용량이 표시되지만 최근 몇 시간 동안 수행한 작업은 반영되지 않을 수 있습니다.

Customers Portal에서 보기#

Customers Portal의 GitLab Credits 대시보드는 사용량과 비용을 가장 자세히 보여 줍니다.

대시보드에서 사용한 크레딧은 사용 가능한 크레딧에서 차감된 양을 나타냅니다. 초과 사용분(온디맨드 크레딧)의 경우, 사용 청구 약관에 동의했다면 사용한 크레딧은 나중에 지불할 온디맨드 사용량을 나타냅니다.

대시보드에는 주요 지표를 요약한 카드가 표시됩니다.

  • Current month usage: 이번 달에 사용한 GitLab Credits 총량입니다(월간 커밋이 있는 경우).
  • Included credits: 구독에 포함된 크레딧 총량입니다(월간 커밋이 있는 경우).
  • Committed credits: 월간 커밋 풀의 크레딧입니다(해당하는 경우).
  • Monthly waivers: 면제분으로 남은 크레딧입니다(해당하는 경우).
  • On-demand usage: 포함된 크레딧과 커밋된 크레딧을 초과해 소비한 크레딧입니다. 면제 크레딧이 모든 온디맨드 크레딧을 상쇄할 만큼 충분하면 GitLab Credits 대시보드는 On-Demand 카드를 숨기고 Monthly Waiver 카드를 대신 표시합니다.
  • Usage control status: 사용자별 크레딧 한도에 도달해 개별 사용자의 Agent Platform 접근이 차단되었는지 여부입니다.

GitLab에서 보기#

히스토리
  • Secrets Manager 사용량이 GitLab 19.1에서 도입되었습니다.
Note

Security Review Flow, Business Logic Security Analyzer와 같은 일부 사전 출시 기능은 과금 대상이며 GitLab Credits 요금이 부과됩니다.

GitLab의 GitLab Credits 대시보드는 조직의 크레딧 사용 현황을 운영 관점에서 보여 줍니다. 대시보드에서 어떤 사용자, 그룹 또는 프로젝트가 사용량을 늘리고 있는지 파악하고, 리소스 배분에 관한 판단을 내릴 수 있습니다.

대시보드에는 다음 정보가 표시됩니다.

  • Organization usage: GitLab 인스턴스 또는 그룹 전체의 총 크레딧 사용량(과금 및 비과금), 활성 사용자, 일일 평균 크레딧, 최대 사용일 사용량
  • Total credit usage: 모든 제품에 걸친 일별 과금 및 비과금 크레딧 사용량(누적 막대 차트로 표시)
  • Usage by user: 사용자별 크레딧 사용량(과금 및 비과금)
  • User drill-down view: 비과금 이벤트를 포함한 사용자별 개별 사용 이벤트와, 크레딧 기반 기능별 세션 세부 정보 링크
  • Usage by product: 크레딧 기반 기능별 크레딧 사용량(과금 및 비과금)과 전체 크레딧 사용량 대비 비율
Note

GitLab Secrets Manager가 베타인 동안에는 GitLab이 사용량을 과금하지 않습니다. Secrets Manager는 Credits 대시보드에 표시되지만 베타 기간이 끝날 때까지 사용량 데이터가 표시되지 않습니다.

비과금 사용량#

히스토리
  • GitLab 19.5에서 도입되었습니다.
  • 비과금 사용량이 GitLab 19.6에서 Usage by user, Usage by product 및 사용자 드릴다운 보기에 추가되었습니다.

비과금 사용량은 프로모션으로 충당되는 사용량처럼 GitLab이 과금하지 않는 크레딧 소비입니다. 대시보드는 다음 항목에 비과금 사용량을 포함해 집계합니다.

  • Total usage, Daily average usage, Peak day usage 카드.
  • Usage by user 탭. 각 사용자의 Credits used 값은 과금 크레딧과 비과금 크레딧을 합한 값입니다. 비과금 사용량만 있는 사용자도 목록에 표시됩니다.
  • Usage by product 탭(각 제품의 Share 포함).
  • 사용자 드릴다운 보기의 Total credits used 카드와 사용 이벤트 목록.

Total credit usage 차트의 Billable 값은 과금 크레딧만 집계하므로 Customers Portal 대시보드와 일치합니다.

Total credit usage 차트에는 다음이 표시됩니다.

  • Billable: 사용한 과금 크레딧 수
  • Non-billable: 사용한 비과금 크레딧 수. 선택한 기간에 비과금 사용량이 포함된 경우에만 표시됩니다.
  • Stacked bars: 일별 사용 크레딧이며, Billable usage와 Non-billable usage 사유가 별도 계열로 표시됩니다.

차트에는 다음 비과금 사용량 계열이 표시됩니다.

계열 설명
Non-billable usage (Promotional) 프로모션으로 충당되는 사용량입니다.
Non-billable usage (Beta) 아직 과금 대상이 아닌 기능의 사용량입니다.
Non-billable usage (Other) 그 밖의 사유로 과금되지 않은 사용량입니다.

차트에는 선택한 기간에 해당하는 사용 사유만 표시됩니다. 비과금 사용량 데이터를 일시적으로 사용할 수 없으면 대시보드에 과금 사용량만 표시됩니다.

GitLab Orbit 사용량#

히스토리
  • GitLab Orbit 사용량이 GitLab 19.5에서 도입되었습니다.

GitLab Orbit 사용량은 대시보드에 Orbit 제품으로 표시됩니다. GitLab Orbit API에 대한 쿼리 하나가 사용 이벤트 하나입니다.

Products 드롭다운 목록은 GitLab Orbit 사용량을 각 쿼리의 출처별로 묶어 보여 줍니다.

출처 설명
Orbit - Duo Agent Platform GitLab Duo Agent Platform 에이전트와 플로에서 보낸 쿼리입니다.
Orbit - MCP 다른 에이전트가 GitLab Orbit MCP 엔드포인트로 보낸 쿼리입니다.
Orbit - REST GitLab Orbit CLI 가 REST API 로 보낸 쿼리입니다.
Orbit - Frontend 쿼리 편집기가 있는 GitLab Orbit 대시보드에서 보낸 쿼리입니다.
Orbit - Code Intelligence GitLab의 코드 탐색에서 보낸 쿼리입니다.

프로모션으로 충당되는 GitLab Orbit 사용량은 Total credit usage 차트에 **Non-billable usage (Promotional)**로 표시됩니다.

사용량 데이터 내보내기에서 GitLab Orbit 이벤트에는 프로젝트가 없습니다. 쿼리 하나가 여러 프로젝트에 걸칠 수 있기 때문입니다.

GitLab Credits 대시보드 보기#

히스토리
  • 과거 사용 기간 선택 기능이 GitLab 18.11에서 도입되었습니다.

사전 요구 사항:

  • 자세한 사용량 정보를 보려면 청구 계정 관리자여야 합니다.
  1. Customers Portal에 로그인합니다.
  2. 해당 구독 옆에서 GitLab Credits dashboard를 선택합니다.
  3. 선택 사항. 이전 달을 보려면 Usage period 드롭다운 목록에서 보려는 기간을 선택합니다.
  4. 선택 사항. 결과를 User 또는 Total credits used 기준으로 정렬하려면 해당 열을 선택합니다.

사전 요구 사항:

  • 그룹의 Owner 권한이 있어야 합니다.
  1. 상단 표시줄에서 Search or go to를 선택하고 최상위 그룹을 찾습니다.
  2. Settings > GitLab Credits를 선택합니다.
  3. 선택 사항. 결과를 User 또는 Total credits used 기준으로 정렬하려면 해당 열을 선택합니다.

사전 요구 사항:

  • 관리자여야 합니다.
  • 인스턴스가 구독 데이터를 GitLab과 동기화해야 합니다.
  1. 오른쪽 위 모서리에서 Admin을 선택합니다.
  2. 왼쪽 사이드바에서 GitLab Credits를 선택합니다.
  3. 선택 사항. 결과를 User 또는 Total credits used 기준으로 정렬하려면 해당 열을 선택합니다.

기본적으로 GitLab Credits 대시보드에는 개별 사용자 데이터가 표시되지 않습니다. 표시하려면 그룹 또는 인스턴스에서 이 설정을 활성화해야 합니다.

내 GitLab Credits 사용량 보기#

히스토리
  • GitLab 19.5에서 도입되었습니다.
  • 비과금 사용량이 GitLab 19.6에서 도입되었습니다.

Your GitLab Credits usage 페이지에서 최상위 그룹에서 소비한 GitLab Credits를 추적할 수 있습니다. 이 대시보드는 크레딧 소비량만 보고합니다. 남은 크레딧이나 크레딧 한도는 표시하지 않습니다.

Your GitLab Credits usage에는 다음이 표시됩니다.

  • 현재 청구 기간의 사용량(과금 및 비과금).
  • 선택한 날짜 범위와 제품에 대한 일별 크레딧 소비량 차트. 차트에는 과금 사용량과 비과금 사용량이 그룹 대시보드와 같은 사유의 별도 계열로 표시됩니다.
  • Total usage: 선택한 날짜 범위와 제품에서 사용한 크레딧 총량(과금 및 비과금).
  • Daily average usage: 선택한 날짜 범위와 제품에서 하루 동안 사용한 크레딧의 평균(과금 및 비과금).
  • Peak day usage: 선택한 날짜 범위와 제품에서 하루 동안 소비한 최대 크레딧(과금 및 비과금).

비과금 사용량 데이터를 일시적으로 사용할 수 없으면 페이지에 과금 사용량만 표시됩니다.

사전 요구 사항:

  • GitLab Credits가 포함된 구독이 있는 최상위 그룹의 구성원이어야 합니다.

GitLab Credits 사용량을 보려면 다음을 수행합니다.

  1. 오른쪽 위 모서리에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. 왼쪽 사이드바에서 GitLab Credits를 선택합니다.
  4. 여러 그룹의 구성원이면 Group 드롭다운 목록에서 최상위 그룹을 선택합니다.
  5. 선택 사항. Date range 드롭다운 목록에서 사용량을 볼 날짜 범위를 선택합니다. 기본값은 현재 달입니다.
  6. 선택 사항. Products 드롭다운 목록에서 포함할 제품을 선택합니다.

사람이 아닌 주체의 사용량#

히스토리
  • GitLab 19.0에서 도입되었습니다.

크레딧은 기능이 실행되는 방식에 따라 사람 또는 사람이 아닌 주체가 소비하며, 청구 방식도 다릅니다. 자세한 내용은 크레딧 사용량의 청구 주체를 참고합니다.

크레딧이 어디에서 소비되는지 파악할 수 있도록 GitLab Credits 대시보드의 Usage by user 탭은 사람이 아닌 주체를 나타내는 행 옆에 Automated flow 배지를 표시합니다. 배지가 없는 행은 사람 사용자를 나타냅니다. 사람 사용자의 행에는 그 사용자가 시작한 플로의 사용량도 포함될 수 있으며, 이 사용량은 네임스페이스에 청구됩니다.

Automated flow 배지의 표시 여부는 Display GitLab Credits user data 설정으로 제어하며, 이 설정은 그룹과 인스턴스에서 사용할 수 있습니다.

사용량 한도#

히스토리
  • GitLab 18.11에서 budget_caps_graphql_api라는 기능 플래그와 함께 도입되었습니다. 기본적으로 활성화되어 있습니다.
  • GitLab 19.3에서 일반 공급되었습니다. 기능 플래그 budget_caps_graphql_api가 제거되었습니다.

구독 수준과 사용자 수준에서 월간 GitLab Credits 한도를 설정하면 예상치 못한 초과 요금을 방지할 수 있습니다. 크레딧 소비량이 설정된 한도에 도달하면 다음 청구 기간이 시작되거나 관리자가 한도를 조정하거나 비활성화할 때까지 크레딧 기반 기능에 대한 접근이 자동으로 중지됩니다.

다음 한도 유형을 사용할 수 있습니다.

한도 유형 적용 대상 집계되는 크레딧 출처 관리 위치
구독 한도 구독의 모든 사용자 온디맨드만 Customers Portal
일괄 사용자 한도 개별 사용자(기본 한도) 사람 주체 사용량의 전체 사용자 인터페이스, GraphQL API
사용자별 재정의 특정 사용자의 포함 크레딧을 포함한 총 사용량. 일괄 한도를 재정의합니다. 따라서 사용자는 포함된 할당량과 한도 중 더 큰 값까지 소비할 수 있습니다. 사람 주체 사용량의 전체 사용자 인터페이스, GraphQL API

현재 청구 기간의 온디맨드 사용량이 설정된 한도에 도달하거나 초과하면 해당 구독 또는 인스턴스의 모든 사용자에 대해 모든 크레딧 기반 기능이 중지되고, GitLab은 청구 계정 관리자에게 이메일 알림을 보냅니다. 사용자 한도의 경우 한도에 도달한 해당 사용자만 중지됩니다.

일괄 사용자 한도와 사용자별 재정의 한도는 사용자에게 포함된 할당량을 넘는 사용량에 적용됩니다. 사용자에게 포함된 크레딧이 남아 있는 동안에는 사용량이 한도에 도달한 뒤에도 포함된 크레딧을 계속 소비할 수 있습니다. 한도는 사용자의 포함 크레딧이 모두 소진된 뒤에만 적용됩니다.

한도에 도달한 사용자는 한도가 상향되거나 다음 청구 기간이 시작될 때까지 Agent Platform 기능에 접근할 수 없습니다.

사용량 카운터는 각 청구 기간이 시작될 때 자동으로 초기화됩니다. 한도 값은 변경하지 않는 한 청구 기간이 바뀌어도 유지됩니다.

한도는 사용 가능한 가장 최근 사용량 데이터를 사용해 적용됩니다. 데이터가 실시간이 아니므로, 적용되기 전에 GitLab Credits가 제한적으로 추가 사용될 수 있습니다.

한도는 사용자가 포함된 GitLab Credits를 소비하는 것을 막지 않습니다. 적용은 사용자별로, 해당 사용자의 포함 할당량이 소진된 뒤에만 시작됩니다. 그때까지 사용자는 한도 값(0 포함)과 관계없이 GitLab Duo Agent Platform에 전체 접근 권한을 유지합니다.

포함된 잔액과 관계없이 모든 GitLab Credits 소비를 즉시 중지하려면 해당 사용자에게서 GitLab Duo 시트를 제거하거나 네임스페이스에서 GitLab Duo를 끕니다. 시트 제거와 재할당을 자동화하려면 userAddOnAssignmentRemove 및 userAddOnAssignmentCreate GraphQL 변이(mutation)를 사용합니다.

한도 값이 적용되는 방식은 한도 유형에 따라 다음과 같습니다.

  • 구독 한도는 온디맨드 사용량에만 적용됩니다. 이 한도는 모든 사용자의 포함 크레딧에 더해 구독 전체에서 허용되는 온디맨드 사용량입니다. 한도가 현재 청구 기간에 보고된 총 온디맨드 사용량보다 낮게 설정되면 다음 적용 점검에서 즉시 한도에 도달한 것으로 간주됩니다.
  • 사용자별 한도는 사용자가 직접 발생시킨 사용량에 대해, 포함 크레딧을 포함한 사용자의 총 사용량에 적용됩니다. 따라서 사용자는 포함된 할당량과 한도 중 더 큰 값까지 소비할 수 있습니다.
Note

서비스 계정으로 실행되는 GitLab Duo Agent Platform 플로의 사용량은 사용자가 아니라 네임스페이스에 청구되며, 사용자의 일괄 한도나 사용자별 재정의에 포함되지 않습니다. 이 사용량은 사용자의 Total credits used에는 계속 표시될 수 있으므로, 표시된 사용량이 한도를 초과해도 사용자가 차단되지 않을 수 있습니다. 이 사용량을 제한하려면 구독 한도를 설정하거나 사용자의 GitLab Duo 시트를 제거합니다.

GitLab Duo Agent Platform을 사용할 수 있는 사람을 제어하려면 그룹 구성원 자격을 기준으로 GitLab Duo 접근을 제한합니다. 접근 제어는 기능 접근 권한을 바꾸는 것이지 크레딧 사용량을 바꾸지 않으며, 그룹 크레딧 한도를 설정하지도 않습니다.

예시#

구독 한도의 예로, 사용자 10명이 각각 GitLab Credits 100개를 포함해 받는 구독을 가정합니다. 청구 계정 관리자가 구독 온디맨드 한도를 0으로 설정합니다.

  • 포함된 크레딧 100개를 이미 모두 사용한 사용자는 이후 사용량이 모두 온디맨드가 되므로 Agent Platform 기능이 즉시(다음 적용 점검 시) 차단됩니다.
  • 포함된 크레딧을 40개만 사용한 사용자는 Agent Platform 기능을 계속 사용하고 남은 포함 크레딧 60개를 소비할 수 있습니다. 0 한도는 아직 이 사용자에게 적용되지 않습니다.

사용자별 한도의 예로, 포함 GitLab Credits가 24개인 사용자를 가정합니다.

  • 사용자별 한도가 50이면 사용자는 총 50 크레딧을 사용한 뒤, 즉 포함된 할당량을 26 크레딧 초과한 시점에 차단됩니다.
  • 사용자별 한도가 10이면 사용자는 포함된 할당량이 소진되는 24 크레딧 사용 시점에 차단됩니다.

구독 사용량 한도 설정#

사전 요구 사항:

  • 청구 계정 관리자여야 합니다.

구독 사용량 한도를 설정하려면 다음을 수행합니다.

  1. Customers Portal에 로그인합니다.
  2. 해당 구독 옆에서 GitLab Credits dashboard를 선택합니다.
  3. Spend controls를 선택합니다.
  4. On-demand credit cap 패널에서 Set on-demand credit cap 토글을 켭니다.
  5. 청구 기간당 허용할 최대 온디맨드 GitLab Credits 수를 입력합니다.
  6. Save Changes를 선택합니다.

한도를 비활성화하려면 Set on-demand credit cap 토글을 끕니다. 비활성화하면 구독 온디맨드 크레딧 한도가 적용되지 않으며, 기존 청구 동작으로 되돌아갑니다.

GraphQL API를 사용해 사용량 한도를 확인하고 일괄 사용자 수준 한도 또는 사용자별 재정의 한도를 설정할 수 있습니다.

크레딧 한도 관리#

히스토리
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.

크레딧 한도를 관리하려면 다음을 수행합니다.

사전 요구 사항:

  • 그룹의 Owner 권한.
  1. 상단 표시줄에서 Search or go to를 선택하고 최상위 그룹을 찾습니다.
  2. Settings > GitLab Credits를 선택합니다.
  3. Credit caps를 선택합니다.

사전 요구 사항:

  • 관리자 접근 권한.
  1. 오른쪽 위 모서리에서 Admin을 선택합니다.
  2. 왼쪽 사이드바에서 GitLab Credits를 선택합니다.
  3. Credit caps를 선택합니다.

Credit caps 페이지에서 다음을 설정할 수 있습니다.

  • Flat user cap: 구독의 모든 사용자에게 적용되는 기본 크레딧 한도.
  • Per-user cap overrides: 일괄 사용자 한도를 재정의하는, 개별 사용자별 한도.

일괄 사용자 한도 설정#

모든 사용자에게 기본으로 적용되는 일괄 사용자 한도를 설정하려면 다음을 수행합니다.

  1. 사용자가 청구 기간당 소비할 수 있는 최대 GitLab Credits 수를 입력합니다.
  2. 토글을 켜서 적용을 활성화합니다.
  3. Save를 선택합니다.

사용자별 한도 재정의 설정#

개별 사용자의 한도 재정의를 추가, 업데이트, 비활성화할 수 있습니다. Per-user cap overrides 섹션은 일괄 사용자 한도 값을 저장한 경우에만 표시됩니다. 일괄 사용자 한도 적용은 꺼진 상태로 둘 수 있습니다.

사전 요구 사항:

재정의를 추가하려면 다음을 수행합니다.

  1. Add override를 선택합니다.
  2. 사용자를 한 명 이상 선택합니다.
  3. 한도 값을 설정하고 Enabled 토글을 켜거나 끕니다.
  4. Save override를 선택합니다.

재정의를 업데이트하려면 다음을 수행합니다.

  1. Per-user cap overrides에서 해당 사용자의 한도 값을 조정하고 Enabled 토글을 켜거나 끕니다.
  2. Save를 선택합니다.

재정의를 비활성화하려면 다음을 수행합니다.

  1. Per-user cap overrides에서 해당 사용자의 Enabled 토글을 끕니다.
  2. Save를 선택합니다.

재정의 일괄 업데이트#

히스토리
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.

일괄 업데이트를 사용하면 여러 사용자의 재정의를 한 번에 추가하거나 변경할 수 있습니다.

사용자의 CSV 목록을 붙여넣을 수 있으며, 이 목록은 기존 재정의 목록에 병합되어 새 레코드를 추가하거나 기존 레코드를 업데이트합니다.

입력은 쉼표로 구분된 세 개의 열을 받습니다.

열 유형 허용되는 값
username 문자열 @ 접두사가 없는 GitLab 사용자 이름(예: @jsmith가 아닌 jsmith)
cap 숫자 음수가 아닌 숫자. 소수 값에는 소수점 구분자로 .을 사용합니다(예: 0, 500, 1000.5).
enabled 불리언 true, True, TRUE, false, False, FALSE

첫 줄에 선택 사항인 헤더 행을 추가할 수 있습니다. 헤더 행은 username,cap,enabled여야 하며 대소문자를 구분하지 않습니다. 유효성 검사에 실패하거나 사용자 이름을 찾을 수 없으면 전체 업데이트가 거부되고 아무 변경 사항도 저장되지 않습니다.

헤더 행이 있는 예시:

username,cap,enabled
sidney.jones,500,true
zhang.wei,1000.5,True
alex.garcia,250,false

헤더 행이 없는 예시:

sidney.jones,500,true
zhang.wei,1000.5,True
alex.garcia,250,false

사용자별 한도 재정의를 일괄 업데이트하려면 다음을 수행합니다.

  1. Per-user cap overrides에서 Bulk update를 선택합니다.
  2. 모달에 CSV 목록을 붙여넣습니다.
  3. Save를 선택합니다.

사용 제어 상태#

히스토리
  • GitLab 18.11에서 도입되었습니다.

사용자별 크레딧 한도가 활성화되면 GitLab Credits 대시보드의 Usage by user 탭에 Usage control status 열이 표시됩니다. 이 열은 각 사용자가 크레딧 기반 기능에 접근할 수 있는지, 아니면 크레딧 한도에 도달해 차단되었는지를 보여 줍니다.

Usage control status 열은 GitLab이 해당 사용자에게 한도를 적용할 때만 Blocked usage 상태를 표시합니다. GitLab은 사용자의 포함 크레딧이 소진된 뒤에 한도를 적용합니다. 한도에 도달했지만 포함 크레딧이 남아 있는 사용자는 포함된 크레딧을 계속 소비할 수 있으므로 Regular usage 상태입니다.

이 열에는 다음 상태 중 하나가 표시됩니다.

상태 설명
Regular usage 사용자가 크레딧 한도에 도달하지 않았거나, 한도에 도달했지만 포함 크레딧이 남아 있으며, GitLab Duo Agent Platform 기능을 사용할 수 있습니다.
Blocked usage 사용자가 포함 크레딧을 모두 소진하고 사용자별 한도에 도달했습니다. 한도는 구독의 모든 사용자에게 설정된 일괄 사용자 한도이거나, 해당 사용자에게 개별로 설정된 사용자별 재정의 한도입니다.

대시보드는 어떤 유형의 한도가 사용자를 차단했는지 표시하지 않습니다. 한도 유형을 확인하려면 GraphQL API를 사용합니다.

Usage control status 열에는 사용자별 한도만 표시됩니다. 구독 온디맨드 한도는 개별 사용자가 아니라 구독 전체에 적용되므로 이 열에 나열되지 않습니다.

이 상태는 사용자가 직접 발생시킨 사용량만 반영합니다. Automated flow 배지가 있는 행은 사람이 아닌 주체를 나타내며, 사용자별 한도가 적용되지 않으므로 Blocked usage가 표시되지 않습니다.

크레딧 한도에 도달한 사용자 차단 해제#

현재 사용량보다 높은 사용자별 재정의 한도를 설정하면 차단된 사용자의 접근 권한을 복원할 수 있습니다.

재정의가 있는 사용자의 차단을 해제하려면 다음을 수행합니다.

  1. Credit caps 페이지로 이동합니다.
  2. Per-user cap overrides에서 해당 사용자의 한도 값을 더 높게 설정합니다.
  3. Save를 선택합니다.

재정의가 없는 사용자의 차단을 해제하려면 현재 사용량보다 높은 한도 값으로 사용자별 한도 재정의를 설정합니다.

한도를 업데이트하면 사용자의 상태가 Regular usage로 바뀌고 크레딧 기반 기능을 다시 사용할 수 있습니다.

사용자 크레딧 사용량 세부 정보 보기#

히스토리
  • GitLab Duo Agent Platform 세션 세부 정보 링크가 GitLab 18.10에서 도입되었습니다.
  • 비과금 사용 이벤트가 GitLab 19.6에서 도입되었습니다.

드릴다운 보기에서 사용자의 개별 사용 이벤트를 보려면 다음을 수행합니다.

  1. GitLab Credits 대시보드에서 Usage by user 탭을 선택합니다.
  2. User 열에서 보려는 사용자를 선택합니다.
  3. 세션 세부 정보를 보려면 Action 열에서 보려는 작업을 선택합니다.
  4. 선택 사항. 특정 플로의 이벤트만 보려면 Flow 드롭다운 목록에서 포함할 플로를 선택합니다.

사용자 보기 페이지에서는 다음과 같이 표시됩니다.

  • Total credits used 카드와 이벤트 목록에 비과금 사용량이 포함됩니다.
  • Flow 드롭다운 목록에는 사용자가 과금 여부와 관계없이 사용한 플로가 포함됩니다.
  • Action 열에서 비과금 이벤트에는 과금되지 않은 사유가 담긴 배지가 표시됩니다. 예를 들어 **Non-billable usage (Promotional)**입니다.
Note

세션 링크는 프로젝트에서 발생했고 연결된 세션 ID 가 있는 GitLab Duo Agent Platform 사용 이벤트에만 제공됩니다. 그룹에서 발생한 사용 이벤트, 레거시 이벤트, Agent Platform 밖의 작업에는 링크가 없습니다.

사용량 데이터 내보내기#

히스토리
  • GitLab 18.10에서 도입되었습니다.
  • 이벤트별 상세 파일이 포함된 백그라운드 내보내기가 GitLab 19.4에서 도입되었습니다.

Customers Portal에서 구독의 크레딧 사용량 데이터를 내보낼 수 있습니다. 내보내기는 백그라운드에서 실행되며, GitLab이 결과를 내려받을 수 있는 링크를 이메일로 보냅니다. 다운로드 링크는 7일 후 만료됩니다.

다운로드 파일은 CSV 파일 두 개가 들어 있는 ZIP 파일입니다.

  • 선택한 기간의 일별 사용 이벤트와 사용한 크레딧을 나열한 일별 요약 파일.
  • 과금 이벤트마다 한 행씩 있는 이벤트별 파일. 제품, 플로 유형, 세션, 사용자 ID, 네임스페이스, 프로젝트, 사용한 크레딧, 토큰 수가 포함됩니다.

내보내기 한 번은 최대 31일 기간을 다룹니다.

사전 요구 사항:

  • 청구 계정 관리자여야 합니다.
  1. Customers Portal에 로그인합니다.
  2. 해당 구독 옆에서 GitLab Credits dashboard를 선택합니다.
  3. Usage period 드롭다운 목록에서 데이터를 내보낼 기간을 선택합니다.
  4. Export usage data를 선택합니다.

GitLab Credits 대시보드

GitLab v19.6
Tier: Premium, Ultimate
Offering: GitLab.com
원문 보기

요약

GitLab Credits 대시보드는 GitLab Credits 사용량에 관한 정보를 표시합니다. 크레딧 소비 관리를 돕기 위해 GitLab은 청구 계정에 연결된 Customers Portal 사용자에게 다음 정보를 이메일로 보냅니다.

공식 파트너 견적·라이선스 상담

인포그랩은 GitLab 공식 파트너입니다. 라이선스 견적, 갱신, 도입 상담은 인포그랩에 문의하세요. 라이선스 상담 신청 →

히스토리
  • GitLab 18.7에서 도입되었습니다.
  • 결과 정렬 기능이 GitLab 18.10에서 도입되었습니다.

GitLab Credits 대시보드는 GitLab Credits 사용량에 관한 정보를 표시합니다. 대시보드에서 크레딧 소비량을 모니터링하고, 추세를 추적하며, 사용 패턴을 파악할 수 있습니다.

크레딧 소비 관리를 돕기 위해 GitLab은 청구 계정에 연결된 Customers Portal 사용자에게 다음 정보를 이메일로 보냅니다.

  • 월간 크레딧 사용량 요약
  • 크레딧 사용량이 50%, 80%, 100%에 도달했을 때의 알림

대시보드는 Customers Portal과 GitLab에서 접근할 수 있습니다. GitLab Dedicated에서는 Customers Portal과 인스턴스 관리자에게 대시보드가 제공됩니다. 그룹 및 개인 크레딧 사용량 보기는 GitLab.com에서만 사용할 수 있습니다.

Note

사용량 데이터는 실시간으로 표시되지 않습니다. 데이터가 대시보드에 주기적으로 동기화되므로, 사용량 데이터는 실제 소비 후 몇 시간 이내에 표시됩니다. 즉, 대시보드에는 최근 사용량이 표시되지만 최근 몇 시간 동안 수행한 작업은 반영되지 않을 수 있습니다.

Customers Portal에서 보기#

Customers Portal의 GitLab Credits 대시보드는 사용량과 비용을 가장 자세히 보여 줍니다.

대시보드에서 사용한 크레딧은 사용 가능한 크레딧에서 차감된 양을 나타냅니다. 초과 사용분(온디맨드 크레딧)의 경우, 사용 청구 약관에 동의했다면 사용한 크레딧은 나중에 지불할 온디맨드 사용량을 나타냅니다.

대시보드에는 주요 지표를 요약한 카드가 표시됩니다.

  • Current month usage: 이번 달에 사용한 GitLab Credits 총량입니다(월간 커밋이 있는 경우).
  • Included credits: 구독에 포함된 크레딧 총량입니다(월간 커밋이 있는 경우).
  • Committed credits: 월간 커밋 풀의 크레딧입니다(해당하는 경우).
  • Monthly waivers: 면제분으로 남은 크레딧입니다(해당하는 경우).
  • On-demand usage: 포함된 크레딧과 커밋된 크레딧을 초과해 소비한 크레딧입니다. 면제 크레딧이 모든 온디맨드 크레딧을 상쇄할 만큼 충분하면 GitLab Credits 대시보드는 On-Demand 카드를 숨기고 Monthly Waiver 카드를 대신 표시합니다.
  • Usage control status: 사용자별 크레딧 한도에 도달해 개별 사용자의 Agent Platform 접근이 차단되었는지 여부입니다.

GitLab에서 보기#

히스토리
  • Secrets Manager 사용량이 GitLab 19.1에서 도입되었습니다.
Note

Security Review Flow, Business Logic Security Analyzer와 같은 일부 사전 출시 기능은 과금 대상이며 GitLab Credits 요금이 부과됩니다.

GitLab의 GitLab Credits 대시보드는 조직의 크레딧 사용 현황을 운영 관점에서 보여 줍니다. 대시보드에서 어떤 사용자, 그룹 또는 프로젝트가 사용량을 늘리고 있는지 파악하고, 리소스 배분에 관한 판단을 내릴 수 있습니다.

대시보드에는 다음 정보가 표시됩니다.

  • Organization usage: GitLab 인스턴스 또는 그룹 전체의 총 크레딧 사용량(과금 및 비과금), 활성 사용자, 일일 평균 크레딧, 최대 사용일 사용량
  • Total credit usage: 모든 제품에 걸친 일별 과금 및 비과금 크레딧 사용량(누적 막대 차트로 표시)
  • Usage by user: 사용자별 크레딧 사용량(과금 및 비과금)
  • User drill-down view: 비과금 이벤트를 포함한 사용자별 개별 사용 이벤트와, 크레딧 기반 기능별 세션 세부 정보 링크
  • Usage by product: 크레딧 기반 기능별 크레딧 사용량(과금 및 비과금)과 전체 크레딧 사용량 대비 비율
Note

GitLab Secrets Manager가 베타인 동안에는 GitLab이 사용량을 과금하지 않습니다. Secrets Manager는 Credits 대시보드에 표시되지만 베타 기간이 끝날 때까지 사용량 데이터가 표시되지 않습니다.

비과금 사용량#

히스토리
  • GitLab 19.5에서 도입되었습니다.
  • 비과금 사용량이 GitLab 19.6에서 Usage by user, Usage by product 및 사용자 드릴다운 보기에 추가되었습니다.

비과금 사용량은 프로모션으로 충당되는 사용량처럼 GitLab이 과금하지 않는 크레딧 소비입니다. 대시보드는 다음 항목에 비과금 사용량을 포함해 집계합니다.

  • Total usage, Daily average usage, Peak day usage 카드.
  • Usage by user 탭. 각 사용자의 Credits used 값은 과금 크레딧과 비과금 크레딧을 합한 값입니다. 비과금 사용량만 있는 사용자도 목록에 표시됩니다.
  • Usage by product 탭(각 제품의 Share 포함).
  • 사용자 드릴다운 보기의 Total credits used 카드와 사용 이벤트 목록.

Total credit usage 차트의 Billable 값은 과금 크레딧만 집계하므로 Customers Portal 대시보드와 일치합니다.

Total credit usage 차트에는 다음이 표시됩니다.

  • Billable: 사용한 과금 크레딧 수
  • Non-billable: 사용한 비과금 크레딧 수. 선택한 기간에 비과금 사용량이 포함된 경우에만 표시됩니다.
  • Stacked bars: 일별 사용 크레딧이며, Billable usage와 Non-billable usage 사유가 별도 계열로 표시됩니다.

차트에는 다음 비과금 사용량 계열이 표시됩니다.

계열 설명
Non-billable usage (Promotional) 프로모션으로 충당되는 사용량입니다.
Non-billable usage (Beta) 아직 과금 대상이 아닌 기능의 사용량입니다.
Non-billable usage (Other) 그 밖의 사유로 과금되지 않은 사용량입니다.

차트에는 선택한 기간에 해당하는 사용 사유만 표시됩니다. 비과금 사용량 데이터를 일시적으로 사용할 수 없으면 대시보드에 과금 사용량만 표시됩니다.

GitLab Orbit 사용량#

히스토리
  • GitLab Orbit 사용량이 GitLab 19.5에서 도입되었습니다.

GitLab Orbit 사용량은 대시보드에 Orbit 제품으로 표시됩니다. GitLab Orbit API에 대한 쿼리 하나가 사용 이벤트 하나입니다.

Products 드롭다운 목록은 GitLab Orbit 사용량을 각 쿼리의 출처별로 묶어 보여 줍니다.

출처 설명
Orbit - Duo Agent Platform GitLab Duo Agent Platform 에이전트와 플로에서 보낸 쿼리입니다.
Orbit - MCP 다른 에이전트가 GitLab Orbit MCP 엔드포인트로 보낸 쿼리입니다.
Orbit - REST GitLab Orbit CLI 가 REST API 로 보낸 쿼리입니다.
Orbit - Frontend 쿼리 편집기가 있는 GitLab Orbit 대시보드에서 보낸 쿼리입니다.
Orbit - Code Intelligence GitLab의 코드 탐색에서 보낸 쿼리입니다.

프로모션으로 충당되는 GitLab Orbit 사용량은 Total credit usage 차트에 **Non-billable usage (Promotional)**로 표시됩니다.

사용량 데이터 내보내기에서 GitLab Orbit 이벤트에는 프로젝트가 없습니다. 쿼리 하나가 여러 프로젝트에 걸칠 수 있기 때문입니다.

GitLab Credits 대시보드 보기#

히스토리
  • 과거 사용 기간 선택 기능이 GitLab 18.11에서 도입되었습니다.

사전 요구 사항:

  • 자세한 사용량 정보를 보려면 청구 계정 관리자여야 합니다.
  1. Customers Portal에 로그인합니다.
  2. 해당 구독 옆에서 GitLab Credits dashboard를 선택합니다.
  3. 선택 사항. 이전 달을 보려면 Usage period 드롭다운 목록에서 보려는 기간을 선택합니다.
  4. 선택 사항. 결과를 User 또는 Total credits used 기준으로 정렬하려면 해당 열을 선택합니다.

사전 요구 사항:

  • 그룹의 Owner 권한이 있어야 합니다.
  1. 상단 표시줄에서 Search or go to를 선택하고 최상위 그룹을 찾습니다.
  2. Settings > GitLab Credits를 선택합니다.
  3. 선택 사항. 결과를 User 또는 Total credits used 기준으로 정렬하려면 해당 열을 선택합니다.

사전 요구 사항:

  • 관리자여야 합니다.
  • 인스턴스가 구독 데이터를 GitLab과 동기화해야 합니다.
  1. 오른쪽 위 모서리에서 Admin을 선택합니다.
  2. 왼쪽 사이드바에서 GitLab Credits를 선택합니다.
  3. 선택 사항. 결과를 User 또는 Total credits used 기준으로 정렬하려면 해당 열을 선택합니다.

기본적으로 GitLab Credits 대시보드에는 개별 사용자 데이터가 표시되지 않습니다. 표시하려면 그룹 또는 인스턴스에서 이 설정을 활성화해야 합니다.

내 GitLab Credits 사용량 보기#

히스토리
  • GitLab 19.5에서 도입되었습니다.
  • 비과금 사용량이 GitLab 19.6에서 도입되었습니다.

Your GitLab Credits usage 페이지에서 최상위 그룹에서 소비한 GitLab Credits를 추적할 수 있습니다. 이 대시보드는 크레딧 소비량만 보고합니다. 남은 크레딧이나 크레딧 한도는 표시하지 않습니다.

Your GitLab Credits usage에는 다음이 표시됩니다.

  • 현재 청구 기간의 사용량(과금 및 비과금).
  • 선택한 날짜 범위와 제품에 대한 일별 크레딧 소비량 차트. 차트에는 과금 사용량과 비과금 사용량이 그룹 대시보드와 같은 사유의 별도 계열로 표시됩니다.
  • Total usage: 선택한 날짜 범위와 제품에서 사용한 크레딧 총량(과금 및 비과금).
  • Daily average usage: 선택한 날짜 범위와 제품에서 하루 동안 사용한 크레딧의 평균(과금 및 비과금).
  • Peak day usage: 선택한 날짜 범위와 제품에서 하루 동안 소비한 최대 크레딧(과금 및 비과금).

비과금 사용량 데이터를 일시적으로 사용할 수 없으면 페이지에 과금 사용량만 표시됩니다.

사전 요구 사항:

  • GitLab Credits가 포함된 구독이 있는 최상위 그룹의 구성원이어야 합니다.

GitLab Credits 사용량을 보려면 다음을 수행합니다.

  1. 오른쪽 위 모서리에서 아바타를 선택합니다.
  2. Preferences를 선택합니다.
  3. 왼쪽 사이드바에서 GitLab Credits를 선택합니다.
  4. 여러 그룹의 구성원이면 Group 드롭다운 목록에서 최상위 그룹을 선택합니다.
  5. 선택 사항. Date range 드롭다운 목록에서 사용량을 볼 날짜 범위를 선택합니다. 기본값은 현재 달입니다.
  6. 선택 사항. Products 드롭다운 목록에서 포함할 제품을 선택합니다.

사람이 아닌 주체의 사용량#

히스토리
  • GitLab 19.0에서 도입되었습니다.

크레딧은 기능이 실행되는 방식에 따라 사람 또는 사람이 아닌 주체가 소비하며, 청구 방식도 다릅니다. 자세한 내용은 크레딧 사용량의 청구 주체를 참고합니다.

크레딧이 어디에서 소비되는지 파악할 수 있도록 GitLab Credits 대시보드의 Usage by user 탭은 사람이 아닌 주체를 나타내는 행 옆에 Automated flow 배지를 표시합니다. 배지가 없는 행은 사람 사용자를 나타냅니다. 사람 사용자의 행에는 그 사용자가 시작한 플로의 사용량도 포함될 수 있으며, 이 사용량은 네임스페이스에 청구됩니다.

Automated flow 배지의 표시 여부는 Display GitLab Credits user data 설정으로 제어하며, 이 설정은 그룹과 인스턴스에서 사용할 수 있습니다.

사용량 한도#

히스토리
  • GitLab 18.11에서 budget_caps_graphql_api라는 기능 플래그와 함께 도입되었습니다. 기본적으로 활성화되어 있습니다.
  • GitLab 19.3에서 일반 공급되었습니다. 기능 플래그 budget_caps_graphql_api가 제거되었습니다.

구독 수준과 사용자 수준에서 월간 GitLab Credits 한도를 설정하면 예상치 못한 초과 요금을 방지할 수 있습니다. 크레딧 소비량이 설정된 한도에 도달하면 다음 청구 기간이 시작되거나 관리자가 한도를 조정하거나 비활성화할 때까지 크레딧 기반 기능에 대한 접근이 자동으로 중지됩니다.

다음 한도 유형을 사용할 수 있습니다.

한도 유형 적용 대상 집계되는 크레딧 출처 관리 위치
구독 한도 구독의 모든 사용자 온디맨드만 Customers Portal
일괄 사용자 한도 개별 사용자(기본 한도) 사람 주체 사용량의 전체 사용자 인터페이스, GraphQL API
사용자별 재정의 특정 사용자의 포함 크레딧을 포함한 총 사용량. 일괄 한도를 재정의합니다. 따라서 사용자는 포함된 할당량과 한도 중 더 큰 값까지 소비할 수 있습니다. 사람 주체 사용량의 전체 사용자 인터페이스, GraphQL API

현재 청구 기간의 온디맨드 사용량이 설정된 한도에 도달하거나 초과하면 해당 구독 또는 인스턴스의 모든 사용자에 대해 모든 크레딧 기반 기능이 중지되고, GitLab은 청구 계정 관리자에게 이메일 알림을 보냅니다. 사용자 한도의 경우 한도에 도달한 해당 사용자만 중지됩니다.

일괄 사용자 한도와 사용자별 재정의 한도는 사용자에게 포함된 할당량을 넘는 사용량에 적용됩니다. 사용자에게 포함된 크레딧이 남아 있는 동안에는 사용량이 한도에 도달한 뒤에도 포함된 크레딧을 계속 소비할 수 있습니다. 한도는 사용자의 포함 크레딧이 모두 소진된 뒤에만 적용됩니다.

한도에 도달한 사용자는 한도가 상향되거나 다음 청구 기간이 시작될 때까지 Agent Platform 기능에 접근할 수 없습니다.

사용량 카운터는 각 청구 기간이 시작될 때 자동으로 초기화됩니다. 한도 값은 변경하지 않는 한 청구 기간이 바뀌어도 유지됩니다.

한도는 사용 가능한 가장 최근 사용량 데이터를 사용해 적용됩니다. 데이터가 실시간이 아니므로, 적용되기 전에 GitLab Credits가 제한적으로 추가 사용될 수 있습니다.

한도는 사용자가 포함된 GitLab Credits를 소비하는 것을 막지 않습니다. 적용은 사용자별로, 해당 사용자의 포함 할당량이 소진된 뒤에만 시작됩니다. 그때까지 사용자는 한도 값(0 포함)과 관계없이 GitLab Duo Agent Platform에 전체 접근 권한을 유지합니다.

포함된 잔액과 관계없이 모든 GitLab Credits 소비를 즉시 중지하려면 해당 사용자에게서 GitLab Duo 시트를 제거하거나 네임스페이스에서 GitLab Duo를 끕니다. 시트 제거와 재할당을 자동화하려면 userAddOnAssignmentRemove 및 userAddOnAssignmentCreate GraphQL 변이(mutation)를 사용합니다.

한도 값이 적용되는 방식은 한도 유형에 따라 다음과 같습니다.

  • 구독 한도는 온디맨드 사용량에만 적용됩니다. 이 한도는 모든 사용자의 포함 크레딧에 더해 구독 전체에서 허용되는 온디맨드 사용량입니다. 한도가 현재 청구 기간에 보고된 총 온디맨드 사용량보다 낮게 설정되면 다음 적용 점검에서 즉시 한도에 도달한 것으로 간주됩니다.
  • 사용자별 한도는 사용자가 직접 발생시킨 사용량에 대해, 포함 크레딧을 포함한 사용자의 총 사용량에 적용됩니다. 따라서 사용자는 포함된 할당량과 한도 중 더 큰 값까지 소비할 수 있습니다.
Note

서비스 계정으로 실행되는 GitLab Duo Agent Platform 플로의 사용량은 사용자가 아니라 네임스페이스에 청구되며, 사용자의 일괄 한도나 사용자별 재정의에 포함되지 않습니다. 이 사용량은 사용자의 Total credits used에는 계속 표시될 수 있으므로, 표시된 사용량이 한도를 초과해도 사용자가 차단되지 않을 수 있습니다. 이 사용량을 제한하려면 구독 한도를 설정하거나 사용자의 GitLab Duo 시트를 제거합니다.

GitLab Duo Agent Platform을 사용할 수 있는 사람을 제어하려면 그룹 구성원 자격을 기준으로 GitLab Duo 접근을 제한합니다. 접근 제어는 기능 접근 권한을 바꾸는 것이지 크레딧 사용량을 바꾸지 않으며, 그룹 크레딧 한도를 설정하지도 않습니다.

예시#

구독 한도의 예로, 사용자 10명이 각각 GitLab Credits 100개를 포함해 받는 구독을 가정합니다. 청구 계정 관리자가 구독 온디맨드 한도를 0으로 설정합니다.

  • 포함된 크레딧 100개를 이미 모두 사용한 사용자는 이후 사용량이 모두 온디맨드가 되므로 Agent Platform 기능이 즉시(다음 적용 점검 시) 차단됩니다.
  • 포함된 크레딧을 40개만 사용한 사용자는 Agent Platform 기능을 계속 사용하고 남은 포함 크레딧 60개를 소비할 수 있습니다. 0 한도는 아직 이 사용자에게 적용되지 않습니다.

사용자별 한도의 예로, 포함 GitLab Credits가 24개인 사용자를 가정합니다.

  • 사용자별 한도가 50이면 사용자는 총 50 크레딧을 사용한 뒤, 즉 포함된 할당량을 26 크레딧 초과한 시점에 차단됩니다.
  • 사용자별 한도가 10이면 사용자는 포함된 할당량이 소진되는 24 크레딧 사용 시점에 차단됩니다.

구독 사용량 한도 설정#

사전 요구 사항:

  • 청구 계정 관리자여야 합니다.

구독 사용량 한도를 설정하려면 다음을 수행합니다.

  1. Customers Portal에 로그인합니다.
  2. 해당 구독 옆에서 GitLab Credits dashboard를 선택합니다.
  3. Spend controls를 선택합니다.
  4. On-demand credit cap 패널에서 Set on-demand credit cap 토글을 켭니다.
  5. 청구 기간당 허용할 최대 온디맨드 GitLab Credits 수를 입력합니다.
  6. Save Changes를 선택합니다.

한도를 비활성화하려면 Set on-demand credit cap 토글을 끕니다. 비활성화하면 구독 온디맨드 크레딧 한도가 적용되지 않으며, 기존 청구 동작으로 되돌아갑니다.

GraphQL API를 사용해 사용량 한도를 확인하고 일괄 사용자 수준 한도 또는 사용자별 재정의 한도를 설정할 수 있습니다.

크레딧 한도 관리#

히스토리
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.

크레딧 한도를 관리하려면 다음을 수행합니다.

사전 요구 사항:

  • 그룹의 Owner 권한.
  1. 상단 표시줄에서 Search or go to를 선택하고 최상위 그룹을 찾습니다.
  2. Settings > GitLab Credits를 선택합니다.
  3. Credit caps를 선택합니다.

사전 요구 사항:

  • 관리자 접근 권한.
  1. 오른쪽 위 모서리에서 Admin을 선택합니다.
  2. 왼쪽 사이드바에서 GitLab Credits를 선택합니다.
  3. Credit caps를 선택합니다.

Credit caps 페이지에서 다음을 설정할 수 있습니다.

  • Flat user cap: 구독의 모든 사용자에게 적용되는 기본 크레딧 한도.
  • Per-user cap overrides: 일괄 사용자 한도를 재정의하는, 개별 사용자별 한도.

일괄 사용자 한도 설정#

모든 사용자에게 기본으로 적용되는 일괄 사용자 한도를 설정하려면 다음을 수행합니다.

  1. 사용자가 청구 기간당 소비할 수 있는 최대 GitLab Credits 수를 입력합니다.
  2. 토글을 켜서 적용을 활성화합니다.
  3. Save를 선택합니다.

사용자별 한도 재정의 설정#

개별 사용자의 한도 재정의를 추가, 업데이트, 비활성화할 수 있습니다. Per-user cap overrides 섹션은 일괄 사용자 한도 값을 저장한 경우에만 표시됩니다. 일괄 사용자 한도 적용은 꺼진 상태로 둘 수 있습니다.

사전 요구 사항:

재정의를 추가하려면 다음을 수행합니다.

  1. Add override를 선택합니다.
  2. 사용자를 한 명 이상 선택합니다.
  3. 한도 값을 설정하고 Enabled 토글을 켜거나 끕니다.
  4. Save override를 선택합니다.

재정의를 업데이트하려면 다음을 수행합니다.

  1. Per-user cap overrides에서 해당 사용자의 한도 값을 조정하고 Enabled 토글을 켜거나 끕니다.
  2. Save를 선택합니다.

재정의를 비활성화하려면 다음을 수행합니다.

  1. Per-user cap overrides에서 해당 사용자의 Enabled 토글을 끕니다.
  2. Save를 선택합니다.

재정의 일괄 업데이트#

히스토리
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.

일괄 업데이트를 사용하면 여러 사용자의 재정의를 한 번에 추가하거나 변경할 수 있습니다.

사용자의 CSV 목록을 붙여넣을 수 있으며, 이 목록은 기존 재정의 목록에 병합되어 새 레코드를 추가하거나 기존 레코드를 업데이트합니다.

입력은 쉼표로 구분된 세 개의 열을 받습니다.

열 유형 허용되는 값
username 문자열 @ 접두사가 없는 GitLab 사용자 이름(예: @jsmith가 아닌 jsmith)
cap 숫자 음수가 아닌 숫자. 소수 값에는 소수점 구분자로 .을 사용합니다(예: 0, 500, 1000.5).
enabled 불리언 true, True, TRUE, false, False, FALSE

첫 줄에 선택 사항인 헤더 행을 추가할 수 있습니다. 헤더 행은 username,cap,enabled여야 하며 대소문자를 구분하지 않습니다. 유효성 검사에 실패하거나 사용자 이름을 찾을 수 없으면 전체 업데이트가 거부되고 아무 변경 사항도 저장되지 않습니다.

헤더 행이 있는 예시:

username,cap,enabled
sidney.jones,500,true
zhang.wei,1000.5,True
alex.garcia,250,false

헤더 행이 없는 예시:

sidney.jones,500,true
zhang.wei,1000.5,True
alex.garcia,250,false

사용자별 한도 재정의를 일괄 업데이트하려면 다음을 수행합니다.

  1. Per-user cap overrides에서 Bulk update를 선택합니다.
  2. 모달에 CSV 목록을 붙여넣습니다.
  3. Save를 선택합니다.

사용 제어 상태#

히스토리
  • GitLab 18.11에서 도입되었습니다.

사용자별 크레딧 한도가 활성화되면 GitLab Credits 대시보드의 Usage by user 탭에 Usage control status 열이 표시됩니다. 이 열은 각 사용자가 크레딧 기반 기능에 접근할 수 있는지, 아니면 크레딧 한도에 도달해 차단되었는지를 보여 줍니다.

Usage control status 열은 GitLab이 해당 사용자에게 한도를 적용할 때만 Blocked usage 상태를 표시합니다. GitLab은 사용자의 포함 크레딧이 소진된 뒤에 한도를 적용합니다. 한도에 도달했지만 포함 크레딧이 남아 있는 사용자는 포함된 크레딧을 계속 소비할 수 있으므로 Regular usage 상태입니다.

이 열에는 다음 상태 중 하나가 표시됩니다.

상태 설명
Regular usage 사용자가 크레딧 한도에 도달하지 않았거나, 한도에 도달했지만 포함 크레딧이 남아 있으며, GitLab Duo Agent Platform 기능을 사용할 수 있습니다.
Blocked usage 사용자가 포함 크레딧을 모두 소진하고 사용자별 한도에 도달했습니다. 한도는 구독의 모든 사용자에게 설정된 일괄 사용자 한도이거나, 해당 사용자에게 개별로 설정된 사용자별 재정의 한도입니다.

대시보드는 어떤 유형의 한도가 사용자를 차단했는지 표시하지 않습니다. 한도 유형을 확인하려면 GraphQL API를 사용합니다.

Usage control status 열에는 사용자별 한도만 표시됩니다. 구독 온디맨드 한도는 개별 사용자가 아니라 구독 전체에 적용되므로 이 열에 나열되지 않습니다.

이 상태는 사용자가 직접 발생시킨 사용량만 반영합니다. Automated flow 배지가 있는 행은 사람이 아닌 주체를 나타내며, 사용자별 한도가 적용되지 않으므로 Blocked usage가 표시되지 않습니다.

크레딧 한도에 도달한 사용자 차단 해제#

현재 사용량보다 높은 사용자별 재정의 한도를 설정하면 차단된 사용자의 접근 권한을 복원할 수 있습니다.

재정의가 있는 사용자의 차단을 해제하려면 다음을 수행합니다.

  1. Credit caps 페이지로 이동합니다.
  2. Per-user cap overrides에서 해당 사용자의 한도 값을 더 높게 설정합니다.
  3. Save를 선택합니다.

재정의가 없는 사용자의 차단을 해제하려면 현재 사용량보다 높은 한도 값으로 사용자별 한도 재정의를 설정합니다.

한도를 업데이트하면 사용자의 상태가 Regular usage로 바뀌고 크레딧 기반 기능을 다시 사용할 수 있습니다.

사용자 크레딧 사용량 세부 정보 보기#

히스토리
  • GitLab Duo Agent Platform 세션 세부 정보 링크가 GitLab 18.10에서 도입되었습니다.
  • 비과금 사용 이벤트가 GitLab 19.6에서 도입되었습니다.

드릴다운 보기에서 사용자의 개별 사용 이벤트를 보려면 다음을 수행합니다.

  1. GitLab Credits 대시보드에서 Usage by user 탭을 선택합니다.
  2. User 열에서 보려는 사용자를 선택합니다.
  3. 세션 세부 정보를 보려면 Action 열에서 보려는 작업을 선택합니다.
  4. 선택 사항. 특정 플로의 이벤트만 보려면 Flow 드롭다운 목록에서 포함할 플로를 선택합니다.

사용자 보기 페이지에서는 다음과 같이 표시됩니다.

  • Total credits used 카드와 이벤트 목록에 비과금 사용량이 포함됩니다.
  • Flow 드롭다운 목록에는 사용자가 과금 여부와 관계없이 사용한 플로가 포함됩니다.
  • Action 열에서 비과금 이벤트에는 과금되지 않은 사유가 담긴 배지가 표시됩니다. 예를 들어 **Non-billable usage (Promotional)**입니다.
Note

세션 링크는 프로젝트에서 발생했고 연결된 세션 ID 가 있는 GitLab Duo Agent Platform 사용 이벤트에만 제공됩니다. 그룹에서 발생한 사용 이벤트, 레거시 이벤트, Agent Platform 밖의 작업에는 링크가 없습니다.

사용량 데이터 내보내기#

히스토리
  • GitLab 18.10에서 도입되었습니다.
  • 이벤트별 상세 파일이 포함된 백그라운드 내보내기가 GitLab 19.4에서 도입되었습니다.

Customers Portal에서 구독의 크레딧 사용량 데이터를 내보낼 수 있습니다. 내보내기는 백그라운드에서 실행되며, GitLab이 결과를 내려받을 수 있는 링크를 이메일로 보냅니다. 다운로드 링크는 7일 후 만료됩니다.

다운로드 파일은 CSV 파일 두 개가 들어 있는 ZIP 파일입니다.

  • 선택한 기간의 일별 사용 이벤트와 사용한 크레딧을 나열한 일별 요약 파일.
  • 과금 이벤트마다 한 행씩 있는 이벤트별 파일. 제품, 플로 유형, 세션, 사용자 ID, 네임스페이스, 프로젝트, 사용한 크레딧, 토큰 수가 포함됩니다.

내보내기 한 번은 최대 31일 기간을 다룹니다.

사전 요구 사항:

  • 청구 계정 관리자여야 합니다.
  1. Customers Portal에 로그인합니다.
  2. 해당 구독 옆에서 GitLab Credits dashboard를 선택합니다.
  3. Usage period 드롭다운 목록에서 데이터를 내보낼 기간을 선택합니다.
  4. Export usage data를 선택합니다.