翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# ストリームセッションファイルのエクスポート
ストリームセッション中、アプリケーションは、ログ、診断情報、クラッシュダンプ、ファイルの保存、ユーザーデータ、スクリーンショットなど、アプリケーションのデバッグまたは検証に役立つ出力ファイルを生成できます。ストリームセッションファイルのエクスポート機能は、セッション中に作成または変更されたファイルを収集し、圧縮された ZIP ファイルとして指定された Amazon S3 の場所にエクスポートします。また、この機能は、エクスポート ZIP ファイルに含まれているセッションのパフォーマンス統計を 1 秒ごとに収集します。
**警告**
ファイルをエクスポートする前に、次の点に注意してください。
ファイルには、認証情報など、アプリケーションによって書き込まれた機密情報が含まれている場合があります。
ファイルサイズはアプリケーションサイズによっては大きくなる場合があり、Amazon S3 ストレージコストに影響します。
ストリームグループのリージョン AWS リージョン とは異なる で Amazon S3 バケットを選択すると、エクスポートされたストリームセッションファイルはリージョン間で移動します。
## 仕組み
アクティブなストリームセッションでこのオペレーションを手動で呼び出して、そのセッション中に生成されたファイルをエクスポートする必要があります。ストリームセッションは、特に、、`ACTIVE`、`CONNECTED`、 `PENDING_CLIENT_RECONNECTION`のいずれかのステータスでアクティブである必要があります`RECONNECTING`。セッションの終了時に、Amazon GameLift Streams はファイルを Amazon Simple Storage Service (Amazon S3) のバケットにエクスポートします。したがって、エクスポートされたすべてのデータはお客様の所有権内であり、Amazon S3 バケットのアクセス許可ポリシーの対象となります。
エクスポートファイルを有効にしたストリームセッションライフサイクルのチュートリアルを次に示します。
1. Amazon GameLift Streams は、コンピューティングリソースで実行されているアプリケーションにユーザーを接続することでセッションを開始します。
1. アプリケーションはストリーミング中に、ランタイム環境のファイルシステムにファイルを作成または変更します。
1. セッションが終了すると、Amazon GameLift Streams はファイルシステム内のすべての新規または変更されたファイルのコピーを取得し、そのファイルを Amazon S3 バケットにエクスポートします。
Amazon GameLift Streams は、以下の生成および変更されたファイルを収集します。`.zip` アーカイブ内の対応するフォルダでそれらを見つけます。
+ `application/`: アプリケーションまたはゲームが保存されているフォルダ。
+ `profile/`: ユーザーのプロファイルフォルダには、ユーザーの個人設定、設定、データが含まれます。
+ `temp/`: システムの一時フォルダには、アプリケーションとシステムが作成する一時ファイルとデータが含まれています。これには、キャッシュファイル、ログファイル、または中間処理データが含まれます。
+ `stats/`: `perf_stats_v1.csv`1 秒あたりに収集されたセッションのパフォーマンス統計を保持する が含まれます。これには、アプリケーションレベルの統計 (CPU とメモリの使用率) とシステムレベルの統計 (CPU、メモリ、GPU、VRAM の使用率) が含まれます。CSV ファイルに含まれる各統計の詳細な説明については、「」を参照してください。 [パフォーマンス統計リファレンス](realtime-performance-stats.md#realtime-performance-stats-csv)
ファイルを削除するには、Amazon S3 バケット内の オブジェクトを削除します。
## コストへの影響
Amazon S3 にファイルを保存すると、コストが発生します。ストリームセッションは、アプリケーションによっては大量のデータを生成する場合があります。この機能が有効になっている多くのストリームセッションでは、コストが加算される可能性があることに注意してください。
詳細については、[Amazon S3の料金](https://aws.amazon.com/s3/pricing/)」を参照してください。
## ファイルのエクスポート (コンソール)
**Amazon GameLift Streams コンソールでストリームセッションファイルのエクスポートを有効にするには**
1. にサインイン AWS マネジメントコンソール し、[Amazon GameLift Streams コンソール](https://console.aws.amazon.com/gameliftstreams/)を開きます。
1. ナビゲーションバーで、**セッション**を選択して、過去 90 日間のアクティブなストリームセッションと最近のストリームセッションのリストを表示します。
1. **アクティブセッション**タブで、アクティブなストリームセッションを選択します。
1. **ファイルのエクスポート**を選択して、そのストリームセッションのファイルのエクスポート機能を有効にします。
1. **ストリームセッションファイルのエクスポート**ダイアログボックスで、**新しい S3 バケットを作成する** または**既存の S3 バケットを選択する** を選択します。コンソールの手順に従って、エクスポートしたデータを保存する S3 オブジェクトを作成または選択します。
**警告**
ZIP ファイル名がディレクトリ内の既存のファイル名と一致する場合、前のファイル名は上書きされます。
1. **[確認]** を選択します。これで、**エクスポートされたファイル**タブにセッションが一覧表示されます。
1. セッションが終了し、ファイルがエクスポートされるまで待ちます。
Amazon GameLift Streams は、セッションが終了****状態になるとファイルをエクスポートします。セッションが終了すると、**アクティブセッション**タブから**最近のセッション**タブに移動します。
エクスポートプロセスのステータスは、**セッション**エクスポートタブで確認できます。ステータスが**保留中**の場合、ストリームセッションはまだアクティブであるため、Amazon GameLift Streams はまだファイルをエクスポートしていません。ステータスが**成功**の場合、提供されたリンクを使用して Amazon S3 からファイルをダウンロードできます。ステータスが **Failed** の場合、ステータスにカーソルを合わせると、失敗の理由が表示されます。
## ファイルのエクスポート (CLI)
**前提条件**
ユーザー認証情報と選択した AWS CLI を使用して を設定する必要があります AWS リージョン。セットアップ手順については、「」を参照してください[のダウンロード AWS CLI](setting-up.md#setting-up-prereqs)。
**でストリームセッションファイルをエクスポートするには AWS CLI**
では、コンテンツに合わせてカスタマイズされた [ExportStreamSessionFiles](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_ExportStreamSessionFiles.html) コマンド AWS CLI を使用します。
```
aws gameliftstreams export-stream-session-files \
--identifier arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4 \
--stream-session-identifier arn:aws:gameliftstreams:us-west-2:111122223333:streamsession/sg-1AB2C3De4/ABC123def4567
--ouput-uri s3://amzn-s3-demo-bucket/prefix
```
各パラメータの意味は次のとおりです。
`identifier`
ストリームグループ[リソースを一意に識別する Amazon リソースネーム (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) または ID。
ARN の例: `arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4`
ID の例: `sg-1AB2C3De4`
`stream-session-identifier`
ストリームセッション[リソースを一意に識別する Amazon リソースネーム (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) または ID。
ARN の例: `arn:aws:gameliftstreams:us-west-2:111122223333:streamsession/sg-1AB2C3De4/ABC123def4567`
ID の例: `ABC123def4567`
`output-uri`
Amazon GameLift Streams がこのストリームセッションの圧縮エクスポートされたファイルのセットをアップロードする Amazon S3 バケット URI。
指定できる有効な形式は 2 つあります。URI に `.zip`または `.ZIP` ファイル拡張子がある場合、Amazon GameLift Streams はエクスポートされたファイルを指定された URI に保存します。それ以外の場合、Amazon GameLift Streams は圧縮フォルダの名前を生成し、URI に保存します。生成された名前はパターン に従います`date-time-applicationId-streamGroupId-streamSessionId`。例えば、次のようになります。
+ という URI を指定すると`s3://amzn-s3-demo-bucket/MyGame_Session1.zip`、Amazon GameLift Streams はその正確な ZIP フォルダにファイルを保存します。
+ という URI を指定すると`s3://amzn-s3-demo-bucket/MyGame_Session1/`、Amazon GameLift Streams はファイルを に保存します`s3://amzn-s3-demo-bucket/MyGame_Session1/YYYYMMDD-HHMMSS-applicationId-streamGroupId-sessionId.zip`。
ZIP ファイル名が、*Amazon Simple Storage Service ユーザーガイド*の[オブジェクトキーの命名ガイドライン](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html)に準拠していることを確認してください。
ZIP ファイル名がディレクトリ内の既存のファイル名と一致する場合、前のファイル名は上書きされます。
[GetStreamSession](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_GetStreamSession.html) API を呼び出すことで、アクティブなセッションのステータスを確認できます。ストリームセッションの概要から、エクスポートされたファイルのステータスに関する詳細を取得できます。ステータスが**保留中**の場合、ストリームセッションはまだアクティブであるため、Amazon GameLift Streams はまだファイルをエクスポートしていません。ステータスが**成功の場合は**、出力 URI に移動して Amazon S3 のファイルを確認します。ステータスが **Failed** の場合は、 `StatusReason`の を確認します`ExportFilesMetaData`。