Pencatatan pesan server (Amazon GameLift ServersRealtime) - Amazon GameLift Servers
Mencatat pesan di skrip server AndaMengakses log serverMenyesuaikan level logging

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

Pencatatan pesan server (Amazon GameLift ServersRealtime)

Anda dapat menangkap pesan server khusus dari file log Amazon GameLift Servers Realtime masuk Anda. 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, pesan sistem Amazon GameLift Servers Realtime keluaran Anda 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 Amazon GameLift Serverstitik akhir dan kuota di Referensi Umum AWS). Saat sesi game berakhir, Amazon GameLift Servers unggah log server ke Amazon Simple Storage Service (Amazon S3). Amazon GameLift Serverstidak 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 Anda Amazon GameLift ServersRealtime. 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 galat

    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, lihatAmazon GameLift ServersRealtimecontoh skrip.

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 Servers 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 Amazon GameLift ServersRealtime, Anda dapat menyesuaikan level logging dengan memberikan parameter dalam konfigurasi runtime armada Anda dalam formulirloggingLevel:LOGGING_LEVEL, di LOGGING_LEVEL mana 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 itu 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.

Mengatur level logging saat membuat Amazon GameLift ServersRealtime armada (Konsol)

Ikuti petunjuk di Buat EC2 armada Amazon GameLift Servers terkelola 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

Mengatur level logging saat membuat Amazon GameLift ServersRealtime fleet (AWS CLI)

Ikuti petunjuk di Buat EC2 armada Amazon GameLift Servers terkelola 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 Amazon GameLift ServersRealtime armada yang sedang berjalan (Konsol)

Ikuti petunjuk di Perbarui konfigurasi Amazon GameLift Servers armada untuk memperbarui armada Anda menggunakan Amazon GameLift Servers Konsol, 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 Amazon GameLift ServersRealtime armada yang sedang berjalan (AWS CLI)

Ikuti petunjuk di Perbarui konfigurasi Amazon GameLift Servers armada untuk memperbarui armada Anda menggunakan AWS 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}]"