¿Qué es Assembly Execution Progress?
Assembly Execution Progress de Transloadit estima en tiempo real la finalización de las Assemblies que lo habilitan con el parámetro emit_execution_progress. Los porcentajes se calculan a partir de los Steps de la Assembly y pueden describir la ejecución general o un archivo individual.
Cómo funciona Assembly Execution Progress
El progreso de ejecución reúne el avance del trabajo programado en un grafo cuyas ramas pueden diferir mucho en costo. El valor mostrado se calcula a partir de la actividad de los Steps y los archivos, en lugar de una simple cuenta regresiva del tiempo real, por lo que puede avanzar de forma irregular. Además, las ramas paralelas pueden hacer que parezca detenerse mientras se ejecuta una operación costosa. No se emite progreso para las Assemblies de URL Transform. El progreso general resume la tarea, mientras que el progreso por archivo puede revelar un elemento lento o bloqueado. Las interfaces utilizan la estimación para informar del avance, mientras que los datos de estado siguen siendo la fuente definitiva para determinar la finalización.
Datos clave
- 1Un Step de transcodificación que se ejecuta en una fase avanzada puede consumir mucho más tiempo real que un Step de metadatos anterior, por lo que incrementos porcentuales iguales no implican duraciones restantes iguales.
- 2Los eventos de progreso se emiten solo cuando los parámetros de la Assembly establecen
emit_execution_progressen true, y se entregan a través de la conexión en tiempo real; consultar periódicamente solo el documento Assembly Status no mostrará estos porcentajes. - 3Un Step que aún se está ejecutando informa de un progreso que no supera el 95 % porque quedan tareas finales, como la extracción de metadatos y el almacenamiento de resultados. Confirma la finalización solo a partir del estado terminal de la Assembly; una rama fallida o cancelada no equivale a completar correctamente el 100 %.
Cuándo es importante Assembly Execution Progress
Activa emit_execution_progress y escucha los eventos de progreso en la conexión en tiempo real cuando los usuarios necesiten información sobre el avance durante tareas de procesamiento prolongadas; los porcentajes llegan como eventos transmitidos de forma continua, en lugar de como un campo en las respuestas a las consultas periódicas de Assembly Status. Trata el porcentaje como una estimación y no como tiempo transcurrido, porque los Steps pueden tener duraciones diferentes o impredecibles.