Assembly Execution Progress とは?

Transloadit Assembly Execution Progress は、emit_execution_progress パラメーターで有効化した Assemblies を対象に、Assembly の完了状況をリアルタイムで推定します。パーセンテージは Assembly の Steps に基づいて計算され、実行全体または個々のファイルの進捗を示す場合があります。

Assembly Execution Progress の仕組み

実行の進捗は、処理コストが大きく異なる場合もある分岐からなるグラフ全体で、スケジュールされた処理がどこまで進んだかを集計したものです。表示値は単純な実時間のカウントダウンではなく、Step とファイルの処理状況から算出されます。そのため進み方は一定とは限らず、並列分岐では負荷の大きい処理の実行中に、進捗が止まって見えることもあります。URL Transform Assembly では進捗は配信されません。全体の進捗はジョブの概要を示し、ファイル単位の進捗からは、処理の遅い項目や停止している項目を把握できます。インターフェースはこの推定値を状況表示に使いますが、完了を判断する根拠はあくまでステータスデータです。

要点

  1. 後半のトランスコード Step は、前半のメタデータ処理 Step よりも実際の所要時間が大幅に長くなることがあります。そのため、進捗率が同じ幅で増えても、残り時間が同じだけ減るとは限りません。
  2. 進捗イベントは、Assembly のパラメーターで emit_execution_progress を true に設定した場合にのみ発行され、リアルタイム接続で配信されます。Assembly Status ドキュメントのポーリングだけでは、これらの進捗率は取得できません。
  3. 実行中の Step が報告する進捗には上限( 95% )があります。メタデータ抽出や結果の保存などの仕上げの処理が残っているためです。完了は、終了状態にある Assembly のステータスのみで確認してください。失敗またはキャンセルとなった分岐は、正常に 100% に達したことにはなりません。

Assembly Execution Progress が重要になる場面

長時間の処理ジョブでユーザーに状況を伝える必要がある場合は、emit_execution_progress を有効にし、リアルタイム接続で進捗イベントを受信してください。進捗率は、ポーリングで取得する Assembly Status のフィールドではなく、ストリーミングされるイベントとして届きます。Step の所要時間は一様ではなく、予測できない場合もあるため、進捗率は経過時間ではなく推定値として扱ってください。

メディアの知識を実用的なパイプラインに

単一の宣言的 API で、アップロード、処理、AI、ストレージ、配信を連携できます。エンコードスタックの管理、スケーリング、形式の変化への対応はお任せください。

Transloadit を無料で試す