Administra notificaciones de alertas de presupuesto programáticas

Descripción general

El comportamiento típico de un presupuesto es enviar correos electrónicos de alerta cuando las reglas de límite de alertas de presupuesto activan una notificación por correo electrónico.

Figura 1: Muestra la funcionalidad de correo electrónico predeterminada para las notificaciones de alertas de presupuesto y el método opcional para automatizar las respuestas del control de costos con Pub/Sub para las notificaciones programáticas.

Sin embargo, si usas presupuestos como una herramienta de control de costos, es posible que las notificaciones por correo electrónico no sean la mejor forma de usar para garantizar una acción oportuna para controlar tus costos de Google Cloud. Además de las notificaciones por correo electrónico, puedes usar notificaciones programáticas para automatizar las respuestas del control de costos. Estos son algunos ejemplos de respuestas de control de costos:

• Limita tu inversión en Google Cloud mediante la inhabilitación automática de la facturación o la interrupción de recursos.
• Reenvía los mensajes de presupuesto a otros medios (como Slack).
• Restringe el uso de recursos mediante el ajuste de cuotas.

Para obtener más información, consulta la página Ejemplos de respuestas automatizadas de control de costos.

Nota: Los presupuestos usan los datos estimados de la Facturación de Cloud, que están sujetos a cambios hasta que se complete la factura. En casos excepcionales, es posible que veas una disminución del costo entre las notificaciones.

Permisos necesarios para esta tarea

Para configurar los temas de Pub/Sub y vincularlos a un presupuesto de Facturación de Cloud, necesitas las siguientes funciones:

• A fin de crear o modificar un presupuesto para tu cuenta de facturación de Cloud, necesitas la función de administrador en la cuenta de facturación de Cloud.

• Para configurar o modificar los temas de Pub/Sub, necesitas la función Editor de Pub/Sub en el proyecto de destino que contenga los temas de Pub/Sub.

  Específicamente, debes tener los siguientes permisos:

  • billing.budgets.create en la cuenta de facturación de Cloud, para crear un presupuesto nuevo
  • billing.budgets.get y billing.budgets.list en la cuenta de facturación de Cloud, para ver todos los presupuestos de la cuenta de facturación de Cloud
  • billing.budgets.update en la cuenta de facturación de Cloud para modificar un presupuesto existente
  • roles/pubsub.editor en el proyecto de destino que contiene los temas de Pub/Sub.

  Si quieres editar un presupuesto de Facturación de Cloud existente para conectarlo a un tema de Pub/Sub existente, necesitas estos permisos específicos:

  • billing.budgets.get y billing.budgets.list en la cuenta de facturación de Cloud, para ver todos los presupuestos de la cuenta de facturación de Cloud
  • billing.budgets.update en la cuenta de facturación de Cloud para modificar un presupuesto existente
  • pubsub.topics.list en el proyecto de destino que contiene los temas de Pub/Sub.

Permisos relacionados con una restricción de dominio

Si configuraste las políticas de la organización para limitar el uso compartido de recursos por dominio, es posible que aparezca un error cuando intentes configurar los temas de Pub/Sub o conectarlos a un presupuesto de Facturación de Cloud.

En esta situación, es posible que tengas que forzar el acceso a la cuenta para conectar con éxito un tema de Pub/Sub a un presupuesto. Específicamente, para forzar el acceso a la cuenta, haz lo siguiente:

1. Quita la política de la organización que contiene la restricción de dominio mediante uno de los siguientes métodos:

   • Quita la política de la organización de forma temporal.

     O

   • Anula la política de la organización del proyecto que contiene el tema de Pub/Sub.

2. Sigue los pasos para conectar un tema de Pub/Sub a un presupuesto de Facturación de Cloud.

3. Restablece la política de la organización para la organización o el proyecto (opcional).

Para obtener más información sobre los permisos de Google Cloud, consulta las siguientes páginas:

• Descripción general del control de acceso de Facturación de Cloud
• Crea funciones personalizadas de la Facturación de Cloud
• Información sobre las funciones predefinidas de administración de identidades y accesos.

Cómo configurar y habilitar las notificaciones programáticas de Pub/Sub

Para habilitar las notificaciones programáticas para recibir mensajes de Pub/Sub con el estado actual de tu presupuesto, conecta un tema de Pub/Sub a tu presupuesto de Facturación de Cloud.

Nota: Debes tener permiso para otorgar la función de publicador de Pub/Sub en el tema a fin de permitir que la Facturación de Cloud publique mensajes en él.

Sigue estos pasos para conectar, editar o quitar un tema de Pub/Sub vinculado a tu presupuesto:

1. Crea un tema de Pub/Sub

Configura un tema de Pub/Sub en el que la Facturación de Cloud publicará las alertas de presupuesto. Si ya tienes configurado un tema de Pub/Sub para la Facturación de Cloud, puedes volver a utilizarlo en todos los presupuestos o crear un tema único por presupuesto.

1. Ve a la página Pub/Sub de Google Cloud Console.

   Acceder a Pub/Sub de Cloud Console

2. Selecciona un proyecto

   Nota: Recomendamos que configures un proyecto de Google Cloud único separado que contenga todas tus necesidades de administración de facturación, incluidos tus temas de Pub/Sub relacionados con la Facturación de Cloud. Tu proyecto de Google Cloud de administración de facturación también se puede usar para cosas como el acceso a la API de presupuestos de Facturación de Cloud, el acceso a la API de cuenta de facturación de Cloud, los Datos exportados de Facturación de Cloud, etc.

3. Haz clic en Crear tema.

4. En el campo ID de tema, proporciona un nombre de tema y haz clic en CREAR TEMA.

2. Conecta un presupuesto de Facturación de Cloud a un tema de Pub/Sub

Para conectar un presupuesto de Facturación e Cloud a un tema de Pub/Sub, haz lo siguiente:

1. Accede a Google Cloud Console.

   Acceder a Cloud Console

2. Abre el menú de navegación  de la consola y, luego, selecciona Facturación.

   Si tienes más de una cuenta de facturación de Cloud, realiza una de las siguientes acciones:

   • Si quieres administrar la Facturación de Cloud para el proyecto actual, selecciona Ir a la cuenta de facturación vinculada.
   • Si deseas ubicar otra cuenta de facturación de Cloud, selecciona Administrar cuentas de facturación y elige la cuenta para la que deseas administrar un presupuesto.

3. En el menú de navegación de Facturación, selecciona Presupuestos y alertas.

4. Si es necesario, crea un presupuesto. Para editar un presupuesto existente y las reglas de alerta, haz clic en el nombre del presupuesto.

5. En la sección Acciones, en Administrar notificaciones, selecciona Conectar un tema de Pub/Sub a este presupuesto.

6. En el campo Proyecto, haz clic en Seleccionar un proyecto y elige el proyecto que contiene los temas de Pub/Sub que configuraste. Si seguiste la recomendación en la sección anterior, este es tu proyecto de administración de facturación de Google Cloud.

7. En Seleccionar un tema de Pub/Sub, selecciona un tema existente o crea uno nuevo, para lo que debes seleccionar Crear un tema.

   • Si creas un tema nuevo, en el campo ID del tema, proporciona un nombre de tema y haz clic en CREAR TEMA.
   • Una vez creado, se seleccionará el tema.

8. Haga clic en Save.

Formato de las notificaciones

Las notificaciones que se envían al tema de Pub/Sub constan de dos partes:

• Atributos: Son un conjunto de pares clave-valor que describen el evento.
• Datos: una string que contiene un objeto JSON que describe los detalles de la alerta de presupuesto.

Nota: Puedes buscar y probar una notificación de ejemplo con los Ejemplos de respuestas automáticas del control de costos y la configuración de una función de Cloud Functions.

