View a markdown version of this page

Mencatat panggilan API Amazon GameLift Streams menggunakan AWS CloudTrail - Aliran GameLift Amazon

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

Mencatat panggilan API Amazon GameLift Streams menggunakan AWS CloudTrail

Amazon GameLift Streams terintegrasi dengan AWS CloudTrail, layanan yang menyediakan catatan tindakan yang diambil oleh pengguna, peran, atau Layanan AWS. CloudTrail menangkap semua panggilan API untuk Amazon GameLift Streams sebagai acara. Panggilan yang ditangkap termasuk panggilan dari konsol Amazon GameLift Streams dan panggilan kode ke operasi Amazon GameLift Streams API. Dengan menggunakan informasi yang dikumpulkan oleh CloudTrail, Anda dapat menentukan permintaan yang dibuat ke Amazon GameLift Streams, alamat IP dari mana permintaan dibuat, kapan permintaan dibuat, dan detail tambahan.

Setiap entri peristiwa atau log berisi informasi tentang entitas yang membuat permintaan tersebut. Informasi identitas membantu Anda menentukan berikut hal ini:

  • Baik permintaan tersebut dibuat dengan kredensial pengguna root atau pengguna.

  • Apakah permintaan dibuat atas nama pengguna Pusat Identitas IAM.

  • Apakah permintaan tersebut dibuat dengan kredensial keamanan sementara untuk satu peran atau pengguna gabungan.

  • Apakah permintaan tersebut dibuat oleh Layanan AWS lain.

CloudTrail aktif di akun Anda Akun AWS saat Anda membuat akun dan Anda secara otomatis memiliki akses ke riwayat CloudTrail Acara. Ri CloudTrail wayat acara menyediakan catatan yang dapat dilihat, dapat dicari, dapat diunduh, dan tidak dapat diubah dari 90 hari terakhir dari peristiwa manajemen yang direkam dalam sebuah. Wilayah AWS Untuk informasi selengkapnya, lihat Bek erja dengan riwayat CloudTrail acara di Panduan AWS CloudTrail Pengguna. Tidak ada CloudTrail biaya untuk melihat ri wayat acara.

Untuk catatan peristiwa yang berkelanjutan dalam 90 hari Akun AWS terakhir Anda, buat jejak atau penyimpanan data acara CloudTrail Lake.

CloudTrail jalan setapak

Jej ak CloudTrail memungkinkan pengiriman file log ke bucket Amazon S3. Semua jalur yang dibuat menggunakan Multi-wilayah. Konsol Manajemen AWS Anda dapat membuat jejak wilayah tunggal atau multi-wilayah dengan menggunakan. AWS CLI Membuat jejak Multi-wilayah disarankan karena Anda menangkap aktivitas di semua Wilayah AWS di akun Anda. Jika Anda membuat jejak satu wilayah, Anda hanya dapat melihat peristiwa yang dicatat di jalur tersebut Wilayah AWS. Untuk informasi selengkapnya tentang jalur, lihat Membuat jejak untuk Anda Akun AWS dan Membuat jejak untuk organisasi di Panduan AWS CloudTrail Pengguna.

Anda dapat mengirimkan satu salinan acara manajemen yang sedang berlangsung ke bucket Amazon S3 Anda tanpa biaya CloudTrail dengan membuat jejak, namun, ada biaya penyimpanan Amazon S3. Untuk informasi selengkapnya tentang CloudTrail harga, lihat AWS CloudTrail Harga. Untuk informasi tentang harga Amazon S3, lihat Harga Amazon S3.

CloudTrail Penyimpanan data acara danau

CloudTrail Lake memungkinkan Anda menjalankan SQL-based kueri pada acara Anda. CloudTrail Lake mengonversi peristiwa yang ada dalam format JSON berbasis baris ke format Apache ORC. ORC adalah format penyimpanan kolumnar yang dioptimalkan untuk pengambilan data dengan cepat. Peristiwa digabungkan ke dalam penyimpanan data peristiwa, yang merupakan kumpulan peristiwa yang tidak dapat diubah berdasarkan kriteria yang Anda pilih dengan menerapkan pemilih peristiwa lanj utan. Pemilih yang Anda terapkan ke penyimpanan data peristiwa mengontrol peristiwa mana yang bertahan dan tersedia untuk Anda kueri. Untuk informasi lebih lanjut tentang CloudTrail Danau, lihat Bekerja dengan AWS CloudTrail Danau di Panduan AWS CloudTrail Pengguna.

CloudTrail Penyimpanan dan kueri data acara danau dikenakan biaya. Saat membuat penyimpanan data peristiwa, Anda memilih opsi harga yang ingin Anda gunakan untuk penyimpanan data peristiwa. Opsi harga menentukan biaya untuk menelan dan menyimpan peristiwa, serta periode retensi default dan maksimum untuk penyimpanan data peristiwa. Untuk informasi selengkapnya tentang CloudTrail harga, lihat AWS CloudTrail Harga.

