Aller au contenu
Bastide Connexion Créer un compte
Appuyez sur / pour chercher

Notifications et alertes

EnglishMarkdownv0.3.0

Bastide vous prévient de trois façons : les notifications de votre compte, que vous réglez par genre de fait et par canal ; les événements envoyés à vos webhooks, pour brancher vos propres outils ; et les avis que la plateforme adresse à votre compte. Cette page dit ce que chacun couvre, comment le régler, et ce qui n'est pas encore en service.

Les notifications du compte

Chaque personne choisit, pour chaque organisation où elle est membre, comment elle est prévenue de quatre genres de fait :

GenreCe qui le déclencheCanaux par défaut
Échec de productionUn déploiement vers la production échoue.Courriel, notification web, application
Incident ouvertUn projet entre en anomalie (erreurs, latence, saturation), une fois par épisode.Courriel, notification web, application
Mise en ligneUn déploiement est promu en production.Notification web
Alerte de facturationUn seuil ou un plafond de consommation est atteint.Courriel

Les alertes de facturation ne vont qu'aux Propriétaires, Administrateurs et membres Facturation. Les trois canaux sont le courriel, la notification web et l'application (notification poussée sur un téléphone déclaré).

Le texte d'une notification ne porte que le nom court du projet, l'environnement et un pourcentage de seuil. Aucune valeur de variable, aucun extrait de journal, aucun message d'erreur n'y entre : le détail se lit dans la console, après connexion.

Attention. Vos choix s'enregistrent et se relisent dès aujourd'hui, mais l'envoi de ces notifications n'est pas encore en service. Pour être prévenu d'un échec de déploiement maintenant, branchez un webhook (voir plus bas).

Régler depuis la console

  1. Ouvrez Compte, carte « Notifications ». Elle vaut pour l'organisation ouverte.
  2. Cochez ou décochez un canal pour un genre : le choix s'enregistre aussitôt. Tant que vous n'avez rien changé, la ligne affiche « Réglage par défaut ».
  3. Sous « Appareils déclarés », retirez un téléphone qui ne doit plus rien recevoir.

Un appareil se déclare depuis l'application elle-même, pas depuis la console ; vingt appareils au plus par compte. Le jeton d'un appareil n'est jamais réaffiché.

Régler par la ligne de commande ou l'API

Ces réglages sont personnels : ils n'ont pas d'outil MCP.

bastide account notification read --organization-id org_01JQ8ZK4M7NP2RSTVWXYZ34567
bastide account notification write --organization-id org_01JQ8ZK4M7NP2RSTVWXYZ34567 \
  --genre mise_en_ligne --channels courriel --channels web

L'option --channels se répète, une fois par canal ; elle accepte aussi une liste JSON ('["courriel","web"]').

{
  "organizationId": "org_01JQ8ZK4M7NP2RSTVWXYZ34567",
  "genre": "echec_de_production",
  "channels": ["courriel"]
}

Le corps ci-dessus, envoyé en PUT /v1/account/notifications, remplace la liste des canaux de ce genre pour vous et cette organisation. Une liste vide éteint le genre. Références : account.notification.read, account.notification.write.

Les webhooks : brancher vos outils

Pour alimenter un outil d'astreinte, une messagerie d'équipe ou un tableau de bord, déclarez un point de réception dans Webhooks : la plateforme y envoie les événements de vos projets, signés, et rejouables. La liste complète des événements, leur charge et la vérification de la signature sont sur la page Webhooks.

Alertes de dépense et de quota

  • Plafond de dépense. Une organisation naît avec un plafond mensuel de 500 €, que la Propriétaire ou un membre Facturation règle (voir Facturation). Plafond atteint, plus aucune construction ni ressource nouvelle ne part, avec le code plafond_de_depense_atteint ; les sites déjà en ligne restent servis.
  • Seuils de dépense. Les événements spend.threshold.reached et spend.cap.reached sont déclarés, mais pas encore émis : ils attendent la chaîne de mesure de la consommation (voir Journaux, section « Consommation »).
  • Trafic sortant. L'événement project.egress.threshold part quand un projet consomme 80 % de la rafale de dix secondes de son palier sur un edge, au plus une fois par projet et par nœud chaque quart d'heure. Au-delà, l'edge espace l'envoi sans rien refuser.
  • Transformations d'images. L'événement project.images.threshold part quand un projet franchit 80 % du plafond mensuel de son palier, au plus une fois par mois. Au-delà du plafond, les images sont servies telles quelles jusqu'au mois suivant.

Ces deux derniers événements sont émis aujourd'hui : recevez-les par un webhook. Les plafonds de chaque palier sont sur la page Limites.

Note. Les règles d'alerte personnalisées sur vos métriques (un seuil de taux d'erreur, de latence…) ne sont pas encore disponibles : aucun écran ni aucune opération ne les règle.

Les avis du compte

La plateforme écrit parfois directement à votre compte : un jeton personnel inactif qui va être désactivé, une relance du second facteur exigé par une organisation, un lien de mot de passe ou de second facteur, une invitation. La carte « Avis reçus » de l'écran Compte dit ce qu'il est advenu de chacun pendant 30 jours : « Remis », « En attente », « Refusé » par la messagerie, ou « Abandonné », avec la réponse du relais. Elle ne montre ni l'adresse ni le contenu.

bastide account notice list

Si un avis est refusé ou abandonné, vérifiez que votre messagerie accepte les courriels de la plateforme. Référence : account.notice.list.

Erreurs fréquentes

CodeCe qui se passeQue faire
plafond_d_appareils_atteintLe compte déclare déjà vingt appareils.Retirez un appareil dans la carte « Notifications », puis recommencez depuis l'application.
plafond_de_depense_atteintLe plafond de dépense de l'organisation est atteint pour le cycle.Relevez le plafond dans Facturation, ou attendez le cycle suivant.

Voir aussi : Webhooks, Journaux, Facturation, Limites, Sécurité.

Signaler une erreur sur cette page