翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# トラブルシューティング
<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) コードを返したことを確認します。