Aviso: nos próximos meses, vamos reorganizar o site de documentação do App Engine para facilitar a localização de conteúdo e o alinhamento com o restante dos produtos do Google Cloud. O mesmo conteúdo estará disponível, mas a navegação agora corresponderá ao restante dos produtos do Cloud.

Como atribuir rótulos a recursos do App Engine

Python |Java |Node.js |Go |Ruby |PHP |.NET

O rótulo é uma maneira leve de agrupar recursos relacionados ou associados entre si. Os rótulos oferecem uma visão mais detalhada de como os recursos são cobrados nos serviços do App Engine. Também é possível aproveitar recursos como a filtragem aninhada para realizar pesquisas mais precisas dos seus recursos.

Veja algumas maneiras de usar rótulos:

Rotule os tipos de serviços criados. Por exemplo, se você adicionar rótulos como service:default, service:backend e service:frontend aos serviços do App Engine, será possível comparar como esses serviços diferentes usam a largura de banda de saída, instâncias/horas e outros recursos.
Rotule por equipe ou centro de custo para diferenciar projetos de equipes diferentes. Isso pode ser usado na contabilidade ou no orçamento de custos. Por exemplo, team:marketing e team:research.
Rotule o ambiente em que um serviço está sendo executado. Por exemplo, environment:prod e environment:test.
Rotule por proprietário ou contato principal se houver um indivíduo responsável por um recurso.
Rotule o status de um serviço. Por exemplo, state:inuse e state:readyfordeletion.

Os rótulos só podem ser usados para dados de faturamento e não para outras ferramentas, como o Metrics Explorer.

Restrições

É possível atribuir até 64 rótulos a cada recurso.
Só é possível atribuir explicitamente rótulos a serviços. As versões e instâncias herdam rótulos do serviço pai.

Como adicionar ou modificar rótulos

Para adicionar rótulos aos serviços do App Engine:

Console

Acesse a página "Serviços" do App Engine.

Acessar a página de serviços
Marque as caixas de seleção ao lado dos serviços que você quer rotular.
Clique em Mostrar painel de informações e selecione a guia Rótulos para expandir a coluna correspondente.
Clique em Adicionar rótulo para incluir um par de chave-valor nos serviços selecionados. Por exemplo, para adicionar o rótulo env:prod, digite env para a Chave e prod para o Valor.
Salve as alterações.

Admin API

É possível adicionar e definir rótulos por meio do recurso Service. Consulte a documentação de referência da API Admin:

Como visualizar dados de faturamento associados aos serviços rotulados

É possível adicionar granularidade aos dados de faturamento do seu aplicativo usando rótulos. Por exemplo, é possível ver os custos de um recurso específico, como a largura de banda de saída, detalhado por dia e serviço. Isso fornece insights sobre os custos diários do aplicativo e permite otimizar o uso de recursos do aplicativo.

Para visualizar os rótulos de faturamento, exporte seus dados para o BigQuery e execute a consulta:

Exporte os dados de faturamento para o BigQuery.

Depois da ativação do BigQuery Export, pode levar algumas horas para você ver seus dados.
Na página do BigQuery no console do Google Cloud, selecione o projeto e o conjunto de dados de faturamento.
Execute uma consulta na tabela criada com o BigQuery Export.

Os rótulos são adicionados ao conjunto de dados como campos repetidos. Isso significa que vários rótulos podem ser anexados a uma única linha do conjunto de dados de custos. Para consultar facilmente por rótulo, convém usar FLATTEN na tabela, no campo de rótulos.

Por exemplo, a consulta a seguir puxa dados de custo, bem como a chave e o valor do rótulo, relativos à largura de banda de saída em que há um rótulo:

SELECT
  product,
  resource_type,
  start_time,
  end_time,
  labels.key,
  labels.value,
  cost
FROM (FLATTEN([YOUR_DATASET.TABLEID], labels))
WHERE
  cost > 0.0
  and labels.key is not null
  and resource_type = 'Out Bandwidth'
LIMIT 100

O BigQuery retorna os dados com um resultado nivelado:

product	resource_type	start_time	end_time	labels_key	labels_value	cost
App Engine	Largura de banda de saída	2017-10-07 22:00:00	2017-10-07 23:00:00	service	default	0.020033
App Engine	Largura de banda de saída	2017-10-07 13:00:00	2017-10-07 14:00:00	service	frontend	0.016042
App Engine	Largura de banda de saída	2017-10-07 06:00:00	2017-10-07 07:00:00	service	backend_task	0.013125
App Engine	Largura de banda de saída	2017-10-07 21:00:00	2017-10-07 22:00:00	service	default	0.020722
App Engine	Largura de banda de saída	2017-10-07 19:00:00	2017-10-07 20:00:00	service	frontend	0.020725
App Engine	Largura de banda de saída	2017-10-08 04:00:00	2017-10-08 05:00:00	service	backend_task	0.02072
App Engine	Largura de banda de saída	2017-10-08 02:00:00	2017-10-08 03:00:00	service	default	0.020723
App Engine	Largura de banda de saída	2017-10-07 14:00:00	2017-10-07 15:00:00	service	frontend	0.020724
App Engine	Largura de banda de saída	2017-10-07 23:00:00	2017-10-08 00:00:00	service	backend_task	0.021417

Períodos nos relatórios de faturamento

Para garantir que cada dia no relatório abranja um período completo de 24 horas, os dados de faturamento exportados vão somente até a meia-noite mais recente no horário do Pacífico. Por exemplo, se você exportar os dados de faturamento ao meio-dia de 3 de dezembro, a exportação incluirá dados até as 23h59 de 2 de dezembro.

Para cada dia no relatório, os dados de faturamento são atribuídos aos rótulos presentes no início do dia. Por exemplo, se você criar um rótulo no dia 3 de dezembro, ao meio-dia (horário do Pacífico), o relatório de 3 de dezembro não atribuirá dados ao rótulo porque ele não existia no início do dia. Os dados serão atribuídos a partir do dia 4 de dezembro.

Um rótulo criado ao meio-dia e removido no mesmo período de 24 horas não terá dados atribuídos a ele.

Como visualizar rótulos no console do Google Cloud

Depois de rotular os recursos, será possível ver os rótulos no console do Google Cloud.

Acesse a página "Serviços" do App Engine.

Acessar a página de serviços
Veja todos os rótulos de cada serviço na coluna Labels.

Como remover rótulos

Para remover rótulos dos serviços:

Acesse a página "Serviços" do App Engine.

Acessar a página "Serviços" do App Engine
Marque as caixas de seleção ao lado dos serviços com os rótulos que você quer remover.
Clique em Mostrar painel de informações e selecione a guia Rótulos para expandir a coluna correspondente.
Clique no X ao lado de todos os rótulos que quiser remover.
Salve as alterações.