Definir limites de gastos para serviços do Firebase

Pré-lançamento: os orçamentos com gasto máximo estão disponíveis em Pré-lançamento, o que significa que eles não estão sujeitos a SLAs nem a políticas de descontinuação e podem mudar de maneira incompatível com versões anteriores.

Nesta página, descrevemos como configurar e gerenciar orçamentos de gasto máximo quando seu projeto do Firebase está no plano de preços Blaze.

Os orçamentos com gasto máximo estão disponíveis para os seguintes serviços do Firebase: Firebase AI Logic, Firebase App Hosting, Cloud Functions for Firebase e Firebase Extensions.

Importante: os gastos máximos não são "limites rígidos". Devido à latência nos relatórios de uso, a aplicação do gasto máximo não é instantânea e pode levar vários minutos. Os custos excedentes incorridos durante esse atraso serão faturados normalmente.
Por isso, defina seu orçamento um pouco abaixo do limite absoluto e considere os gastos máximos como apenas uma ferramenta que pode ajudar você a gerenciar seus custos e reduzir o impacto de grandes faturas inesperadas. Saiba mais sobre outras opções de alerta e lógica.

Ir para as instruções de configuração de um gasto máximo

Noções básicas sobre 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 monetários gerais que você planeja gastar por mês e podem ser orçamentos só para alertas ou orçamentos com limite de gasto.

Orçamentos só para alertas

• Se os gastos atingirem os limites definidos para seu orçamento, o Cloud Billing enviará 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 entrar em ação, 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 uma solicitação automática para configurar um orçamento só para alertas. Também é possível configurar manualmente orçamentos só para alertas no console do Google Cloud.

Orçamentos com gasto máximo (esta página)

• Se os gastos atingirem os limites definidos para seu orçamento em 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 com gasto máximo 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 os orçamentos com gasto máximo no console do Firebase (conforme descrito nesta página) ou no console do Google Cloud.

  • Antes de configurar um orçamento com gasto máximo, leia as informações importantes sobre orçamentos com gasto máximo mais adiante nesta página.

Todos os projetos do Firebase são, na verdade, projetos do Google Cloud nos bastidores, o que significa que o faturamento é compartilhado entre o Firebase e o Google Cloud, e o mesmo projeto pode ser visualizado nos consoles do Firebase e do Google Cloud.

Visão geral dos orçamentos com gasto máximo

Antes de configurar um orçamento com gasto máximo, revise as informações nesta seção, que inclui a lista de serviços qualificados e os possíveis estados do gasto máximo. Também recomendamos que você analise as limitações dos orçamentos com gasto máximo mais adiante nesta página.

Você também pode encontrar uma lista de perguntas frequentes sobre orçamentos com gasto máximo 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 ao Gemini Developer API ou ao Agent Platform Gemini API (formerly Vertex AI).
• Firebase App Hosting: defina limites no serviço Cloud Run.
• Cloud Functions for Firebase: defina limites no serviço subjacente do Cloud Run functions.
• Firebase Extensions: defina limites no serviço subjacente do Cloud Run functions.

Estamos trabalhando para adicionar mais serviços qualificados para orçamentos com gasto máximo. Por isso, volte a esta lista periodicamente.

Observação: quando você define um orçamento de gasto máximo para um dos serviços subjacentes acima, esse orçamento se aplica para envolvidos no projeto e a qualquer uma das maneiras de interagir com o serviço no projeto. Por exemplo, se você definir um orçamento na Agent Platform Gemini API (formerly Vertex AI), ele também será aplicado a qualquer uso dessa API no projeto por meio de Firebase SQL Connect, ADK, Genkit etc. (não apenas ao uso por meio de Firebase AI Logic).

Estados do gasto máximo

Um gasto máximo pode estar em um dos seguintes estados:

• Configurado: o 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 gasto máximo. Qualquer novo uso do serviço pelo restante do mês será pausado, a menos que o gasto máximo aplicado seja explicitamente suspenso.

• Suspenso: o Cloud Billing aplicou o gasto máximo (e pausou qualquer novo uso do serviço aplicável), mas o gasto máximo aplicado foi explicitamente suspenso para retomar o serviço.

  No estado Suspenso, o serviço é 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 do limite de gastos é reativado automaticamente.

Observação: modificar qualquer configuração de limite de gasto (mesmo renomear o orçamento no console do Google Cloud) faz com que o limite de gasto volte ao estado Configurado. Se os gastos mensais já atingirem ou excederem o limite do orçamento, o limite será acionado e aplicado imediatamente.

Se você não suspender um gasto máximo aplicado, o serviço vai permanecer pausado apenas no mês atual. Em seguida, no início do próximo mês, o gasto máximo aplicado será redefinido automaticamente e o serviço será retomado.

Configurar e gerenciar gastos máximos

Observação: antes de configurar um orçamento de gasto máximo, consulte a visão geral dos orçamentos de gasto máximo anteriormente nesta página.

1. Configure um orçamento com gasto máximo.
   Configure um orçamento com gasto máximo para que o Cloud Billing possa começar a monitorar ativamente os gastos do seu projeto em um serviço específico.

2. Entenda os alertas e a aplicação do limite de gastos.
   Se os gastos do seu projeto atingirem determinados limites do orçamento mensal para esse serviço, o Cloud Billing vai enviar e-mails de alerta e aplicar o limite de gastos. Aplicar significa que qualquer novo uso desse serviço será pausado pelo restante do mês.

3. Se quiser, remova um gasto máximo aplicado (ou aumente o orçamento).
   Se você quiser retomar o uso de um serviço pausado naquele mês (sem limite ou com um orçamento maior), será necessário remover explicitamente o limite de gastos aplicado.

Permissões necessárias

Para configurar e gerenciar um orçamento com gasto máximo, é 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 Administrador da conta de faturamento na conta do Cloud Billing vinculada ao projeto

• Opção 2: papel de Proprietário do projeto no projeto em que você quer configurar os orçamentos com gasto máximo

• Opção 3: a seguinte combinação de papéis do IAM da conta do Cloud Billing e do projeto:

  • Papel de Gerente de custos da conta de faturamento na conta do Cloud Billing vinculada ao projeto

    e

  • Papel de editor do projeto no projeto em que você quer configurar os orçamentos com gasto máximo

Configurar um orçamento de gasto máximo

Para que o Cloud Billing comece a monitorar ativamente seus gastos com um serviço, é preciso configurar um orçamento de gasto máximo para esse serviço. 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.

Veja como configurar orçamentos com gasto máximo usando o console do Firebase:

1. Acesse seu projeto no console do Firebase e vá para a página Configurações > Uso e faturamento > Detalhes e configurações.

2. Acesse o card Limites de gastos no nível do serviço.

3. Localize o serviço que você quer limitar, defina o valor do orçamento mensal e clique em Configurar.

   • Um orçamento com gasto máximo é definido para um único projeto e um único serviço qualificado dentro desse projeto.

   • O período de um orçamento com gasto máximo é mensal, começando no primeiro dia de cada mês.

Atenção: os orçamentos com gastos máximos não são "limites rígidos". Devido à latência nos relatórios de uso, a aplicação do gasto máximo não é instantânea. Os custos excedentes incorridos durante esse atraso serão faturados normalmente. Considere definir seu orçamento um pouco abaixo do limite absoluto.

Observe que você também pode configurar orçamentos de gasto máximo usando o console do Google Cloud.

E-mails de alerta e aplicação do limite de gasto máximo

Depois que você configurar um orçamento com gasto máximo, 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 gasto máximo com base nos limites de gastos a seguir para o orçamento do gasto máximo desse serviço.

• 50% e 80% do orçamento definido:

  • O Cloud Billing envia e-mails de alerta de aviso para todos os administradores de faturamento, proprietários de projetos e qualquer "contato essencial" aplicável.

• 100% do orçamento definido:

  • Cloud Billing aplica o gasto máximo, 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 gasto máximo aplicado.

  • Cloud Billing envia outro e-mail de alerta. Além disso, os consoles do Firebase e do Google Cloud mostram notificações em 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 à aplicação de um gasto máximo, o app do lado do cliente começa a gerar erros para esse serviço. Trate essas exceções de maneira adequada no código do app (por exemplo, usando blocos try-catch).

Remover um gasto máximo aplicado

Se um gasto máximo for acionado e aplicado, todo o novo uso do serviço aplicável será pausado pelo restante do mês, a menos que você suspenda explicitamente o gasto máximo aplicado.

Veja como remover um limite de gasto aplicado usando o console do Firebase:

1. Acesse seu projeto no console do Firebase e vá para a página Configurações > Uso e faturamento > Detalhes e configurações.

2. Acesse o card Limites de gastos máximos no nível do serviço.

3. Localize o serviço com um gasto máximo aplicado e clique em Aumentar.

Observações importantes sobre como remover um gasto máximo:

• Possível atraso na retomada do serviço: alguns serviços podem levar até uma hora para serem totalmente retomados depois que você suspender o limite de gastos.
• Sem limite para o restante do mês: se você suspender um gasto máximo aplicado e não fizer outras mudanças, o serviço será executado sem um limite de gastos pelo restante do mês. No início do próximo mês, o gasto máximo é redefinido automaticamente para o estado Configurado com o orçamento original, e o serviço é retomado.
• Se você não suspender um gasto máximo aplicado: o serviço vai permanecer pausado apenas no mês atual. No início do mês seguinte, o gasto máximo é redefinido automaticamente para o estado Configurado com o orçamento original, e o serviço é retomado.

Observe que também é possível remover os gastos máximos aplicados usando o Google Cloudconsole.

Aumentar um limite de gastos após a aplicação

Se o limite de gastos for aplicado 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. É preciso remover o limite antes de definir um valor maior.

Veja como retomar um serviço e aumentar o limite de gasto máximo:

1. Remover o gasto máximo: no console do Firebase ou do Google Cloud, localize o serviço restrito e clique em Remover.

   O gasto máximo vai entrar em um estado pendente enquanto a restrição é removida.

2. Aguarde a conclusão da remoção: aguarde alguns minutos e atualize a página até que o status do limite de gastos mostre Removido.

   O serviço será retomado. Dependendo do serviço, isso pode levar até uma hora.

3. Atualize o valor do orçamento: edite o orçamento do limite de gastos inserindo o novo valor mensal mais alto. Salve as alterações.

Considerações importantes ao aumentar um limite:

• 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 custos excedentes gerados durante 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 já 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:

  1. Você definiu um gasto máximo de US $10 em Cloud Functions for Firebase.

  2. Seu gasto chega a US $10 (mais US $1 de sobreuso durante o atraso no relatório, totalizando US $11). O limite é aplicado, pausando as funções.

  3. Você confirma que o tráfego é legítimo, então remove o limite e aguarda o estado mostrar Removido.

  4. Você atualiza o gasto máximo para US $20. Quando você salvar essa modificação, o gasto máximo será redefinido para o estado Configurado.

  5. Suas funções continuam sendo executadas com o novo limite de US $20, com aproximadamente US $9 de orçamento restante para o mês (limite de US$ 20 menos US$ 11 já acumulados).

  6. No mês seguinte, o orçamento do gasto máximo vai manter o limite de US $20.

Limitações dos orçamentos com limite de gasto máximo

Confira a seguir as limitações importantes sobre os orçamentos com limite de gastos:

• Os orçamentos com gasto máximo 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 atrasar vários minutos. Os custos excedentes incorridos durante esse atraso serão faturados normalmente. Considere definir seu orçamento um pouco abaixo do limite absoluto.

• Com escopo de projeto e serviço. Um orçamento de gasto máximo tem como escopo um único projeto e um único serviço qualificado dentro desse projeto.

  • Não é possível definir um orçamento com gasto máximo no nível de toda a conta do Cloud Billing ou no nível da pasta, da organização ou do rótulo.

  • Não é possível definir um único orçamento com gasto máximo que cubra vários projetos ou serviços.

  • Quando você define um orçamento com gasto máximo para um serviço, ele se aplica a todas as formas de interação com o serviço no projeto. Por exemplo, se você definir um orçamento na Agent Platform Gemini API (formerly Vertex AI), ele também será aplicado a qualquer uso dessa API no projeto por meio de Firebase SQL Connect, ADK, Genkit etc. (não apenas pelo uso por meio de Firebase AI Logic).

• Período mensal. O período de um orçamento com limite de gasto é 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 gasto máximo aplicado, o serviço vai permanecer pausado apenas no mês atual. No início do mês seguinte, o gasto máximo aplicado é redefinido automaticamente para o estado Configurado com o orçamento original, e o serviço é retomado.

  • Se você suspender um gasto máximo 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, e o gasto máximo 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 de um orçamento com 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 com gasto máximo na documentação do Google Cloud.