ラベルを使用して Kubernetes アプリの関連する使用量を追跡する

多くの Google Cloud Marketplace プロダクトは、お客様による Google Cloudインフラストラクチャとリソースの利用を促進します。ラベルをプロダクトに統合すると、関連する顧客の Google Cloud 使用状況という観点からプロダクトの影響に関する分析情報を Google に提供できます。Google はこの情報を使用して、影響を提示し、市場参入(GTM)投資をガイドします。

このドキュメントでは、Cloud Marketplace で提供する Kubernetes アプリのパートナー使用量トラッキングを設定する方法について説明します。

ラベル スキーマ

ラベルは、 Google Cloud リソースに割り当てることができる Key-Value ペアです。ラベルの詳細については、ラベルの概要をご覧ください。

パートナーの消費量トラッキングにラベルを使用する場合、ラベルは次の形式になります。

goog-partner-solution = SOLUTION_URN

商品の消費追跡ラベルを確認する

Cloud Marketplace で提供する各プロダクトの関連する使用量トラッキング ラベルは、Producer Portal で確認できます。ラベルを見つける手順は次のとおりです。

  1. Producer Portal で、[概要] ページに移動します。
  2. 商品リストで、使用状況を追跡する商品を見つけます。
  3. [Consumption tracking label] に表示されている値をコピーして保存します。
  4. サービスの消費量トラッキングを統合する際は、保存した消費量トラッキング ラベルを使用します。

Producer Portal の概要ページへの直接リンクは次のとおりです。

https://console.cloud.google.com/producer-portal?project=YOUR_PROJECT_ID

使用量トラッキング ラベルを Kubernetes アプリと統合する

Kubernetes アプリの使用量トラッキングを有効にするには、次の操作を行います。

  • 次の例に示すように、すべての Pod 仕様に使用量トラッキング ラベルを含めます。
  • 定義されたリソースを使用して Pod 仕様を作成します。

Terraform では、Terraform がデプロイするすべての Google Cloud リソースに適用されるデフォルトのラベルを Google プロバイダ レベルで追加できます。Terraform でデフォルトのラベルを使用する方法については、Terraform ドキュメントの Google Cloud プロバイダの構成リファレンスをご覧ください。

消費追跡ラベルの統合の例

次の例は、使用量トラッキング ラベルが追加された Kubernetes Deployment の Pod 仕様を示しています。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: example-app
  labels:
    app: example-app
spec:
  replicas: 1
  selector:
    matchLabels:
      app: example-app
  template:
    metadata:
      labels:
        app: example-app
        goog-partner-solution: isol_plb32_SOLUTION_URN
    spec:
      containers:
      - name: example-app
        image: busybox:latest
        command:
            - "/bin/sh"
            - "-c"
            - "while true; do sleep 3600; done"
        resources:
          limits:
            cpu: "500m"
            ephemeral-storage: "10Mi"
            memory: "0.5Gi"
          requests:
            cpu: "500m"
            ephemeral-storage: "10Mi"
            memory: "0.5Gi"

SOLUTION_URN は、アプリの使用状況トラッキング ラベルに置き換えます。使用状況のトラッキング ラベルを確認するには、Producer Portal の [プロダクト] テーブルでアプリを見つけます。[消費追跡ラベル] 列の値は、アプリの消費追跡ラベルです。

この例では、次の行で使用量トラッキングに必要なリソースを定義しています。

resources:
  limits:
    cpu: "500m"
    ephemeral-storage: "10Mi"
    memory: "0.5Gi"
  requests:
    cpu: "500m"
    ephemeral-storage: "10Mi"
    memory: "0.5Gi"