En este documento, se proporciona una descripción general breve de las etiquetas y sus características.
¿Qué son las etiquetas?
Una etiqueta es un par clave-valor que puedes asignar a los recursos de Google Cloud. Te ayudan a organizar estos recursos y administrar los costos a gran escala, con el nivel de detalle que necesitas. Puedes adjuntar una etiqueta a cada recurso y, luego, usarlas para filtrarlos. La información sobre las etiquetas se reenvía al sistema de facturación, lo que te permite desglosar los cargos facturados por etiquetas. Con los informes de facturación integrados, puedes filtrar y agrupar costos por etiquetas de recurso. También puedes usar etiquetas para consultar las exportaciones de datos de facturación.
Requisitos para las etiquetas
Las etiquetas que se aplican a un recurso deben cumplir los siguientes requisitos:
- Cada recurso puede tener hasta 64 etiquetas.
- Cada etiqueta debe ser un par clave-valor.
- La longitud de las claves debe ser de entre 1 y 63 caracteres, y no pueden estar vacías. Los valores pueden estar vacíos y su longitud máxima es de 63 caracteres.
- Las claves y los valores pueden contener solo letras en minúscula, caracteres numéricos, guiones bajos y guiones. Todos los caracteres deben usar la codificación UTF-8, además, se permiten los caracteres internacionales. Las claves deben comenzar con una letra en minúscula o un carácter internacional.
- La porción de clave de una etiqueta debe ser única para un solo recurso. Sin embargo, puedes usar la misma clave en varios recursos.
Estos límites se aplican a la clave y al valor de cada etiqueta de clúster, y a los recursos individuales de Google Cloud que tienen etiquetas de clúster. No hay límite para la cantidad de etiquetas de clúster que puedes aplicar en todos los recursos de un proyecto.
Usos comunes de las etiquetas
Estos son algunos casos prácticos comunes de las etiquetas:
Etiquetas por equipo o centro de costos: agrega etiquetas por equipo o centro de costos para distinguir los recursos pertenecientes a distintos equipos (por ejemplo,
team:research
yteam:analytics
). Puedes usar este tipo de etiquetas para la contabilidad de costos o la creación de presupuestos.Etiquetas de componentes: por ejemplo,
component:redis
,component:frontend
,component:ingest
ycomponent:dashboard
.Etiquetas de entorno o etapa: por ejemplo,
environment:production
yenvironment:test
.Etiquetas de estado: por ejemplo,
state:active
,state:readytodelete
ystate:archive
.Etiquetas de propiedad: Se usan para identificar los equipos responsables de las operaciones, por ejemplo:
team:shopping-cart
.
- Etiquetas de red: Se puede adjuntar una etiqueta a una máquina virtual. Las etiquetas de red que definiste con anterioridad aparecerán como una etiqueta sin un valor.
No recomendamos crear grandes cantidades de etiquetas únicas, como marcas de tiempo o valores individuales para cada llamada a la API. El problema con este enfoque es que, cuando los valores cambian con frecuencia o con claves que sobrecargan el catálogo, esto dificulta el filtrado y la generación de informes eficaces para los recursos.
Etiquetas
Las etiquetas se pueden usar como anotaciones que se pueden consultar en los recursos, pero no se pueden usar para establecer condiciones en las políticas. Las etiquetas proporcionan una forma de permitir o rechazar políticas de manera condicional en función de si un recurso tiene una etiqueta específica, ya que proporciona un control detallado sobre las políticas. Para obtener más información, consulta la Descripción general de etiquetas.
Permisos
Los siguientes permisos son obligatorios cuando necesitas agregar, modificar y ver etiquetas de proyectos:
- Para agregar o modificar una etiqueta, llama al método
projects.patch()
. Esto requiere el permisoresourcemanager.projects.update
. - Para ver la etiqueta de un proyecto, llama al método
projects.get()
. Esto requiere el permisoresourcemanager.projects.get
.
Comprende los costos con las etiquetas
Puedes adjuntar una etiqueta a un recurso y, luego, filtrar los recursos según sus etiquetas. La información sobre las etiquetas se reenvía al sistema de facturación, lo que te permite desglosar los cargos facturados según las etiquetas.
Estas son algunas maneras en las que puedes usar las etiquetas para comprender los costos:
- Puedes agregar etiquetas como
costcenter=cost_center_name
,service=service_name
yenvironment=environment_name
a tus VM o buckets de Cloud Storage. Esto te permite comprender dónde se implementan los recursos, con qué propósito y el centro de costos en el que se deben cobrar. - Puedes habilitar la exportación de datos de facturación a BigQuery. Las etiquetas se exportan a BigQuery con los recursos de Google Cloud correspondientes y su uso. Esto te permite supervisar aspectos como el costo de ejecutar el servicio de carrito de compras en la aplicación o el costo de las máquinas de prueba de desarrolladores.
- Puedes usar BigQuery junto con las etiquetas para comprender el costo de todos los recursos del sistema de prueba en comparación con los recursos de producción o cuánto cuesta un servicio en particular.
Ejemplo
En este ejemplo, el costo de los servicios de playlist
para un proyecto se determina mediante la exportación del uso y las etiquetas a BigQuery.
Para ello, primero habilita la exportación de facturación a BigQuery. labels-demo-prj
es la fuente del uso de los recursos y labels_demo_bqexport
es el conjunto de datos de destino en el que se almacenan los datos de uso. Después de exportar el uso y las etiquetas a BigQuery, puedes determinar los costos del servicio de playlist
.
Estos son los detalles del uso de Compute Engine y su costo asociado en BigQuery.