Consultas de rendimiento del lado del servidor
Un buen rendimiento de la representación en el servidor es fundamental para unas velocidades de fotogramas estables y una buena experiencia del usuario. Es importante supervisar atentamente las características del rendimiento en el servidor y optimizarlo cuando sea necesario. Los datos del rendimiento se pueden consultar mediante funciones de API dedicadas.
Lo que más afecta al rendimiento de la representación son los datos de entrada del modelo. Puede ajustar los datos de entrada tal como se describe en Configuración de la conversión de modelos.
También puede producirse un cuello de botella en el rendimiento de la aplicación del lado cliente. Para un análisis exhaustivo del rendimiento del lado cliente, se recomienda realizar un performance trace.
Escala de tiempo de cliente o servidor
Antes de entrar en detalles con respecto a los distintos valores de latencia, merece la pena echar un vistazo a los puntos de sincronización entre el cliente y el servidor en la escala de tiempo:
En la ilustración se muestra el proceso:
- El cliente inicia una estimación de la posición en una velocidad de fotogramas constante de 60 Hz (cada 16,6 ms).
- Después, el servidor inicia la representación, basándose en la posición.
- El servidor devuelve la imagen de vídeo codificada.
- El cliente descodifica la imagen, realiza algunas tareas de CPU y GPU en ella y muestra la imagen.
Consultas de estadísticas de fotogramas
Las estadísticas de fotogramas ofrecen información de alto nivel, como la latencia, para el último fotograma. Los datos proporcionados en la estructura de FrameStatistics se miden en el lado cliente, por lo que la API es una llamada sincrónica:
void QueryFrameData(RenderingSession session)
{
FrameStatistics frameStatistics;
if (session.GraphicsBinding.GetLastFrameStatistics(out frameStatistics) == Result.Success)
{
// do something with the result
}
}
void QueryFrameData(ApiHandle<RenderingSession> session)
{
FrameStatistics frameStatistics;
if (session->GetGraphicsBinding()->GetLastFrameStatistics(&frameStatistics) == Result::Success)
{
// do something with the result
}
}
El objeto FrameStatistics recuperado contiene los siguientes miembros:
| Miembro | Explicación |
|---|---|
| LatencyPoseToReceive | La latencia de la estimación de la posición de la cámara en el dispositivo cliente hasta que un fotograma de servidor en esta posición esté totalmente disponible para la aplicación cliente. Este valor incluye los ciclos de ida y vuelta de red, el tiempo de representación del servidor, la descodificación de vídeo y la compensación por vibración. Consulte el intervalo 1 en la ilustración anterior. |
| LatencyReceiveToPresent | Latencia de la disponibilidad de un fotograma remoto recibido hasta que la aplicación cliente llama a PresentFrame en la CPU. Consulte el intervalo 2 en la ilustración anterior. |
| LatencyPresentToDisplay | Latencia desde la presentación de un fotograma en la CPU hasta que la pantalla se enciende. Este valor incluye el tiempo de GPU del cliente, cualquier almacenamiento en búfer de fotogramas realizado por el sistema operativo, la reproyección de hardware y el tiempo de examen de la visualización dependiente del dispositivo. Consulte el intervalo 3 de la ilustración anterior. |
| TimeSinceLastPresent | El tiempo entre las llamadas posteriores a PresentFrame en la CPU. Unos valores mayores que la duración de la visualización (por ejemplo 16,6 ms en un dispositivo cliente de 60 Hz) indican problemas causados por la aplicación cliente que no finalizan la carga de trabajo de la CPU a tiempo. |
| VideoFramesReceived | Número de fotogramas recibidos del servidor en el último segundo. |
| VideoFrameReusedCount | Número de fotogramas recibidos en el último segundo que se usaron en el dispositivo más de una vez. Unos valores distintos de cero indican que los fotogramas han tenido que reutilizarse y reproyectarse debido a la vibración de la red o a un tiempo excesivo de representación del servidor. |
| VideoFramesSkipped | Número de fotogramas recibidos en el último segundo que se descodificaron, pero que no se mostraron en la pantalla porque llegó un fotograma más reciente. Unos valores distintos de cero indican que la vibración de la red ha provocado que varios fotogramas se retrasaran y que llegaran juntos al dispositivo cliente en una ráfaga. |
| VideoFramesDiscarded | Es muy parecido a videoFramesSkipped, pero el motivo de su descarte es que un fotograma ha llegado tan tarde que ya ni siquiera se puede correlacionar con ninguna posición pendiente. Si este descarte sucede, hay una contención de red grave. |
| VideoFrameMinDelta | Cantidad mínima de tiempo entre dos fotogramas consecutivos que llegan durante el último segundo. Junto con VideoFrameMaxDelta, este intervalo proporciona una indicación de vibración causada por el códec de vídeo o de red. |
| VideoFrameMaxDelta | Cantidad máxima de tiempo entre dos fotogramas consecutivos que llegan durante el último segundo. Junto con VideoFrameMinDelta, este intervalo proporciona una indicación de la vibración causada por el códec de vídeo o de red. |
La suma de todos los valores de latencia suele ser mucho mayor que el tiempo del fotograma disponible a 60 Hz. Esto es correcto, porque varios fotogramas se han lanzado en paralelo y las nuevas solicitudes de fotogramas se inician a la velocidad de fotogramas deseada, tal como se muestra en la ilustración. Sin embargo, si la latencia se vuelve demasiado grande, afecta a la calidad de la reproyección de la fase más tardía y puede poner en peligro la experiencia general.
VideoFramesReceived, VideoFrameReusedCount y VideoFramesDiscarded se pueden usar para medir el rendimiento de la red y del servidor. Una combinación de un valor de VideoFramesReceived bajo y un valor de VideoFrameReusedCount alto puede indicar la congestión de la red o un rendimiento deficiente del servidor. Un valor de VideoFramesDiscarded alto también indica congestión de la red.
Por último,TimeSinceLastPresent, VideoFrameMinDelta y VideoFrameMaxDelta ofrecen una idea de la varianza de los fotogramas de vídeo entrantes y las llamadas presentes locales. Una varianza alta implica una velocidad de fotogramas inestable.
Ninguno de los valores anteriores proporciona una indicación clara de la latencia de red pura (las flechas rojas de la ilustración), ya que el tiempo exacto en el que el servidor está ocupado con la representación debe restarse del valor del ciclo de ida y vuelta LatencyPoseToReceive. La parte del lado servidor de la latencia total es información que no está disponible para el cliente. Sin embargo, en el siguiente párrafo se explica cómo se aproxima este valor a través de la entrada adicional del servidor y se expone a través del valor NetworkLatency.
Consultas de valoración del rendimiento
Las consultas de valoración del rendimiento proporcionan información más detallada sobre la carga de trabajo de la CPU y GPU en el servidor. Dado que los datos se solicitan desde el servidor, la consulta de una instantánea de rendimiento sigue el patrón asincrónico habitual:
async void QueryPerformanceAssessment(RenderingSession session)
{
try
{
PerformanceAssessment result = await session.Connection.QueryServerPerformanceAssessmentAsync();
// do something with result...
}
catch (RRException ex)
{
}
}
void QueryPerformanceAssessment(ApiHandle<RenderingSession> session)
{
session->Connection()->QueryServerPerformanceAssessmentAsync([](Status status, PerformanceAssessment result) {
if (status == Status::OK)
{
// do something with result...
}
});
}
Al contrario que el objeto FrameStatistics, el objeto PerformanceAssessment contiene información del servidor:
| Miembro | Explicación |
|---|---|
| TimeCPU | Tiempo medio de CPU de servidor por fotograma en milisegundos |
| TimeGPU | Tiempo medio de GPU de servidor por fotograma en milisegundos |
| UtilizationCPU | Utilización total de CPU del servidor en porcentaje |
| UtilizationGPU | Utilización total de GPU del servidor en porcentaje |
| MemoryCPU | Uso total de la memoria principal del servidor en porcentaje |
| MemoryGPU | Uso total de la memoria de vídeo dedicada en porcentaje de GPU del servidor |
| NetworkLatency | La latencia media aproximada de la red del ciclo de ida y vuelta en milisegundos. En la ilustración anterior, este valor se corresponde con la suma de las flechas rojas. El valor se calcula mediante la resta del tiempo de representación real del servidor del valor de LatencyPoseToReceive de FrameStatistics. Aunque esta aproximación no es precisa, proporciona alguna indicación de la latencia de red, aislada de los valores de latencia calculados en el cliente. |
| PolygonsRendered | Número de triángulos representados en un fotograma. Este número también incluye los triángulos que se seleccionan más adelante durante la representación. Esto significa que este número no varía demasiado en las distintas posiciones de la cámara, pero el rendimiento puede variar drásticamente en función de la tasa de selección del triángulo. |
| PointsRendered | Número de puntos en nubes de puntos representadas en un marco. Se aplican aquí los mismos criterios de selección de PolygonsRendered mencionados anteriormente. |
Para ayudarle a evaluar los valores, cada parte incluye una clasificación de calidad como Excelente, Bueno, Mediocre o Deficiente. Esta métrica de evaluación proporciona una indicación aproximada del estado del servidor, pero no debe considerarse absoluta. Por ejemplo, supongamos que ve una puntuación "Mediocre" para el tiempo de GPU. Se considera mediocre porque se acerca al límite del presupuesto general del tiempo de los fotogramas. Sin embargo, en su caso, podría ser un buen valor, ya que se está representando un modelo complejo.
Salida de depuración de estadísticas
La clase ServiceStatistics es una clase de C# que se encapsula en torno a las consultas de estadísticas de fotogramas y de evaluación del rendimiento y proporciona una práctica funcionalidad para devolver estadísticas como valores agregados o como una cadena pregenerada. El código siguiente es la forma más fácil de mostrar las estadísticas del lado servidor en la aplicación cliente.
ServiceStatistics _stats = null;
void OnConnect()
{
_stats = new ServiceStatistics();
}
void OnDisconnect()
{
_stats = null;
}
void Update()
{
if (_stats != null)
{
// update once a frame to retrieve new information and build average values
_stats.Update(Service.CurrentActiveSession);
// retrieve a string with relevant stats information
InfoLabel.text = _stats.GetStatsString();
}
}
El código anterior rellena la etiqueta de texto con el texto siguiente:
La API GetStatsString da formato a una cadena de todos los valores, pero cada valor único también se puede consultar mediante programación desde la instancia de ServiceStatistics.
También hay variantes de los miembros, que agregan los valores a lo largo del tiempo. Vea los miembros con sufijo *Avg, *Max o *Total. El miembro FramesUsedForAverage indica el número de fotogramas que se han utilizado para esta agregación.
Documentación de la API
- RenderingConnection.QueryServerPerformanceAssessmentAsync() de C#
- RenderingConnection::QueryServerPerformanceAssessmentAsync() de C++