Atributos

Los atributos son pares clave-valor que se encuentran en todas las notificaciones que la Facturación de Cloud envía al tema de Pub/Sub. Las notificaciones siempre contienen el siguiente conjunto de pares clave-valor, sin importar la carga útil de la notificación.

Nombre del atributo	Ejemplo	Descripción
billingAccountId	01D4EE-079462-DFD6EC	Es el identificador de la cuenta de facturación de Cloud a la que le pertenece el presupuesto.
budgetId	de72f49d-779b-4945-a127-4d6ce8def0bb	Es el identificador de la alerta de presupuesto en la cuenta de facturación de Cloud.
schemaVersion	1.0	Es la versión del esquema de notificaciones.

Datos

Para la versión 1.x del esquema, los detalles de la alerta de presupuesto se muestran en una string UTF-8 codificada en base64 que contiene un objeto JSON con las siguientes propiedades:

Datos	Ejemplo	Descripción
budgetDisplayName	"My Personal Budget"	Es el nombre visible asignado al presupuesto.
costAmount	140.321	Es el importe de los costos acumulados. El tipo de costos a los que se les realiza seguimiento depende de los filtros y las opciones de configuración del presupuesto.
costIntervalStart	"2021-02-01T08:00:00Z"	Es el inicio del período de la alerta de presupuesto. "costAmount" incluye los costos del uso a partir de este momento. Este es el primer día del período del presupuesto (mes, trimestre, año o un período personalizado) durante el cual se produjo el uso del presupuesto.
budgetAmount	152.557	Es el importe asignado al presupuesto.
budgetAmountType	"SPECIFIED_AMOUNT"	Es el tipo de importe del presupuesto. Puede ser uno de los siguientes valores: "SPECIFIED_AMOUNT": Un importe fijo. "LAST_MONTH_COST": Los costos totales incurridos durante el último mes calendario. "LAST_PERIODS_COST": los costos generados durante el último período no mensual, como un trimestre o un año.
alertThresholdExceeded	0.9	Es la alerta que indica que se superó el límite configurado del costo real. El valor es un porcentaje en formato decimal (por ejemplo, 0.9 equivale al 90%). Esta clave no está presente si el costo real no excede ningún límite.
forecastThresholdExceeded	0.2	Es la alerta que indica que se superó el límite del costo previsto. El valor es un porcentaje en formato decimal (por ejemplo, 0.2 es del 20%). Esta clave no está presente si el costo previsto no excede ningún límite.
currencyCode	"USD"	Es el tipo de moneda de la alerta de presupuesto. Todos los importes de la alerta de presupuesto y de costos están en esta moneda.

Garantías de entrega de notificaciones a Pub/Sub

Después de crear un presupuesto y conectarlo a un tema de Pub/Sub, es posible que recibas notificaciones programáticas como se describe a continuación:

• Las notificaciones de presupuesto se envían al tema de Pub/Sub varias veces al día con el estado actual de tu presupuesto. Esta es una diferencia diferente de los correos electrónicos de alerta de presupuesto, que solo se envían cuando se alcanza un límite de presupuesto.
• Las notificaciones de Pub/Sub se envían incluso si no tiene uso la cuenta de Facturación de Cloud.
• Puede tomar varias horas antes de recibir la primera notificación de Pub/Sub.
• Pub/Sub solo garantiza una entrega al menos una vez. Es posible que recibas un mensaje varias veces y que estos lleguen de forma desordenada.

• Si la entrega falla debido a una configuración incorrecta del tema de Pub/Sub, no recibirás ninguna notificación.

  La entrega puede fallar por uno de los siguientes motivos:

  • Ya no existe el tema de Pub/Sub.
  • La Facturación de Cloud ya no tiene permiso para publicar en el tema de Pub/Sub.
  • Superaste la cuota de notificaciones.