Organizar instâncias e conferir custos usando rótulos

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

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 visualizar os custos com a 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 de rótulos.

Casos de uso comuns de rótulos

Alguns casos de uso comuns de rótulos incluem:

• Rótulos de centro de custo ou de equipe: diferencie recursos pertencentes a equipes diferentes (por exemplo, team:research e team:analytics) para contabilidade de custo 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 até 63 caracteres.
• 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 ficar 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 visualizar 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

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

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

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

gcloud spanner instances update INSTANCE_ID --clear-labels

Analisar os 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 para seus dados de custo, permitindo que você filtre e agrupe cobranças.

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

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

1. No console do 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 de rótulo 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).