Nesta página, descrevemos como configurar e gerenciar orçamentos de limite de gastos quando seu 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.
Acesse as instruções para configurar um limite de gastos
Entender os orçamentos
Para controlar os custos e evitar surpresas na fatura, crie orçamentos para o Google Cloud Billing. Os orçamentos são valores gerais em dólar que você planeja gastar por mês e podem ser orçamentos somente de alertas ou orçamentos de limite de gastos.
Orçamentos somente com alertas
Se os gastos atingirem os limites definidos para seu orçamento, o Cloud Billing envia notificações por e-mail.
Observações:
Os alertas de orçamento não pausam os serviços. O objetivo é 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 console do Firebase, você recebe automaticamente uma solicitação para configurar um orçamento somente para alertas. Também é possível configurar manualmente orçamentos somente de alertas no console do Google Cloud.
Orçamentos com limite de gastos (esta página)
Se os gastos atingirem os limites definidos para o orçamento de um serviço específico, o Cloud Billing enviará notificações por e-mail.
Se os gastos atingirem 100% do orçamento para esse serviço, 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 manualmente orçamentos de limite de gastos no console Firebase (conforme descrito nesta página) ou no console Google Cloud.
- Antes de configurar um orçamento de limite de gastos, leia 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 que você analise 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 do Google Cloud.
Serviços qualificados
É possível configurar orçamentos com limites de gastos para os seguintes serviços do Firebase:
- Firebase AI Logic: defina limites no acesso a Gemini Developer API ou Agent Platform Gemini API (formerly Vertex AI).
- Firebase App Hosting: define limites no serviço Cloud Run subjacente.
- Cloud Functions for Firebase: defina limites no serviço de funções do Cloud Run.
- Firebase Extensions: defina limites no serviço de funções do Cloud Run.
Estamos trabalhando para adicionar mais serviços a essa lista de serviços qualificados para orçamentos de limite de gastos. Consulte a lista periodicamente.
Estados do limite de gastos
Um limite de gastos pode estar em um dos seguintes estados:
- Configurado: Cloud Billing está monitorando ativamente os gastos do seu projeto em um serviço específico com base no orçamento com limite de gastos.
- Aplicado: os gastos do seu projeto atingiram 100% do orçamento mensal definido para esse serviço. Por isso, 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 aplicou o limite de gastos (e pausou qualquer novo uso do serviço aplicável), mas o limite aplicado foi suspenso explicitamente para retomar o serviço.
Configurar e gerenciar limites de gastos
Configure um orçamento com limite de gastos.
Configure um orçamento com limite de gastos para que o Cloud Billing possa começar a monitorar ativamente os gastos do seu projeto em um serviço específico.Entenda os alertas e a aplicação do limite de gastos.
Se o gasto do seu projeto atingir determinados limites do orçamento mensal desse serviço, o Cloud Billing vai 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.Suspenda um limite de gastos aplicado, se quiser.
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 ter acesso de administrador ao projeto e à conta do Cloud Billing vinculada. Qualquer uma das seguintes opções 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: papel de proprietário do projeto no projeto em que você quer configurar orçamentos de limite de gastos
Opção 3: a seguinte combinação de conta do Cloud Billing e papéis do IAM no nível do projeto:
Função Gerente de custos da conta de faturamento na conta Cloud Billing vinculada ao projeto
e
Função de editor de projeto no projeto em que você quer configurar orçamentos de limite de gastos
Configurar um orçamento de limite de gastos
Para que o Cloud Billing comece a monitorar seus gastos com um serviço, você precisa configurar um orçamento de limite de gastos para ele. Se o projeto atingir determinados limites de gastos para esse serviço, o Cloud Billing vai enviar e-mails de alerta e aplicar o limite de gastos.
Saiba como configurar orçamentos de limite de gastos usando o console Firebase:
Acesse seu projeto no console do 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 de 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 limites de gastos usando o console Google Cloud.
E-mails de alerta e aplicação do limite de gasto máximo
Depois de configurar um orçamento com limite de gastos, o Cloud Billing vai monitorar ativamente os gastos do seu projeto com 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 para todos os administradores de faturamento, proprietários do projeto e qualquer contato essencial aplicável.
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, os consoles Firebase e Google Cloud mostram notificações de banner sobre a aplicação do limite de gastos e o serviço pausado.
Impacto do 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. É preciso processar essas exceções
de maneira adequada 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 remover um limite de gastos obrigatório usando o console Firebase:
Acesse seu projeto no console do 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 obrigatório e clique em Lift.
Também é possível remover os limites de gastos obrigatórios usando o console do Google Cloud.
Limitações dos orçamentos com limite de gastos
Estas são algumas limitações importantes dos orçamentos de limite de gastos:
Os orçamentos com limites de gastos máximos 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 adiada em vários minutos. Qualquer excesso de custo incorrido durante esse atraso será faturado normalmente. Considere definir um orçamento um pouco abaixo do seu limite absoluto.
Escopo de projeto e serviço Um orçamento com limite de gastos tem escopo de um único projeto e um único serviço qualificado nesse projeto.
Não é possível definir um orçamento de limite de gastos no nível da conta Cloud Billing inteira ou no nível da pasta, da organização ou do 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 com limite de gastos para um serviço, ele se aplica a qualquer uma das maneiras de interagir com o serviço no projeto. Por exemplo, se você definir um orçamento para a 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).
Intervalo de tempo 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 forçado, o serviço vai permanecer pausado apenas no mês atual.
Por padrão, no início do próximo mês, um limite de gastos aplicado será removido automaticamente e o serviço será retomado.
No entanto, é possível ajustar as configurações de orçamento do limite de gastos para que ele permaneça aplicado (e o serviço pausado) indefinidamente até que você suspenda explicitamente o limite de gastos aplicado.
Por padrão, se você não remover um limite de gastos aplicado, o serviço vai permanecer pausado durante o mês atual, mas será retomado automaticamente no início do mês seguinte. No entanto, é possível ajustar as configurações de orçamento do limite de gastos para que ele 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, confira mais detalhes sobre as limitações dos orçamentos de limite de gastos na documentação do Google Cloud.