Organizar instâncias e conferir custos usando rótulos

Nesta página, descrevemos como usar rótulos Google Cloud para organizar suas instâncias do Spanner e conferir um detalhamento granular dos custos.

Um rótulo doGoogle Cloud é um par de chave-valor que pode ser atribuído a recursos individuais do Google Cloud , como instâncias do Spanner.

Os rótulos ajudam a organizar esses recursos e ver os custos na granularidade necessária. As informações sobre rótulos são encaminhadas ao sistema de faturamento, que permite detalhar as cobranças faturadas por rótulo. Para saber mais sobre rótulos, consulte Visão geral dos rótulos.

Casos de uso comuns para rótulos

Alguns casos de uso comuns de rótulos incluem:

  • Rótulos de centro de custo ou de equipe:diferencie os recursos pertencentes a equipes diferentes (por exemplo, team:research e team:analytics) para contabilidade de custos ou orçamento.
  • Rótulos de ambiente:especifique ambientes de desenvolvimento, teste ou produção (por exemplo, env:dev, env:test e env:prod).
  • Rótulos de componentes:categorizam os recursos por componente de aplicativo ou tipo de carga de trabalho (por exemplo, component:frontend e component:backend).
  • Rastreamento granular no nível da instância:rotule as instâncias do Spanner com o próprio ID ou um identificador específico (por exemplo, instance_id:my-instance-1) para detalhar diretamente os custos por instância em relatórios de faturamento ou consultas do BigQuery.

Requisitos e restrições

Os rótulos aplicados às instâncias do Spanner precisam atender aos seguintes requisitos:

  • Cada instância pode ter até 64 rótulos.
  • As chaves e os valores precisam ter 63 caracteres ou menos.
  • As chaves e os valores contêm apenas letras minúsculas, caracteres numéricos, sublinhados (_) e traços (-).
  • As chaves precisam começar com uma letra minúscula ou um caractere internacional. As chaves não podem estar vazias.
  • A parte principal de um rótulo precisa ser exclusiva em uma única instância.

Adicionar e gerenciar rótulos em instâncias do Spanner

É possível adicionar rótulos ao criar uma instância do Spanner ou atualizar os rótulos em uma instância atual.

Permissões necessárias

Para ver e gerenciar rótulos em instâncias do Spanner, você precisa das seguintes permissões do IAM:

  • spanner.instances.get
  • spanner.instances.update

Essas permissões estão incluídas no papel roles/spanner.admin.

Adicionar, atualizar ou remover rótulos

Console

  1. No console do Google Cloud , acesse a página Instâncias do Spanner.

    Acessar instâncias do Spanner

  2. Marque a caixa de seleção ao lado da instância que você quer rotular. O painel de informações é exibido.

  3. Selecione Rótulos no painel de informações.

  4. Adicione, atualize ou exclua rótulos da instância e clique em Salvar.

gcloud

Para criar uma instância do Spanner com rótulos, execute o comando gcloud spanner instances create com a flag --labels:

gcloud spanner instances create INSTANCE_ID \
    --config=INSTANCE_CONFIG \
    --description=INSTANCE_NAME \
    --nodes=NODE_COUNT \
    --labels=KEY=VALUE,KEY=VALUE

Para adicionar ou atualizar rótulos em uma instância, execute o comando gcloud spanner instances update com a flag --update-labels:

gcloud spanner instances update INSTANCE_ID \
    --update-labels=KEY=VALUE,KEY=VALUE

Para remover rótulos específicos de uma instância atual, use a flag --remove-labels:

gcloud spanner instances update INSTANCE_ID \
    --remove-labels=KEY1,KEY2

Para limpar todos os rótulos de uma instância atual, use a flag --clear-labels:

gcloud spanner instances update INSTANCE_ID --clear-labels

Analisar custos do Spanner por rótulos no Cloud Billing

Depois de aplicar rótulos às instâncias do Spanner, use-os para analisar seus custos. Os rótulos são encaminhados aos seus dados de custo, permitindo que você filtre e agrupe as cobranças.

Conferir custos agrupados por rótulos nos relatórios de faturamento

É possível conferir e analisar os custos do Spanner agrupados por chaves de rótulo diretamente no console do Google Cloud :

  1. No console Google Cloud , acesse a seção Faturamento.
  2. Selecione sua Conta de faturamento e clique em Relatórios no painel de navegação.
  3. No painel Filtros:
    1. Em Serviços, selecione Spanner para isolar os custos do banco de dados do Spanner.
    2. Em Agrupar por, selecione Chaves de rótulo e escolha a chave que você quer analisar (por exemplo, environment ou instance_id).
  4. O gráfico e a tabela de custos são atualizados para mostrar um detalhamento dos custos agrupados por cada valor de rótulo (por exemplo, environment:prod e environment:dev ou instance_id:my-instance-1 e instance_id:my-instance-2).