Passer au contenu principal
Les notifications de seuil surveillent des métriques en temps réel et se déclenchent lorsque des seuils définis sont franchis. Elles sont idéales pour la surveillance proactive et les workflows pilotés par l’utilisation. Les notifications de seuil se répartissent en trois catégories principales :
  • Les notifications de seuil d’engagement et de crédit surveillent les soldes restants des engagements ou crédits. Elles peuvent être utilisées pour notifier un client lorsqu’il a utilisé 90 % de son engagement, ou pour signaler les comptes qui sont sur le point d’épuiser leurs crédits prépayés.
INFOLes notifications de seuil d’engagement et de crédit alertent sur le solde des engagements et crédits au niveau du client et du contrat. Les crédits individuels limités à un siège ne sont pas inclus dans le calcul du seuil pour ces notifications.
  • Les notifications de seuil de dépense et d’utilisation suivent combien un client a dépensé ou utilisé au cours d’un cycle de facturation donné. Elles peuvent être utilisées pour déclencher un message lorsqu’un client franchit un seuil de dépense, comme $5 000, ou pour alimenter la logique d’offre de mises à niveau une fois qu’un client approche d’un certain plafond d’utilisation.
  • Les notifications de seuil de facture surveillent les totaux des factures après que les engagements et crédits ont été appliqués aux dépenses du client. Elles peuvent être utilisées pour notifier proactivement les clients lorsque les dépenses dépassent des budgets préconfigurés.

​
Types de notifications de seuil

​
Solde de crédit de contrat

Type d’alerte : alerts.low_remaining_contract_credit_balance_reachedSe déclenche lorsque le solde de crédit d’un client atteint ou descend en dessous d’un montant défini. Si plusieurs crédits existent pour un client, Metronome additionne les soldes restants de tous les crédits pour comparer au seuil.Pour notifier sur un crédit spécifique, définissez un champ personnalisé sur le crédit dans Metronome et utilisez les filtres avancés pour évaluer uniquement les crédits avec cette valeur de champ personnalisé spécifique.

​
Pourcentage de crédit de contrat

Type d’alerte : alerts.low_remaining_contract_credit_percentage_reachedSe déclenche si le pourcentage de crédits disponibles pour le client sur tous les crédits actifs de ce type de crédit (devise ou unité de tarification) atteint ou descend en dessous d’un seuil défini.Pour notifier sur un crédit spécifique, définissez un champ personnalisé sur le crédit dans Metronome et utilisez les filtres avancés pour évaluer uniquement les crédits avec cette valeur de champ personnalisé spécifique.

​
Solde d’engagement

Type d’alerte : alerts.low_remaining_commit_balance_reachedSe déclenche lorsque le solde d’engagement d’un client atteint ou descend en dessous d’un montant défini. Si plusieurs engagements existent pour un client, Metronome additionne les soldes restants de tous les engagements pour comparer au seuil.Pour notifier sur un engagement spécifique, définissez un champ personnalisé sur l’engagement dans Metronome et utilisez les filtres avancés pour évaluer uniquement les engagements avec cette valeur de champ personnalisé spécifique.

​
Pourcentage d’engagement

Type d’alerte : alerts.low_remaining_commit_percentage_reachedSe déclenche si le pourcentage d’engagements disponibles pour le client sur tous les engagements actifs de ce type de crédit (devise ou unité de tarification) atteint ou descend en dessous d’un seuil défini.Pour notifier sur un engagement spécifique, définissez un champ personnalisé sur l’engagement dans Metronome et utilisez les filtres avancés pour évaluer uniquement les engagements avec cette valeur de champ personnalisé spécifique.

​
Solde de crédit et d’engagement de contrat

Type d’alerte : alerts.low_remaining_contract_credit_and_commit_balance_reachedSe déclenche lorsque le solde combiné d’engagement et de crédit d’un client atteint ou descend en dessous d’un montant défini. Si plusieurs engagements et crédits existent pour un client, Metronome additionne les soldes restants de tous les engagements et crédits pour comparer au seuil.

​
Solde de sièges

Type d’alerte : alerts.low_remaining_seat_balance_reachedSe déclenche lorsque le solde de sièges d’un client atteint ou descend en dessous d’un montant défini. Metronome additionne les soldes restants pour le siège spécifique sur tous les engagements et crédits pour comparer au seuil.Utilisez le paramètre seat_filter requis pour limiter la notification aux soldes de sièges associés à des abonnements basés sur les sièges avec un seat_group_key spécifique. Metronome additionnera les soldes restants pour chaque siège sur tous les engagements et crédits pour comparer au seuil.Optionnellement, utilisez le paramètre seat_filter.seat_group_value pour limiter la notification à un siège spécifique.

​
Seuil de dépense

Type d’alerte : alerts.spend_threshold_reachedSe déclenche si les dépenses basées sur l’utilisation du client avant le tirage sur engagements et crédits pour leur période de facturation actuelle atteignent ou dépassent le seuil défini. Cette notification évalue par rapport à la somme de toutes les charges basées sur l’utilisation pour un client particulier, y compris les tirages d’utilisation sur les crédits et engagements.Les achats d’engagements ne sont pas pris en compte dans la notification de seuil de dépense d’un client. Par exemple, si le seuil est fixé à $10 000, $7 000 de charges d’utilisation plus un achat d’engagement de $3 000 ne déclencheront pas la notification.De plus, les notifications de dépense sont évaluées uniquement par rapport aux dépenses directes dans un type de crédit spécifique. Un seuil de notification de dépense configuré pour une devise est toujours évalué à ok si vous utilisez une unité de tarification personnalisée pour les lignes d’articles d’un client. Pour éviter cela, configurez les seuils de notification de dépense pour utiliser la même unité de tarification que les lignes d’articles sur la facture d’un client.Pour notifier sur un type de contrat spécifique, définissez un champ personnalisé sur le contrat dans Metronome et utilisez les filtres avancés pour évaluer uniquement les contrats avec cette valeur de champ personnalisé spécifique.Optionnellement, utilisez le paramètre de filtre avancé group_values avec ce type de notification pour évaluer uniquement l’utilisation associée à une paire spécifique clé de groupe:valeur de groupe. Vous pouvez également filtrer sur group_key pour évaluer l’utilisation sur toutes les valeurs de groupe pour cette clé.

