# 送信・ポーリング・ダウンロードを通して1件のAI動画要求を追跡するには？ > 送信前に安定したoperation IDを作り、provider request、job、poll、webhook、保存済みアセットへ対応付けます。秘密情報や署名付きURLは記録しません。 非同期動画要求は複数システムを横断し、共通IDを持ちません。最初の外部呼び出し前に永続的な相関キーを作ります。 ## 境界でoperation IDを作る ```json {"operation_id":"vidop_01J...","tenant_id":"acct_42","request_fingerprint":"sha256:..."} ``` 個人情報やprompt、認証情報はIDへ埋め込みません。 ## operation、attempt、spanを分ける | レコード | 数 | 目的 | |---|---:|---| | Operation | 1 | ビジネス上の相関 | | Submission attempt | 1以上 | 再試行の説明 | | Provider mapping | 0以上 | 状態とWebhookの結合 | | Span | 多数 | 各工程の計測 | | Asset | 0以上 | 永続出力の証明 | ## キューを通してトレース文脈を伝える 各メッセージに `operation_id`、`attempt_id`、trace contextを含め、再配信も別レコードにします。 ## 呼び出し前後の送信証拠を記録する 前にfingerprint、ルート、idempotency keyを保存し、後にHTTP、request ID、job ID、使用量を追加します。タイムアウトは `submission_unknown` とします。 ## ログノイズを増やさずポーリングを追跡する | フィールド | 理由 | |---|---| | Provider job ID | リモート相関 | | 生・正規化状態 | アダプター監査 | | HTTP | 障害診断 | | 待ち時間 | 性能測定 | | 次回poll | スケジューラー説明 | ## Webhookを安全に結合する 署名を検証し、イベントを重複排除してマッピングを検索します。送信応答より早いイベントは一時保管します。 ## ダウンロードと永続保存を追跡する バイト数、content type、checksum、検証、object key、所要時間を記録し、署名付きURLは保存しません。 ## サポート用の一本のタイムラインを作る ```text accepted -> provider accepted -> processing -> webhook succeeded -> asset stored ``` [Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=trace-ai-video-request-submission-polling-download) で入口を統合しても、attemptごとの正確なモデルとルートを保存します。 ## 結論 安定したoperation ID、attempt ID、永続マッピング、秘匿ログを使い、アセット検証まで一連の証拠を残します。 ## FAQ ### トレースのルートIDは？ 最初の外部呼び出し前にアプリが生成するoperation IDです。 ### 再試行は同じIDですか？ operation IDは共有し、各送信とダウンロードには別のattempt IDとspanを付けます。 ### pollごとに何を記録しますか？ 時刻、job ID、状態、HTTP、必要なメタデータ、次回確認時刻です。 ### Webhookをどう結合しますか？ 永続マッピングでprovider job IDから元のoperationを検索します。 ### 署名付きURLを記録しますか？ いいえ。一時的な認証情報として完全なURLを秘匿します。 ### Atlas Cloudとの関係は？ モデルアクセスを統合しつつ、アプリがoperation ID、ルート、使用量、保存結果を保持します。