Organizar instâncias e conferir custos usando rótulos

Esta página descreve como usar Google Cloud rótulos para organizar suas instâncias do Spanner e conferir uma discriminação detalhada de custos.

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

Os rótulos ajudam a organizar esses recursos e conferir os custos na granularidade necessária. As informações sobre rótulos são encaminhadas ao sistema de faturamento, permitindo que você detalhe 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 para rótulos incluem:

• Rótulos de centro de custo ou de equipe:distinguem os recursos pertencentes a equipes diferentes (por exemplo, team:research e team:analytics) para contabilidade de custos ou orçamento.
• Rótulos de ambiente:especificam ambientes de desenvolvimento, teste ou produção (por exemplo, env:dev, env:test e env:prod).
• Rótulos de componentes:categorizam 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 instâncias do Spanner com o próprio ID ou um identificador específico (por exemplo, instance_id:my-instance-1) para discriminar 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 da chave 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 conferir 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 custos do Spanner por rótulos no Cloud Billing

Depois de aplicar rótulos às instâncias do Spanner, você pode usá-los para analisar seus custos. Os rótulos são encaminhados aos dados de custo, permitindo filtrar e agrupar cobranças.

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

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

1. No Google Cloud console, 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 do 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 detalhado 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).