개요#

청구 가능 이벤트 스키마는 고객 청구에 기여하는 사용 이벤트를 추적하기 위한 구조와 필드를 정의합니다. 이 스키마는 청구 목적으로 표준화된 사용 데이터를 캡처하기 위해 GitLab.com, Dedicated, Self-Managed 배포 전반에 걸쳐 사용됩니다.

이 문서는 billable_usage jsonschema를 기반으로 한 청구 가능 사용 이벤트 스키마의 참조로 사용됩니다.

필드 설명#

이벤트 식별 필드#

청구 가능 이벤트를 고유하게 식별하고 분류하는 필드.

인스턴스 및 환경 필드#

GitLab 배포 환경과 인스턴스를 식별하는 필드.

사용자 및 리소스 식별 필드#

청구 가능 이벤트와 관련된 사용자, 시트, 리소스를 식별하는 필드.

사용량 측정 필드#

청구를 위한 실제 사용량을 캡처하는 필드.

구현 가이드라인#

청구에 필요한 필드#

다음 필드는 청구 계산에 중요하며 모든 청구 가능 이벤트에 있어야 합니다:

• event_id: 이벤트 고유성 및 중복 제거 보장

• event_type: 청구 가능한 활동 분류

• unit_of_measure: 청구 단위 정의

• realm: 배포 모델 식별

• timestamp: 시간 기반 청구 및 분석 가능

필드 채우기 가이드라인#

• 이벤트 식별: event_id에 항상 고유한 RFC9562 UUID를 생성합니다

• 타임스탬프: ISO 8601 형식 사용 (예: 2025-11-04T10:30:00Z)

• 측정 단위: 적절한 단위 선택 (byte, second, token, request 등)

• 수량: 실제 사용량을 나타내는 음수가 아닌 비제로 숫자여야 합니다

• 메타데이터: 분석에 도움이 되지만 청구에 필요하지 않은 추가 컨텍스트에 사용합니다

GitLab Duo Agent Platform의 메타데이터 필드#

---

예시:

{
    "workflow_id": "wf_123456",
    "execution_environment": "duo_agent_platform",
    "llm_operations": [
        {
            "token_count": 5328,
            "model_id": "claude-3-7-sonnet-20250219",
            "prompt_tokens": 3150,
            "completion_tokens": 2178
        },
        {
            "token_count": 5328,
            "model_id": "claude-opus-4.1",
            "prompt_tokens": 3150,
            "completion_tokens": 2178
        }
    ],
    "orbit_called": true
}

---