사용량 기반 SaaS 제품의 경우 단일 Google Cloud 프로젝트에 대한 Google Cloud Marketplace 속성 사용량은 usageReportingId 필드에서 지정됩니다. 일부 시나리오에서 SaaS 제품은 고객의 조직 내에서 광범위하게 공유되고 여러 고객 프로젝트에서 사용될 수 있습니다. 보다 구체적인 비용 기여 분석을 사용하려면 사용량 기반 SaaS 제품의 사용량 보고서 작업에 선택사항 userLabels 필드를 포함하는 것이 좋습니다.
서비스가 이미 리소스 라벨 개념을 지원하는 경우 해당 라벨을 사용량 보고서에 전달하는 것이 좋습니다. 라벨은 문법 요구사항을 준수해야 합니다.
사용량 라벨
Cloud Marketplace에서 다음 라벨을 예약합니다. 이러한 라벨을 사용하여 서비스 플랫폼 내에서 사용에 대한 추가 컨텍스트를 식별할 수 있습니다. 기본적으로 사용 보고서에 이러한 라벨을 포함하는 것이 좋습니다.
| 라벨 키 | 라벨 값 | 설명> |
|---|---|---|
| cloudmarketplace.googleapis.com/resource_name | USER_SUPPLIED | 사용량 측정항목과 연결된 리소스의 이름입니다. |
| cloudmarketplace.googleapis.com/container_name | USER_SUPPLIED | 리소스 컨테이너의 이름입니다. |
라벨은 비용 보고서와 결제 내보내기를 포함한 Cloud Billing 비용 관리 도구로 전달됩니다.
사용량 라벨 지정 예시
이 예시에서는 조직이 SaaS Storage Solutions라는 스토리지 제품을 제안한다고 가정해보세요.
칼이라는 고객은 전자상거래 웹사이트의 user_profiles_db 및 products_db 데이터베이스를 호스팅하기 위해 Google Cloud 프로젝트 e-commerce-website에 대한 스토리지 서비스를 구매했습니다.
user_profiles_db에는 칼의 사이트를 방문하는 사용자에 대한 정보가 포함되어 있습니다.products_db에는 칼이 사이트에서 판매하는 제품에 대한 정보가 포함되어 있습니다.
칼에게 사용량에 대한 자세한 비용 분석을 제공하려면 userLabels 키-값 쌍을 사용하여 각 데이터베이스의 사용량 비용을 별도로 보고할 수 있습니다.
예를 들어 칼의 products_db 스토리지 사용량에 대한 비용을 보고하려면 칼의 products_db 스토리지 비용에 100단위가 소요됨을 나타내는 다음 보고서를 보내면 됩니다.
operation = {
'operationId': '<UUID>',
'operationName': 'db-total-storage',
'consumerId': 'project:carl_website',
'startTime': '<Timestamp>',
'endTime': '<Timestamp>',
'metricValues': [{
'int64Value': 100,
}],
'userLabels': {
'cloudmarketplace.googleapis.com/container_name': 'e-commerce-website',
'cloudmarketplace.googleapis.com/resource_name': 'products_db'
}
}
service.services().report(
serviceName=service_name, body={
'operations': [operation]
}).execute()
이 예시에서 service_name은 칼의 Google Cloud 프로젝트의 프로젝트 ID입니다.
userLabels 사용에 대한 자세한 예시는 SaaS Codelab을 참조하세요.