

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Ekspor file sesi streaming
<a name="stream-sessions-export-files"></a>

 Selama sesi streaming, aplikasi Anda dapat menghasilkan file keluaran yang membantu Anda men-debug atau memverifikasi aplikasi Anda, seperti log, informasi diagnostik, crash dump, menyimpan file, data pengguna, dan tangkapan layar. Fitur file sesi aliran ekspor mengumpulkan file yang dibuat atau dimodifikasi selama sesi dan mengekspornya sebagai file ZIP terkompresi ke lokasi Amazon S3 yang disediakan. Fitur ini juga mengumpulkan statistik kinerja untuk sesi setiap detik, yang termasuk dalam file ZIP ekspor. 

**Awas**  
 Sebelum Anda mengekspor file, perhatikan hal-hal berikut:   
 File mungkin berisi informasi sensitif yang ditulis oleh aplikasi Anda, termasuk informasi kredensil. 
 Ukuran file mungkin besar tergantung pada ukuran aplikasi Anda, yang memengaruhi biaya penyimpanan Amazon S3 Anda. 
 Jika Anda memilih bucket Amazon S3 di bucket Wilayah AWS yang berbeda dari Region grup streaming, maka file sesi streaming yang diekspor akan berpindah lintas wilayah. 

## Cara kerjanya
<a name="stream-sessions-export-files-overview"></a>

 Anda harus menjalankan operasi ini secara manual pada sesi aliran aktif untuk mengekspor file yang dihasilkan selama sesi itu. Sesi streaming harus aktif, khususnya dalam salah satu status berikut`ACTIVE`,, `CONNECTED``PENDING_CLIENT_RECONNECTION`, dan`RECONNECTING`. Di akhir sesi, Amazon GameLift Streams mengekspor file ke bucket Anda di Amazon Simple Storage Service (Amazon S3). Dengan demikian, semua data yang diekspor berada dalam kepemilikan Anda dan tunduk pada kebijakan izin bucket Amazon S3. 

 Berikut panduan siklus hidup sesi streaming dengan file ekspor diaktifkan: 

1.  Amazon GameLift Streams memulai sesi dengan menghubungkan pengguna ke aplikasi Anda yang berjalan pada sumber daya komputasi. 

1.  Saat aplikasi Anda mengalir, aplikasi ini membuat atau memodifikasi file di sistem file lingkungan runtime. 

1.  Saat sesi berakhir, Amazon GameLift Streams mendapatkan salinan semua file baru atau yang dimodifikasi di sistem file dan mengekspor file ke bucket Amazon S3 Anda. 