Amazon GameLift Streaming acara data di CloudTrail

Peristiwa data memberikan informasi tentang operasi sumber daya yang dilakukan pada atau di sumber daya (misalnya, memulai sesi aliran dalam grup aliran). Ini juga dikenal sebagai operasi bidang data. Peristiwa data sering kali merupakan aktivitas bervolume tinggi. Secara default, CloudTrail tidak mencatat peristiwa data. Ri CloudTrail wayat peristiwa tidak merekam peristiwa data.

Biaya tambahan berlaku untuk peristiwa data. Untuk informasi selengkapnya tentang CloudTrail harga, lihat AWS CloudTrail Harga.

Anda dapat mencatat peristiwa data untuk jenis sumber daya Amazon GameLift Streams dengan menggunakan CloudTrail konsol, AWS CLI, atau operasi CloudTrail API. Untuk informasi selengkapnya tentang cara mencatat peristiwa data, lihat Pencatatan peristiwa data dengan Konsol Manajemen AWS dan Pencatatan peristiwa data dengan AWS Command Line Interface di Panduan AWS CloudTrail Pengguna.

Tabel berikut mencantumkan jenis sumber daya Amazon GameLift Streams yang dapat Anda catat peristiwa datanya. Kolom Jenis sumber daya (konsol) menunjukkan nilai untuk dipilih dari daftar jenis sumber daya di CloudTrail konsol. Kolom nilai resources.type menunjukkan resources.type nilai, yang akan Anda tentukan saat mengonfigurasi pemilih acara lanjutan menggunakan API or. AWS CLI CloudTrail CloudTrailKol om API Data yang dicatat ke menampilkan panggilan API yang dicatat CloudTrail untuk jenis sumber daya.

Jenis sumber daya (konsol) nilai resource.type API data log ke CloudTrail
GameLift Aplikasi Streaming AWS::GameLiftStreams::Application
GameLift Grup aliran aliran AWS::GameLiftStreams::StreamGroup

CloudTrail mencatat operasi API URL aliran (CreateStreamUrl,, GetStreamUrlListStreamUrls, danRevokeStreamUrl) sebagai peristiwa data, dengan cara yang sama mencatat operasi sesi aliran lainnya. Saat pengguna akhir mengaktifkan URL aliran untuk memulai sesi streaming, Amazon Stre GameLift ams menangani aktivasi tersebut atas nama pengguna akhir sehingga tidak mencatat aktivasi sebagai panggilan API pelanggan. Catatan aktivitas URL streaming yang dapat diaudit adalah CreateStreamUrl panggilan yang membuat URL streaming dan RevokeStreamUrl panggilan yang mencabutnya. Untuk melihat sesi dimulai dari URL aliran, gunakanGetStreamUrl.

Anda dapat mengonfigurasi pemilih acara lanjutan untuk memfilter eventNamereadOnly,, dan resources.ARN bidang untuk mencatat hanya peristiwa yang penting bagi Anda. Untuk informasi selengkapnya tentang bidang ini, lihat AdvancedFieldSelector di Refer AWS CloudTrail ensi API.

Acara GameLift pengelolaan Amazon Streams di CloudTrail

Acara manajemen memberikan informasi tentang operasi manajemen yang dilakukan pada sumber daya di Anda Akun AWS. Ini juga dikenal sebagai operasi bidang kontrol. Secara default, CloudTrail mencatat peristiwa manajemen.

Amazon GameLift Streams mencatat operasi pesawat kontrol Amazon GameLift Streams berikut CloudTrail sebagai peristiwa manajemen.

Contoh acara Amazon GameLift Streams

Peristiwa mewakili permintaan tunggal dari sumber apa pun dan mencakup informasi tentang operasi API yang diminta, tanggal dan waktu operasi, parameter permintaan, dan sebagainya. CloudTrail file log bukanlah jejak tumpukan yang diurutkan dari panggilan API publik, jadi acara tidak muncul dalam urutan tertentu.

Contoh berikut menunjukkan peristiwa CloudTrail manajemen yang menunjukkan CreateApplication operasi.

