Passer au contenu principal
Une métrique facturable est une requête personnalisable qui filtre et agrège les événements de votre flux d’événements. Ces métriques sont suivies en continu à mesure que l’utilisation entre dans Metronome via le pipeline d’ingestion. Le processus d’ingestion transforme les données d’utilisation brutes en métriques de tarification actionnables, vous permettant de mesurer et facturer avec précision vos produits. C’est ce qui est finalement utilisé pour calculer la quantité pour les postes de facture, et peut être utilisé pour les alertes. Les métriques facturables sont un élément fondamental du modèle de tarification dans Metronome. Une fois les métriques facturables créées, elles contribuent à une facture comme suit :
  • Les métriques facturables sont associées à des produits, qui est l’endroit où vous définissez la couche de présentation pour la façon dont les postes doivent être affichés sur une facture.
  • Les prix de liste sont définis pour les produits en tant que taux sur une carte tarifaire.
  • Les taux peuvent être associés ou remplacés sur un contrat, où les factures sont générées pour chaque client Metronome. Les quantités pour chacun des postes sont calculées à partir d’événements en utilisant la définition de la métrique facturable.
La mise en œuvre des métriques facturables dans Metronome implique ces étapes :
  1. Identifiez les composants d’utilisation à tarifer.
  2. Identifiez l’échelle et la latence souhaitées nécessaires pour les calculs de factures.
  3. Définissez les clés de groupe pour organiser vos données de métriques.
  4. Définissez les filtres et une stratégie d’agrégation pour identifier et accumuler les événements pertinents de votre flux d’utilisation.

​
1. Identifier les composants d’utilisation

Avant de mettre en œuvre vos métriques facturables, déterminez les facteurs qui contribuent à votre facturation basée sur l’utilisation. Vous devriez considérer quels aspects de votre service vos clients apprécient le plus, ce qu’ils s’attendraient à voir sur une facture finale, et quels éléments de données vous avez à disposition pour envoyer à Metronome. Quelques exemples de métriques peuvent inclure :
  • Nombre d’appels API
  • Nombre de tokens d’entrée et de sortie consommés
  • Stockage utilisé (Go-heures)
  • Nombre d’utilisateurs
La conception de métriques facturables va de pair avec la conception d’événements d’utilisation. Bien que vos événements d’utilisation puissent inclure un certain nombre de propriétés pertinentes sur lesquelles vous pourriez vouloir tarifer, vos métriques facturables doivent individuellement s’aligner sur le composant que vous voudrez peut-être mesurer. Par exemple, votre événement d’utilisation pourrait être un heartbeat d’un serveur contenant l’utilisation du CPU, la mémoire utilisée et la région cloud. Si vous souhaitez que chacun de ces composants d’utilisation contribue à la tarification d’un utilisateur, créez des métriques distinctes pour agréger la valeur de chaque propriété.
Composants d'utilisation
Pour plus d’informations sur ce qu’il faut considérer avant de concevoir vos événements d’utilisation, veuillez consulter notre guide Concevoir des événements d’utilisation.

​
2. Identifier l’échelle et la latence souhaitées

Avant de mettre en œuvre vos métriques facturables, considérez l’échelle des événements que vous envoyez à Metronome pour une métrique particulière. Metronome propose deux types de métriques facturables :
  • Métriques facturables streaming : métriques conçues pour des workflows à latence ultra-faible et à haut débit. Utilisez les métriques facturables streaming si :
    • Vos définitions de métriques peuvent être définies via un ensemble de filtres simples et d’agrégations (par exemple, COUNT, SUM, MAX ou LATEST).
    • Vous avez besoin d’alertes en temps réel sur une large base de clients avec un volume élevé d’événements.

​
Types d’agrégation des métriques facturables streaming

Les métriques facturables streaming prennent en charge quatre types d’agrégation : COUNT, SUM, MAX et LATEST. Les quatre sont disponibles partout — UI, API, Plans et Contrats. LATEST retourne la valeur la plus récente pour la propriété au sein de la période de facturation — utile pour les métriques où vous voulez facturer sur une lecture ponctuelle (par exemple, le dernier nombre de sièges signalé ou la taille de stockage) plutôt qu’une somme ou un max sur la période. Si vous avez besoin de compter des valeurs distinctes (par exemple, des utilisateurs uniques), utilisez une métrique facturable SQL avec count(distinct …).
INFOLors de l’utilisation de métriques facturables streaming, la métrique facturable doit être définie dans Metronome avant que toute utilisation puisse y être associée. Si l’utilisation est envoyée avant qu’une métrique streaming ne soit définie, elle n’est pas attribuée à la métrique par défaut. Comme Metronome conserve tous les événements bruts reçus, nous pouvons effectuer un reflow si vous avez besoin que des événements passés s’appliquent à une nouvelle métrique facturable streaming — contactez votre représentant Metronome pour que cela soit effectué.
  • Métriques facturables SQL : métriques conçues avec des requêtes SQL pour prendre en charge des calculs plus complexes.
    • Utilisées si les métriques facturables souhaitées ne sont pas satisfaites par les filtres de base fournis dans les métriques facturables streaming.
