Crear informes de uso con etiquetas

Las etiquetas de Pub/Sub te ayudan a gestionar los costes y a organizar los recursos. Por ejemplo, imagina que tienes varias suscripciones a diferentes tipos de noticias. Puedes etiquetar cada suscripción con una categoría pertinente, como news_category=sports o news_category=entertainment.

¿Qué son las etiquetas?

Una etiqueta es un par clave-valor que puede asignar a los Google Cloud recursos. Te ayudan a organizar estos recursos y a gestionar tus costes a gran escala, con la granularidad que necesites. Puedes asignar una etiqueta a cada recurso y, después, filtrar los recursos en función de sus etiquetas. La información relacionada con las etiquetas se reenvía al sistema de facturación para que puedas desglosar los cargos facturados por etiquetas. Con los informes de facturación integrados, puedes filtrar y agrupar los costes por etiquetas de recursos. También puedes usar etiquetas para consultar exportaciones de datos de facturación.

Requisitos de las etiquetas

Las etiquetas aplicadas a un recurso deben cumplir los siguientes requisitos:

  • Cada recurso puede tener hasta 64 etiquetas.
  • Cada etiqueta debe ser un par clave-valor.
  • Las claves deben tener como mínimo 1 carácter y como máximo 63 caracteres, y no pueden estar vacías. Los valores pueden estar vacíos y pueden tener hasta 63 caracteres.
  • Las claves y los valores solo pueden contener letras minúsculas, caracteres numéricos, guiones bajos y guiones. Todos los caracteres deben usar codificación UTF-8, y se pueden usar caracteres internacionales. Las claves deben empezar por una letra minúscula o un carácter internacional.
  • La parte de la clave de una etiqueta debe ser única en un solo recurso. Sin embargo, puedes usar la misma clave con varios recursos.

Estos límites se aplican a la clave y al valor de cada etiqueta, así como a los recursos individuales Google Cloud que tienen etiquetas. No hay límite en el número de etiquetas que puedes aplicar a todos los recursos de un proyecto.

Usos habituales de las etiquetas

A continuación se indican algunos de los usos más habituales de las etiquetas:

  • Etiquetas de equipo o de centro de costes: añade etiquetas basadas en el equipo o el centro de costes para distinguir los recursos propiedad de diferentes equipos (por ejemplo, team:research y team:analytics). Puedes usar este tipo de etiquetas para la contabilidad de costes o la elaboración de presupuestos.

  • Etiquetas de componentes: por ejemplo, component:redis, component:frontend, component:ingest y component:dashboard.

  • Etiquetas de entorno o fase: por ejemplo, environment:production y environment:test.

  • Etiquetas de estado: por ejemplo, state:active, state:readytodelete y state:archive.

  • Etiquetas de propiedad: se usan para identificar los equipos responsables de las operaciones. Por ejemplo, team:shopping-cart.

No recomendamos crear un gran número de etiquetas únicas, como las de marcas de tiempo o valores individuales para cada llamada a la API. El problema de este método es que, cuando los valores cambian con frecuencia o con claves que saturan el catálogo, resulta difícil filtrar y generar informes sobre los recursos de forma eficaz.

Etiquetas

Las etiquetas se pueden usar como anotaciones consultables para los recursos, pero no se pueden usar para definir condiciones en las políticas. Las etiquetas permiten aplicar o denegar políticas de forma condicional en función de si un recurso tiene una etiqueta específica, lo que proporciona un control pormenorizado de las políticas. Para obtener más información, consulta la descripción general de las etiquetas.

Gestionar etiquetas en Pub/Sub

En Pub/Sub, las etiquetas se suelen usar para organizar las tarifas de una cuenta de facturación determinada. Las tarifas se asocian a la cuenta de facturación del proyecto que contiene el recurso solicitado, pero puede que quieras establecer asociaciones adicionales. Por ejemplo, una suscripción que pertenece a un proyecto se puede crear para un tema que pertenece a otro proyecto. Puedes usar etiquetas para asociar ese tema y esa suscripción a un centro de costes común.

Los recursos de Pub/Sub no heredan etiquetas entre sí. En el ejemplo anterior, asignarías la misma etiqueta al tema y a la suscripción para asociar esos cargos.

Puedes usar las siguientes funciones para aplicar etiquetas a los recursos de Pub/Sub: