En esta página, se describe cómo configurar y administrar presupuestos con límite de inversión cuando tu proyecto de Firebase usa el plan de precios Blaze.
Los presupuestos con límite de inversión están disponibles para los siguientes servicios seleccionados de Firebase: Firebase AI Logic, Firebase App Hosting, Cloud Functions for Firebase y Firebase Extensions.
Ir a las instrucciones para configurar un límite de inversión
Comprende los presupuestos
Puedes controlar tus costos y evitar sorpresas en tu factura creando presupuestos para Google Cloud Billing. Los presupuestos son importes monetarios generales que planeas gastar cada mes y pueden ser presupuestos solo con alertas o presupuestos con límite de inversión.
Presupuestos solo con alertas
Si la inversión alcanza los límites establecidos para tu presupuesto, Cloud Billing envía notificaciones por correo electrónico.
Ten en cuenta lo siguiente:
Las alertas de presupuesto nodetienen los servicios. Su objetivo es ayudarte a supervisar tus costos y alertarte para que puedas tomar medidas, si es necesario. Por ejemplo, puedes considerar usar notificaciones de presupuesto para inhabilitar la facturación en el proyecto.
Cuando actualizas al plan de precios Blaze en la consola de Firebase, se te solicita automáticamente que configures un presupuesto solo para alertas. También puedes configurar manualmente presupuestos solo para alertas en la consola de Google Cloud.
Presupuestos con límite de inversión (esta página)
Si la inversión alcanza los límites establecidos para tu presupuesto de un servicio específico, Cloud Billing envía notificaciones por correo electrónico.
Si la inversión alcanza el 100% de tu presupuesto para ese servicio, Cloud Billing pausará el servicio durante el resto del mes.
Ten en cuenta lo siguiente:
Los presupuestos con límites de inversión solo están disponibles para los siguientes servicios de Firebase: Firebase AI Logic, Firebase App Hosting, Cloud Functions for Firebase y Firebase Extensions.
Puedes configurar manualmente presupuestos con límite de inversión en la consola de Firebase (como se describe en esta página) o en la consola de Google Cloud.
- Antes de configurar un presupuesto con límite de inversión, revisa la información importante sobre los presupuestos con límite de inversión que se incluye más adelante en esta página.
Descripción general de los presupuestos con límite de inversión
Antes de configurar un presupuesto con límite de inversión, revisa la información de esta sección, que incluye la lista de servicios aptos y los posibles estados del límite de inversión. También te recomendamos que revises las limitaciones de los presupuestos con límite de inversión más adelante en esta página.
También puedes encontrar una lista de preguntas frecuentes sobre los presupuestos con límite de inversión en la documentación de Google Cloud.
Servicios aptos
Los presupuestos con límites de inversión se pueden configurar para los siguientes servicios de Firebase:
- Firebase AI Logic: Establece límites en el acceso a Gemini Developer API o Agent Platform Gemini API (formerly Vertex AI).
- Firebase App Hosting: Establece límites en el servicio subyacente de Cloud Run.
- Cloud Functions for Firebase: Establece límites en el servicio subyacente de Cloud Run Functions.
- Firebase Extensions: Establece límites en el servicio subyacente de Cloud Run Functions.
Estamos trabajando para agregar más servicios a esta lista de servicios aptos para los presupuestos con límite de inversión, así que revísala periódicamente.
Estados del límite de inversión
Un límite de inversión puede tener uno de los siguientes estados:
Configurado: Cloud Billing supervisa activamente el gasto de tu proyecto en un servicio específico según tu presupuesto con límite de inversión.
Aplicado: La inversión de tu proyecto alcanzó el 100% del presupuesto mensual establecido para ese servicio, por lo que Cloud Billing aplicó el límite de inversión. Se pausará cualquier nuevo uso del servicio por el resto del mes, a menos que se quite explícitamente el límite de inversión aplicado.
Quitado: Cloud Billing había aplicado el límite de inversión (y pausado cualquier uso nuevo del servicio aplicable), pero el límite de inversión aplicado se quitó de forma explícita para reanudar el servicio.
Mientras está en el estado Sin límite, el servicio se ejecuta sin límite de inversión durante el resto del mes, a menos que vuelvas a configurar o aumentar el límite. Al comienzo del mes siguiente, se vuelve a habilitar automáticamente el presupuesto original del límite de inversión.
Si no quitas un límite de inversión aplicado, el servicio permanecerá pausado solo durante el mes actual. Luego, al comienzo del mes siguiente, el límite de inversión aplicado se restablecerá automáticamente y se reanudará el servicio.
Cómo configurar y administrar límites de inversión
Configura un presupuesto con límite de inversión.
Configura un presupuesto con límite de inversión para que Cloud Billing pueda comenzar a supervisar de forma activa la inversión de tu proyecto en un servicio específico.Comprende las alertas y la aplicación del límite de inversión.
Si la inversión de tu proyecto alcanza ciertos límites de tu presupuesto mensual para ese servicio, Cloud Billing envía correos electrónicos de alerta y aplica el límite de inversión. La aplicación significa que se pausará cualquier uso nuevo de ese servicio por el resto de ese mes.De manera opcional, puedes quitar un límite de inversión aplicado (o aumentar su presupuesto).
Si deseas reanudar el uso de un servicio pausado ese mes (ya sea sin límite o con un presupuesto más alto), debes quitar explícitamente el límite de inversión aplicado.
Permisos necesarios
Para configurar y administrar un presupuesto con límite de inversión, necesitas acceso de nivel de administrador al proyecto y a su cuenta de Cloud Billing vinculada. Cualquiera de las siguientes opciones te otorga los permisos necesarios:
Opción 1: Rol de administrador de cuentas de facturación en la cuenta de Cloud Billing vinculada al proyecto
Opción 2: Rol de Propietario del proyecto en el proyecto en el que deseas configurar presupuestos con límite de inversión
Opción 3: La siguiente combinación de roles de IAM a nivel del proyecto y de la cuenta de Cloud Billing:
Rol de Administrador de costos de la cuenta de facturación en la cuenta de Cloud Billing vinculada al proyecto
y
Rol de editor del proyecto en el proyecto en el que deseas configurar los presupuestos con límite de inversión
Configura un presupuesto con límite de inversión
Para que Cloud Billing comience a supervisar activamente tu inversión en un servicio, debes configurar un presupuesto de límite de inversión para ese servicio. Si tu proyecto alcanza ciertos límites de inversión para ese servicio, Cloud Billing enviará correos electrónicos de alerta y aplicará el límite de inversión.
Sigue estos pasos para configurar presupuestos con límite de inversión a través de la consola de Firebase:
Accede a tu proyecto en Firebase console y, luego, ve a la página Detalles y configuración de
Configuración > Uso y facturación.Ve a la tarjeta Límites de inversión de nivel de servicio.
Busca el servicio al que deseas establecer un límite, configura el importe de tu presupuesto mensual y, luego, haz clic en Configurar.
Un presupuesto con límite de inversión se limita a un solo proyecto y a un solo servicio apto dentro de ese proyecto.
El período de un presupuesto con límite de inversión es mensual y comienza el primer día de cada mes.
Ten en cuenta que también puedes configurar presupuestos con límites de inversión a través de la consola de Google Cloud.
Correos electrónicos de alerta y aplicación del límite de inversión
Después de configurar un presupuesto con límite de inversión, Cloud Billing supervisará activamente la inversión de tu proyecto en ese servicio. Enviará correos electrónicos de alerta y aplicará el límite de inversión según los siguientes umbrales de inversión para el presupuesto del límite de inversión de ese servicio.
50% y 80% del presupuesto establecido:
- Cloud Billing envía correos electrónicos de alerta de advertencia a todos los administradores de facturación, los propietarios del proyecto y los "contactos esenciales" aplicables.
100% del presupuesto establecido:
Cloud Billing Aplica el límite de inversión, lo que significa que se pausará cualquier uso nuevo del servicio aplicable por el resto del mes, a menos que quites explícitamente el límite de inversión aplicado.
Cloud Billing envía otro correo electrónico de alerta. Además, en las consolas de Firebase y Google Cloud, se muestran notificaciones de banner sobre la aplicación del límite de inversión y el servicio en pausa.
Impacto y manejo de errores del cliente
Cuando se pausa un servicio debido a un límite de inversión aplicado, tu app del cliente comenzará a arrojar errores para ese servicio. Debes controlar estas excepciones de forma correcta en el código de tu app (por ejemplo, con bloques try-catch).
Cómo aumentar un límite de inversión aplicado
Si se activa y aplica un límite de inversión, se pausará todo nuevo uso del servicio aplicable por el resto del mes, a menos que quites explícitamente el límite de inversión aplicado.
Sigue estos pasos para quitar un límite de inversión aplicado con la consola de Firebase:
Accede a tu proyecto en Firebase console y, luego, ve a la página Detalles y configuración de
Configuración > Uso y facturación.Ve a la tarjeta Límites de inversión de nivel de servicio.
Ubica el servicio con un límite de inversión aplicado y, luego, haz clic en Efectividad.
Ten en cuenta que también puedes aumentar los límites de inversión obligatorios con la consola de Google Cloud.
Cómo aumentar un límite de inversión después de la aplicación
Si se aplica tu límite de inversión y quieres reanudar el servicio con un presupuesto más alto durante el resto del mes (por ejemplo, aumentar tu límite de USD 10 a USD 20), no puedes editar el importe del presupuesto mientras el límite esté en el estado Aplicado. Primero debes quitar el límite antes de establecer uno más alto.
Sigue estos pasos para reanudar un servicio y aumentar su límite de inversión:
Levanta el límite de inversión: En la consola de Firebase o Google Cloud, busca el servicio aplicado y, luego, haz clic en Levantar.
El límite de gasto entrará en un estado pendiente mientras se quita la aplicación.
Espera a que se complete el aumento: Espera unos minutos y actualiza la página hasta que el estado del límite de inversión muestre Aumentado.
Se reanudará el servicio. Según el servicio, esto puede tardar hasta una hora.
Actualiza el importe del presupuesto: Para ello, ingresa el nuevo importe mensual más alto del presupuesto con límite de inversión. Guarda los cambios.
Consideraciones importantes cuando se aumenta un límite:
Vinculado a la inversión total del mes actual: El nuevo importe del presupuesto sigue vinculado a tu inversión total acumulada del mes actual, incluidos los excesos de costos que se generaron durante las demoras en la generación de informes antes de que se aplicara el límite.
Establece un presupuesto superior a la inversión del mes actual: Asegúrate de que tu nuevo presupuesto sea superior a lo que ya invertiste este mes (incluidos los excedentes). De lo contrario, se activará el límite y se pausará el servicio de inmediato.
Cálculo del presupuesto restante: Tu presupuesto restante para el mes es el importe del nuevo límite menos tu inversión total hasta el momento. Por ejemplo:
Estableces un límite de inversión de USD 10 en Cloud Functions for Firebase.
Tu inversión alcanza los USD 10 (más un exceso de USD 1 durante la demora en la generación de informes, lo que suma USD 11). Se aplica el límite y se pausan tus funciones.
Confirmas que el tráfico es legítimo, por lo que quitas el límite y esperas a que el estado muestre Lifted.
Actualizas el límite de inversión a USD 20. Cuando guardes esta modificación, el límite de inversión se restablecerá al estado Configurado.
Tus funciones seguirán ejecutándose con el nuevo límite de USD 20, con aproximadamente USD 9 de presupuesto restante para el mes (límite de USD 20 menos los USD 11 ya acumulados).
Al mes siguiente, el presupuesto del límite de inversión mantendrá el umbral de USD 20.
Limitaciones de los presupuestos con límite de inversión
Estas son algunas limitaciones importantes que debes comprender sobre los presupuestos con límite de inversión:
Los presupuestos con límites de inversión no son "límites estrictos". Debido a la latencia en los informes de uso, la aplicación del límite de inversión no es instantánea y puede demorarse varios minutos. Los excedentes de costos que se generen durante esta demora se facturarán de la manera habitual. Considera establecer tu presupuesto un poco por debajo de tu límite absoluto.
Se limita al proyecto y al servicio. Un presupuesto con límite de inversión se limita a un solo proyecto y a un solo servicio apto dentro de ese proyecto.
No puedes establecer un presupuesto con límite de inversión a nivel de toda la cuenta de Cloud Billing ni a nivel de la carpeta, la organización o la etiqueta.
No puedes establecer un solo presupuesto con límite de inversión que abarque varios proyectos o servicios.
Cuando estableces un presupuesto de límite de inversión para un servicio, este se aplica a cualquiera de las formas en que puedes interactuar con el servicio en el proyecto. Por ejemplo, si estableces un presupuesto en Agent Platform Gemini API (formerly Vertex AI), también se aplicará a cualquier uso de esa API en el proyecto a través de Firebase SQL Connect, el ADK, Genkit, etcétera (no solo el uso a través de Firebase AI Logic).
Período mensual. El período de un presupuesto con límite de inversión es mensual y comienza el primer día de cada mes.
El servicio se reanuda automáticamente cada mes.
Si no quitas un límite de inversión aplicado, el servicio permanecerá pausado solo durante el mes actual. Al comienzo del mes siguiente, el límite de inversión aplicado se restablece automáticamente al estado Configurado con el presupuesto original y se reanuda el servicio.
Si quitas un límite de inversión aplicado durante el mes y no cambias el presupuesto, el servicio se ejecutará sin un límite de inversión durante el resto de ese mes, y el límite de inversión se restablecerá automáticamente al estado Configurado con el presupuesto original, y se reanudará el servicio.
No incluye ahorros ni créditos. Los cálculos de costos para un presupuesto con límite de inversión se basan en los costos brutos y no incluyen ahorros ni créditos.
Si tienes una configuración de facturación más avanzada, puedes encontrar más detalles sobre las limitaciones de los presupuestos con límite de inversión en la documentación de Google Cloud.