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.
Ir para as instruções de configuração de um limite de gastos
Entender os orçamentos
Para controlar os custos e evitar surpresas na sua fatura, crie orçamentos para 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 o orçamento, o Cloud Billing envia notificações por e-mail.
Observações:
Os alertas de orçamento não pausam os serviços. Eles ajudam você a monitorar seus custos e alertam 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 envia notificações por e-mail.
Se os gastos atingirem 100% do orçamento para esse serviço, o Cloud Billing vai 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 com limite de gastos, leia as informações importantes sobre esse tipo de orçamento 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 de acesso a Gemini Developer API ou Agent Platform Gemini API (formerly Vertex AI).
- Firebase App Hosting: define limites no serviço Cloud Run.
- 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 orçamentos de limite de gastos qualificados. 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 com um serviço específico com base no orçamento com limite de gastos.
Aplicado: os gastos do 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 de gastos aplicado foi explicitamente suspenso para retomar o serviço.
Enquanto estiver no estado Suspenso, o serviço será executado sem limite de gastos pelo restante do mês, a menos que você reconfigure ou aumente o limite. No início do próximo mês, o orçamento original com limite de gastos será reativado automaticamente.
Se você não suspender um limite de gastos aplicado, o serviço vai permanecer pausado apenas no mês atual. No início do mês seguinte, o limite de gastos aplicado será redefinido automaticamente, e o serviço será retomado.
Configurar e gerenciar limites de gastos
Configure um orçamento de 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 os gastos do seu projeto atingirem 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.Se quiser, remova um limite de gastos aplicado ou aumente o orçamento dele.
Se você quiser retomar o uso de um serviço pausado naquele mês (sem limite ou com um orçamento maior), suspenda explicitamente o limite de gastos aplicado.
Permissões necessárias
Para configurar e gerenciar um orçamento de limite de gastos, é necessário 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: Papel de Admin da conta de faturamento na conta Cloud Billing vinculada ao projeto
Opção 2: Função de proprietário do projeto no projeto em que você quer configurar os 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 de gerente de custos da conta de faturamento na conta Cloud Billing vinculada ao projeto
e
Função Editor de projeto no projeto em que você quer configurar orçamentos de limite de gastos
Configurar um orçamento com limite de gastos
Para que o Cloud Billing comece a monitorar seus gastos com um serviço, é preciso 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 com 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 limite de gastos usando o console do 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 em 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 aumentar 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.
Aumentar um limite de gastos após a aplicação
Se o limite de gastos estiver em vigor e você quiser retomar o serviço com um orçamento maior pelo restante do mês (por exemplo, aumentando o limite de US$ 10 para US $20), não será possível editar o valor do orçamento enquanto o limite estiver no estado Aplicado. Primeiro, você precisa remover o limite antes de definir um valor maior.
Saiba como retomar um serviço e aumentar o limite de gastos dele:
Remover o limite de gastos:no console do Firebase ou do Google Cloud, localize o serviço aplicado e clique em Remover.
O limite de gastos vai entrar em um estado pendente enquanto a aplicação é removida.
Aguarde a conclusão da suspensão:aguarde alguns minutos e atualize a página até que o status do limite de gastos mostre Suspenso.
O serviço será retomado. Dependendo do serviço, isso pode levar até uma hora.
Atualize o valor do orçamento:edite o orçamento de limite de gastos inserindo o novo valor do orçamento mensal mais alto. Salve as alterações.
Considerações importantes ao aumentar um limite máximo:
Vinculado ao gasto total do mês atual:o novo valor do orçamento ainda está vinculado ao gasto total acumulado do mês atual, incluindo os excedentes de custo incorridos durante os atrasos nos relatórios antes da aplicação do limite.
Defina um orçamento maior do que o gasto do mês atual:verifique se o novo orçamento é maior do que o valor gasto neste mês (incluindo excedentes). Caso contrário, o limite será acionado e pausará o serviço novamente imediatamente.
Cálculo do orçamento restante:o orçamento restante para o mês é o novo valor do limite menos o gasto total até o momento. Exemplo:
Você definiu um limite de gastos de US $10 em Cloud Functions for Firebase.
Seu gasto atinge US $10 (mais um sobreuso de US $1 durante o atraso no relatório, totalizando US $11). O limite é aplicado, pausando suas funções.
Você confirma que o tráfego é legítimo, então aumenta o limite e aguarda o estado mostrar Aumentado.
Você atualiza o limite de gastos para US $20. Quando você salva essa modificação, o limite de gastos volta ao estado Configurado.
Suas funções continuam sendo executadas com o novo limite de US $20, com aproximadamente US $9 de orçamento restantes para o mês (limite de US$ 20 menos US$ 11 já acumulados).
No mês seguinte, o orçamento do limite de gastos vai manter o limite de US $20.
Limitações dos orçamentos com limite de gastos
Confira algumas 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 adiada por vários minutos. Os custos excedentes incorridos durante esse atraso serão faturados normalmente. Considere definir um orçamento um pouco abaixo do seu limite absoluto.
Com 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 dentro desse 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 abranja 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 por Firebase SQL Connect, ADK, Genkit etc. (não apenas o uso por 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 automaticamente a cada mês.
Se você não suspender um limite de gastos aplicado, o serviço vai permanecer pausado apenas no mês atual. No início do mês seguinte, o limite de gastos aplicado é redefinido automaticamente para o estado Configurado com o orçamento original, e o serviço é retomado.
Se você suspender um limite de gastos aplicado durante o mês e não mudar o orçamento, o serviço será executado sem um limite de gastos pelo restante do mês. O limite de gastos será redefinido automaticamente para o estado Configurado com o orçamento original, e o serviço será retomado.
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.