Performance Agent

Performance Agent examine le code source et les journaux de votre projet pour trouver des problèmes concrets et corrigeables qui ralentissent votre application. Chaque résultat est accompagné d’un résumé en langage clair, d’une gravité et d’une correction recommandée que l’Agent peut appliquer pour vous.

Ce que Performance Agent détecte

Performance Agent recherche deux types de problèmes. Chaque type apparaît dans son propre groupe dans les résultats.

Latence : les parties de votre application qui font attendre les visiteurs. Par exemple, une page peut effectuer un traitement lent étape par étape au lieu de tout faire en même temps, ou répéter le même travail à chaque visite.
Couche de données : les problèmes de base de données tels que les requêtes N+1, les index manquants et le chargement de plus de données que la page n’en a besoin.

Performance Agent signale et corrige uniquement les problèmes qu’il peut relier à votre code. Il ne modifie pas la taille de votre machine ni les autres paramètres de déploiement. Pour donner plus de puissance à votre application, consultez Configuration de la machine.

Avant de commencer

Performance Agent nécessite :

Un plan payant. Performance Agent est disponible pour les créateurs disposant d’un plan payant. Si vous êtes sur le plan gratuit, la carte Analyse de performance affiche une option de mise à niveau.
Un accès en modification au projet.

Vous pouvez analyser une application avant de la publier. Après la publication, Performance Agent peut aussi utiliser vos journaux de déploiement pour trouver les points de terminaison lents pour de vrais visiteurs. L’analyse lit uniquement votre projet. Elle ne modifie ni votre code, ni votre base de données, ni votre application publiée. Les modifications n’ont lieu que lorsque vous choisissez de corriger les problèmes.

Lancer une analyse

Ouvrir la surveillance

Dans le panneau Outils de votre projet, ouvrez Surveillance sous Replit Cloud. Faites défiler jusqu’à la carte Analyse de performance.

Lancer une analyse

Sélectionnez Lancer l’analyse avec l’Agent pour analyser l’ensemble de votre projet avec les paramètres par défaut.Pour cibler l’analyse, sélectionnez d’abord la flèche à côté de Lancer l’analyse avec l’Agent :

Ajouter du contexte (facultatif) : décrivez les parties de votre application qui vous intéressent, par exemple « le parcours de paiement et la page des commandes ».
Analyser uniquement les modifications depuis la dernière analyse : cochez cette case pour examiner uniquement ce qui a changé depuis votre analyse précédente. Performance Agent revérifie aussi les problèmes de cette analyse pour voir s’ils sont toujours présents.

Sélectionnez ensuite Démarrer l’analyse de performance.

La carte Analyse de performance avec les options d'analyse ouvertes, affichant un champ Ajouter du contexte contenant Parcours de paiement et page des commandes, une case Analyser uniquement les modifications depuis la dernière analyse cochée et un bouton Démarrer l'analyse de performance — Ajoutez du contexte ou limitez l'analyse aux modifications récentes avant de la démarrer

Attendre les résultats

L’analyse s’exécute comme une tâche distincte, vous pouvez donc continuer à créer. Pendant son exécution, la carte affiche Analyse en cours. Une analyse prend généralement quelques minutes. Sélectionnez Aller à la tâche pour la suivre.

Vous pouvez aussi demander à l’Agent de lancer une analyse depuis le chat :

Examiner les résultats

Lorsque l’analyse est terminée, une carte Résultats de l’analyse de performance apparaît dans la tâche d’analyse. Elle indique combien de nouveaux problèmes Performance Agent a trouvés, regroupés en Latence et Couche de données. Développez un problème pour lire son résumé, ou sélectionnez Voir le problème pour ouvrir les détails complets, y compris les fichiers concernés et la correction recommandée.

La carte Résultats de l'analyse de performance affichant 4 nouveaux problèmes dans deux groupes, Latence et Couche de données, chaque problème avec une étiquette de gravité Élevée ou Moyenne, et les boutons Corriger plus tard et Corriger tous les problèmes — Les résultats de l'analyse regroupent les nouveaux problèmes par type et par gravité

Choisissez ce qu’il faut faire ensuite :

Corriger tous les problèmes : l’Agent démarre une tâche de correction pour chaque groupe et ouvre l’outil Surveillance pour que vous puissiez les suivre.
Corriger plus tard : ferme les résultats sans rien modifier. Les problèmes restent dans la carte Analyse de performance pour que vous puissiez les corriger quand vous le souhaitez.

Si l’analyse ne trouve rien de nouveau, la carte l’indique et vous pouvez sélectionner Compris.

Corriger les problèmes depuis la surveillance

La carte Analyse de performance de l’outil Surveillance garde la trace de chaque problème ouvert, y compris ceux des analyses précédentes. Les problèmes sont regroupés en Latence et Couche de données, avec une Gravité et un Statut pour chacun. Développez un problème pour lire son résumé, ou sélectionnez Voir le problème pour voir les détails complets.

La carte Analyse de performance dans l'outil Surveillance avec un tableau de problèmes regroupés sous Latence et Couche de données, des étiquettes de gravité et un statut Non résolu sur chaque problème. Le premier problème de Latence est développé pour afficher son résumé et un bouton Voir le problème. Chaque groupe a un bouton Corriger avec l'Agent et l'en-tête a un bouton Tout corriger avec l'Agent — Développez un problème pour lire son résumé, ou sélectionnez Voir le problème pour les détails complets

Vous pouvez corriger les problèmes groupe par groupe ou tous en même temps :

Corriger avec l’Agent sur un groupe envoie tous les problèmes de ce groupe à l’Agent sous forme d’une seule tâche.
Tout corriger avec l’Agent envoie chaque groupe ouvert à l’Agent.

L’Agent travaille sur chaque tâche de correction en arrière-plan, en parallèle, pour que vous puissiez continuer à créer. Le statut de chaque problème évolue au fil de l’avancement du travail :

Correction en cours : l’Agent travaille sur la correction. Sélectionnez Aller à la tâche pour la suivre.
Prêt pour examen : la correction est terminée. Ouvrez la tâche, examinez les modifications, puis sélectionnez Appliquer les modifications à la version principale pour les ajouter à votre application.
Application de la correction : Replit ajoute les modifications à votre application.
Prêt pour la republication : la correction est dans votre application mais pas encore dans votre version publiée.
Corrigé : la correction est en ligne.

La carte Analyse de performance avec les problèmes de Latence affichant Correction en cours, les problèmes de Couche de données affichant Prêt pour examen, et un bouton Aller à la tâche sur chaque groupe — Les statuts des problèmes évoluent à mesure que l'Agent traite chaque tâche de correction

Republier pour appliquer vos corrections

Les corrections n’atteignent vos visiteurs qu’après la republication. Dès qu’une ou plusieurs corrections sont Prêtes pour la republication, un bouton Republier le projet apparaît dans la carte Analyse de performance. Sélectionnez-le pour publier une nouvelle version de votre application avec les corrections. Le statut passe à Publication en cours, puis à Corrigé.

La carte Analyse de performance avec chaque problème marqué Prêt pour la republication et un bouton Republier le projet dans l'en-tête à côté de Lancer l'analyse avec l'Agent — Sélectionnez Republier le projet pour mettre vos corrections en ligne

Vous pouvez aussi republier depuis l’outil Publication. Consultez Après la publication.

Après la republication, lancez une nouvelle analyse en cochant Analyser uniquement les modifications depuis la dernière analyse. Performance Agent confirme quels problèmes sont corrigés et vérifie si vos modifications récentes en introduisent de nouveaux.