Amazon GameLift Streams mengumpulkan file yang dihasilkan dan dimodifikasi berikut. Temukan mereka di folder yang sesuai di `.zip` arsip.
+ `application/`: Folder tempat aplikasi atau game Anda disimpan.
+ `profile/`: Folder profil pengguna berisi pengaturan, konfigurasi, dan data pribadi pengguna.
+ `temp/`: Folder temp sistem berisi file sementara dan data yang dibuat oleh aplikasi Anda dan sistem. Ini dapat mencakup file cache, file log, atau data pemrosesan perantara.
+ `stats/`: Berisi`perf_stats_v1.csv`, yang menyimpan statistik kinerja untuk sesi yang dikumpulkan per detik. Ini termasuk statistik tingkat aplikasi (pemanfaatan CPU dan memori) dan statistik tingkat sistem (CPU, memori, GPU, dan pemanfaatan VRAM). Untuk penjelasan rinci tentang setiap stat yang disertakan dalam file CSV, lihat [Referensi statistik kinerja](realtime-performance-stats.md#realtime-performance-stats-csv)

 Untuk menghapus file, hapus objek di bucket Amazon S3. 

## Dampak biaya
<a name="stream-sessions-export-files-cost"></a>

Anda dikenakan biaya untuk menyimpan file di Amazon S3. Sesi streaming mungkin menghasilkan sejumlah besar data tergantung pada aplikasi Anda. Ketahuilah bahwa dengan banyak sesi streaming yang mengaktifkan fitur ini, biayanya dapat bertambah. 

 Untuk informasi selengkapnya, lihat [harga Amazon S3](https://aws.amazon.com/s3/pricing/). 

## Ekspor file (Konsol)
<a name="stream-sessions-export-files-console"></a>

**Untuk mengaktifkan file sesi streaming ekspor di konsol Amazon GameLift Streams**

1. Masuk ke Konsol Manajemen AWS dan buka [konsol Amazon GameLift Streams](https://console.aws.amazon.com/gameliftstreams/).

1.  Di bilah navigasi, pilih **Sesi** untuk melihat daftar sesi streaming aktif dan terbaru dalam 90 hari terakhir. 

1. Di tab **Sesi aktif**, pilih sesi aliran aktif.

1.  Pilih **Ekspor file** untuk mengaktifkan fitur ekspor file untuk sesi streaming tersebut. 

1.  Di kotak dialog **Export stream sessions file**, pilih **Create a new S3 bucket atau Pilih bucket** **S3 yang sudah ada**. Ikuti langkah-langkah di konsol untuk membuat atau memilih objek S3 untuk menyimpan data yang diekspor. 
**Awas**  
Jika nama file ZIP cocok dengan yang sudah ada di direktori, yang sebelumnya akan ditimpa.

1.  Pilih **Konfirmasi**. Anda sekarang dapat menemukan sesi yang tercantum di tab **File yang diekspor**. 

1.  Tunggu sesi berakhir dan file diekspor. 

 Amazon GameLift Streams akan mengekspor file saat sesi dalam status **Terminasi.** Ketika sesi telah dihentikan, itu akan berpindah dari tab **Sesi aktif** ke tab **Sesi terbaru**. 

 Anda dapat memeriksa status proses ekspor di **Ekspor sesi** tab. Jika statusnya **Tertunda**, sesi streaming masih aktif, sehingga Amazon GameLift Streams belum mengekspor file. Jika statusnya **Berhasil,** Anda dapat mengunduh file dari Amazon S3 menggunakan tautan yang disediakan. Jika status **Gagal**, arahkan kursor ke status untuk melihat alasan kegagalan. 

## Ekspor file (CLI)
<a name="stream-sessions-export-files-cli"></a>

**Prasyarat**

 Anda harus mengkonfigurasi AWS CLI dengan kredensi pengguna Anda dan pilihan Anda. Wilayah AWS Untuk petunjuk penyiapan, lihat[Unduh AWS CLI](setting-up.md#setting-up-prereqs). 

**Untuk mengekspor file sesi streaming di AWS CLI**

 Saat Anda AWS CLI menggunakan [ExportStreamSessionFiles](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_ExportStreamSessionFiles.html)perintah, disesuaikan untuk konten Anda. 

```
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
```

Di mana

`identifier`  
[Nama Sumber Daya Amazon (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) atau ID yang secara unik mengidentifikasi sumber daya grup aliran.   
Contoh ARN: `arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4`  
Contoh ID: `sg-1AB2C3De4`

`stream-session-identifier`  
[Nama Sumber Daya Amazon (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) atau ID yang secara unik mengidentifikasi sumber daya sesi streaming.   
Contoh ARN: `arn:aws:gameliftstreams:us-west-2:111122223333:streamsession/sg-1AB2C3De4/ABC123def4567`  
Contoh ID: `ABC123def4567`

`output-uri`  
URI bucket Amazon S3 tempat Amazon GameLift Streams mengunggah kumpulan file ekspor terkompresi untuk sesi streaming ini.   
 Ada dua format valid yang dapat Anda berikan. Jika URI memiliki ekstensi `.ZIP` file `.zip` atau, Amazon GameLift Streams menyimpan file yang diekspor di URI yang disediakan. Jika tidak, Amazon GameLift Streams menghasilkan nama untuk folder terkompresi dan menyimpannya di URI. Nama yang dihasilkan mengikuti pola:`date-time-applicationId-streamGroupId-streamSessionId`. Contoh:   
+  Jika Anda memberikan URI yang disebut`s3://amzn-s3-demo-bucket/MyGame_Session1.zip`, Amazon GameLift Streams menyimpan file di folder ZIP yang tepat. 
+  Jika Anda memberikan URI yang disebut`s3://amzn-s3-demo-bucket/MyGame_Session1/`, Amazon GameLift Streams akan menyimpan file di`s3://amzn-s3-demo-bucket/MyGame_Session1/YYYYMMDD-HHMMSS-applicationId-streamGroupId-sessionId.zip`. 
 Pastikan bahwa nama file ZIP Anda sesuai dengan [pedoman penamaan kunci Objek](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html) di *Panduan Pengguna Layanan Penyimpanan Sederhana Amazon*.   
Jika nama file ZIP cocok dengan yang sudah ada di direktori, yang sebelumnya akan ditimpa.

 Anda dapat memeriksa status sesi aktif dengan memanggil [GetStreamSession](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_GetStreamSession.html)API. Dari ringkasan sesi streaming, Anda bisa mendapatkan detail tentang status file yang diekspor. Jika statusnya **Tertunda**, maka sesi streaming masih aktif, sehingga Amazon GameLift Streams belum mengekspor file. Jika status **Berhasil, navigasikan** ke URI keluaran untuk melihat file di Amazon S3. Jika statusnya **Gagal**, periksa `StatusReason` di`ExportFilesMetaData`. 