Vista geral

Este documento oferece uma breve vista geral das etiquetas e das respetivas funcionalidades.

O que são etiquetas?

Uma etiqueta é um par de chave-valor que pode atribuir a Google Cloud recursos. Ajudam a organizar estes recursos e a gerir os custos em grande escala, com a granularidade de que precisa. Pode anexar uma etiqueta a cada recurso e, em seguida, filtrar os recursos com base nas respetivas etiquetas. As informações sobre as etiquetas são encaminhadas para o sistema de faturação que lhe permite discriminar os encargos faturados por etiqueta. Com os relatórios de faturação integrados, pode filtrar e agrupar os custos por etiquetas de recursos. Também pode usar etiquetas para consultar exportações de dados de faturação.

Requisitos para etiquetas

As etiquetas aplicadas a um recurso têm de cumprir os seguintes requisitos:

  • Cada recurso pode ter até 64 etiquetas.
  • Cada etiqueta tem de ser um par chave-valor.
  • As chaves têm um comprimento mínimo de 1 caráter e um comprimento máximo de 63 carateres, e não podem estar vazias. Os valores podem estar vazios e ter um comprimento máximo de 63 carateres.
  • As chaves e os valores só podem conter letras minúsculas, carateres numéricos, sublinhados e travessões. Todos os carateres têm de usar a codificação UTF-8, e são permitidos carateres internacionais. As chaves têm de começar com uma letra minúscula ou um caráter internacional.
  • A parte da chave de uma etiqueta tem de ser exclusiva num único recurso. No entanto, pode usar a mesma chave com vários recursos.

Estes limites aplicam-se à chave e ao valor de cada etiqueta, bem como aos recursos Google Cloud individuais que têm etiquetas. Não existe um limite para o número de etiquetas que pode aplicar a todos os recursos num projeto.

Utilizações comuns das etiquetas

Seguem-se alguns exemplos de utilização comuns das etiquetas:

  • Etiquetas de equipa ou centro de custos: adicione etiquetas com base na equipa ou no centro de custos para distinguir os recursos pertencentes a diferentes equipas (por exemplo, team:research e team:analytics). Pode usar este tipo de etiqueta para contabilidade de custos ou orçamentação.

  • Etiquetas de componentes: por exemplo, component:redis, component:frontend, component:ingest e component:dashboard.

  • Etiquetas de ambiente ou fase: por exemplo, environment:production e environment:test.

  • Etiquetas de estado: por exemplo, state:active,state:readytodelete e state:archive.

  • Etiquetas de propriedade: usadas para identificar as equipas responsáveis pelas operações, por exemplo: team:shopping-cart.

  • Etiquetas de rede: pode anexar uma etiqueta a uma máquina virtual. As etiquetas de rede que definiu no passado são apresentadas como uma etiqueta sem valor.

Não recomendamos a criação de um grande número de etiquetas únicas, como para carimbos de data/hora ou valores individuais para cada chamada da API. O problema desta abordagem é que, quando os valores mudam frequentemente ou com chaves que desorganizam o catálogo, torna-se difícil filtrar e criar relatórios sobre os recursos de forma eficaz.

Etiquetas e marcadores

As etiquetas podem ser usadas como anotações consultáveis para recursos, mas não podem ser usadas para definir condições nas políticas. As etiquetas oferecem uma forma de permitir ou negar condicionalmente políticas com base no facto de um recurso ter uma etiqueta específica, oferecendo um controlo detalhado sobre as políticas. Para mais informações, consulte a Vista geral das etiquetas.

Autorizações

As seguintes autorizações são necessárias quando tem de adicionar, modificar e ver etiquetas para projetos:

  • Pode adicionar ou modificar uma etiqueta chamando o método projects.patch(). Isto requer a autorização resourcemanager.projects.update.
  • Pode ver a etiqueta de um projeto chamando o método projects.get(). Isto requer a autorização resourcemanager.projects.get.

Compreenda os custos através de etiquetas

Pode anexar uma etiqueta a um recurso e, em seguida, filtrar os recursos com base nas respetivas etiquetas. As informações sobre as etiquetas são encaminhadas para o sistema de faturação que lhe permite discrimininar os encargos faturados por etiqueta.

Seguem-se algumas formas de usar etiquetas para compreender os custos:

  • Pode adicionar etiquetas, como costcenter=cost_center_name, service=service_name e environment=environment_name, às suas VMs ou contentores do Cloud Storage. Isto permite-lhe compreender onde os seus recursos são implementados, para que finalidade e o centro de custos ao qual devem ser cobrados.
  • Pode ativar a exportação de dados de faturação para o BigQuery. As etiquetas são exportadas para o BigQuery com os recursos correspondentes e a respetiva utilização. Google Cloud Isto permite-lhe monitorizar aspetos como o custo de execução do serviço de carrinho de compras na aplicação ou o custo das máquinas de teste do programador.
  • Pode usar o BigQuery em combinação com etiquetas para compreender o custo de todos os recursos do sistema de teste em comparação com os recursos de produção ou quanto custa um serviço específico.

Exemplo

Neste exemplo, o custo dos serviços do playlist para um projeto é determinado pela exportação da utilização e das etiquetas para o BigQuery. Para o fazer, comece por ativar a exportação de faturação para o BigQuery. labels-demo-prj é a origem da utilização de recursos e labels_demo_bqexport é o conjunto de dados de destino onde os dados de utilização são armazenados. Depois de exportar a utilização e as etiquetas para o BigQuery, pode determinar o valor dos custos dos serviços.playlist

Seguem-se os detalhes da utilização do Compute Engine e o respetivo custo associado no BigQuery.