Fonctionnement des budgets et des seuils

• Chaque projet que vous protégez a un budget : le maximum que vous voulez qu'il dépense sur un mois calendaire. Il est réinitialisé au début de chaque mois.
• Le montant est exprimé dans la devise de votre compte de facturation, fixée par Google à la création du compte, et en unités entières (par exemple 500 $, pas 499,50 $).
• La dépense correspond au coût réel du projet depuis le début du mois, après déduction des crédits comme l'essai gratuit ou les promotions. Ce n'est pas une prévision.
• Lorsque vous enregistrez, FireShield crée ou met à jour un budget correspondant dans votre compte de facturation Google Cloud, configuré pour envoyer ses rapports à FireShield. Vous pouvez le voir sous Billing → Budgets & alerts dans la console Google Cloud.

• Un seuil est un pourcentage du budget, de 1 % à 100 %. Un budget peut en avoir jusqu'à 10, chacun à un pourcentage différent.
• Chaque seuil porte les actions à exécuter quand la dépense l'atteint :
  • Alerte E-mail (toutes les formules).
  • Alertes Slack et Telegram (Pro).
  • Soft Kill : un webhook signé qui demande à votre service de se dégrader. Voir le guide d'intégration.
  • Hard Kill : dissocie le compte de facturation du projet. Voir ce qu'est un Hard Kill.
• Un nouveau budget démarre avec un seuil à 100 % qui vous envoie un e-mail et exécute un Hard Kill. Chaque seuil ajouté commence par vous envoyer un e-mail, afin qu'aucun ne soit silencieux par accident.

FireShield n'interroge pas votre projet. Google publie la dépense actuelle du budget plusieurs fois par jour, généralement toutes les demi-heures environ, et FireShield agit sur chaque rapport dès son arrivée. Les données de coûts de Google ont jusqu'à plusieurs heures de retard sur l'utilisation réelle ; un rapport décrit donc toujours la dépense d'il y a un moment.

À chaque rapport, FireShield divise la dépense par le budget. Tous les seuils inférieurs ou égaux à ce pourcentage sont franchis, et chacune de leurs actions s'exécute, sauf si elle a déjà été exécutée ce mois-ci.

Exemple : un budget de 500 $ avec des seuils à 50 %, 80 % et 100 %. Un rapport de 430 $ correspond à 86 %, donc les seuils de 50 % et 80 % sont franchis. Si la dépense y est arrivée d'un coup, les deux s'exécutent lors de cette même mise à jour : rien n'est sauté parce qu'un seuil plus élevé a été atteint en premier.

Lorsqu'une mise à jour franchit un seuil comportant un Hard Kill, le Hard Kill s'exécute avant tout le reste, afin que les alertes envoyées avec lui puissent indiquer si la facturation a été coupée.

• Une fois par mois. Google continue d'envoyer des rapports tout le mois, mais une action déjà exécutée ce mois-ci n'est pas répétée.
• Modifier le montant du budget réarme toutes les actions, à partir du prochain rapport de Google. Enregistrer ne recalcule rien sur le moment : FireShield met à jour le budget chez Google, et le rapport suivant (en général en moins d'une demi-heure) contient le nouveau montant. À partir de ce rapport, les pourcentages sont calculés sur le nouveau budget, et les actions exécutées pour l'ancien montant sont considérées comme non exécutées : chacune s'exécute à nouveau dès que les dépenses atteignent son seuil du nouveau montant. Exemple : avec 430 $ dépensés, passer un budget de 500 $ à 1 000 $ vous place à 43 %, et l'alerte à 50 % s'exécute à nouveau quand les dépenses atteignent 500 $. Le baisser à 400 $ vous place à 107 %, donc le Hard Kill à 100 % s'exécute dès ce rapport suivant.
• Une action en échec est relancée à chaque nouveau rapport jusqu'à ce qu'elle réussisse : un endpoint Soft Kill injoignable, un canal Slack qui a rejeté le message, un Hard Kill qui n'a pas pu dissocier la facturation. Chaque tentative apparaît dans les journaux récents du projet.
• Une action Slack ou Telegram sur la formule Starter est ignorée, pas consommée : si vous passez à une formule supérieure avant la fin du mois, elle s'exécutera quand même.

En plus du seuil et de la dépense à date, chaque alerte indique si le projet est dans les clous ou en avance sur le rythme du mois. Être dans les clous signifie que la dépense ne dépasse pas la part du budget correspondant aux jours écoulés. En cas d'avance, l'alerte donne la date à laquelle le budget sera épuisé au rythme actuel. Si le projet est dans les clous ou déjà au-delà du budget, elle projette le total de fin de mois. Pendant les deux premiers jours du mois, les données sont trop peu nombreuses : l'alerte donne alors le verdict sans date ni projection.

L'e-mail liste aussi ce que feront les seuils supérieurs, pour que vous sachiez si un Hard Kill est le prochain.

• L'organisation n'a pas d'abonnement FireShield actif.
• Le projet est arrêté par un Hard Kill. La surveillance reprend lorsque vous le réactivez.

• 50 % : e-mail, pour être prévenu tôt d'un mois qui s'emballe.
• 80 % : e-mail et Slack ou Telegram, plus un Soft Kill si votre service peut se dégrader lui-même.
• 100 % : e-mail et Hard Kill, le filet de sécurité.