Registro de mensajes del servidor (servidores en tiempo real)

Puede capturar mensajes de servidor personalizados de sus servidores en tiempo real en archivos de registro. Para obtener más información sobre el registro de servidores personalizados, consulteRegistro de mensajes del servidor (servidores personalizados).

Hay diferentes tipos de mensajes que puede enviar a los archivos de registro (consulteRegistro de mensajes en el script de su servidor). Además de los mensajes personalizados, los servidores en tiempo real generan mensajes del sistema con los mismos tipos de mensajes y los escriben en los mismos archivos de registro. Puede ajustar el nivel de registro de su flota para reducir la cantidad de mensajes de registro que generan sus servidores (consulteAjuste de Registro de Registro de Registro de Registro).

importante

Hay un límite en el tamaño de un archivo de registro por sesión de juego (consulte los GameLiftpuntos de conexión y cuotas de Amazon en Referencia general de AWS). Cuando termina una sesión de juego, AmazonGameLift carga los registros del servidor de almacenamiento en Amazon Simple Storage Service (Amazon S3). Amazon noGameLift cargará registros que superen el límite. Los troncos pueden crecer muy rápido y superar el límite de tamaño. Debe supervisar sus registros y limitar la salida del registro únicamente a los mensajes necesarios.

Registro de mensajes en el script de su servidor

Puede generar mensajes personalizados en el script para sus servidores en tiempo real. Siga estos pasos para enviar mensajes de servidor de registro:

1. Cree una variable para contener la referencia al objeto de registro.

   var logger;

2. En lainit() función, obtenga el registrador del objeto de sesión y asígnelo a su variable de registro.

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

3. Llame a la función correspondiente del registrador para generar un mensaje.

   Mensajes de depuración

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

   Mensajes informativos

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

   Mensajes de advertencia

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

   Mensajes de error

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

   Mensajes de error fatales

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

   Mensajes de error graves sobre la experiencia del cliente

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

Para ver un ejemplo de las sentencias de registro de un script, consultede script de servidores Realtime.

El resultado de los archivos de registro indica el tipo de mensaje (DEBUG,,INFO,WARN,ERROR,CXFATAL)FATAL, tal como se muestra en las siguientes líneas de un registro de ejemplo:

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.

de Registro de Registro de Registro de

Cuando finaliza una sesión de juego, Amazon almacenaGameLift automáticamente los registros en Amazon S3 y los conserva durante un período de tiempo limitado. Puedes usar la llamada a laGetGameSessionLogUrl API para obtener la ubicación de los registros de una sesión de juego. Usa la URL devuelta por la llamada a la API para descargar los registros.

Ajuste de Registro de Registro de Registro de Registro

Los troncos pueden crecer muy rápido y superar el límite de tamaño. Debe supervisar sus registros y limitar la salida del registro únicamente a los mensajes necesarios. Para Realtime Servers, puede ajustar el nivel de registro proporcionando un parámetro en la configuración del tiempo de ejecución de su flota en el formulariologgingLevel:LOGGING_LEVEL, dondeLOGGING_LEVEL aparece uno de los siguientes valores:

1. debug

2. info(predeterminado)

3. warn

4. error

5. fatal

6. cxfatal

Esta lista está ordenada de menos grave (debug) a más grave (cxfatal). Si configura uno únicologgingLevel, el servidor solo registrará los mensajes con ese nivel de gravedad o un nivel de gravedad superior. Por ejemplo, la configuraciónloggingLevel:error hará que todos los servidores de su flota solo escribanerror y envíencxfatal mensajes al registro.fatal

Puede establecer el nivel de Registro de Registro de Registro de Registro de Registro de Registro de Registro de Registro de Registro de Registro de Registro de Registro de Registro de Registro de Registro de Registro de Registro de Cambiar el nivel de registro de tu flota después de que esté en funcionamiento solo afectará a los registros de las sesiones de juego que se hayan creado después de la actualización. Los registros de las sesiones de juego existentes no se verán afectados. Si no establece un nivel de registro al crear su flota, sus servidores establecerán el nivel de registro de formainfo predeterminada. Consulte las siguientes secciones para obtener instrucciones sobre cómo configurar el nivel de registro.

Configurar el nivel de registro al crear una flota de servidores en tiempo real (consola)

Siga las instruccionesCrea una flotaGameLift gestionada por Amazon que se indican para crear su flota, con la siguiente adición:

• En el subpaso de asignación de procesos del servidor del paso de administración de procesos, proporcione el par clave-valor del nivel de registro (por ejemplologgingLevel:error) como valor para los parámetros de lanzamiento. Utilice un carácter no alfanumérico (excepto una coma) para separar el nivel de registro de cualquier parámetro adicional (por ejemplo,loggingLevel:error +map Winter444).

Establecer el nivel de registro al crear una flota de servidores en tiempo real (AWS CLI)

Siga las instruccionesCrea una flotaGameLift gestionada por Amazon que se indican para crear su flota, con la siguiente adición:

• En el argumento del--runtime-configuration parámetro forcreate-fleet, proporcione el par clave-valor del nivel de registro (por ejemplologgingLevel:error) como valor paraParameters. Utilice un carácter no alfanumérico (excepto una coma) para separar el nivel de registro de cualquier parámetro adicional. Vea el siguiente ejemplo:

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

Configuración del nivel de registro para una flota de servidores en tiempo real en ejecución (consola)

Sigue las instruccionesActualización de un grupo de implementaciones que se indican para actualizar tu flota mediante laGameLift consola de Amazon, con la siguiente adición:

• En la página Editar flota, en Asignación de procesos del servidor, proporcione el par clave-valor del nivel de registro (por ejemplologgingLevel:error) como valor para los parámetros de lanzamiento. Utilice un carácter no alfanumérico (excepto una coma) para separar el nivel de registro de cualquier parámetro adicional (por ejemplo,loggingLevel:error +map Winter444).

Configuración del nivel de registro para una flota de servidores en tiempo real en ejecución (AWS CLI)

Siga las instruccionesActualización de un grupo de implementaciones que se indican para actualizar su flota mediante elAWS CLI, con la siguiente adición:

• En el argumento del--runtime-configuration parámetro forupdate-runtime-configuration, proporcione el par clave-valor del nivel de registro (por ejemplologgingLevel:error) como valor paraParameters. Utilice un carácter no alfanumérico (excepto una coma) para separar el nivel de registro de cualquier parámetro adicional. Vea el siguiente ejemplo:

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