Passer au contenu principal
Les compteurs convertissent les événements bruts en quantités facturables. Ils filtrent les événements et appliquent des fonctions d’agrégation (Compter, Somme, Max, Dernier) pour calculer l’utilisation par client.
Interface de création de compteur montrant le nom de l'événement, le type d'agrégation et les options de filtrage

​
Ressources API

​
Création d’un compteur

1

Informations de base

​
Nom du compteur
string
required
Nom descriptif (ex. : “Demandes API”, “Utilisation de jetons”)
​
Nom de l'événement
string
required
Nom exact de l’événement à correspondre (sensible à la casse). Exemples : api.call, image.generated
2

Agrégation

​
Type d'agrégation
string
required
Choisissez comment les événements sont agrégés :
  • Compter : Nombre total d’événements (appels API, téléchargements)
  • Somme : Ajoutez des valeurs numériques (jetons, octets)
  • Max : Valeur la plus élevée de la période (utilisateurs de pointe)
  • Dernier : Valeur la plus récente
​
Sur propriété
string
Clé de métadonnées à agréger (requise pour tous les types sauf Compter). Exemples : tokens, bytes, duration_ms
​
Unité de mesure
string
required
Étiquette d’unité pour les factures. Exemples : calls, tokens, GB, hours
3

Filtrage (optionnel)

Filtrage des événements
Ajoutez des conditions pour filtrer les événements comptés :
  • Logique ET : Toutes les conditions doivent correspondre
  • Logique OU : Toute condition peut correspondre
Comparateurs : égal, différent, supérieur à, inférieur à, contientActivez le filtrage, choisissez la logique, ajoutez des conditions avec la clé de propriété, le comparateur et la valeur.
4

Créer

Vérifiez la configuration et cliquez sur Créer un compteur.

​
Visualisation des analyses

Analyses du compteur
Votre tableau de bord des compteurs montre :
  • Aperçu : Utilisation totale et graphique d’utilisation
  • Événements : Événements individuels reçus
  • Clients : Utilisation et frais par client

​
Dépannage

  • Le nom de l’événement doit correspondre exactement (sensible à la casse)
  • Vérifiez que les filtres du compteur n’excluent pas les événements
  • Vérifiez que les ID des clients existent
  • Désactivez temporairement les filtres pour tester
  • Vérifiez que la propriété correspond exactement à la clé de métadonnées
  • Utilisez des nombres, pas des chaînes : tokens: 150 pas "150"
  • Incluez les propriétés requises dans tous les événements
  • Correspondre exactement à la casse
  • Utilisez les bons opérateurs pour le type de données
  • Assurez-vous que les événements incluent les propriétés filtrées
  • Vérifiez l’onglet Événements pour compter les événements réellement reçus
  • Vérifiez le type d’agrégation (Compter vs Somme)
  • Assurez-vous que les valeurs sont numériques pour Somme/Max

​
Prochaines étapes

Envoyer des événements

Commencez à envoyer des événements d’utilisation depuis votre application vers vos compteurs.

Voir les modèles

Utilisez des configurations de compteurs prêtes à l’emploi pour des cas d’utilisation courants.