Administra las etiquetas de entorno y desglosa los costos del entorno

En esta página, se explica cómo asignar etiquetas a los entornos de Cloud Composer y, luego, desglosar los costos de facturación según estas etiquetas.

Acerca de las etiquetas de entorno

Las etiquetas de entorno son pares clave-valor que puedes asignar a tus entornos. Por ejemplo, si owner:engineering-team es una etiqueta personalizada, owner es la clave y engineering-team es el valor.

Cada entorno puede tener varias etiquetas, pero las claves de las etiquetas de un entorno deben ser únicas. Puedes asignar una misma clave y valor a varios entornos.

Etiquetas de entorno en los informes de facturación

Las etiquetas de entorno que asignas a los entornos se pueden ver en los informes de facturación, por lo que puedes desglosar los costos según las claves y los valores de las etiquetas.

Las etiquetas no se aplican de forma retroactiva. Por ejemplo, si asignas una etiqueta el 15 de mayo, los costos de facturación del 14 de mayo no contienen la etiqueta asignada.

Asigna etiquetas a entornos nuevos

Puedes asignar etiquetas cuando creas un entorno. Para obtener más información, consulta Crea entornos.

Asigna etiquetas a entornos existentes

Console

  1. Ve a la página Entornos en Google Cloud Console:

    Ir a Entornos

  2. Selecciona tu entorno.

  3. Ve a la pestaña Etiquetas.

  4. Haga clic en Editar y, luego, en Agregar etiqueta.

  5. Agregue un par clave-valor para la etiqueta y, luego, haga clic en Guardar.

  6. Espera hasta que el entorno se actualice.

gcloud

Cuando actualizas un entorno mediante el comando gcloud composer, los siguientes argumentos especifican etiquetas para el entorno:

  • --clear-labels quita todas las etiquetas.

  • --update-labels actualiza las etiquetas especificadas. si crea etiquetas nuevas que aún no existen.

  • --remove-labels quita las etiquetas especificadas. las etiquetas especificadas que no existen se ignoran.

Si usas varios de estos argumentos, se aplican en el siguiente orden: --clear-labels, --update-labels, --remove-labels.

Cómo actualizar o crear etiquetas

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --update-labels LABEL_KEY=LABEL_VALUE

Quita las etiquetas especificadas

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --remove-labels LABEL_KEY

Cómo quitar todas las etiquetas

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --clear-labels

Reemplaza lo siguiente:

  • ENVIRONMENT_NAME por el nombre del entorno
  • LOCATION por la región de Compute Engine en la que se encuentra el entorno
  • LABEL_KEY por la clave de etiqueta de entorno que deseas crear, actualizar o quitar.
  • LABEL_VALUE por el valor de la etiqueta del entorno

Ejemplo

En el siguiente ejemplo, se actualiza la etiqueta owner, se crea la nueva etiqueta env y se quita la etiqueta misc:

gcloud composer environments update example-environment \
    --location us-central1 \
    --update-labels owner=engineering-team,env=production \
    --remove-labels misc

API

Cuando actualices un entorno, en el recurso Entorno, especifica etiquetas nuevas de tu entorno.

Reemplazar todas las etiquetas

Para reemplazar todas las etiquetas, incluye labels en el parámetro de consulta updateMask y proporciona un reemplazo en el cuerpo de la solicitud.

// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask.fieldPaths=labels

{
  "labels":{
      "LABEL_KEY": "LABEL_VALUE"
    }
}

Reemplaza lo siguiente:

  • LABEL_KEY con una clave de la etiqueta de entorno
  • LABEL_VALUE con un valor nuevo para la etiqueta del entorno.

Ejemplo:

// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask.fieldPaths=labels

{
  "labels": {
    "owner": "engineering-team",
    "env": "production"
  }
}

Cómo quitar todas las etiquetas

Para quitar todas las etiquetas, incluye labels en el parámetro de consulta updateMask y no proporciones el valor de reemplazo.

Cómo actualizar etiquetas individuales

Para actualizar una etiqueta o agregar una nueva a etiquetas existentes, incluye labels.LABEL_KEY en el parámetro de consulta updateMask y proporciona un reemplazo en el cuerpo de la solicitud.

// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask=labels.LABEL_KEY

{
  "labels":{
      "LABEL_KEY": "LABEL_VALUE"
    }
}

Reemplaza lo siguiente:

  • LABEL_KEY con una clave de la etiqueta de entorno
  • LABEL_VALUE con un valor nuevo para la etiqueta del entorno.

Ejemplo:

// PATCH https://composer.googleapis.com/v1/
// ?name=projects/example-project/locations/
// us-central1/environments/example-environment
// &updateMask=labels.owner,labels.env

{
  "labels": {
    "owner": "engineering-team",
    "env": "production"
  }
}

Cómo quitar etiquetas individuales

Para quitar etiquetas, incluye labels.LABEL_KEY en el parámetro de consulta updateMask y no proporciones el valor de reemplazo.

Terraform

Para crear un entorno con parámetros predeterminados, se especifica una ubicación, edita el bloque labels en la configuración de Terraform y ejecuta terraform apply.

resource "google_composer_environment" "example" {
  name = "example-environment"
  region = "us-central1"

  labels = {
    LABEL_KEY = "LABEL_VALUE"
  }

}

Reemplaza lo siguiente:

  • LABEL_KEY por la clave de etiqueta del entorno que deseas crear o actualizar. Para quitar etiquetas, borra sus campos.
  • LABEL_VALUE por el valor de la etiqueta del entorno

Ejemplo:

resource "google_composer_environment" "example" {
  name = "example-environment"
  region = "us-central1"

  labels = {
    owner = "engineering-team"
    env = "production"
  }
}

Cómo ver las etiquetas en los informes

Una vez que las etiquetas de tu entorno se propaguen a los informes de facturación, puedes desglosar los costos de facturación según las siguientes etiquetas:

  1. Visualiza los informes de la Facturación de Cloud correspondientes a tu cuenta de facturación de Cloud.

  2. En la página Informes, sigue estos pasos:

    1. Haz clic en Mostrar filtros (Show filters).
    2. En el cuadro de diálogo Filtros, expande la sección Etiquetas.
    3. Filtra los datos que se muestran según las claves y los valores de tus etiquetas de entorno.

¿Qué sigue?