Passer au contenu principal
À mesure que votre entreprise se développe, votre volume d’événements augmente avec elle. Votre architecture de facturation doit prendre en charge tout, des lancements initiaux de produits aux pics soudains d’adoption, sans introduire de retards ni atteindre des limites de traitement inattendues. L’infrastructure de Metronome est conçue pour fournir cette fiabilité à grande échelle. Nous prenons en charge des entreprises qui envoient des milliards d’événements par jour et qui s’appuient sur Metronome pour calculer avec précision la facturation de leurs millions de clients finaux en temps réel. Ce guide décrit comment l’architecture de Metronome est conçue pour le passage à l’échelle et comment vous pouvez tirer parti de ses capacités pour garantir l’intégrité des données à mesure que vous grandissez.

​
Ingestion d’événements à haut débit

L’infrastructure de Metronome prend en charge jusqu’à 110 000 événements par seconde (6,6 millions d’événements par minute) sans nécessiter de pré-agrégation ni de rollups. La limite de débit d’ingestion par défaut commence à 5 000 événements par seconde. Si vous avez besoin d’un débit plus élevé, contactez Metronome pour l’augmenter. Lors de la mise à l’échelle pour envoyer de grands volumes d’événements, regrouper vos événements en lots vous aide à tirer pleinement parti de cette capacité. Vous pouvez regrouper 100 événements par requête envoyée au point de terminaison d’ingestion de Metronome. Pour ce faire, soumettez un tableau d’objets d’événements d’utilisation à l’aide d’une requête POST en envoyant des événements dont le schéma correspond à la structure décrite. Pour en savoir plus sur l’envoi d’utilisation à Metronome, cliquez ici. 
curl https://api.metronome.com/v1/ingest \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '[
  {
    "transaction_id": "event-20250910-001",
    "customer_id": "customer_123",
    "timestamp": "2025-09-10T12:00:00Z",
    "event_type": "ai-run",
    "properties": {
      "model_name": "gpt-5",
      "input_tokens": "10000",
      "output_tokens": "1000",
      "type": "input"
    }
  },
  {
    "transaction_id": "event-20250910-002",
    "customer_id": "customer_456",
    "timestamp": "2025-09-10T12:05:00Z",
    "event_type": "ai-run",
    "properties": {
      "model_name": "gpt-4o",
      "input_tokens": "8000",
      "output_tokens": "900",
      "type": "output"
    }
  }
  // additional 98 events objects
]'

​
Surveiller les données d’événements dans l’interface utilisateur

L’interface utilisateur Metronome offre un accès direct pour inspecter votre pipeline d’événements via notre explorateur d’événements dédié. Cette fonctionnalité est utile pour valider que Metronome a bien ingéré les événements, qu’ils ont été correctement appariés aux objets Metronome comme les métriques facturables, et pour identifier les événements en double. Avec l’interface utilisateur des événements, vous pouvez :
  • Voir des graphiques récapitulatifs basés sur le temps de l’ensemble du flux d’événements ou des événements en double isolés
    • Inclut des options de visualisation par périodes personnalisées
  • Rechercher par client, doublons, métriques facturables et IDs de transaction
  • Afficher les charges utiles complètes des événements d’utilisation à partir d’événements individuels
  • Afficher l’attribution des événements d’utilisation au client et aux métriques facturables appariés
  • Exporter un journal CSV des événements
Flux d'événements dans l'interface utilisateur Metronome
Résumé des événements dans l'interface utilisateur Metronome

​
Maintenir l’intégrité des données à grande échelle

L’interface utilisateur Metronome est idéale pour des vérifications ponctuelles et une validation rapide. Pour une fiabilité durable à des volumes élevés, vous voudrez des contrôles automatisés et programmatiques qui s’exécutent en continu et vous alertent avant que des problèmes n’affectent les clients ou les revenus. Utilisez les conseils ci-dessous pour construire une posture d’événements plus évolutive. L’ingestion d’événements à haut volume nécessite une surveillance et une maintenance efficaces de votre pipeline d’événements. Metronome fournit une visibilité de bout en bout et des outils en libre-service pour vous aider à résoudre les problèmes avant qu’ils n’impactent votre activité.
  • File d’attente et réessai : vous devez suivre les bonnes pratiques standard de l’industrie concernant la mise en file d’attente, les réessais, la journalisation des files d’attente de messages, l’alerte et l’utilisation de files d’attente de lettres mortes. Veuillez consulter ici pour les recommandations de Metronome.
  • Observabilité du pipeline d’utilisation : l’API de recherche d’événements de Metronome vous permet d’échantillonner les événements bruts et de valider qu’ils correspondent aux métriques facturables actives. C’est un contrôle critique pour empêcher la perte silencieuse de revenus si un système en amont modifie un schéma d’événement.
  • Backfills et récupération sans heurts : en cas d’incident, vous devez pouvoir récupérer les données rapidement. Metronome propose une fenêtre d’ingestion historique et de déduplication de 34 jours traitée via le même point de terminaison d’ingestion. Cette fenêtre étendue garantit que vous pouvez rejouer plus de 24 heures de trafic et recalculer les factures brouillon et les registres de crédit en temps réel. Les corrections au-delà de 34 jours sont gérées par notre équipe des opérations et sont généralement effectuées rapidement.