Como gerar relatórios de uso com rótulos

O que são rótulos?

Um rótulo é um par de chave-valor que ajuda você a organizar seus recursos do Google Cloud. É possível anexar um rótulo a cada recurso e filtrar os recursos com base nesses rótulos. As informações sobre os rótulos são encaminhadas ao sistema de faturamento para que você separe as cobranças por rótulo.

Usos comuns dos rótulos

Não recomendamos criar um grande número de rótulos exclusivos, como para carimbos de data/hora, ou valores individuais para todas as chamadas de API. Veja alguns casos de uso comuns de rótulos:

  • Rótulos de centro de custo ou de equipe: adicione rótulos com base na equipe ou no centro de custo para distinguir os recursos pertencentes a equipes diferentes (por exemplo, team:research e team:analytics). É possível usar esse tipo de rótulo para contabilidade de custos ou em orçamentos.

  • Rótulos de componente: por exemplo, component:redis, component:frontend, component:ingest e component:dashboard.

  • Rótulos de ambiente ou estágio: por exemplo, environment:production e environment:test.

  • Rótulos de estado: por exemplo, state:active, state:readytodelete e state:archive.

Requisitos dos rótulos

Os rótulos aplicados a um recurso precisam atender aos seguintes requisitos:

  • Cada recurso pode ter vários rótulos, até um máximo de 64.
  • Cada rótulo precisa ser um par de chave-valor.
  • As chaves têm tamanho mínimo de um e máximo de 63 caracteres. Elas não podem ser vazias. Os valores podem ser vazios e ter um tamanho máximo de 63 caracteres.
  • As chaves e os valores podem conter apenas letras minúsculas, caracteres numéricos, sublinhados e traços. Todos os caracteres precisam usar a codificação UTF-8. Caracteres internacionais são permitidos.
  • A parte da chave de um rótulo precisa ser única. No entanto, é possível usar a mesma chave com vários recursos.
  • As chaves precisam começar com uma letra minúscula ou um caractere internacional.

Como gerenciar rótulos no Pub/Sub

No Pub/Sub, os rótulos são usados para organizar taxas de uma determinada conta de faturamento. As taxas estão associadas à conta de faturamento do projeto que contém o recurso solicitado, mas pode ser necessário estabelecer outras associações. Por exemplo, uma assinatura que pertence a um projeto pode ser criada para um tópico que pertence a um projeto diferente. É possível usar rótulos para associar esse tópico e essa assinatura a um centro de custo comum.

Os recursos do Pub/Sub não podem herdar rótulos uns dos outros. No exemplo acima, você definiria o mesmo rótulo no tópico e na assinatura para associar essas cobranças.

É possível usar os seguintes recursos para aplicar rótulos aos recursos do Pub/Sub: