Como funcionam orçamentos e limites

• Cada projeto que você protege tem um orçamento: o máximo que você quer que ele gaste em um mês do calendário. Ele é reiniciado no começo de cada mês.
• O valor está na moeda da sua conta de faturamento, que o Google define quando a conta é criada, e em unidades inteiras (por exemplo, $500, não $499.50).
• O gasto é o custo real do projeto até agora no mês, depois de créditos como o teste grátis ou promoções. Não é uma previsão.
• Ao salvar, o FireShield cria ou atualiza um orçamento correspondente na sua conta de faturamento do Google Cloud, configurado para informar o FireShield. Você pode vê-lo em Billing → Budgets & alerts no console do Google Cloud.

• Um limite é uma porcentagem do orçamento, de 1% a 100%. Um orçamento pode ter até 10, cada um em uma porcentagem diferente.
• Cada limite contém as ações a executar quando o gasto o atinge:
  • Alerta por E-mail (todos os planos).
  • Alertas no Slack e no Telegram (Pro).
  • Soft Kill: um webhook assinado pedindo que seu serviço se degrade. Veja o guia de integração.
  • Hard Kill: desconecta a conta de faturamento do projeto. Veja o que é um Hard Kill.
• Um novo orçamento começa com um limite em 100% que envia um e-mail para você e executa um Hard Kill. Todo limite que você adiciona começa enviando um e-mail para você, para que nenhum fique silencioso por acidente.

O FireShield não consulta seu projeto periodicamente. O Google publica o gasto atual do orçamento várias vezes ao dia, normalmente a cada meia hora ou algo assim, e o FireShield age em cada relatório assim que ele chega. Os dados de custo do Google ficam atrás do uso real em até várias horas, então um relatório sempre descreve o gasto de pouco tempo atrás.

A cada relatório, o FireShield divide o gasto pelo orçamento. Todo limite igual ou abaixo dessa porcentagem é considerado ultrapassado, e cada uma de suas ações é executada, a menos que já tenha sido executada neste mês.

Exemplo: um orçamento de $500 com limites em 50%, 80% e 100%. Um relatório de $430 equivale a 86%, então os limites de 50% e 80% são ultrapassados. Se o gasto saltou até lá de uma vez, os dois são executados na mesma atualização: nada é pulado porque um limite mais alto foi atingido primeiro.

Quando uma atualização ultrapassa um limite com Hard Kill, o Hard Kill é executado antes de tudo, para que os alertas enviados junto possam dizer se o faturamento foi cortado.

• Uma vez por mês. O Google continua enviando relatórios o mês inteiro, mas uma ação que já foi executada neste mês não se repete.
• Alterar o valor do orçamento rearma todas as ações, a partir do próximo relatório do Google. Salvar não recalcula nada na hora: o FireShield atualiza o orçamento no Google, e o próximo relatório (normalmente em menos de meia hora) já traz o novo valor. A partir desse relatório, as porcentagens são medidas sobre o novo orçamento, e as ações que rodaram com o valor anterior contam como não executadas, então cada uma roda de novo assim que o gasto atinge o limite dela no novo valor. Exemplo: com US$ 430 gastos, aumentar um orçamento de US$ 500 para US$ 1.000 deixa você em 43%, e o alerta de 50% roda de novo quando o gasto chegar a US$ 500. Reduzi-lo para US$ 400 deixa você em 107%, então o Hard Kill de 100% roda nesse próximo relatório.
• Uma ação que falhou é repetida a cada novo relatório até ter sucesso: um endpoint de Soft Kill inacessível, um canal do Slack que rejeitou a mensagem, um Hard Kill que não conseguiu desconectar o faturamento. Cada tentativa aparece nos logs recentes do projeto.
• Uma ação de Slack ou Telegram no plano Starter é pulada, não consumida: se você fizer upgrade antes do fim do mês, ela ainda será executada.

Além do limite e do gasto até o momento, todo alerta diz se o projeto está dentro do ritmo ou acima do ritmo para o mês. Estar dentro do ritmo significa que o gasto não passa da fração do orçamento correspondente aos dias já transcorridos. Quando está acima, o alerta informa a data em que o orçamento se esgota no ritmo atual. Quando está dentro do ritmo ou já acima do orçamento, ele projeta o total do fim do mês. Nos dois primeiros dias do mês há poucos dados, então o alerta dá o veredito sem data nem projeção.

O e-mail também lista o que os limites seguintes vão fazer, para que você saiba se um Hard Kill vem a seguir.

• A organização não tem uma assinatura ativa do FireShield.
• O projeto foi parado por um Hard Kill. O monitoramento é retomado quando você o reativa.

• 50%: e-mail, para você saber cedo de um mês acelerado.
• 80%: e-mail e Slack ou Telegram, mais um Soft Kill se o seu serviço puder se degradar sozinho.
• 100%: e-mail e um Hard Kill, a rede de segurança.