Was ist Assembly Execution Progress?
Der Transloadit Assembly Execution Progress schätzt den Abschluss einer Assembly in Echtzeit für Assemblies, die sich mit dem Parameter emit_execution_progress dafür anmelden. Die Prozentsätze werden anhand der Steps der Assembly berechnet und können die Gesamtausführung oder eine einzelne Datei beschreiben.
So funktioniert Assembly Execution Progress
Der Ausführungsfortschritt fasst zusammen, wie weit geplante Arbeiten innerhalb eines Graphen fortgeschritten sind, dessen Zweige sich im Aufwand stark unterscheiden können. Der angezeigte Wert wird aus den Aktivitäten der Steps und Dateien abgeleitet, nicht aus einem einfachen Countdown der verstrichenen Zeit. Daher kann er ungleichmäßig steigen, und parallele Zweige können den Eindruck erwecken, er pausiere während einer aufwendigen Operation. Für URL Transform Assemblies wird kein Fortschritt ausgegeben. Der Gesamtfortschritt fasst den Verarbeitungsauftrag zusammen, während der Fortschritt auf Dateiebene ein langsames oder blockiertes Element erkennen lassen kann. Benutzeroberflächen nutzen die Schätzung für Rückmeldungen; maßgeblich für den Abschluss bleiben die Statusdaten.
Wichtige Fakten
- 1Ein später Transkodierungs-Step kann wesentlich mehr tatsächliche Zeit beanspruchen als ein früherer Metadaten-Step. Gleiche prozentuale Fortschrittsschritte bedeuten daher keine gleichen verbleibenden Laufzeiten.
- 2Fortschrittsereignisse werden nur ausgegeben, wenn die Parameter der Assembly den Wert für
emit_execution_progressauf true setzen. Sie werden über die Echtzeitverbindung übertragen; allein durch Polling des Dokuments mit dem Assembly Status lassen sich diese Prozentwerte nicht abrufen. - 3Ein Step, der noch ausgeführt wird, meldet einen gedeckelten Fortschrittswert (95 %), da abschließende Arbeiten wie die Metadatenextraktion und das Speichern der Ergebnisse noch ausstehen. Bestätigen Sie den Abschluss ausschließlich anhand eines endgültigen Status der Assembly; ein fehlgeschlagener oder abgebrochener Zweig entspricht keinem erfolgreichen Abschluss mit 100 %.
Wann Assembly Execution Progress wichtig ist
Aktivieren Sie emit_execution_progress und empfangen Sie Fortschrittsereignisse über die Echtzeitverbindung, wenn Nutzer während langer Verarbeitungsaufträge Rückmeldungen benötigen. Die Prozentwerte werden als Ereignisse gestreamt und nicht als Feld im per Polling abgerufenen Assembly Status bereitgestellt. Betrachten Sie den Prozentwert als Schätzung, nicht als verstrichene Zeit, da Steps unterschiedlich lange oder unvorhersehbare Laufzeiten haben können.