Etiqueta recursos de App Engine

Las etiquetas son una forma sencilla de agrupar recursos que están relacionados o asociados entre sí. Puedes usar etiquetas si deseas obtener una vista más detallada de cómo se facturan los recursos para tus servicios de App Engine. También puedes aprovechar funciones como el filtrado anidado para realizar búsquedas más precisas de recursos.

A continuación, mostramos algunas formas en las que puedes usar las etiquetas:

Etiqueta los tipos de servicios que creas. Por ejemplo, si agregas etiquetas como service:default, service:backend y service:frontend a tus servicios de App Engine, puedes comparar cómo estos servicios diferentes usan el ancho de banda saliente, las horas de instancia y otros recursos.
Etiqueta por equipo o por centro de costos para distinguir los proyectos que pertenecen a diferentes equipos. Esto puede usarse para contabilizar costos o crear presupuestos. Por ejemplo, usa las etiquetas team:marketing y team:research.
Etiqueta el entorno en el que se ejecuta un servicio. Por ejemplo, usa las etiquetas environment:prod y environment:test.
Etiqueta por propietario o por contacto principal si hay una persona que es responsable de un recurso.
Etiqueta el estado de un servicio. Por ejemplo, state:inuse y state:readyfordeletion

Las etiquetas se pueden usar solo para los datos de facturación y no para ninguna otra herramienta, como el Explorador de métricas.

Restricciones

Puedes asignar hasta 64 etiquetas a cada recurso.
Solo puedes etiquetar servicios de forma explícita. Las versiones y las instancias heredan las etiquetas de su servicio superior.
El entorno flexible de App Engine no admite etiquetas de facturación por el uso de Firestore en el modo Datastore (Datastore).

Agrega o modificar etiquetas

Para agregar etiquetas a los servicios de App Engine, sigue estos pasos:

Console

Ve a la página de Servicios de App Engine.

Ir a Servicios
Selecciona las casillas de verificación que aparecen junto a los servicios que deseas etiquetar.
Haz clic en Mostrar panel de información y selecciona la pestaña Etiquetas para expandir la columna de etiquetas.
Haz clic en Agregar etiqueta para agregar un par clave-valor a los servicios seleccionados. Por ejemplo, para agregar la etiqueta env:prod, debes ingresar env como la Clave y prod para el Valor.
Guarda los cambios.

API de Admin

Puedes agregar y configurar etiquetas a través del recurso Service. Consulta la documentación de referencia de la API de Administrador:

Visualiza los datos de facturación asociados con los servicios etiquetados

Puedes agregar un mayor nivel de detalle a los datos de facturación de tu aplicación mediante etiquetas. Por ejemplo, puedes ver los costos de un recurso específico, como el ancho de banda saliente, desglosados por día y por servicio. Esto puede brindarte información sobre los costos diarios de la aplicación, lo que te permitirá optimizar el uso de recursos de tu aplicación.

Para visualizar las etiquetas de facturación, exporta tus datos a BigQuery y, luego, consúltalos:

Exporta los datos de facturación a BigQuery.

Después de habilitar la exportación a BigQuery, es posible que pasen un par de horas hasta que puedas ver los datos.
En la página de BigQuery en la consola de Google Cloud, selecciona tu proyecto y conjunto de datos de facturación.
Ejecuta una consulta en la tabla creada a partir de la exportación a BigQuery.

Las etiquetas van a agregarse al conjunto de datos como campos repetidos, lo que quiere decir que puedes adjuntar varias etiquetas a una sola fila en el conjunto de datos de costo. Para realizar consultas de forma sencilla por etiqueta, es posible que quieras FLATTEN la tabla en el campo para las etiquetas.

Por ejemplo, la siguiente consulta solicita los datos de costos, la clave de etiqueta y el valor de etiqueta para el ancho de banda de salida en donde existe una 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

BigQuery muestra los datos con una salida acoplada:

producto	resource_type	start_time	end_time	labels_key	labels_value	costo
App Engine	Ancho de banda de salida	07-10-2017 10:00:00 p.m.	07-10-2017 11:00:00 p.m.	servicio	predeterminado	0.020033
App Engine	Ancho de banda de salida	07-10-2017 1:00:00 p.m.	07-10-2017 2:00:00 p.m.	servicio	frontend	0.016042
App Engine	Ancho de banda de salida	07-10-2017 06:00:00 a.m.	07-10-2017 07:00:00 a.m.	servicio	backend_task	0.013125
App Engine	Ancho de banda de salida	07-10-2017 9:00:00 p.m.	07-10-2017 10:00:00 p.m.	servicio	predeterminado	0.020722
App Engine	Ancho de banda de salida	07-10-2017 7:00:00 p.m.	07-10-2017 8:00:00 p.m.	servicio	frontend	0.020725
App Engine	Ancho de banda de salida	08-10-2017 04:00:00 a.m.	08-10-2017 05:00:00 a.m.	servicio	backend_task	0.02072
App Engine	Ancho de banda de salida	08-10-2017 02:00:00 a.m.	08-10-2017 03:00:00 a.m.	servicio	predeterminado	0.020723
App Engine	Ancho de banda de salida	07-10-2017 2:00:00 p.m.	07-10-2017 3:00:00 p.m.	servicio	frontend	0.020724
App Engine	Ancho de banda de salida	07-10-2017 11:00:00 p.m.	08-10-2017 12:00:00 a.m.	servicio	backend_task	0.021417

Períodos en los informes de facturación

Para garantizar que cada día en el informe abarque un período completo de 24 horas, los datos de facturación que exportas solo contienen datos hasta la medianoche más reciente, según la hora del Pacífico. Por ejemplo, si exportas datos de facturación al mediodía del 3 de diciembre, la exportación incluye datos correspondientes hasta el 2 de diciembre a las 11:59 p.m.

Para cada día del informe, los datos de facturación se atribuyen a las etiquetas que existen al comienzo del día. Por ejemplo, si creas una etiqueta al mediodía (hora del Pacífico) del 3 de diciembre, el informe del 3 de diciembre no atribuirá datos a la etiqueta, ya que esta no existía al comienzo del día. Los datos se atribuirán a la etiqueta a partir del 4 de diciembre.

Las etiquetas que se crean al mediodía y se quitan en el mismo período de 24 horas no tendrán datos atribuidos.

Visualiza etiquetas en la consola de Google Cloud

Después de etiquetar los recursos, puedes ver las etiquetas en la consola de Google Cloud.

Ve a la página de Servicios de App Engine.

Ir a Servicios
Puedes ver todas las etiquetas de cada servicio en la columna Etiquetas.

Quita etiquetas

Para quitar etiquetas de los servicios, sigue estos pasos:

Ve a la página de Servicios de App Engine.

Ir a Servicios de App Engine
Selecciona las casillas de verificación que aparecen junto a los servicios cuyas etiquetas deseas quitar.
Haz clic en Mostrar panel de información y selecciona la pestaña Etiquetas para expandir la columna de etiquetas.
Haz clic en X junto a todas las etiquetas que deseas quitar.
Guarda los cambios.