이 페이지에서는 Google Cloud 라벨을 사용하여 Spanner 인스턴스를 구성하고 세부 비용 분석을 보는 방법을 설명합니다.
Google Cloud 라벨은 Spanner 인스턴스와 같은 개별 Google Cloud 리소스에 할당할 수 있는 키-값 쌍입니다.
라벨을 사용하면 이러한 리소스를 구성하고 필요한 세부사항으로 비용을 확인할 수 있습니다. 라벨에 대한 정보는 청구 요금을 라벨별로 분류할 수 있는 결제 시스템으로 전달됩니다. 라벨에 대해 자세히 알아보려면 라벨 개요를 참고하세요.
라벨의 일반적인 사용 사례
라벨의 일반적인 사용 사례는 다음과 같습니다.
- 팀 또는 비용 센터 라벨: 비용 회계 또는 예산 책정을 위해 서로 다른 팀 (예:
team:research및team:analytics)에서 소유하는 리소스를 구분합니다. - 환경 라벨: 개발, 테스트 또는 프로덕션 환경을 지정합니다 (예:
env:dev,env:test,env:prod). - 구성요소 라벨: 애플리케이션 구성요소 또는 워크로드 유형 (예:
component:frontend및component:backend)별로 리소스를 분류합니다. - 세분화된 인스턴스 수준 추적: Spanner 인스턴스에 자체 ID 또는 특정 식별자 (예:
instance_id:my-instance-1)를 라벨로 지정하여 결제 보고서 또는 BigQuery 쿼리에서 인스턴스별 비용을 직접 분류합니다.
요구사항 및 제약조건
Spanner 인스턴스에 적용된 라벨은 다음 요구사항을 충족해야 합니다.
- 각 인스턴스에는 최대 64개의 라벨이 있을 수 있습니다.
- 키와 값은 63자(영문 기준) 이하여야 합니다.
- 키와 값에는 소문자, 숫자, 밑줄 (
_), 대시 (-)만 사용할 수 있습니다. - 키는 소문자나 국제 문자로 시작해야 합니다. 키는 비워 둘 수 없습니다.
- 라벨의 키 부분은 단일 인스턴스에서 고유해야 합니다.
Spanner 인스턴스에 라벨 추가 및 관리
Spanner 인스턴스를 만들 때 라벨을 추가하거나 기존 인스턴스의 라벨을 업데이트할 수 있습니다.
필수 권한
Spanner 인스턴스에서 라벨을 보고 관리하려면 다음 IAM 권한이 필요합니다.
spanner.instances.getspanner.instances.update
이러한 권한은 roles/spanner.admin 역할에 포함되어 있습니다.
라벨 추가, 업데이트 또는 삭제
콘솔
Google Cloud 콘솔에서 Spanner 인스턴스 페이지로 이동합니다.
라벨을 지정할 인스턴스 옆에 있는 체크박스를 선택합니다. 정보 패널이 표시됩니다.
정보 패널에서 라벨을 선택합니다.
인스턴스의 라벨을 추가, 업데이트 또는 삭제한 다음 저장을 클릭합니다.
gcloud
라벨이 있는 Spanner 인스턴스를 만들려면 --labels 플래그와 함께 gcloud spanner instances create 명령어를 실행합니다.
gcloud spanner instances create INSTANCE_ID \
--config=INSTANCE_CONFIG \
--description=INSTANCE_NAME \
--nodes=NODE_COUNT \
--labels=KEY=VALUE,KEY=VALUE
기존 인스턴스에서 라벨을 추가하거나 업데이트하려면 --update-labels 플래그와 함께 gcloud spanner instances update 명령어를 실행합니다.
gcloud spanner instances update INSTANCE_ID \
--update-labels=KEY=VALUE,KEY=VALUE
기존 인스턴스에서 특정 라벨을 삭제하려면 --remove-labels 플래그를 사용합니다.
gcloud spanner instances update INSTANCE_ID \
--remove-labels=KEY1,KEY2
기존 인스턴스에서 모든 라벨을 삭제하려면 --clear-labels 플래그를 사용합니다.
gcloud spanner instances update INSTANCE_ID --clear-labels
Cloud Billing에서 라벨별로 Spanner 비용 분석
Spanner 인스턴스에 라벨을 적용한 후에는 라벨을 사용하여 비용을 분석할 수 있습니다. 라벨은 비용 데이터로 전달되므로 요금을 필터링하고 그룹화할 수 있습니다.
결제 보고서에서 라벨별로 그룹화된 비용 보기
Google Cloud 콘솔에서 직접 라벨 키로 그룹화된 Spanner 비용을 보고 분석할 수 있습니다.
- Google Cloud 콘솔에서 결제 섹션으로 이동합니다.
- 결제 계정을 선택하고 탐색창에서 보고서를 클릭합니다.
- 필터 패널에서 다음을 수행합니다.
- 서비스에서 Spanner를 선택하여 Spanner 데이터베이스 비용을 분리합니다.
- 그룹화 기준에서 라벨 키를 선택하고 분석할 라벨 키 (예:
environment또는instance_id)를 선택합니다.
- 차트와 비용 표가 업데이트되어 각 라벨 값 (예:
environment:prod및environment:dev또는instance_id:my-instance-1및instance_id:my-instance-2)으로 그룹화된 비용의 세부 분석이 표시됩니다.