Organiza instancias y consulta los costos con etiquetas

En esta página, se describe cómo usar etiquetas Google Cloud para organizar tus instancias de Spanner y ver un desglose detallado de los costos.

Una etiqueta es un par clave-valor que puedes asignar a recursos Google Cloud individuales, como instancias de Spanner.Google Cloud

Las etiquetas te ayudan a organizar estos recursos y ver tus costos con el nivel de detalle que necesitas. La información sobre las etiquetas se envía al sistema de facturación que te permite desglosar los cargos facturados por etiqueta. Para obtener más información sobre las etiquetas, consulta Descripción general de las etiquetas.

Casos de uso comunes de las etiquetas

Estos son algunos casos de uso comunes de las etiquetas:

  • Etiquetas por equipo o centro de costos: Distingue los recursos que pertenecen a diferentes equipos (por ejemplo, team:research y team:analytics) para la contabilidad de costos o la creación de presupuestos.
  • Etiquetas de entorno: Especifica entornos de desarrollo, prueba o producción (por ejemplo, env:dev, env:test y env:prod).
  • Etiquetas de componentes: Categoriza los recursos por componente de la aplicación o tipo de carga de trabajo (por ejemplo, component:frontend y component:backend).
  • Seguimiento detallado a nivel de la instancia: Etiqueta las instancias de Spanner con su propio ID o un identificador específico (por ejemplo, instance_id:my-instance-1) para desglosar directamente los costos por instancia en los informes de facturación o las consultas de BigQuery.

Requisitos y restricciones

Las etiquetas que se aplican a las instancias de Spanner deben cumplir con los siguientes requisitos:

  • Cada instancia puede tener hasta 64 etiquetas.
  • Las claves y los valores deben tener un máximo de 63 caracteres.
  • Las claves y los valores solo pueden contener letras en minúscula, caracteres numéricos, guiones bajos (_) y guiones (-).
  • Las claves deben empezar con una letra en minúscula o un carácter internacional. Las claves no pueden estar vacías.
  • La porción de clave de una etiqueta debe ser única para una sola instancia.

Agrega y administra etiquetas en instancias de Spanner

Puedes agregar etiquetas cuando creas una instancia de Spanner o actualizar las etiquetas en una instancia existente.

Permisos necesarios

Para ver y administrar etiquetas en instancias de Spanner, necesitas los siguientes permisos de IAM:

  • spanner.instances.get
  • spanner.instances.update

Estos permisos están incluidos en el rol roles/spanner.admin.

Cómo agregar, actualizar o quitar etiquetas

Console

  1. En la consola de Google Cloud , ve a la página Instancias de Spanner.

    Ir a Instancias de Spanner

  2. Selecciona la casilla de verificación junto a la instancia que deseas etiquetar. Aparecerá el panel de información.

  3. Selecciona Etiquetas en el panel de información.

  4. Agrega, actualiza o borra las etiquetas de la instancia y, luego, haz clic en Guardar.

gcloud

Para crear una instancia de Spanner con etiquetas, ejecuta el comando gcloud spanner instances create con la marca --labels:

gcloud spanner instances create INSTANCE_ID \
    --config=INSTANCE_CONFIG \
    --description=INSTANCE_NAME \
    --nodes=NODE_COUNT \
    --labels=KEY=VALUE,KEY=VALUE

Para agregar o actualizar etiquetas en una instancia existente, ejecuta el comando gcloud spanner instances update con la marca --update-labels:

gcloud spanner instances update INSTANCE_ID \
    --update-labels=KEY=VALUE,KEY=VALUE

Para quitar etiquetas específicas de una instancia existente, usa la marca --remove-labels:

gcloud spanner instances update INSTANCE_ID \
    --remove-labels=KEY1,KEY2

Para borrar todas las etiquetas de una instancia existente, usa la marca --clear-labels:

gcloud spanner instances update INSTANCE_ID --clear-labels

Analiza los costos de Spanner por etiquetas en la Facturación de Cloud

Después de aplicar etiquetas a tus instancias de Spanner, puedes usarlas para analizar tus costos. Las etiquetas se reenvían a tus datos de costos, lo que te permite filtrar y agrupar los cargos.

Consulta los costos agrupados por etiquetas en los informes de facturación

Puedes ver y analizar tus costos de Spanner agrupados por claves de etiquetas directamente en la consola de Google Cloud :

  1. En la consola de Google Cloud , ve a la sección Facturación.
  2. Selecciona tu cuenta de facturación y haz clic en Informes en el panel de navegación.
  3. En el panel Filtros, haz lo siguiente:
    1. En Servicios, selecciona Spanner para aislar los costos de tu base de datos de Spanner.
    2. En Agrupar por, selecciona Claves de etiquetas y elige la clave de etiqueta que deseas analizar (por ejemplo, environment o instance_id).
  4. El gráfico y la tabla de costos se actualizan para mostrar un desglose detallado de los costos agrupados por cada valor de la etiqueta (por ejemplo, environment:prod y environment:dev, o instance_id:my-instance-1 y instance_id:my-instance-2).