<!-- Canonical URL: https://ask.atlascloud.ai/ko/trace-ai-video-request-submission-polling-download -->

# 제출, 폴링, 다운로드 전 과정에서 하나의 AI 동영상 요청을 추적하려면?

> 제출 전에 안정적인 operation ID를 만들고 provider request, job, poll, webhook, 저장 asset에 연결하세요. 각 시도는 별도 ID를 쓰고 비밀과 서명 URL은 기록하지 않습니다.

<!-- Canonical URL: https://ask.atlascloud.ai/trace-ai-video-request-submission-polling-download -->

비동기 동영상 요청은 공통 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개 이상 | 상태와 웹훅 연결 |
| Trace span | 다수 | 단계별 측정 |
| Asset | 0개 이상 | 영구 출력 증명 |

## 큐를 통해 trace context 전달하기

모든 메시지에 `operation_id`, `attempt_id`, trace context를 넣고 재전송은 별도 delivery로 기록합니다.

## 호출 전후 제출 증거 기록하기

호출 전 fingerprint, 경로, idempotency key를 저장하고 이후 HTTP, request ID, job ID, usage를 추가합니다. timeout은 `submission_unknown`입니다.

## 로그 소음 없이 폴링 추적하기

| 필드 | 이유 |
|---|---|
| Provider job ID | 원격 상관 |
| 원본 및 정규화 상태 | adapter 감사 |
| HTTP 상태 | 장애 진단 |
| 지연 시간 | 성능 측정 |
| 다음 poll | scheduler 설명 |

## 웹훅을 안전하게 연결하기

서명을 검증하고 event ID로 중복을 제거한 뒤 매핑을 조회합니다. 전송 응답보다 먼저 온 이벤트는 임시 저장합니다.

## 다운로드와 영구 저장 추적하기

바이트, 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, 영구 매핑, 비밀이 제거된 로그로 최종 asset 검증까지 연결합니다.

## FAQ

### 루트 추적 ID는 무엇인가요?

원격 호출 전에 애플리케이션이 생성한 operation ID입니다.

### 재시도도 같은 추적 ID를 쓰나요?

operation ID는 공유하지만 제출과 다운로드 시도는 각각 attempt ID와 span을 가집니다.

### 각 poll에서 무엇을 기록하나요?

시간, job ID, 상태, HTTP, 필요한 metadata, 다음 확인 시각입니다.

### 웹훅을 원래 trace와 어떻게 연결하나요?

영구 매핑에서 provider job ID로 operation을 찾습니다.

### 서명 다운로드 URL도 기록하나요?

아니요. 임시 자격 증명으로 취급하고 전체 쿼리를 숨깁니다.

### Atlas Cloud는 어디에 들어가나요?

접근 계층을 통합하고 앱은 operation ID, 모델 경로, 사용량, 저장 결과를 보관합니다.