INFOPour de nombreuses charges de travail d’alerte, les métriques facturables SQL auront des performances comparables aux métriques facturables streaming. Pour des requêtes complexes ou un grand nombre de métriques facturables SQL, l’équipe Metronome peut vous aider à atteindre la latence souhaitée. Veuillez contacter votre équipe Metronome si vous êtes intéressé par l’utilisation de métriques facturables SQL avec des alertes.

​
3. Définir les clés de groupe

Les clés de groupe sont utilisées dans Metronome pour spécifier une ou plusieurs propriétés qui peuvent être utilisées pour ventiler l’utilisation dans la tarification et le packaging en aval. Cela fonctionne de manière similaire à une clause group by dans une requête SQL. Les clés de groupe doivent d’abord être définies dans la couche métrique afin d’être disponibles pour utilisation dans la tarification et le packaging en aval. Une métrique facturable donnée peut avoir plusieurs clés de groupe. Les clés de groupe aident à prendre en charge les cas d’usage suivants dans la plateforme :
  • Les clés de groupe de présentation vous permettent de séparer les quantités sur une facture par une valeur de propriété particulière.
    • Par exemple, si vous spécifiez user_id comme clé de groupe, vous pouvez afficher l’utilisation sur une facture ventilée par chaque user_id. C’est utile pour attribuer les dépenses à travers une organisation plus large.
  • Les clés de groupe de tarification forment la base de la tarification dimensionnelle et vous permettent de tarifer une métrique différemment en fonction des valeurs de propriétés.
    • Par exemple, si vous spécifiez les propriétés [cloud_service_provider, region] comme clé de groupe, vous pouvez configurer des taux distincts pour les événements avec différentes valeurs de cette propriété.
      • Les événements avec les propriétés cloud_service_provider=aws et region=us-east-1 sont tarifés à $0,50
      • Les événements avec la propriété cloud_service_provider=azure et region=southindia sont tarifés à $0,40
Si vous créez un produit qui utilise à la fois des clés de groupe de présentation et de tarification, vous devez définir toutes les propriétés à travers les deux clés dans une seule clé de groupe composée. Par exemple, si vous voulez qu’un produit prenne en charge les deux exemples ci-dessus — clé de groupe de présentation sur user_id et clé de groupe de tarification sur [cloud_service_provider, region] — créez une clé de groupe sur la métrique facturable qui ressemble à [user_id, cloud_service_provider, region].
NOTE DE CONFIGURATIONL’utilisation de clés de groupe avec de nombreuses valeurs possibles pour un client donné peut augmenter la latence lors de l’appel de l’API Metronome. Si vous anticipez que la cardinalité de ces valeurs possibles atteigne mille, contactez votre représentant Metronome pour discuter de votre configuration.

​
Définir les clés de groupe sur les métriques facturables streaming

Les clés de groupe pour les métriques facturables streaming sont définies via l’éditeur de filtres de base, ou via le point de terminaison d’API create billable metric. Pour inclure une propriété dans une clé de groupe, elle doit d’abord être définie dans les filtres de propriétés avec un filtre Exists ou In. Les clés de groupe ne sont pas modifiables une fois qu’une métrique est créée, il est donc important de considérer si elles sont nécessaires pour votre présentation de facture ou votre tarification lors de la création de vos métriques facturables.

​
Définir les clés de groupe sur les métriques facturables SQL

Lors de la définition d’une métrique facturable SQL, toute propriété renvoyée par votre requête SQL en dehors de la colonne value peut être utilisée comme clé de groupe. Par exemple, pour utiliser la propriété user_id comme clé de groupe de présentation, et region comme clé de groupe de tarification, votre requête SQL peut ressembler à : 
SELECT count() as value, properties.user_id, properties.region  
FROM events  
WHERE event_type = 'api_request'  
GROUP BY user_id, region

​
4. Définir les filtres et agrégations pour les événements pertinents

Une fois que vous avez les éléments de tarification de votre flux d’utilisation que vous souhaitez voir représentés dans Metronome, vous devez mettre en œuvre la définition de votre métrique facturable. Metronome offre deux outils pour définir les métriques facturables :
  • Éditeur de filtres de base Une interface conviviale avec des filtres et des agrégations prédéfinis, adaptée à la plupart des cas d’usage de base.
INFOToutes les métriques créées avec l’éditeur de filtres de base sont créées comme métriques facturables streaming.
  • Éditeur SQL Une option plus flexible permettant des requêtes SQL personnalisées pour des scénarios complexes. Toutes les métriques créées avec l’éditeur SQL sont créées comme métriques facturables SQL.

​
5. Envoyer et tracer les événements pour tester votre métrique facturable

Une fois que vous avez créé votre métrique facturable, envoyez quelques événements pour vous assurer qu’ils correspondent correctement comme prévu. Utilisez le point de terminaison ingest pour envoyer vos événements de test, puis appelez le point de terminaison searchEvents avec les transaction_ids des événements. La réponse contient la liste des métriques facturables appariées, ainsi que le client apparié s’il existe. Si vous avez configuré un client correspondant et une métrique facturable correspondante, mais ne voyez pas ces valeurs renseignées, vous pouvez creuser dans la définition de la métrique facturable pour voir si quelque chose est défini incorrectement.