Qu’est-ce qu’Assembly Execution Progress ?
Transloadit Assembly Execution Progress estime en temps réel l’achèvement d’une Assembly pour les Assemblies qui l’activent au moyen du paramètre emit_execution_progress. Les pourcentages sont calculés à partir des Steps de l’Assembly et peuvent décrire l’exécution globale ou un fichier individuel.
Fonctionnement d’Assembly Execution Progress
La progression de l’exécution agrège l’avancement du travail planifié dans un graphe dont les branches peuvent avoir des coûts très différents. La valeur affichée est calculée à partir de l’activité des Steps et des fichiers plutôt que d’un simple compte à rebours fondé sur l’horloge. Elle peut donc avancer de manière irrégulière, et des branches parallèles peuvent donner l’impression qu’elle s’interrompt pendant une opération coûteuse. La progression n’est pas émise pour les Assemblies URL Transform. La progression globale résume le traitement, tandis que la progression par fichier peut révéler un élément lent ou bloqué. Les interfaces utilisent cette estimation pour fournir des indications, tandis que les données de statut restent la référence pour déterminer si le traitement est terminé.
Points clés
- 1Un Step de transcodage tardif peut représenter une durée réelle bien plus longue qu’un Step de métadonnées antérieur. Des incréments de pourcentage égaux n’impliquent donc pas des durées restantes égales.
- 2Les événements de progression ne sont émis que lorsque les paramètres de l’Assembly définissent
emit_execution_progresssur true, et ils sont transmis via la connexion en temps réel ; la seule interrogation périodique du document Assembly Status ne permet pas d’obtenir ces pourcentages. - 3Un Step encore en cours d’exécution indique une progression plafonnée (95 %), car il reste des opérations de finalisation, telles que l’extraction des métadonnées et le stockage des résultats. Ne confirmez la fin du traitement qu’à partir du statut final de l’Assembly ; une branche en échec ou annulée ne correspond pas à un traitement réussi à 100 %.
Quand Assembly Execution Progress compte
Activez emit_execution_progress et écoutez les événements de progression sur la connexion en temps réel lorsque les utilisateurs ont besoin d’indications pendant des traitements de longue durée ; les pourcentages arrivent sous forme d’événements en flux plutôt que dans un champ d’Assembly Status interrogé périodiquement. Considérez le pourcentage comme une estimation plutôt que comme une mesure du temps écoulé, car les Steps peuvent avoir des durées inégales ou imprévisibles.