ForHosting KIT · Outils pour développeurs

Débit par lots

Le calculateur de débit par lots convertit une taille de lot et un intervalle de traitement en cadence effective.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Il affiche les éléments par seconde, minute et heure, puis compare éventuellement cette capacité à une cible. Si vous indiquez un débit cible, il calcule la plus petite taille entière nécessaire à durée constante et l’intervalle maximal admissible pour le lot actuel. Vous pouvez ainsi vérifier vos hypothèses avant d’ajuster des workers, consommateurs de files, imports, tâches d’inférence ou opérations groupées planifiées.

Convertissez le fonctionnement par lots en cadence comparable

Les systèmes par lots sont souvent décrits par deux nombres difficiles à comparer directement : le nombre d’éléments traités et la durée d’une exécution. Le calculateur divise la taille du lot par sa durée afin d’obtenir le débit effectif en éléments par seconde, puis convertit cette cadence par minute et par heure. Ainsi, un worker qui termine 500 éléments toutes les 20 secondes soutient 25 éléments par seconde, s’il peut lancer le lot suivant sans délai supplémentaire. Utilisez le temps entre deux lancements lorsque la préparation, l’interrogation, l’attente ou le retard de file appartiennent au cycle réel. N’utilisez que le traitement si ces délais sont comptabilisés ailleurs. Le résultat est une moyenne : il ne signifie pas que chaque élément se termine à intervalles réguliers. Un lot peut livrer tous ses résultats simultanément tout en conservant le débit indiqué. Cette distinction permet de comparer traitements groupés et flux continus sans confondre latence de livraison et capacité de traitement.

Dimensionnez le lot pour atteindre un débit cible

Ajoutez une cible en éléments par seconde pour savoir si la configuration suit les arrivées ou respecte un objectif de service. Le calculateur multiplie cette cible par la durée actuelle, puis arrondit au nombre entier supérieur. Cet arrondi est indispensable : une fraction d’élément ne peut pas rejoindre un lot et un arrondi inférieur fournirait moins de capacité que demandé. La taille requise est donc le plus petit entier qui atteint ou dépasse la cible sans modifier la durée. Le débit résultant révèle la faible marge éventuellement créée par l’arrondi. Ce scénario suppose qu’agrandir le lot n’allonge pas son traitement. C’est une première estimation utile, mais bases de données, API, mémoire et parallélisme peuvent évoluer de manière non linéaire. Testez la taille candidate avec des charges représentatives, puis réintroduisez l’intervalle mesuré dans le calculateur. En répétant ce cycle, vous remplacez une hypothèse optimiste par des mesures provenant du système réel.

Déterminez l’intervalle autorisé pour le lot existant

La taille du lot est parfois imposée par une API en amont, une limite de transaction, la mémoire ou le broker de messages. L’analyse calcule alors la durée maximale admise avec la taille actuelle en divisant le nombre d’éléments par le débit cible. Par exemple, un lot de 600 éléments visant 40 éléments par seconde doit se terminer avec un intervalle entre lancements de 15 secondes au plus. Comparez ce seuil à des durées mesurées sur des percentiles élevés, et pas seulement à l’exécution moyenne ou la plus rapide. Si les variations ordinaires dépassent la limite, la configuration nominale peut satisfaire la cible alors que la file continue de croître. Le ratio de débit résume la marge : supérieur à un, il indique une capacité excédentaire ; égal à un, une correspondance exacte ; inférieur à un, un déficit. Le modèle suppose une voie séquentielle. Pour plusieurs workers identiques, utilisez leur lot combiné sur un intervalle commun ou additionnez leurs débits seulement si la charge est équilibrée.

Dimensionner un consommateur de file

Convertissez la taille et l’intervalle du consommateur en débit, puis vérifiez qu’il dépasse le rythme d’arrivée des messages.

Planifier des appels API groupés

Trouvez le minimum d’enregistrements par requête ou l’intervalle maximal nécessaire au rythme de synchronisation.

Évaluer la capacité d’un pipeline

Comparez des lots d’import mesurés à une cible pour déterminer si leur taille ou leur durée doit être améliorée.

Quelle formule calcule le débit par lots ?

Le débit effectif est la taille du lot divisée par sa durée en secondes. Il est aussi converti par minute et par heure.

Que doit inclure la durée du lot ?

Utilisez le temps entre lancements pour une capacité complète. Isolez le traitement seulement si attente et préparation sont volontairement exclues.

Comment la taille requise est-elle calculée ?

La cible par seconde est multipliée par la durée du lot, puis arrondie au supérieur afin de ne jamais rester sous l’objectif.

Les workers parallèles sont-ils pris en compte ?

Pas automatiquement. Regroupez-les dans un lot sur un intervalle commun ou additionnez leurs débits si la charge est équilibrée.

Pourquoi le débit réel peut-il être inférieur ?

Files, reprises, préparation, contention, évolution non linéaire et charge inégale peuvent le réduire. Utilisez des percentiles élevés représentatifs.

Quel est le prix d’une requête API ?

Chaque requête API coûte $0.002. Vous pouvez aussi utiliser gratuitement le calculateur dans votre navigateur.

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

POSThttps://api.kit.forhosting.com/dev/batch-throughput

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

curl -X POST https://api.kit.forhosting.com/dev/batch-throughput \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"batch_size":500,"batch_time_seconds":20}'
{
  "batch_size": 500,
  "batch_time_seconds": 20
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.batch_throughput",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →