Etiquetar 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.

Agrega o modificar etiquetas

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

Console

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

    Ir a la página Servicios

  2. Selecciona las casillas de verificación que aparecen junto a los servicios que deseas etiquetar.

  3. Haz clic en Mostrar panel de información y selecciona la pestaña Etiquetas para expandir la columna de etiquetas.

  4. 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.

  5. 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:

  1. 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.

  2. En la página de BigQuery en la consola de Google Cloud, selecciona tu proyecto y conjunto de datos de facturación.

  3. 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 ACOPLAR 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 tipo_de_recurso hora_de_inicio hora_de_finalización clave_de_etiquetas valor_de_etiquetas 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 tarea_backend 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 tarea_backend 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 tarea_backend 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.

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

    Ir a la página Servicios

  2. Puedes ver todas las etiquetas de cada servicio en la columna Etiquetas.

Quita etiquetas

Para quitar etiquetas de los servicios, sigue estos pasos:

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

    Ir a la página de Servicios de App Engine

  2. Selecciona las casillas de verificación que aparecen junto a los servicios cuyas etiquetas deseas quitar.

  3. Haz clic en Mostrar panel de información y selecciona la pestaña Etiquetas para expandir la columna de etiquetas.

  4. Haz clic en X junto a todas las etiquetas que deseas quitar.

  5. Guarda los cambios.