Requêtes de performances côté serveur
De bonnes performances de rendu sur le serveur sont capitales pour obtenir des fréquences d’images stables et une expérience utilisateur satisfaisante. Il est important de superviser soigneusement les caractéristiques des performances sur le serveur, et de les optimiser là où c’est nécessaire. Les données de performances peuvent être interrogées par le biais de fonctions API dédiées.
La plus grande incidence observée sur les performances de rendu vient des données d’entrée des modèles. Vous pouvez ajuster les données d’entrée, comme indiqué dans Configurer la conversion de modèle.
Les performances de l’application côté client peuvent également constituer un goulot d’étranglement. Pour une analyse approfondie des performances côté client, il est recommandé d’effectuer une performance trace.
Chronologie client/serveur
Avant d’entrer dans les détails des différentes valeurs de latence, il est utile d’examiner les points de synchronisation entre le client et le serveur sur la chronologie :
L’illustration montre comment :
- une Estimation de pose est lancée par le client à une fréquence d’images constante de 60 Hz (toutes les 16,6 ms) ;
- le serveur démarre ensuite le rendu, en fonction de la pose ;
- le serveur retourne l’image vidéo encodée ;
- le client décode l’image, effectue en sus des opérations d’UC et de GPU, puis affiche l’image.
Requêtes sur les statistiques d’images
Les statistiques d’images offrent quelques informations générales pour la dernière image, telles que la latence. Les données fournies dans la structure FrameStatistics sont mesurées côté client, l’API est donc un appel synchrone :
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
}
}
L’objet FrameStatistics récupéré contient les membres suivants :
| Membre | Explication |
|---|---|
| LatencyPoseToReceive | Latence provenant de la pose estimée de la caméra sur l’appareil client, jusqu’à ce qu’une image serveur de cette pose soit entièrement disponible pour l’application cliente. Cette valeur comprend l’aller-retour réseau, le temps de rendu du serveur, le décodage vidéo et la compensation de l’instabilité. Voir l’intervalle 1 dans l’illustration ci-dessus. |
| LatencyReceiveToPresent | Latence provenant de la disponibilité d’une image distante reçue jusqu’à ce que l’application cliente appelle PresentFrame sur l’UC. Voir l’intervalle 2 dans l’illustration ci-dessus. |
| LatencyPresentToDisplay | Latence provenant de la présentation d’une image sur l’UC jusqu’à ce que l’affichage s’allume. Cette valeur comprend le temps du GPU client, une mise en mémoire tampon d’image effectuée par le système d’exploitation, la reprojection matérielle et la durée de balayage de l’affichage dépendant de l’appareil. Voir l’intervalle 3 dans l’illustration ci-dessus. |
| TimeSinceLastPresent | Délai entre les appels ultérieurs à PresentFrame sur le processeur. Les valeurs supérieures à la durée d’affichage (par exemple 16,6 ms sur un appareil client de 60 Hz) indiquent des problèmes provoqués par l’application cliente qui ne termine pas sa charge de travail processeur à temps. |
| VideoFramesReceived | Nombre d’images reçues du serveur au cours de la dernière seconde. |
| VideoFrameReusedCount | Nombre d’images reçues au cours de la dernière seconde et qui ont été utilisées plusieurs fois sur l’appareil. Les valeurs différentes de zéro indiquent que les images devaient être réutilisées et reprojetées en raison d’une instabilité du réseau ou d’une durée d’affichage du serveur excessive. |
| VideoFramesSkipped | Nombre d’images reçues au cours de la dernière seconde, qui ont été décodées, mais n’ont pas été affichées à l’écran, car une image plus récente est arrivée. Des valeurs différentes de zéro indiquent que l’instabilité du réseau a entraîné le retard de plusieurs images, puis leur arrivée simultanée en rafale sur l’appareil client. |
| VideoFramesDiscarded | Très similaire à VideoFramesSkipped, mais la raison de l’abandon provient du fait qu’une image a été tellement retardée qu’elle ne peut même plus être mise en corrélation avec une pose en attente. Si ce problème se produit, il y a une grave contention de réseau. |
| VideoFrameMinDelta | Intervalle de temps minimal entre deux images consécutives arrivant au cours de la dernière seconde. Avec VideoFrameMaxDelta, cette plage donne une indication de la gigue provoquée par le codec vidéo ou réseau. |
| VideoFrameMaxDelta | Temps maximal entre deux images consécutives arrivant au cours de la dernière seconde. Avec VideoFrameMinDelta, cette plage donne une indication de la gigue provoquée par le codec vidéo ou réseau. |
La somme de toutes les valeurs de latence est en général nettement supérieure à la durée de l’image disponible à 60 Hz. Cela est normal, car plusieurs images sont actives en parallèle, et les nouvelles demandes d’images sont déclenchées à la fréquence d’images souhaitée, comme indiqué dans l’illustration. Toutefois, si la latence devient trop importante, la qualité de la reprojection en phase tardive en est affectée, et l’expérience globale peut être compromise.
VideoFramesReceived, VideoFrameReusedCount et VideoFramesDiscarded peuvent être utilisés pour évaluer les performances du réseau et du serveur. Une combinaison d’une valeur de VideoFramesReceived faible et d’une valeur de VideoFrameReusedCount élevée peut indiquer une congestion du réseau ou une baisse des performances du serveur. Une valeur élevée de VideoFramesDiscarded indique également une congestion du réseau.
Enfin, TimeSinceLastPresent, VideoFrameMinDelta et VideoFrameMaxDelta vous donnent une idée de la variance des trames vidéo entrantes et des appels présents locaux. Une variance élevée signifie une fréquence d’images instable.
Aucune des valeurs ci-dessus ne donne une indication claire de la latence pure du réseau (les flèches rouges dans l’illustration), car la durée exacte pendant laquelle le serveur est occupé à la restitution doit être soustraite de la valeur aller-retour LatencyPoseToReceive. La partie côté serveur de la latence globale représente des informations qui ne sont pas disponibles pour le client. Toutefois, le paragraphe suivant explique comment cette valeur est évaluée par le biais d’une entrée supplémentaire depuis le serveur et exposée au moyen de la NetworkLatencyvaleur.
Requêtes d’évaluation des performances
Les requêtes d’évaluation des performances fournissent des informations plus approfondies sur la charge de travail du processeur et du GPU sur le serveur. Du fait que les données sont demandées à partir du serveur, l’interrogation d’un instantané de performances suit le modèle asynchrone habituel :
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...
}
});
}
Contrairement à l’objet FrameStatistics, l’objet PerformanceAssessment contient des informations côté serveur :
| Membre | Explication |
|---|---|
| TimeCPU | Temps moyen UC du serveur par image en millisecondes |
| TimeGPU | Temps moyen GPU du serveur par image en millisecondes |
| UtilizationCPU | Utilisation totale UC du serveur en pourcentage |
| UtilizationGPU | Utilisation totale GPU du serveur en pourcentage |
| MemoryCPU | Utilisation totale de la mémoire principale du serveur en pourcentage |
| MemoryGPU | Utilisation totale de la mémoire vidéo dédiée en pourcentage du GPU du serveur |
| Latence réseau | Moyenne approximative de la latence aller-retour du réseau en millisecondes. Dans l’illustration ci-dessus, cette valeur correspond à la somme des flèches rouges. La valeur est calculée en soustrayant le temps de rendu réel du serveur, de la valeur LatencyPoseToReceive de FrameStatistics. Même si cette approximation n’est pas précise, elle donne quelque indication du temps de réponse du réseau, isolé des valeurs de latence calculées sur le client. |
| PolygonsRendered | Nombre de triangles restitués dans une image. Ce nombre comprend également les triangles qui sont supprimés plus tard pendant l’affichage. Cela signifie que ce nombre ne varie pas beaucoup entre les différentes positions de la caméra, mais que les performances peuvent varier considérablement, selon le taux d’élimination des triangles. |
| PointsRendered | Nombre de points dans les points de clouds affichés dans un cadre. Les mêmes critères d’élimination que ceux mentionnés ci-dessus pour PolygonsRendered s’appliquent ici. |
Pour vous aider à évaluer les valeurs, chaque partie est accompagnée d’une classification de qualité telle que Excellente, Bonne, Médiocre ou Mauvaise. Cette mesure d’évaluation fournit une indication approximative de l’état d’intégrité du serveur, mais elle ne doit pas être considérée comme absolue. Par exemple, supposons que vous voyez un score « médiocre » pour le temps du GPU. Il est considéré comme médiocre, car il est proche de la limite du budget global de la durée de l’image. Toutefois, dans votre cas, il peut s’agir d’une bonne valeur, car vous affichez un modèle complexe.
Sortie de débogage des statistiques
La classe ServiceStatistics est une classe C# qui inclut dans un wrapper les statistiques des images et les requêtes d’évaluation des performances ; elle fournit des fonctionnalités pratiques pour retourner des statistiques sous forme de valeurs agrégées ou comme chaîne prédéfinie. Le code suivant est le moyen le plus simple pour afficher des statistiques côté serveur dans votre application 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();
}
}
Le code ci-dessus remplit l’étiquette de texte avec le texte suivant :
L’API GetStatsString forme une chaîne de toutes les valeurs, mais chaque valeur en soi peut également être interrogée par programme à partir de l’instance ServiceStatistics.
Il existe également des variantes des membres, qui agrègent les valeurs au fil du temps. Consultez les membres avec le suffixe *Avg, *Max ou *Total. Le membre FramesUsedForAverage indique le nombre d’images qui a été utilisé pour cette agrégation.
Documentation de l’API
- C# RenderingConnection.QueryServerPerformanceAssessmentAsync()
- C++ RenderingConnection::QueryServerPerformanceAssessmentAsync()