기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 문제 해결
<a name="s3-image-troubleshooting"></a>

## 이미지가 Amazon S3 버킷으로 전송되지 않음
<a name="s3-images-not-delivered"></a>

이 문제를 해결하기 위해 주의해야 할 몇 가지 사항이 있습니다.

1. 권한 누락

1. 이미지 생성 구성이 잘못되었습니다.

1. 태그가 조각에 추가되지 않았습니다.

### 권한 누락
<a name="s3-missing-permissions"></a>

고객 관리형 KMS 키를 사용하는 경우 `PutMedia` 호출을 수행하는 역할(업로더)에 적절한 암호화 및 복호화 권한이 있고 다음과 같이 Amazon S3 버킷에 액세스할 수 있는지 확인합니다.
+ `kms:Encrypt`
+ `kms:GenerateDataKey`
+ `kms:Decrypt`
+ `s3:PutObject`

자세한 내용은 [서버 측 암호화를 시작하는 방법](how-kms.md#getting-started-with-sse-akvs) 단원을 참조하십시오.

### 대상 확인
<a name="s3-verify-destination"></a>

 AWS CLI 를 사용하여 스트림에 대한 DescribeImageGenerationConfiguration API를 호출합니다.

```
aws kinesisvideo describe-image-generation-configuration \
  --stream-name "{{demo-stream}}"
```

응답`DestinationConfig`에서를 검토하고 올바른지 확인합니다.

### 이미지 생성 태그가 조각에 추가되었는지 확인
<a name="s3-verify-tag-added"></a>

1. `putKinesisVideoEventMetadata` 호출이 성공했는지 확인합니다.

   `putKinesisVideoEventMetadata` 메서드는 성공 시 상태 코드 0을 반환합니다. 0에 대한 함수의 반환 값을 확인하는 것이 좋습니다. 0이 아닌 상태 코드가 반환되면 16진수로 변환하고 [오류 코드 참조](producer-sdk-errors.md)에서 자세한 내용을 확인합니다.

   오류 로그가 켜져 있는지 확인하고 애플리케이션에서 다른 오류가 있는지 로그를 검토합니다. 애플리케이션의 프레임 제출 호출 패턴을 검토하고 권장 구현인와 비교합니다[조각에 이미지 생성 태그 추가](s3-real-time-image-create.md#s3-adding-image-tags).

1. 로컬에서 생성된 MKV 파일 확인

   생산자 SDK 또는 샘플 애플리케이션이 태그를 올바르게 추가했는지 확인합니다.

   1. `KVS_DEBUG_DUMP_DATA_FILE_DIR` 환경 변수를 설정합니다. 이 값을 설정하면 생산자 SDK는 지정된 위치에 Kinesis Video Streams로 전송했을 미디어 파일을 씁니다.

      ```
      export KVS_DEBUG_DUMP_DATA_FILE_DIR=/path/to/output/directory
      ```
**참고**  
경로가 없는 경우 SDK는 새 디렉터리를 생성하지 않습니다. 필요한 경우 폴더를 생성합니다.

   1. 애플리케이션을 다시 실행합니다. 지정된 출력 디렉터리에 `.mkv` 파일이 기록되는 것을 볼 수 있습니다.

   1. MKVToolNix 또는 기타 소프트웨어를 사용하여 태그가 있는지 콘텐츠를 확인합니다.

      1. MKVToolNix를 설치합니다. `brew install mkvtoolnix` 

      1. 출력 디렉터리의 `.mkv` 파일 중 하나를 사용하여 MKVToolNix를 실행합니다.

         ```
         mkvinfo -v ./path/to/video/file
         ```

      1. MKVToolNix 출력을 검토합니다. `KinesisVideoStream::PutFragmentMetadata` 생산자 SDK 메서드가 올바르게 호출된 경우 다음 MKV 태그가 표시됩니다.

         ```
         |+ Tags
         | + Tag
         |  + Simple
         |   + Name: AWS_KINESISVIDEO_IMAGE_GENERATION
         ```
**참고**  
태그는 앞에 있는 클러스터에 속합니다.

   1. MKV 태그가 없는 경우 생산`KinesisVideoStream::PutEventMetadata`자 SDK 메서드가 `STREAM_EVENT_TYPE_IMAGE_GENERATION` 인수와 함께 호출되었고 성공(0) 코드를 반환했는지 확인합니다.