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 de Firebase seleccionados: 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
Información sobre 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 de alertas o presupuestos con límite de inversión.
Presupuestos solo de alertas
Si la inversión alcanza los límites establecidos para tu presupuesto, entonces Cloud Billing envía notificaciones por correo electrónico.
Ten en cuenta lo siguiente:
Las alertas de presupuesto no pausan los servicios. Están diseñadas para 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 Firebase consola, se te solicita automáticamente que configures un presupuesto solo de alertas. También puedes configurar presupuestos solo de alertas de forma manual en la Google Cloud consola.
Presupuestos con límite de inversión (esta página)
Si la inversión alcanza los límites establecidos para tu presupuesto para un servicio específico, la Facturación de Cloud Cloud Billing envía notificaciones por correo electrónico.
Si la inversión alcanza el 100% de tu presupuesto para ese servicio, entonces Cloud Billing pausa ese servicio durante el resto del mes.
Ten en cuenta lo siguiente:
Los presupuestos con límite 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 presupuestos con límite de inversión de forma manual en la consola Firebase (como se describe en esta página) o en la consola 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 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 Google Cloud documentación.
Servicios aptos
Se pueden configurar presupuestos con límite de inversión 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 Cloud Run.
- Cloud Functions for Firebase: Establece límites en el servicio subyacente de Cloud Functions.
- Firebase Extensions: Establece límites en el servicio subyacente Cloud 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 vuelve a consultarla periódicamente.
Estados del límite de inversión
Un límite de inversión puede estar en uno de los siguientes estados:
- Configurado: Cloud Billing supervisa de forma activa la inversión de tu proyecto para un servicio específico en función de tu presupuesto con límite de inversión.
- Aplicado: La inversión de tu proyecto alcanzó el 100% de tu presupuesto mensual establecido para ese servicio, por lo que se Cloud Billing aplicó el límite de inversión. Se pausará cualquier nuevo uso del servicio durante 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 se quitó explícitamente el límite de inversión aplicado para reanudar el servicio.
Configura y administra los 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 para 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 durante el resto del mes.De manera opcional, quita un límite de inversión aplicado.
Si deseas reanudar el uso de un servicio pausado ese mes, 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 Cloud Billingvinculada. Cualquiera de las siguientes opciones te otorga los permisos necesarios:
Opción 1: Administrador de cuentas de facturación rol en la cuenta 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 Cloud Billing de Facturación de Cloud:
Rol de _Administrador de costos de la cuenta de facturación_ en la cuenta Cloud Billing vinculada al proyecto
y
Rol de Editor del proyecto en el proyecto en el que deseas configurar presupuestos con límite de inversión
Configura un presupuesto con límite de inversión
Para que Cloud Billing comience a supervisar de forma activa tu inversión en un servicio, debes configurar un presupuesto con límite de inversión para ese servicio. Si tu proyecto alcanza ciertos límites de inversión para ese servicio, entonces 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 con Firebase console:
Accede a tu proyecto en la consola Firebase y, luego, ve a la página
Configuración > Uso y facturación > Detalles y configuración.Ve a la tarjeta Límites de inversión a nivel del servicio.
Busca el servicio que deseas limitar, establece 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 intervalo de tiempo para 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ímite de inversión con la Google Cloud consola.
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á de forma activa la inversión de tu proyecto para ese servicio. Enviará correos electrónicos de alerta y aplicará el límite de inversión en función de los siguientes límites de inversión para el presupuesto con 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, propietarios del proyecto y cualquier "contacto esencial".
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 durante 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, la Firebase consola y la Google Cloud consola muestran notificaciones de banner sobre la aplicación del límite de inversión y el servicio pausado.
Impacto del cliente y manejo de errores
Cuando se pausa un servicio debido a un límite de inversión aplicado, tu app del cliente comenzará a generar errores para ese servicio. Debes controlar estas excepciones correctamente en el código de tu app (por ejemplo, con bloques try-catch).
Quita un límite de inversión aplicado
Si se activa y aplica un límite de inversión, se pausará todo**uso nuevo** del servicio aplicable durante 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 Firebase consola:
Accede a tu proyecto en la consola Firebase y, luego, ve a la página
Configuración > Uso y facturación > Detalles y configuración.Ve a la tarjeta Límites de inversión a nivel del servicio.
Busca el servicio con un límite de inversión aplicado y, luego, haz clic en Quitar.
Ten en cuenta que también puedes quitar los límites de inversión aplicados con la Google Cloud consola.
Limitaciones de los presupuestos con límite de inversión
Las siguientes son limitaciones importantes que debes comprender sobre los presupuestos con límite de inversión:
Los presupuestos con límite 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 demorar varios minutos. Todos los excedentes de costos generados durante esta demora se facturarán de forma normal. Considera establecer tu presupuesto un poco por debajo de tu límite absoluto.
Alcance del proyecto y del 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 en todo el nivel de la cuenta Cloud Billing ni en el nivel de la carpeta, la organización o la etiqueta.
No puedes establecer un solo presupuesto con límite de inversión que cubra varios proyectos o varios servicios.
Cuando estableces un presupuesto con límite de inversión para un servicio, se aplica a cualquiera de las formas en que podrías interactuar con el servicio en el proyecto. Por ejemplo, si estableces un presupuesto en Agent Platform Gemini API (formerly Vertex AI), también se aplica a cualquier uso de esa API en el proyecto a través de Firebase SQL Connect, ADK, Genkit, etcétera (no solo el uso a través de Firebase AI Logic).
Intervalo de tiempo mensual. El intervalo de tiempo de un presupuesto con límite de inversión es mensual y comienza el primer día de cada mes.
El servicio se reanuda cada mes de forma predeterminada. Si no quitas un límite de inversión aplicado, el servicio permanecerá pausado durante el mes actual solamente.
De forma predeterminada, al comienzo del mes siguiente, se quitará automáticamente el límite de inversión aplicado y se reanudará el servicio.
Sin embargo, puedes ajustar la configuración del presupuesto con límite de inversión para que el límite de inversión permanezca aplicado (y el servicio permanezca pausado) de forma indefinida hasta que quites explícitamente el límite de inversión aplicado.
De forma predeterminada, si no quitas un límite de inversión aplicado, el servicio permanecerá pausado durante el mes actual, pero se reanudará automáticamente al comienzo del mes siguiente. Sin embargo, puedes ajustar la configuración del presupuesto con límite de inversión para que el límite de inversión permanezca aplicado (y el servicio permanezca pausado) de forma indefinida hasta que quites explícitamente el límite de inversión aplicado.
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 Google Cloud documentación.