Métriques non monotones croissantes

La plupart des métriques facturables dans Metronome suivent un usage qui ne fait qu’augmenter dans le temps — par exemple, le nombre total d’appels d’API effectués. Ce sont des métriques monotones croissantes. Cependant, certaines métriques peuvent fluctuer à la hausse et à la baisse sur une période de facturation — par exemple, le nombre d’appareils connectés ou le stockage utilisé. Ce sont des métriques non monotones croissantes, et elles nécessitent quelques considérations spéciales lors de l’utilisation des contrats, engagements, crédits, changements de tarifs et API d’usage de Metronome. Les métriques non monotones croissantes utilisent généralement le type d’agrégation latest, qui capture la valeur la plus récemment déclarée à chaque point dans le temps plutôt que de compter ou de sommer tous les événements. Cette page couvre les nuances comportementales spécifiques aux métriques non monotones croissantes (par exemple, latest). Pour des informations générales sur la création de métriques facturables, voir Créer des métriques facturables.

​

Comment Metronome facture les métriques non monotones croissantes

Lorsque Metronome traite une métrique latest à des fins de facturation, il calcule le changement incrémental entre les fenêtres de déclaration consécutives plutôt que de facturer sur la valeur absolue. C’est une distinction critique qui affecte la façon dont les charges, engagements, crédits et changements de tarifs sont appliqués. Exemple : vous envoyez les valeurs latest suivantes sur quatre jours : Metronome calcule le changement incrémental quotidien et l’utilise comme quantité facturable. Lorsque la valeur déclarée diminue, la quantité incrémentale est négative, ce qui se traduit par un crédit au client pour cette période.

​

Couverture des engagements et crédits

Les engagements et crédits ne s’appliquent qu’à l’usage incrémental qui se situe dans leur plage de dates d’effet — pas à la valeur absolue déclarée.

​

Exemple

Supposons que vous ayez une métrique latest et envoyez les valeurs suivantes :

• Jour 1 : valeur déclarée = 7
• Jour 2 : valeur déclarée = 9

Vous créez un contrat avec un engagement qui couvre uniquement à partir du Jour 2. Même si la valeur absolue au Jour 2 est 9, l’engagement ne couvre que la quantité incrémentale de 2 (le changement de 7 à 9). L’usage du Jour 1 (quantité de 7) n’est pas couvert par l’engagement car il se situe en dehors de la plage d’effet de l’engagement. Ce comportement garantit que les engagements et crédits sont appliqués proportionnellement à l’usage qui s’est réellement produit pendant leur période d’effet. La même logique s’applique aux crédits. Dans la facture ci-dessous, le crédit de 100 $ libellé « Free credit » ne couvre que la quantité incrémentale qui tombe dans sa plage de dates d’effet (à partir du 17 mars). Exemple de facture avec couverture de crédit : Dans cet exemple, le crédit gratuit couvre 25 des 80 unités incrémentales accumulées pendant la période du 17 mars au 1 avril. Les 55 unités restantes sont facturées au tarif standard.

​

Changements de tarifs

Lorsqu’un changement de tarif prend effet en milieu de période, Metronome applique chaque tarif uniquement à l’usage incrémental qui s’est produit pendant la fenêtre d’effet de ce tarif. Cela interagit avec les métriques non monotones croissantes de deux façons importantes selon que la valeur a augmenté ou diminué.

​

Scénario 1 : la valeur augmente (l’incrément est positif)

• Jour 1 : valeur déclarée = 7 (tarif = 3,00 $/unité)
• Jour 2 : valeur déclarée = 9 (le tarif passe à 4,00 $/unité)

La quantité incrémentale au Jour 2 est 2. Seule cette quantité de 2 est facturée au nouveau tarif de 4,00 $. La quantité de 7 du Jour 1 reste à 3,00$.

​

Scénario 2 : la valeur diminue (l’incrément est négatif)

Lorsque la valeur déclarée chute après un changement de tarif, la quantité incrémentale négative est tarifée au nouveau tarif, ce qui se traduit par un crédit à ce tarif.

• 1 mars – 17 mars : la valeur déclarée atteint 40 (tarif = 3,00 $/unité)
• 17 mars – 1 avril : la valeur déclarée chute de 10 (le tarif passe à 4,00 $/unité)

Exemple de facture avec changement de tarif et quantité négative : Dans ce cas, le client est facturé 120,00 $pour la première période à 3,00$/unité, puis crédité de 40,00 $pour la diminution de 10 unités au nouveau tarif de 4,00$, ce qui donne un total net de 80,00 $.

​

Crédits combinés à des changements de tarifs et des baisses d’usage

Lorsqu’un crédit est présent en plus d’un changement de tarif et d’une diminution d’usage, l’interaction entre ces facteurs peut produire des totaux de facture négatifs. Cela se produit parce que Metronome évalue chaque ligne de charge indépendamment et applique les crédits au fur et à mesure qu’il rencontre des charges positives — il ne regarde pas en avant pour tenir compte des charges négatives qui apparaissent plus tard sur la facture.

​

Exemple

En utilisant le même scénario que ci-dessus — un changement de tarif de 3,00 $à 4,00$ le 17 mars, avec un usage passant à 40 puis chutant de 10 — ajoutez maintenant un crédit gratuit de 100,00 $ qui couvre toute la période de facturation. Metronome traite les charges dans l’ordre chronologique :

1. 1 mars – 17 mars : 40 unités × 3,00 $= 120,00$. Le crédit de 100,00 $est appliqué ici, couvrant 33,33 unités. Les 6,67 unités restantes sont facturées à 3,00$.
2. 17 mars – 1 avril : −10 unités × 4,00 $= −40,00$. Cette charge négative est traitée telle quelle — le crédit a déjà été consommé.

Exemple de facture avec crédit, changement de tarif et quantité négative : Le sous-total des charges est de 80,00 $(le même que dans le scénario sans crédit). Cependant, le crédit complet de 100,00$ a été consommé contre la première tranche de charges positives. Le résultat est un total dû négatif de −20,00 $. Gardez cela à l’esprit lors de la configuration des crédits pour des produits qui utilisent des métriques non monotones croissantes, en particulier en combinaison avec des changements de tarifs en milieu de période.

​

Ventilations de factures

Lorsque vous appelez le point de terminaison de ventilations de factures, Metronome renvoie la quantité incrémentale et son coût associé pour chaque fenêtre de temps — pas la valeur absolue déclarée. Cela inclut les quantités négatives en cas de baisse d’usage.

​

Exemple

Vous envoyez les valeurs latest suivantes : Le point de terminaison des ventilations de factures renvoie : La colonne Quantité reflète le changement incrémental, et le Coût est calculé en fonction de cette quantité incrémentale. Les quantités négatives produisent des coûts négatifs (crédits). Cette ventilation vous donne une vue granulaire, jour par jour, de la façon dont la valeur de la métrique a changé et de la façon dont chaque changement a été tarifé.

​

Points de terminaison d’usage

Contrairement aux ventilations de factures, les points de terminaison d’usage renvoient la dernière valeur absolue déclarée par fenêtre de temps — et non le changement incrémental. La valeur que vous voyez dépend de la granularité demandée.

​

Exemple

Vous envoyez les valeurs latest suivantes : Avec une ventilation quotidienne, le point de terminaison d’usage renvoie : Sans ventilation (période complète), le point de terminaison d’usage renvoie : La valeur renvoyée sans ventilation est la dernière valeur déclarée sur l’ensemble de la fenêtre interrogée.

​

Résumé