Esta página descreve como configurar e gerenciar orçamentos de limite de gastos quando o projeto do Firebase está no plano de preços Blaze.
Os orçamentos de limite de gastos estão disponíveis para os seguintes serviços selecionados do Firebase: Firebase AI Logic, Firebase App Hosting, Cloud Functions for Firebase, e Firebase Extensions.
Ir para as instruções de configuração de um limite de gastos
Entender os orçamentos
Você pode controlar seus custos e evitar surpresas na fatura criando orçamentos para Google Cloud Billing. Os orçamentos são valores monetários gerais que você planeja gastar a cada mês e podem ser orçamentos somente de alertas ou orçamentos de limite de gastos.
Orçamentos somente de alertas
Se os gastos atingirem os limites definidos para o orçamento, então Cloud Billing enviará notificações por e-mail.
Observações:
Os alertas de orçamento não pausam os serviços. Eles são destinados a ajudar você a monitorar seus custos e alertar para que você possa tomar medidas, se necessário. Por exemplo, considere usar notificações de orçamento para desativar o faturamento no projeto.
Ao fazer upgrade para o plano de preços Blaze no Firebase console, você receberá automaticamente uma solicitação para configurar um orçamento somente de alertas. Também é possível configurar orçamentos somente de alertas manualmente no Google Cloud console.
Orçamentos de limite de gastos (esta página)
Se os gastos atingirem os limites definidos para o orçamento de um serviço específico, então Cloud Billing enviará notificações por e-mail.
Se os gastos atingirem 100% do orçamento desse serviço, então Cloud Billing pausará o serviço pelo restante do mês.
Observações:
Os orçamentos de limite de gastos estão disponíveis apenas para os seguintes serviços do Firebase: Firebase AI Logic, Firebase App Hosting, Cloud Functions for Firebase, e Firebase Extensions.
É possível configurar orçamentos de limite de gastos manualmente no console Firebase (conforme descrito nesta página) ou no Google Cloud console.
- Antes de configurar um orçamento de limite de gastos, revise as informações importantes sobre orçamentos de limite de gastos mais adiante nesta página.
Visão geral dos orçamentos de limite de gastos
Antes de configurar um orçamento de limite de gastos, revise as informações nesta seção, que inclui a lista de serviços qualificados e possíveis estados de limite de gastos. Também recomendamos revisar as limitações dos orçamentos de limite de gastos mais adiante nesta página.
Você também pode encontrar uma lista de perguntas frequentes sobre orçamentos de limite de gastos na documentação Google Cloud.
Serviços qualificados
Os orçamentos de limite de gastos podem ser configurados para os seguintes serviços do Firebase:
- Firebase AI Logic: defina limites de acesso a Gemini Developer API ou Agent Platform Gemini API (formerly Vertex AI).
- Firebase App Hosting: defina limites no serviço Cloud Run subjacente.
- Cloud Functions for Firebase: defina limites no serviço subjacente Cloud Run functions.
- Firebase Extensions: defina limites no serviço Cloud Run functions subjacente.
Estamos trabalhando para adicionar à lista de serviços qualificados para orçamentos de limite de gastos. Consulte a lista periodicamente.
Estados de limite de gastos
Um limite de gastos pode estar em um dos seguintes estados:
- Configurado: Cloud Billing está monitorando ativamente os gastos do projeto para um serviço específico com base no orçamento de limite de gastos.
- Aplicado: os gastos do projeto atingiram 100% do orçamento mensal definido para esse serviço, então Cloud Billing aplicou o limite de gastos. Qualquer novo uso do serviço pelo restante do mês será pausado, a menos que o limite de gastos aplicado seja explicitamente suspenso.
- Suspenso: Cloud Billing havia aplicado o limite de gastos (e pausado qualquer novo uso do serviço aplicável), mas o limite de gastos aplicado foi explicitamente suspenso para retomar o serviço.
Configurar e gerenciar limites de gastos
Configurar um orçamento de limite de gastos.
Configure um orçamento de limite de gastos para que Cloud Billing possa começar a monitorar ativamente os gastos do projeto para um serviço específico.Entender os alertas e a aplicação do limite de gastos
Se os gastos do projeto atingirem determinados limites do orçamento mensal para esse serviço, Cloud Billing enviará e-mails de alerta e aplicará o limite de gastos. Aplicação significa que qualquer novo uso desse serviço será pausado pelo restante do mês.Suspender um limite de gastos aplicado (opcional)
Se você quiser retomar o uso de um serviço pausado naquele mês, será necessário suspender explicitamente o limite de gastos aplicado.
Permissões necessárias
Para configurar e gerenciar um orçamento de limite de gastos, você precisa de acesso de administrador ao projeto e à conta Cloud Billing vinculada a ele. Qualquer uma das opções a seguir concede as permissões necessárias:
Opção 1: Admin da conta de faturamento papel na conta Cloud Billing vinculada ao projeto
Opção 2: Proprietário do projeto papel no projeto em que você quer configurar orçamentos de limite de gastos
Opção 3: a combinação a seguir de papéis do IAM de Cloud Billingconta e para envolvidos no projeto:
Papel _Gerente de custos da conta de faturamento_ Cloud Billing na conta vinculada ao projeto
e
Papel Editor do projeto no projeto em que você quer configurar orçamentos de limite de gastos
Configurar um orçamento de limite de gastos
Para que Cloud Billing comece a monitorar ativamente seus gastos para um serviço, é necessário configurar um orçamento de limite de gastos para esse serviço. Se o projeto atingir determinados limites de gastos para esse serviço, então Cloud Billing enviará e-mails de alerta e aplicará o limite de gastos.
Saiba como configurar orçamentos de limite de gastos usando o Firebase console:
Acesse seu projeto no console Firebase e vá para a página
Configurações > Uso e faturamento > Detalhes e configurações.Acesse o card Limites de gastos no nível do serviço.
Localize o serviço que você quer limitar, defina o valor do orçamento mensal e clique em Configurar.
Um orçamento de limite de gastos tem escopo definido para um único projeto e um único serviço qualificado nesse projeto.
O período de um orçamento de limite de gastos é mensal, começando no primeiro dia de cada mês.
Também é possível configurar orçamentos de limite de gastos usando o Google Cloud console.
E-mails de alerta e aplicação do limite de gastos
Depois de configurar um orçamento de limite de gastos, Cloud Billing vai monitorar ativamente os gastos do projeto para esse serviço. Ele vai enviar e-mails de alerta e aplicar o limite de gastos com base nos seguintes limites de gastos para o orçamento de limite de gastos desse serviço.
50% e 80% do orçamento definido:
- Cloud Billing envia e-mails de alerta de aviso a todos os administradores de faturamento, proprietários do projeto e qualquer "contato essencial".
100% do orçamento definido:
Cloud Billing aplica o limite de gastos, o que significa que qualquer novo uso do serviço aplicável será pausado pelo restante do mês a menos que você suspenda explicitamente o limite de gastos aplicado.
Cloud Billing envia outro e-mail de alerta. Além disso, o Firebase console e o Google Cloud console mostram notificações de banner sobre a aplicação do limite de gastos e o serviço pausado.
Impacto no lado do cliente e tratamento de erros
Quando um serviço é pausado devido a um limite de gastos aplicado, o app do lado do cliente começa a gerar erros para esse serviço. Você precisa processar essas exceções normalmente no código do app (por exemplo, usando blocos try-catch).
Suspender um limite de gastos aplicado
Se um limite de gastos for acionado e aplicado, todo novo uso do serviço aplicável será pausado pelo restante do mês, a menos que você suspenda explicitamente o limite de gastos aplicado.
Saiba como suspender um limite de gastos aplicado usando o Firebase console:
Acesse seu projeto no console Firebase e vá para a página
Configurações > Uso e faturamento > Detalhes e configurações.Acesse o card Limites de gastos no nível do serviço.
Localize o serviço com um limite de gastos aplicado e clique em Suspender.
Também é possível suspender limites de gastos aplicados usando o Google Cloud console.
Limitações dos orçamentos de limite de gastos
A seguir, confira as limitações importantes dos orçamentos de limite de gastos:
Os orçamentos de limite de gastos não são "limites fixos". Devido à latência nos relatórios de uso, a aplicação do limite de gastos não é instantânea e pode ser atrasada em vários minutos. Quaisquer custos excedentes incorridos durante esse atraso serão faturados normalmente. Considere definir seu orçamento um pouco abaixo do limite absoluto.
Escopo do projeto e do serviço. Um orçamento de limite de gastos tem escopo definido para um único projeto e um único serviço qualificado nesse projeto.
Não é possível definir um orçamento de limite de gastos em toda a conta Cloud Billing ou no nível da pasta, organização ou rótulo.
Não é possível definir um único orçamento de limite de gastos que cubra vários projetos ou serviços.
Quando você define um orçamento de limite de gastos para um serviço, ele é aplicado a qualquer uma das maneiras de interagir com o serviço no projeto. Por exemplo, se você definir um orçamento em Agent Platform Gemini API (formerly Vertex AI), ele também será aplicado a qualquer uso dessa API no projeto via Firebase SQL Connect, ADK, Genkit, etc. (não apenas o uso via Firebase AI Logic).
Período mensal. O período de um orçamento de limite de gastos é mensal, começando no primeiro dia de cada mês.
O serviço é retomado a cada mês por padrão. Se você não suspender um limite de gastos aplicado, o serviço vai permanecer pausado apenas no mês atual.
Por padrão, no início do mês seguinte, um limite de gastos aplicado será suspenso automaticamente e o serviço será retomado.
No entanto, é possível ajustar as configurações do orçamento de limite de gastos para que o limite de gastos permaneça aplicado (e o serviço permaneça pausado) indefinidamente até que você suspenda explicitamente o limite de gastos aplicado.
Por padrão, se você não suspender um limite de gastos aplicado, o serviço vai permanecer pausado no mês atual, mas será retomado automaticamente no início do mês seguinte. No entanto, é possível ajustar as configurações do orçamento de limite de gastos para que o limite de gastos permaneça aplicado (e o serviço permaneça pausado) indefinidamente até que você suspenda explicitamente o limite de gastos aplicado.
Não inclui economias e créditos. Os cálculos de custo para um orçamento de limite de gastos são baseados em custos brutos e não incluem economias e créditos.
Se você tiver uma configuração de faturamento mais avançada, consulte mais detalhes sobre as limitações dos orçamentos de limite de gastos na documentação Google Cloud.