Etiquetar recursos do App Engine

As etiquetas são uma forma simples de agrupar recursos relacionados ou associados entre si. Pode usar etiquetas para ter uma vista mais detalhada de como os recursos são faturados para os seus serviços do App Engine. Também pode tirar partido de funcionalidades como a filtragem aninhada para fazer pesquisas mais precisas dos seus recursos.

Seguem-se algumas formas de usar etiquetas:

  • Etiquete os tipos de serviços que cria. Por exemplo, se adicionar etiquetas como service:default, service:backend e service:frontend aos seus serviços do App Engine, pode comparar a forma como estes diferentes serviços usam a largura de banda de saída, as horas de instância e outros recursos.

  • Etiquete por equipa ou centro de custos para distinguir projetos pertencentes a diferentes equipas. Pode ser usado na contabilidade de custos ou no orçamento. Por exemplo, team:marketing e team:research.

  • Etiquete o ambiente no qual um serviço está a ser executado. Por exemplo, environment:prod e environment:test.

  • Etiquete por proprietário ou contacto principal se houver um indivíduo responsável por um recurso.

  • Etiquetar o estado de um serviço. Por exemplo, state:inuse e state:readyfordeletion.

As etiquetas só podem ser usadas para dados de faturação e não para outras ferramentas, como o explorador de métricas.

Restrições

  • Pode atribuir até 64 etiquetas a cada recurso.
  • Só pode etiquetar serviços explicitamente. As versões e as instâncias herdam as etiquetas do serviço principal.
  • O ambiente flexível do App Engine não suporta etiquetas de faturação para a utilização do Firestore no modo Datastore (Datastore).

Adicionar ou modificar etiquetas

Para adicionar etiquetas aos serviços do App Engine:

Consola

  1. Aceda à página App Engine Services.

    Aceder a Serviços

  2. Selecione as caixas de verificação junto aos serviços que quer etiquetar.

  3. Clique em Mostrar painel de informações e selecione o separador Etiquetas para expandir a coluna de etiquetas.

  4. Clique em Adicionar etiqueta para adicionar um par de chave-valor aos serviços que selecionou. Por exemplo, para adicionar a etiqueta env:prod, introduza env para a chave e prod para o valor.

  5. Guarde as alterações.

API Admin

Pode adicionar e definir etiquetas através do recurso Service. Consulte a documentação de referência da API Admin:

Visualizar dados de faturação associados aos seus serviços etiquetados

Pode adicionar detalhe aos dados de faturação da sua aplicação através de etiquetas. Por exemplo, pode ver os custos de um recurso específico, como a largura de banda de saída, discriminados por dia e por serviço. Isto pode dar-lhe estatísticas sobre os custos diários da aplicação e permitir-lhe otimizar a utilização de recursos da aplicação.

Para ver as etiquetas de faturação, exporte os seus dados para o BigQuery e, em seguida, consulte os dados:

  1. Exporte os seus dados de faturação para o BigQuery.

    Depois de ativar o BigQuery Export, pode demorar algumas horas até ver os seus dados.

  2. Na página do BigQuery na Google Cloud consola, selecione o seu projeto e conjunto de dados de faturação.

  3. Execute uma consulta na tabela criada a partir do BigQuery Export.

As etiquetas são adicionadas ao conjunto de dados como campos repetidos, o que significa que podem ser anexadas várias etiquetas a uma única linha no conjunto de dados de custos. Para consultar facilmente por etiqueta, pode FLATTEN a tabela no campo de etiquetas.

Por exemplo, a seguinte consulta extrai dados de custos, a chave da etiqueta e o valor da etiqueta para a largura de banda de saída onde existe uma etiqueta:

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 devolve os seus dados com um resultado reduzido:

produto resource_type start_time end_time labels_key labels_value custo
App Engine Largura de banda de saída 2017-10-07 22:00:00 2017-10-07 23:00:00 serviço predefinição 0,020033
App Engine Largura de banda de saída 2017-10-07 13:00:00 2017-10-07 14:00:00 serviço interface 0,016042
App Engine Largura de banda de saída 2017-10-07 06:00:00 2017-10-07 07:00:00 serviço backend_task 0,013125
App Engine Largura de banda de saída 2017-10-07 21:00:00 2017-10-07 22:00:00 serviço predefinição 0,020722
App Engine Largura de banda de saída 2017-10-07 19:00:00 2017-10-07 20:00:00 serviço interface 0,020725
App Engine Largura de banda de saída 2017-10-08 04:00:00 2017-10-08 05:00:00 serviço backend_task 0,02072
App Engine Largura de banda de saída 2017-10-08 02:00:00 2017-10-08 03:00:00 serviço predefinição 0,020723
App Engine Largura de banda de saída 2017-10-07 14:00:00 2017-10-07 15:00:00 serviço interface 0,020724
App Engine Largura de banda de saída 2017-10-07 23:00:00 2017-10-08 00:00:00 serviço backend_task 0,021417

Períodos nos relatórios de custos

Para garantir que cada dia no relatório abrange um período de 24 horas completo, os dados de faturação que exporta contêm apenas dados até à meia-noite mais recente, hora do Pacífico. Por exemplo, se exportar dados de faturação ao meio-dia de 3 de dezembro, a exportação inclui dados até às 23:59 de 2 de dezembro.

Para cada dia no relatório, os dados de faturação são atribuídos a etiquetas que existem no início do dia. Por exemplo, se criar uma etiqueta às 12:00, hora do Pacífico, a 3 de dezembro, o relatório de 3 de dezembro não atribui dados à etiqueta, uma vez que a etiqueta não existia no início do dia. Os dados vão ser atribuídos à etiqueta a partir de 4 de dezembro.

As etiquetas criadas ao meio-dia e removidas no mesmo período de 24 horas não têm dados atribuídos.

Ver etiquetas na Google Cloud consola

Depois de etiquetar os recursos, pode ver as etiquetas na Google Cloud consola.

  1. Aceda à página App Engine Services.

    Aceder a Serviços

  2. Para cada serviço, pode ver todas as etiquetas na coluna Etiquetas.

A remover Marcadores

Para remover etiquetas de serviços:

  1. Aceda à página App Engine Services.

    Aceda aos serviços do App Engine

  2. Selecione as caixas de verificação junto aos serviços para os quais quer remover etiquetas.

  3. Clique em Mostrar painel de informações e selecione o separador Etiquetas para expandir a coluna de etiquetas.

  4. Clique no X junto a todas as etiquetas que quer remover.

  5. Guarde as alterações.