Mencatat pesan server (Server Realtime)

Anda dapat menangkap pesan server kustom dari Server Realtime Anda dalam file log. Untuk mempelajari tentang pencatatan untuk server kustom, lihatPencatatan pesan server (server khusus).

Ada berbagai jenis pesan yang dapat Anda ouptput ke file log Anda (lihatMencatat pesan di skrip server Anda). Selain pesan kustom Anda, Server Realtime Anda mengeluarkan pesan sistem menggunakan jenis pesan yang sama dan menulis ke file log yang sama. Anda dapat menyesuaikan tingkat logging untuk armada Anda untuk mengurangi jumlah pesan logging yang dihasilkan server Anda (lihatMenyesuaikan level logging).

penting

Ada batasan ukuran file log per sesi game (lihat GameLift titik akhir Amazon dan kuota di Referensi Umum AWS). Saat sesi permainan berakhir, Amazon GameLift mengunggah log server ke Amazon Simple Storage Service (Amazon S3). Amazon tidak GameLift akan mengunggah log yang melebihi batas. Log dapat tumbuh sangat cepat dan melebihi batas ukuran. Anda harus memantau log Anda dan membatasi output log hanya untuk pesan yang diperlukan.

Mencatat pesan di skrip server Anda

Anda dapat menampilkan pesan khusus dalam skrip untuk Server Realtime Anda. Gunakan langkah-langkah berikut untuk mengirim pesan server ke file log:

1. Buat varaible untuk menahan referensi ke objek logger.

   var logger;

2. Dalam init() fungsi, dapatkan logger dari objek sesi dan tetapkan ke variabel logger Anda.

   function init(rtSession) {
       session = rtSession;
       logger = session.getLogger();
   }

3. Panggil fungsi yang sesuai pada logger untuk mengeluarkan pesan.

   Pesan debug

   logger.debug("This is my debug message...");

   Pesan informasi

   logger.info("This is my info message...");

   Pesan peringatan

   logger.warn("This is my warn message...");

   Pesan kesalahan

   logger.error("This is my error message...");

   Pesan kesalahan fatal

   logger.fatal("This is my fatal error message...");

   Pelanggan mengalami pesan kesalahan fatal

   logger.cxfatal("This is my customer experience fatal error message...");

Untuk contoh pernyataan logging dalam skrip, lihatContoh skrip Server Realtime.

Output dalam file log menunjukkan jenis pesan (DEBUG,,INFO,WARN, ERRORFATAL,CXFATAL), seperti yang ditunjukkan pada baris berikut dari log contoh:

09 Sep 2021 11:46:32,970 [INFO] (gamelift.js) 215: Calling GameLiftServerAPI.InitSDK...
09 Sep 2021 11:46:32,993 [INFO] (gamelift.js) 220: GameLiftServerAPI.InitSDK succeeded
09 Sep 2021 11:46:32,993 [INFO] (gamelift.js) 223: Waiting for Realtime server to start...
09 Sep 2021 11:46:33,15 [WARN] (index.js) 204: Connection is INSECURE. Messages will be sent/received as plaintext.

Mengakses log server

Ketika sesi permainan berakhir, Amazon GameLift secara otomatis menyimpan log di Amazon S3 dan menyimpannya selama 14 hari. Anda dapat menggunakan panggilan GetGameSessionLogUrl API untuk mendapatkan lokasi log untuk sesi game. Gunakan URL yang dikembalikan oleh panggilan API untuk mengunduh log.

Menyesuaikan level logging

Log dapat tumbuh sangat cepat dan melebihi batas ukuran. Anda harus memantau log Anda dan membatasi output log hanya untuk pesan yang diperlukan. Untuk Server Realtime, Anda dapat menyesuaikan level logging dengan menyediakan parameter dalam konfigurasi runtime armada Anda di formulirloggingLevel:LOGGING_LEVEL, yang LOGGING_LEVEL merupakan salah satu nilai berikut:

1. debug

2. info(default)

3. warn

4. error

5. fatal

6. cxfatal

Daftar ini diurutkan dari yang paling parah (debug) hingga yang paling parah (cxfatal). Anda menetapkan satu loggingLevel dan server hanya akan mencatat pesan pada tingkat keparahan atau tingkat keparahan yang lebih tinggi. Misalnya, pengaturan loggingLevel:error akan membuat semua server di armada Anda hanya menuliserror,fatal, dan cxfatal pesan ke log.

Anda dapat mengatur tingkat logging untuk armada Anda saat Anda membuatnya atau setelah berjalan. Mengubah level logging armada Anda setelah berjalan hanya akan memengaruhi log untuk sesi game yang dibuat setelah pembaruan. Log untuk setiap sesi game yang ada tidak akan terpengaruh. Jika Anda tidak menetapkan tingkat pencatatan saat membuat armada, server Anda akan menyetel level logging secara info default. Lihat bagian berikut untuk instruksi untuk mengatur tingkat logging.

Menyetel level logging saat membuat armada Server Realtime (Konsol)

Ikuti petunjuk di Buat armada GameLift terkelola Amazon untuk membuat armada Anda, dengan tambahan berikut:

• Dalam sublangkah alokasi proses Server dari langkah manajemen Proses, berikan pasangan nilai kunci tingkat pencatatan (sepertiloggingLevel:error) sebagai nilai untuk parameter Peluncuran. Gunakan karakter non-alfanumerik (kecuali koma) untuk memisahkan level logging dari parameter tambahan (misalnya,). loggingLevel:error +map Winter444

Menyetel level logging saat membuat armada Server Realtime () AWS CLI

Ikuti petunjuk di Buat armada GameLift terkelola Amazon untuk membuat armada Anda, dengan tambahan berikut:

• Dalam argumen --runtime-configuration parameter untukcreate-fleet, berikan pasangan nilai kunci tingkat logging (sepertiloggingLevel:error) sebagai nilai untuk. Parameters Gunakan karakter non-alfanumerik (kecuali koma) untuk memisahkan level logging dari parameter tambahan apa pun. Lihat contoh berikut ini:

--runtime-configuration "GameSessionActivationTimeoutSeconds=60,
                    MaxConcurrentGameSessionActivations=2,
                    ServerProcesses=[{LaunchPath=/local/game/myRealtimeLaunchScript.js,
                                    Parameters=loggingLevel:error +map Winter444,
                                    ConcurrentExecutions=10}]"

Menyetel level logging untuk armada Server Realtime yang sedang berjalan (Konsol)

Ikuti petunjuk di Memperbarui konfigurasi armada untuk memperbarui armada Anda menggunakan GameLift Konsol Amazon, dengan tambahan berikut:

• Pada halaman Edit armada, di bawah alokasi proses Server, berikan pasangan nilai kunci tingkat pencatatan (sepertiloggingLevel:error) sebagai nilai untuk parameter Peluncuran. Gunakan karakter non-alfanumerik (kecuali koma) untuk memisahkan level logging dari parameter tambahan (misalnya,). loggingLevel:error +map Winter444

Menyetel level logging untuk armada Server Realtime yang sedang berjalan () AWS CLI

Ikuti petunjuk di Memperbarui konfigurasi armada untuk memperbarui armada Anda menggunakanAWS CLI, dengan tambahan berikut:

• Dalam argumen --runtime-configuration parameter untukupdate-runtime-configuration, berikan pasangan nilai kunci tingkat logging (sepertiloggingLevel:error) sebagai nilai untuk. Parameters Gunakan karakter non-alfanumerik (kecuali koma) untuk memisahkan level logging dari parameter tambahan apa pun. Lihat contoh berikut ini:

--runtime-configuration "GameSessionActivationTimeoutSeconds=60,
                    MaxConcurrentGameSessionActivations=2,
                    ServerProcesses=[{LaunchPath=/local/game/myRealtimeLaunchScript.js,
                                    Parameters=loggingLevel:error +map Winter444,
                                    ConcurrentExecutions=10}]"