​
Utilisation d’une métrique facturable

Type d’alerte : alerts.usage_threshold_reachedSe déclenche si l’utilisation par le client d’une métrique facturable particulière dans leur période de facturation actuelle atteint ou dépasse votre seuil défini.La période de facturation actuelle d’un client est calculée en prenant la date de début la plus précoce et la date de fin la plus tardive sur toutes les factures actives.

​
Total de facture

Type d’alerte : alerts.invoice_total_reachedSe déclenche si l’une des factures actives du client atteint ou dépasse le seuil configuré. Cette notification évalue par rapport au total net de la facture après que tous crédits, engagements ou autres ajustements ont été appliqués. Chaque facture active pour le client est évaluée séparément. De plus, seules les factures dans la devise spécifiée sont évaluées.Pour notifier sur un type de facture spécifique, utilisez les filtres avancés pour cibler le type de facture particulier.

​
Exemples de charges utiles de webhook

{  
  "id": "445b849e-1366-4580-a6cc-f488e27c059f",  
  "properties": {  
    "customer_id": "ac39ecc3-87ee-4d58-8ec0-24041464dddd",  
    "alert_id": "445b849e-1366-4580-a6cc-f488e27c059f",  
    "timestamp": "2024-10-07T15:08:44.865Z",  
    "threshold": 20000,  
    "alert_name": "Credit balance low",  
    "credit_type_id": "2714e483-4ff1-48e4-9e25-ac732e8f24f2",  
    "remaining_balance": 5000,  
    "triggered_by": "usage"  
  },  
  "type": "alerts.low_remaining_credit_balance_reached"  
}

​
Créer et gérer les notifications de seuil

Les notifications de seuil peuvent être créées et gérées via l’interface utilisateur ou l’API. Vous pouvez définir quels seuils vous intéressent et quels clients cibler.
Interface de création de notification de seuil affichant la configuration du seuil de dépense
Dans l’interface utilisateur
  1. Accédez à l’onglet Notifications
  2. Cliquez sur Créer une notification
  3. Choisissez n’importe lequel des types de notifications de seuil ci-dessus
  4. Configurez les détails du seuil et le ciblage au niveau du champ personnalisé le cas échéant
  5. Déterminez si vous souhaitez que la notification évalue les clients qui atteignent déjà le seuil ou ne se déclenche que sur les clients qui franchissent le seuil à l’avenir
  6. Sélectionnez les clients auxquels la notification doit être appliquée
  7. Cliquez sur Enregistrer
  8. Metronome commencera à évaluer les clients sélectionnés par rapport au seuil défini et déclenchera une notification vers vos webhooks configurés lorsque le client franchira le seuil
  9. Assurez-vous que vos webhooks sont configurés pour gérer correctement les charges utiles de ces notifications
Via l’API
  1. Appelez POST /v1/alerts/create
  2. Passez le type d’alerte, le nom et le seuil dans le corps de la requête
  3. Optionnellement, passez des filtres supplémentaires pertinents au type d’alerte
  4. Une réponse réussie retournera un objet CustomerAlert contenant la configuration de la notification avec son ID unique et son statut actuel
Pour obtenir le statut d’évaluation en temps réel d’une paire spécifique notification de seuil-client, vous pouvez appeler le point de terminaison POST /v1/customer-alerts/get. Ce point de terminaison fournit une visibilité instantanée pour savoir si un client a déclenché une condition de seuil, vous permettant de surveiller la santé du compte et de prendre des mesures proactives en fonction de l’état actuel. Ce point de terminaison est utile pour vérifier périodiquement le statut de notification de seuil d’un client, mais ne doit pas être interrogé en boucle. Vous devriez plutôt vous appuyer sur la notification webhook pour comprendre quand les clients passent à IN_ALARM. Les notifications de seuil peuvent être archivées dans l’interface utilisateur ou via l’API, ce qui les retire de la surveillance active.

​
Déclencheurs d’évaluation des notifications de seuil

Pour évaluer si une notification de seuil doit être envoyée, Metronome évalue régulièrement les clients ayant des notifications associées en temps réel à mesure que l’utilisation est envoyée à Metronome. Si la valeur surveillée d’un client — solde de crédit, dépense, etc. — atteint le seuil, une notification de seuil est envoyée. Il existe deux déclencheurs possibles pour une évaluation :
  • Des événements d’utilisation sont ingérés
  • Les métadonnées du client changent (par exemple, un contrat est assigné ou un nouvel alias d’ingestion est assigné) Plus précisément, toute action CRUD (créer, lire, mettre à jour et supprimer) impactant les notifications, clients, alias d’ingestion client, contrats, engagements et crédits est considérée comme un changement de métadonnées et déclenche une évaluation de notification.
Les alertes de seuil envoient des notifications dans les minutes suivant le moment où cette condition est remplie.