Acompanhe o consumo associado dos seus apps do Kubernetes com rótulos

Muitos produtos do Google Cloud Marketplace impulsionam o uso de Google Cloud infraestrutura e recursos pelos clientes. Você pode integrar rótulos aos seus produtos que fornecem insights ao Google sobre o impacto deles em termos de uso associado pelo cliente Google Cloud . O Google pode usar essas informações para mostrar o impacto e orientar os investimentos de entrada no mercado (GTM, na sigla em inglês).

Este documento descreve como configurar o rastreamento do consumo de parceiros para apps do Kubernetes oferecidos no Cloud Marketplace.

Esquema de rotulagem

Rótulos são pares de chave-valor que podem ser atribuídos a recursos do Google Cloud . Para mais informações, consulte a Visão geral dos rótulos.

Quando você usa rótulos para rastreamento de consumo de parceiros, eles seguem o seguinte formato:

goog-partner-solution = SOLUTION_URN

Encontrar o rótulo de rastreamento de consumo do seu produto

Para cada produto oferecido no Cloud Marketplace, você encontra o rótulo de rastreamento de consumo associado no Portal do Produtor. Para encontrar o rótulo, siga estas etapas:

  1. No Portal do Produtor, acesse a página Visão geral.
  2. Na lista de produtos, encontre aquele cujo consumo você quer acompanhar.
  3. Copie e salve o valor listado em Rótulo de acompanhamento de consumo.
  4. Ao integrar o rastreamento de consumo do seu produto, use o rótulo de rastreamento de consumo que você salvou.

O link direto para a página Visão geral do Portal do Produtor é:

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

Integrar o rótulo de acompanhamento de consumo ao seu app do Kubernetes

Para ativar o rastreamento de consumo do seu app do Kubernetes, siga estas etapas:

  • Inclua o rótulo de rastreamento de consumo em todas as especificações de pod, conforme mostrado no exemplo a seguir.
  • Crie a especificação do pod com recursos definidos.

Com o Terraform, é possível adicionar um rótulo padrão no nível do provedor do Google que se aplica a todos os recursos Google Cloud que o Terraform implanta. Para mais informações sobre como usar rótulos padrão com o Terraform, consulte a Referência de configuração do provedorGoogle Cloud na documentação do Terraform.

Exemplo de integração de rótulo de rastreamento de consumo

O exemplo a seguir mostra uma especificação de pod para uma implantação do Kubernetes com um rótulo de rastreamento de consumo adicionado:

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"

Substitua SOLUTION_URN pelo rótulo de rastreamento de consumo do seu app. Para encontrar o rótulo de rastreamento de consumo, no Portal do Produtor, localize seu app na tabela Seus produtos. O valor na coluna Rótulo de rastreamento de consumo é o rótulo de rastreamento de consumo do seu app.

Neste exemplo, as linhas a seguir definem os recursos, o que é necessário para o rastreamento do consumo:

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