Estadísticas de rendimiento en tiempo real

Amazon GameLift Streams recopila estadísticas de rendimiento durante las sesiones de transmisión activas y mide la utilización de los recursos cada segundo. Utilice estas estadísticas para supervisar el rendimiento de su aplicación, identificar los cuellos de botella en los recursos y optimizar su experiencia de streaming.

Las estadísticas de rendimiento incluyen estadísticas a nivel de aplicación (uso de CPU y memoria para una aplicación específica) y estadísticas a nivel de sistema (uso de CPU, memoria, GPU y VRAM para la infraestructura informática compartida).

Puede recibir las estadísticas de rendimiento de dos maneras:

• En tiempo real durante la sesión: utilice el SDK web de Amazon GameLift Streams para recibir las estadísticas a medida que se recopilan. Esto le permite crear superposiciones de rendimiento y supervisar la utilización de los recursos a medida que interactúa con la aplicación.

• Después de la sesión como un archivo CSV: al exportar archivos de sesión, las estadísticas se incluyen como. stats/perf_stats_v1.csv Esto proporciona un registro completo para el análisis y la depuración posteriores a la sesión.

Reciba estadísticas de rendimiento

Recibe estadísticas en tiempo real

Para recibir estadísticas de rendimiento en su aplicación cliente durante una sesión activa, defina el SharedWithClient parámetro en true al llamar a la StartStreamSession API. El SDK web de Amazon GameLift Streams proporciona una performanceStats llamada de retorno que se activa cada vez que llegan nuevas estadísticas de la sesión de streaming.

aviso

No lo habilite SharedWithClient para sesiones de producción con usuarios finales. Actívela solo cuando el cliente sea de confianza, por ejemplo, para la depuración y las pruebas internas.

Al inicializar el SDK web de Amazon GameLift Streams, clientConnection.performanceStats configúrelo en una función de devolución de llamada que recibirá estadísticas de rendimiento.

const gls = new gameliftstreams.GameLiftStreams({
    videoElement: document.getElementById('streamVideoElement'),
    audioElement: document.getElementById('streamAudioElement'),
    inputConfiguration: {
        ...
    },
    clientConnection: {
        ...
        performanceStats: (perfStats) => {
            // Your callback logic here
            console.log('CPU: ' + perfStats.application.cpuNormalized);
            console.log('Memory: ' + perfStats.application.memoryMB + ' MB');
            console.log('GPU: ' + perfStats.system.gpuPercent + '%');
        },
    }
});

La llamada de retorno recibe un PerformanceStats objeto que contiene estadísticas tanto a nivel de aplicación como a nivel de sistema. Para obtener más información sobre la estructura de la interfaz, consulte la documentación del SDK web de Amazon GameLift Streams en la página del producto Getting Started.

La consola de Amazon GameLift Streams también incluye una superposición de rendimiento integrada cuando se utiliza la función de transmisión de pruebas, lo que le permite supervisar las estadísticas en tiempo real sin necesidad de realizar ningún trabajo de implementación.

Puede combinar las estadísticas de rendimiento con las estadísticas de WebRTC proporcionadas por getVideoRTCStats() las funciones getAudioRTCStats() y del SDK web de GameLift Amazon Streams. Esta combinación proporciona una imagen completa del rendimiento de la transmisión, incluidas las estadísticas de la red, la velocidad de fotogramas del cliente y la utilización de los recursos.

Reciba las estadísticas después de la sesión

Amazon GameLift Streams recopila automáticamente las estadísticas de rendimiento durante cada sesión de streaming. Al exportar archivos de sesión, las estadísticas se incluyen igual que stats/perf_stats_v1.csv en el archivo ZIP exportado. Esto proporciona un registro completo de todas las estadísticas recopiladas durante la sesión para analizarlas y depurarlas después de la sesión.

Para obtener más información sobre la exportación de archivos de sesión, consulte. Exportación de archivos de sesión de streaming

Referencia de estadísticas de rendimiento

En la siguiente tabla se enumeran todas las estadísticas de rendimiento recopiladas por Amazon GameLift Streams. Las estadísticas de la aplicación son específicas de la sesión actual, mientras que las estadísticas del sistema compartido reflejan la utilización total del cómputo compartido por las sesiones en las clases de transmisión con varios inquilinos.

Estadísticas normalizadas de las clases de streaming con varios usuarios

Amazon GameLift Streams admite clases de transmisión de varios inquilinos en las que varias sesiones pueden compartir la misma instancia de procesamiento. Las estadísticas normalizadas (uso de la CPU y la memoria de la aplicación) miden el uso de recursos de la aplicación en relación con la parte justa asignada. La parte justa se calcula dividiendo el total de CPU y memoria disponibles en la instancia de cómputo en partes iguales en función de la tenencia de la clase de transmisión.

Un valor de 1,0 significa que tu aplicación está utilizando exactamente su distribución equitativa de acciones. Los valores por debajo de 1,0 indican que está utilizando una cantidad inferior a su asignación. Los valores superiores a 1,0 indican una sobreutilización, lo que puede provocar una degradación del rendimiento de la sesión. En las clases de transmisión con varios inquilinos (tenencia superior a 1), la sobreutilización también puede afectar a otras sesiones que comparten la misma instancia de procesamiento.

Los nombres de las estadísticas que se muestran en la siguiente tabla se utilizan como encabezados de columna CSV en el archivo exportado. Cuando se reciben estadísticas en tiempo real a través del SDK web de Amazon GameLift Streams, estas estadísticas están disponibles a través de la PerformanceStats interfaz con los nombres de las propiedades en mayúsculas. Para conocer la estructura exacta de la interfaz y los nombres de las propiedades, consulte la guía de referencia de la API del SDK web de Amazon GameLift Streams en la página del producto Getting Started.

Nombre de la estadística (columna CSV)	Description (Descripción)	Alcance
timestamp	Hora en la que se realizó la medición, en formato ISO 8601.	Todos
app_cpu_normalized	El uso de la CPU por parte de la aplicación se normalizó con respecto a la asignación de acciones justas, donde 1,0 representa el límite objetivo de acciones justas. Un uso superior a 1.0 indica una sobreutilización, lo que puede provocar problemas de rendimiento	Aplicación
app_mem_mb	Memoria total (RAM) utilizada por la aplicación (medida en MiB)	Aplicación
app_mem_normalized	El uso de memoria de la aplicación se normalizó con respecto a la asignación equitativa de acciones, donde 1,0 representa el límite objetivo de participación justa. Un uso superior a 1,0 indica una sobreutilización, lo que puede provocar problemas de rendimiento	Aplicación
shared_sys_cpu_pct	Porcentaje del uso total de la CPU en el cómputo compartido.	Sistema compartido
shared_sys_mem_mb	Memoria total utilizada en la instancia (medida en MiB).	Sistema compartido
shared_sys_mem_pct	Porcentaje de memoria total en uso en la computación compartida.	Sistema compartido
shared_sys_gpu_pct	Porcentaje del uso total de la GPU en el cómputo compartido.	Sistema compartido
shared_sys_vram_mb	VRAM total (memoria de GPU) utilizada en el cómputo compartido (medida en MiB).	Sistema compartido
shared_sys_vram_pct	Porcentaje del total de VRAM (memoria de GPU) que se utiliza en el cómputo compartido.	Sistema compartido