Registrazione dei messaggi nello script del server Accesso ai log del server Regolazione del livello di registrazione

Messaggi del server di registrazione () Amazon GameLift ServersRealtime

Puoi acquisire messaggi personalizzati dal server dai tuoi file Amazon GameLift Servers Realtime di registro. Per ulteriori informazioni sulla registrazione per server personalizzati, consultaMessaggi del server di registrazione (server personalizzati).

Esistono diversi tipi di messaggi che puoi inviare ai tuoi file di registro (vedi). Registrazione dei messaggi nello script del server Oltre ai messaggi personalizzati, il sistema di Amazon GameLift Servers Realtime output utilizza gli stessi tipi di messaggi e scrive negli stessi file di registro. Puoi regolare il livello di registrazione del tuo parco macchine per ridurre la quantità di messaggi di registrazione generati dai server (vediRegolazione del livello di registrazione).

Importante

C'è un limite alla dimensione di un file di registro per sessione di gioco (vedi Amazon GameLift Serversendpoint e quote nella). Riferimenti generali di AWS Al termine di una sessione di gioco, Amazon GameLift Servers carica i log del server su Amazon Simple Storage Service (Amazon S3). Amazon GameLift Serversnon caricherà log che superano il limite. I log possono crescere molto rapidamente e superare il limite di dimensione. È necessario monitorare i log e limitare l'output dei log ai soli messaggi necessari.

Registrazione dei messaggi nello script del server

Puoi inviare messaggi personalizzati nello script per il tuo Amazon GameLift ServersRealtime. Utilizza i seguenti passaggi per inviare messaggi del server a un file di registro:

Create una variabile per contenere il riferimento all'oggetto logger.
```
var logger;
```
Nella init() funzione, recupera il logger dall'oggetto di sessione e assegnalo alla variabile logger.
```
function init(rtSession) {
    session = rtSession;
    logger = session.getLogger();
}
```

Chiama la funzione appropriata sul logger per emettere un messaggio.

Messaggi di debug


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

Messaggi informativi


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

Messaggi di avviso


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

Messaggi di errore


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

Messaggi di errore irreversibili


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

Il cliente riceve messaggi di errore irreversibili


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

Per un esempio delle istruzioni di registrazione in uno script, vedere. Amazon GameLift ServersRealtimeesempio di script

L'output nei file di registro indica il tipo di messaggio (DEBUG,,INFO,WARN,ERROR,CXFATAL)FATAL, come illustrato nelle righe seguenti di un registro di esempio:

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.

Accesso ai log del server

Al termine di una sessione di gioco, archivia Amazon GameLift Servers automaticamente i log in Amazon S3 e li conserva per 14 giorni. Puoi utilizzare la chiamata GetGameSessionLogUrl API per ottenere la posizione dei log di una sessione di gioco. Utilizza l'URL restituito dalla chiamata API per scaricare i log.

Regolazione del livello di registrazione

I registri possono crescere molto rapidamente e superare il limite di dimensione. È necessario monitorare i log e limitare l'output dei log ai soli messaggi necessari. In Amazon GameLift Servers Realtime effetti, puoi regolare il livello di registrazione fornendo un parametro nella configurazione di runtime del tuo parco macchine nel modulologgingLevel:LOGGING_LEVEL, dove LOGGING_LEVEL è presente uno dei seguenti valori:

debug
info(impostazione predefinita)
warn
error
fatal
cxfatal

Questo elenco è ordinato dal meno grave (debug) al più grave (cxfatal). Se ne loggingLevel imposti uno, il server registrerà solo i messaggi con quel livello di gravità o un livello di gravità superiore. Ad esempio, l'impostazione loggingLevel:error farà in modo che tutti i server del parco utenti error scrivano e cxfatal inviino solo messaggi nel registro. fatal

Puoi impostare il livello di registrazione per la tua flotta al momento della creazione o dopo l'esecuzione. La modifica del livello di registrazione della flotta dopo l'avvio avrà effetto solo sui registri delle sessioni di gioco create dopo l'aggiornamento. I registri di tutte le sessioni di gioco esistenti non verranno modificati. Se non imposti un livello di registrazione quando crei la tua flotta, i tuoi server imposteranno il livello di registrazione come predefinito. info Consulta le seguenti sezioni per istruzioni su come impostare il livello di registrazione.

Impostazione del livello di registrazione durante la creazione di un Amazon GameLift ServersRealtime parco veicoli (console)

Segui le istruzioni riportate Crea una EC2 flotta Amazon GameLift Servers gestita per creare la tua flotta, con la seguente aggiunta:

Nella sottofase di allocazione del processo Server della fase Gestione del processo, fornisci la coppia chiave-valore del livello di registrazione (ad esempiologgingLevel:error) come valore per i parametri di Launch. Utilizzate un carattere non alfanumerico (eccetto la virgola) per separare il livello di registrazione da eventuali parametri aggiuntivi (ad esempio,). loggingLevel:error +map Winter444

Impostazione del livello di registrazione durante la creazione di una flotta () Amazon GameLift ServersRealtimeAWS CLI

Segui le istruzioni riportate Crea una EC2 flotta Amazon GameLift Servers gestita per creare la tua flotta, con la seguente aggiunta:

Nell'argomento relativo al --runtime-configuration parametro forcreate-fleet, fornite la coppia chiave-valore del livello di registrazione (ad esempiologgingLevel:error) come valore per. Parameters Utilizzate un carattere non alfanumerico (eccetto la virgola) per separare il livello di registrazione da eventuali parametri aggiuntivi. Fai riferimento al file di esempio seguente:


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

Impostazione del livello di registrazione per un parco macchine funzionante (console) Amazon GameLift ServersRealtime

Segui le istruzioni riportate Aggiornamento di una configurazione del Amazon GameLift Servers parco veicoli per aggiornare il tuo parco veicoli utilizzando la Amazon GameLift Servers Console, con la seguente aggiunta:

Nella pagina Modifica flotta, in Allocazione dei processi del server, fornisci la coppia chiave-valore del livello di registrazione (ad esempiologgingLevel:error) come valore per i parametri di Launch. Utilizza un carattere non alfanumerico (eccetto la virgola) per separare il livello di registrazione da eventuali parametri aggiuntivi (ad esempio,). loggingLevel:error +map Winter444

Impostazione del livello di registrazione per una flotta in funzione () Amazon GameLift ServersRealtimeAWS CLI

Segui le istruzioni riportate Aggiornamento di una configurazione del Amazon GameLift Servers parco veicoli per aggiornare la tua flotta utilizzando AWS CLI, con la seguente aggiunta:

Nell'argomento relativo al --runtime-configuration parametro forupdate-runtime-configuration, fornite la coppia chiave-valore del livello di registrazione (ad esempiologgingLevel:error) come valore per. Parameters Utilizzate un carattere non alfanumerico (eccetto la virgola) per separare il livello di registrazione da eventuali parametri aggiuntivi. Fai riferimento al file di esempio seguente:


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

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Registrazione per server personalizzati

Sicurezza