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