{ "eventVersion": "1.09", "userIdentity": { "type": "AssumedRole", "principalId": "AROA123456789EXAMPLE:assume-temporary-gameliftstreams-access-role", "arn": "arn:aws:sts::111122223333:assumed-role/GameLiftStreamsTestRole/assume-temporary-gameliftstreams-access-role", "accountId": "111122223333", "accessKeyId": "ASIAIOSFODNN7EXAMPLE", "sessionContext": { "sessionIssuer": { "type": "Role", "principalId": "AROA123456789EXAMPLE", "arn": "arn:aws:iam::111122223333:role/GameLiftStreamsTestRole", "accountId": "111122223333", "userName": "GameLiftStreamsTestRole" }, "webIdFederationData": {}, "attributes": { "creationDate": "2025-07-23T21:18:19Z", "mfaAuthenticated": "false" } } }, "eventTime": "2025-07-23T21:58:54Z", "eventSource": "gameliftstreams.amazonaws.com", "eventName": "CreateApplication", "awsRegion": "us-west-2", "sourceIPAddress": "203.0.113.0", "userAgent": "aws-sdk-javascript/2.0.0 Linux/4.14.291-218.527.amzn2.x86_64 OpenJDK_64-Bit_Server_VM/11.0.17+9-LTS Java/11.0.17 vendor/Amazon.com_Inc. exec-env/AWS_ECS_FARGATE io/sync http/Apache cfg/retry-mode/legacy", "requestParameters": { "ApplicationSourceUri": "s3://amzn-s3-demo-bucket/MyGame", "Description": "MyGame canary - Proton 8", "RuntimeEnvironment": { "Type": "PROTON", "Version": "20230704" }, "ClientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "ExecutablePath": "MyGame100.exe" }, "responseElements": { "Status": "INITIALIZED", "ApplicationSourceUri": "s3://amzn-s3-demo-bucket/MyGame", "Description": "MyGame canary - Proton 8", "RuntimeEnvironment": { "Type": "PROTON", "Version": "20230704" }, "LastUpdatedAt": 1753307934.293, "CreatedAt": 1753307934.293, "Id": "a-9ZY8X7Wv6", "Arn": "arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6", "ExecutablePath": "MyGame100.exe" }, "requestID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "eventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLEbbbbb", "readOnly": false, "eventType": "AwsApiCall", "managementEvent": true, "recipientAccountId": "111122223333", "eventCategory": "Management" }

Contoh berikut menunjukkan peristiwa CloudTrail data dari log jejak yang menunjukkan StartStreamSession operasi.

{ "Records": [ { "eventVersion": "1.09", "userIdentity": { "type": "AssumedRole", "principalId": "AROA123456789EXAMPLE:assume-temporary-gameliftstreams-access-role", "arn": "arn:aws:sts::111122223333:assumed-role/GameLiftStreamsTestRole/assume-temporary-gameliftstreams-access-role", "accountId": "111122223333", "accessKeyId": "ASIAIOSFODNN7EXAMPLE", "sessionContext": { "sessionIssuer": { "type": "Role", "principalId": "AROA123456789EXAMPLE", "arn": "arn:aws:iam::111122223333:role/GameLiftStreamsTestRole", "accountId": "111122223333", "userName": "GameLiftStreamsTestRole" }, "attributes": { "creationDate": "2025-07-23T21:18:19Z", "mfaAuthenticated": "false" } } }, "eventTime": "2025-07-23T23:43:46Z", "eventSource": "gameliftstreams.amazonaws.com", "eventName": "StartStreamSession", "awsRegion": "us-east-2", "sourceIPAddress": "203.0.113.0", "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36", "requestParameters": { "Identifier": "sg-1AB2C3De4", "Description": "StreamGroup sg-1AB2C3De4 Application a-9ZY8X7Wv6 Console stream", "AdditionalLaunchArgs": [], "UserId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "Locations": [ "us-east-2" ], "SignalRequest": "***", "Protocol": "WebRTC", "ApplicationIdentifier": "a-9ZY8X7Wv6", "ClientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "ConnectionTimeoutSeconds": 100, "AdditionalEnvironmentVariables": {} }, "responseElements": { "Status": "ACTIVATING", "ApplicationArn": "arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6", "Description": "StreamGroup sg-1AB2C3De4 Application a-9ZY8X7Wv6 Console stream", "LastUpdatedAt": 1.753314225925E9, "CreatedAt": 1.753314225925E9, "AdditionalEnvironmentVariables": {}, "ConnectionTimeoutSeconds": 100, "AdditionalLaunchArgs": [], "StreamGroupId": "sg-1AB2C3De4", "UserId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "SessionLengthSeconds": 43200, "SignalRequest": "***", "Arn": "arn:aws:gameliftstreams:us-west-2:111122223333:streamsession/sg-1AB2C3De4/ABC123def4567", "Protocol": "WebRTC", "WebSdkProtocolUrl": "https://123456789012.cloudfront.net/e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855.js" }, "requestID": "a1b2c3d4-5678-90ab-cdef-EXAMPLEaaaaa", "eventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLEbbbbb", "readOnly": false, "resources": [ { "accountId": "111122223333", "type": "AWS::GameLiftStreams::StreamGroup", "ARN": "arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4" }, { "accountId": "111122223333", "type": "AWS::GameLiftStreams::Application", "ARN": "arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6" } ], "eventType": "AwsApiCall", "managementEvent": false, "recipientAccountId": "111122223333", "eventCategory": "Data" } ] }

Untuk informasi tentang konten CloudTrail rekaman, lihat konten CloudTrail rek aman di Panduan AWS CloudTrail Pengguna.