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 de 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 no detienen 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 se 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 de 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 aptos a esta lista para los presupuestos con límite de inversión, así que consulta la lista 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 la inversión 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ó explícitamente para 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 nuevo uso de ese servicio por el resto del mes.Quita un límite de inversión aplicado de forma opcional.
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 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 de 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 con límite de gasto 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 en 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 el gasto 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.
El 50% y el 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 cualquier "contacto esencial" aplicable.
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 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 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 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 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 con un límite de inversión aplicado y, luego, haz clic en Aumento.
Ten en cuenta que también puedes aumentar los límites de inversión obligatorios con la consola de Google Cloud.
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í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 presupuesto único con límite de inversión que abarque varios proyectos o servicios.
Cuando estableces un presupuesto con 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 aplica 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).
Intervalo de tiempo 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 todos los meses de forma predeterminada. Si no quitas un límite de inversión aplicado, el servicio permanecerá pausado solo durante el mes actual.
De forma predeterminada, al comienzo del mes siguiente, se quitará automáticamente un límite de inversión aplicado y se reanudará el servicio.
Sin embargo, puedes ajustar la configuración del presupuesto del límite de inversión para que este siga vigente (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 aumentas 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 del límite de inversión para que este siga aplicándose (y el servicio siga 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 documentación de Google Cloud.