

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Analyse des métriques à l’aide du tableau de bord de Performance Insights
<a name="USER_PerfInsights.UsingDashboard"></a>

**Important**  
 AWS a annoncé la end-of-life date de Performance Insights : le 30 juin 2026. Après cette date, Amazon RDS ne prendra plus en charge l’expérience de la console Performance Insights, les périodes de conservation flexibles (1 à 24 mois) et les tarifs associés. L’API Performance Insights continuera d’exister sans modification de prix. Les coûts de l'API Performance Insights apparaîtront sur votre AWS facture avec le coût de CloudWatch Database Insights.   
 Nous vous recommandons de mettre à niveau toutes les instances de base de données de de bases de données utilisant le niveau payant de Performance Insights vers le mode avancé de Database Insights avant le 30 juin 2026. Pour en savoir plus sur la mise à niveau vers le mode avancé de Database Insights, consultez [Activation du mode Avancé de Database Insights pour Amazon RDS](USER_DatabaseInsights.TurningOnAdvanced.md).   
 Si vous n’effectuez aucune action, les instances de base de données utilisant Performance Insights utiliseront par défaut le mode Standard de Database Insights. Avec le mode Standard de Database Insights, vous risquez de perdre l’accès à l’historique des données de performance au-delà de 7 jours et de ne pas être en mesure d’utiliser les plans d’exécution et les fonctionnalités d’analyse à la demande dans la console Amazon RDS. Après le 30 juin 2026, seul le mode avancé de Database Insights prendra en charge les plans d'exécution et les analyses à la demande.   
 Avec CloudWatch Database Insights, vous pouvez surveiller la charge de base de données de votre parc de bases de données et analyser et résoudre les problèmes de performance à grande échelle. Pour plus d’informations sur Database Insights, consultez [Surveillance des bases de données Amazon RDS à l’aide de CloudWatch Database Insights](USER_DatabaseInsights.md). Pour plus d'informations sur les tarifs, consultez [Amazon CloudWatch Pricing](https://aws.amazon.com/cloudwatch/pricing/). 

Le tableau de bord de Performance Insights contient des informations sur les performances des bases de données qui vous aideront à analyser et à résoudre les problèmes de performances. Sur la page de tableau de bord principale, vous pouvez afficher des informations concernant la charge de la base de données. Vous pouvez « trancher » la charge de base de données en différentes dimensions, telles que les événements d’attente ou SQL.

**Topics**
+ [Présentation du tableau de bord Performance Insights](USER_PerfInsights.UsingDashboard.Components.md)
+ [Accès au tableau de bord Performance Insights](USER_PerfInsights.UsingDashboard.Opening.md)
+ [Analyse de la charge de base de données par événements d'attente](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.md)
+ [Analyse des performances de base de données pour une période donnée](USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.md)
+ [Analyse des requêtes à l’aide de l’onglet Top SQL dans Performance Insights](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.md)
+ [Analyse de la charge maximale de PDB Oracle](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.TopPDB.md)
+ [Analyse des plans d’exécution à l’aide du tableau de bord Performance Insights pour Amazon RDS](USER_PerfInsights.UsingDashboard.AnalyzingPlans.md)

# Présentation du tableau de bord Performance Insights
<a name="USER_PerfInsights.UsingDashboard.Components"></a>

Le tableau de bord est le moyen le plus simple d’interagir avec Performance Insights. L’exemple suivant présente le tableau de bord pour une instance de base de données PostgreSQL.

![\[Métriques de filtrage\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_0b.png)


**Topics**
+ [Filtre de plage de temps](#USER_PerfInsights.UsingDashboard.Components.time-range)
+ [Graphique Counter Metrics (Métriques de compteur)](#USER_PerfInsights.UsingDashboard.Components.Countermetrics)
+ [Graphique Database Load (Charge de la base de données)](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions)
+ [Tableau des dimensions principales](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable)

## Filtre de plage de temps
<a name="USER_PerfInsights.UsingDashboard.Components.time-range"></a>

Par défaut, le tableau de bord de Performance Insights affiche la charge de la base de données pour la dernière heure. Vous pouvez régler cette plage pour qu’elle soit aussi courte que 5 minutes ou aussi longue que 2 ans. Vous pouvez également sélectionner une plage relative personnalisée.

![\[Temps relatif de Performance Insights\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf-insights-relative-time.png)


Vous pouvez sélectionner une plage absolue avec une date et une heure de début et de fin. L’exemple suivant montre la plage horaire commençant à minuit le 25/09/24 et se terminant à 23h59 le 28/09/24.

![\[Temps absolu de Performance Insights\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf-insights-absolute-time.png)


Par défaut, le fuseau horaire du tableau de bord Performance Insights est UTC (Coordinated Universal Time). Vous pouvez également choisir le fuseau horaire local.

![\[Sélectionnez le fuseau horaire local pour votre tableau de bord Performance Insights\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf-insights-local-time-zone.png)


## Graphique Counter Metrics (Métriques de compteur)
<a name="USER_PerfInsights.UsingDashboard.Components.Countermetrics"></a>

Grâce aux métriques de compteur, vous pouvez personnaliser le tableau de bord de Performance Insights de sorte à inclure jusqu’à 10 graphiques supplémentaires. Ces graphiques présentent une dizaine de métriques de performances de base de données et de système d’exploitation. Vous pouvez établir des corrélations entre ces informations et la charge de la base de données pour identifier et analyser les problèmes de performances.

 Le graphique **Counter Metrics** (Métriques de compteur) affiche les données des compteurs de performances. Les métriques par défaut varient en fonction du moteur de base de données :
+ MySQL et MariaDB – `db.SQL.Innodb_rows_read.avg`
+ Oracle  – `db.User.user calls.avg`
+ Microsoft SQL Server – `db.Databases.Active Transactions(_Total).avg`
+ PostgreSQL  – `db.Transactions.xact_commit.avg`

![\[Métriques de compteur\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/oracle_perf_insights_counters.png)


Pour changer de compteurs de performance, choisissez **Manage Metrics** (Gérer les métriques). Vous pouvez sélectionner plusieurs **métriques de système d’exploitation** ou **métriques de base de données**, comme illustré dans la capture d’écran suivante. Pour afficher les détails relatifs à une métrique, passez la souris sur le nom de la métrique.

![\[Métriques de filtrage\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_select_metrics.png)


Pour obtenir une description des métriques de compteur que vous pouvez ajouter pour chaque moteur de base de données, voir [Métrique de compteur de Performance Insights](USER_PerfInsights_Counters.md).

## Graphique Database Load (Charge de la base de données)
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions"></a>

Le graphique **Database Load** (Charge de la base de données) montre l’activité de la base de données par rapport à la capacité de l’instance de base de données représentée par la ligne **Max vCPU** (vCPU max). Par défaut, le graphique en courbes empilées représente la charge de la base de données sous forme de sessions actives en moyenne par unité de temps. La charge de la base de données est découpée (groupée) par états d’attente. 

![\[Charge de base de données\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_2.png)


### Charge de base de données tranchée par dimensions
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.dims"></a>

Vous pouvez afficher la charge sous la forme de sessions actives regroupées par dimensions prises en charge. Le tableau suivant montre les dimensions prises en charge pour les différents moteurs.


| Dimension | Oracle | SQL Server | PostgreSQL | MySQL | 
| --- | --- | --- | --- | --- | 
|  Host (Hôte)  |  Oui  |  Oui  |  Oui  |  Oui  | 
|  SQL  |  Oui  |  Oui  |  Oui  |  Oui  | 
|  Utilisateur  |  Oui  |  Oui  |  Oui  |  Oui  | 
|  Éléments d’attente  |  Oui  |  Oui  |  Oui  |  Oui  | 
|  Plans  |  Oui  |  Non  |  Non  |  Non  | 
|  Application  |  Non  |  Non  |  Oui  |  Non  | 
|  Base de données  |  Non  |  Non  |  Oui  |  Oui  | 
|  Type de session  |  Non  |  Non  |  Oui  |  Non  | 

L’image suivante illustre les dimensions d’une instance de base de données PostgreSQL.

![\[Métriques de filtrage\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_2b.png)


### Détails de charge de base de données pour un élément de dimension
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.item-details"></a>

Pour afficher les détails d’un élément de charge de base de données dans une dimension, passez la souris sur le nom d’élément. L’image suivante illustre les détails d’une instruction SQL.

![\[Détails d’un élément de charge de base de données\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_2c.png)


Pour afficher les détails d’un élément pour la période sélectionnée dans la légende, survolez cet élément.

![\[Détails de la période pour la charge de base de données\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_3.png)


## Tableau des dimensions principales
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable"></a>

Le tableau des dimensions principales découpe la charge de la base de données selon différentes dimensions. Une dimension est une catégorie ou « tranche » qui représente l’une des différentes caractéristiques de la charge de la base de données. Si la dimension est SQL, **Top SQL** (Principaux éléments SQL) affiche les instructions SQL qui contribuent le plus à la charge de la base de données.

![\[Principales dimensions N\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_4c.png)


Choisissez l’un des onglets de dimension suivants.


| Onglet | Description | Moteurs pris en charge | 
| --- | --- | --- | 
|  Top SQL (Principaux éléments SQL)  |  Instructions SQL en cours d’exécution  |  Tous  | 
|  Principaux éléments d’attente  |  Événement pour lequel le backend de la base de données attend  |  Tous  | 
|  Principaux hôtes  |  Nom d’hôte du client connecté  |  Tous  | 
|  Principaux utilisateurs  |  Utilisateur connecté à la base de données  |  Tous  | 
|  Principales bases de données  |  Nom de la base de données à laquelle le client est connecté  |  PostgreSQL, MySQL, MariaDB et SQL Server uniquement  | 
|  Principales applications  |  Nom de l’application connectée à la base de données  |  PostgreSQL et SQL Server uniquement  | 
|  Principaux types de session  |  Type de la session en cours  |  PostgreSQL uniquement | 

Pour savoir comment analyser les requêtes à partir de l’onglet **Top SQL** (Principaux éléments SQL), consultez [Présentation de l'onglet Top SQL (Principaux éléments SQL)](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.md#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL).

# Accès au tableau de bord Performance Insights
<a name="USER_PerfInsights.UsingDashboard.Opening"></a>

Amazon RDS fournit une vue consolidée des métriques Performance Insights et CloudWatch dans le tableau de bord Performance Insights.

Pour accéder au tableau de bord de Performance Insights, procédez comme suit.

**Pour afficher le tableau de bord Performance Insights dans la Console de gestion AWS**

1. Ouvrez la console Amazon RDS à l’adresse [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Dans le panneau de navigation gauche, choisissez **Performance Insights**.

1. Choisissez une instance de base de données.

   Pour les instances de base de données avec Performance Insights activé, vous pouvez également accéder au tableau de bord Performance Insights en choisissant l’élément **Sessions** dans la liste des instances de base de données. Sous **Activité actuelle**, l'élément **Sessions** affiche la charge de base de données dans les sessions actives moyennes lors des cinq dernières minutes. La barre affiche visuellement le chargement. Votre instance de base de données est à l'arrêt lorsque la barre est vide. La barre se remplit de bleu à mesure que le chargement augmente. Une fois que le chargement dépasse le nombre d'UC virtuels (vUC) dans la classe d'instance de base de données, la barre vire au rouge, ce qui indique un engorgement potentiel.  
![\[Métriques de filtrage\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_0a.png)

1. (Facultatif) Choisissez la plage de dates ou de temps en haut à droite et spécifiez un autre intervalle de temps relatif ou absolu. Vous pouvez désormais spécifier une période et générer un rapport d'analyse des performances de base de données. Ce rapport fournit les informations et recommandations identifiées. Pour plus d’informations, consultez [Création d’un rapport d’analyse des performances dans Performance Insights](USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.md).  
![\[Filtrer les métriques par intervalle de temps\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_0c.png)

   Dans la capture d'écran suivante, l'intervalle de charge de base de données est de 5 heures.  
![\[Régler l'intervalle de temps sur cinq heures\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_1.png)

1. (Facultatif) Pour effectuer un zoom avant sur une partie du graphique de charge de la base de données, choisissez l'heure de début et faites glisser jusqu'à la fin de la période souhaitée. 

   La zone sélectionnée est mise en évidence dans le tableau de charge de la base de données.  
![\[Charge de la base de données pour un intervalle de temps spécifié\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_zoom_in.png)

   Lorsque vous relâchez la souris, le graphique de charge de la base de données fait un zoom avant sur la région AWS sélectionnée et la table **Top *dimensions*** (Principales dimensions) est recalculée.  
![\[Zoom sur la charge de la base de données sélectionnée\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_zoom_in_b.png)

1. (Facultatif) Pour actualiser automatiquement vos données, sélectionnez **Actualisation automatique**.  
![\[Définir l'actualisation automatique\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_1b.png)

   Le tableau de bord Performance Insights s'actualise automatiquement avec de nouvelles données. Le taux de rafraîchissement dépend de la quantité de données affichées : 
   + Pour 5 minutes, les données seront actualisées toutes les 10 secondes.
   + Pour 1 heure, les données seront actualisées toutes les 5 minutes.
   + Pour 5 heures, les données seront actualisées toutes les 5 minutes.
   + Pour 24 heures, les données seront actualisées toutes les 30 minutes.
   + Pour 1 semaine, les données seront actualisées tous les jours.
   + Pour 1 mois, les données seront actualisées tous les jours.

# Analyse de la charge de base de données par événements d'attente
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad"></a>

Si le graphique **Database load** (Charge de la base de données) présente un goulot d'étranglement, vous pouvez déterminer la provenance de la charge. Pour ce faire, examinez le tableau des principaux éléments de charge en dessous du graphique **Database load (Charge de la base de données)**. Choisissez un élément précis (une requête SQL ou un utilisateur par exemple) pour approfondir son analyse et afficher les détails le concernant.

La vue par défaut du tableau de bord de Performance Insights affiche la charge de la base de données en fonction de l'attente et les principales requêtes SQL. Cette combinaison fournit en général la meilleure compréhension des problèmes de performances. L'affichage de la charge de la base de données en fonction de l'attente indique s'il existe des goulots d'étranglement liés aux ressources ou à des actions simultanées dans la base de données. Dans ce cas, l'onglet **SQL** du tableau Top Load Items (Principaux éléments de charge) indique les requêtes à l'origine de cette charge.

Votre flux de travail standard pour diagnostiquer les problèmes de performances se présente comme suit :

1. Dans le graphique **Database load (Charge de la base de données)**, regardez s'il existe des incidents de charge de base de données qui dépassent la ligne **Max CPU (CPU max)**.

1. Si c'est le cas, observez le graphique **Database load (Charge de la base de données)** et identifiez le ou les états d'attente qui sont les principaux responsables.

1. Identifiez les requêtes de hachage à l'origine de la charge en déterminant les requêtes du tableau Top Load Items (Principaux éléments de charge) de l'onglet **SQL** qui contribuent le plus à ces états d'attente. Vous pouvez les identifier dans la colonne **DB Load by Wait (Charge de base de données par attente)**.

1. Choisissez l'une de ces requêtes de hachage dans l'onglet **SQL** pour la développer et afficher les requêtes enfants qui la composent.

Par exemple, dans le tableau de bord suivant, les attentes **log file sync (synchronisation de fichier journal)** constituent la majeure partie de la charge de base de données. Les attentes **LGWR all worker groups** sont également élevées. Le graphique **Top SQL (Principaux éléments SQL)** montre ce qui provoque les attentes **log file sync (synchronisation de fichier journal)** : les instructions `COMMIT` fréquentes. Dans ce cas, une validation moins fréquente permet de réduire la charge de base de données.

![\[erreurs de synchronisation de fichier journal\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_7.png)


# Analyse des performances de base de données pour une période donnée
<a name="USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod"></a>

Analysez les performances des bases de données à l’aide d’une analyse à la demande en créant un rapport d’analyse des performances pour une période donnée. Affichez un rapport d’analyse des performances pour découvrir les problèmes de performances tels que les goulots d’étranglement ou les modifications d’une requête dans votre instance de base de données. Le tableau de bord d'analyse des performances vous permet de sélectionner une période et de créer un rapport d'analyse des performances. Vous pouvez également ajouter une ou plusieurs balises au rapport. 

Pour utiliser cette fonctionnalité, vous devez utiliser la période de conservation du niveau payant. Pour plus d’informations, consultez [Tarification et conservation des données pour Performance Insights](USER_PerfInsights.Overview.cost.md).

Le rapport est disponible dans l'onglet **Rapports d'analyse des performances – nouveau** pour être sélectionné et affiché. Ce rapport contient les informations, les métriques associées et les recommandations permettant de résoudre le problème de performances. Le rapport peut être consulté pendant toute la durée de conservation de l'analyse des performances.

Le rapport est supprimé si l'heure de début de la période d'analyse du rapport se situe en dehors de la période de rétention. Vous pouvez également supprimer le rapport avant la fin de la période de conservation.

Pour détecter les problèmes de performances et générer le rapport d'analyse pour votre instance de base de données, vous devez activer l'analyse des performances. Pour plus d’informations sur l’activation de Performance Insights, consultez [Activation ou désactivation de l’Analyse des performances pour Amazon RDS](USER_PerfInsights.Enabling.md). 

Pour obtenir les informations de prise en charge de la région, du moteur de base de données et de la classe d’instance pour cette fonctionnalité, consultez [Support du moteur de base de données Amazon RDS pour les fonctionnalités Performance Insights](USER_PerfInsights.Overview.Engines.md#USER_PerfInsights.Overview.PIfeatureEngnRegSupport).

Dans les sections suivantes, vous pouvez créer, afficher, ajouter des balises et supprimer un rapport d’analyse des performances.

**Topics**
+ [Création d’un rapport d’analyse des performances dans Performance Insights](USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport.md)
+ [Affichage d’un rapport d’analyse des performances dans Performance Insights](USER_PerfInsights.UsingDashboard.ViewPerfAnalysisReport.md)
+ [Ajout de balises à un rapport d’analyse des performances dans Performance Insights](USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.md)
+ [Suppression d’un rapport d’analyse des performances dans Performance Insights](USER_PerfInsights.UsingDashboard.DeletePerfAnalysisReport.md)

# Création d’un rapport d’analyse des performances dans Performance Insights
<a name="USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport"></a>

Vous pouvez créer un rapport d’analyse des performances pour une période spécifique dans le tableau de bord d’analyse des performances. Vous pouvez sélectionner une période et ajouter une ou plusieurs balises au rapport d’analyse.

La période d’analyse peut aller de 5 minutes à 6 jours. Il doit y avoir au moins 24 heures de données de performance avant le début de l’analyse.

Pour obtenir les informations de prise en charge de la région, du moteur de base de données et de la classe d’instance pour cette fonctionnalité, consultez [Support du moteur de base de données Amazon RDS pour les fonctionnalités Performance Insights](USER_PerfInsights.Overview.Engines.md#USER_PerfInsights.Overview.PIfeatureEngnRegSupport).

**Pour créer un rapport d’analyse des performances pour une période donnée**

1. Ouvrez la console Amazon RDS à l'adresse [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Dans le panneau de navigation gauche, choisissez **Performance Insights**.

1. Choisissez une instance de base de données. 

1. Choisissez **Analyser les performances** dans la section **Charge de base de données** du tableau de bord.

   Les champs permettant de définir la période et d’ajouter une ou plusieurs balises au rapport d’analyse des performances s’affichent.  
![\[Tableau de bord d’analyse des performances affichant les champs permettant de créer un rapport d’analyse\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/PI_CreateAnalysisReport.png)

1. Choisissez une période. Si vous définissez une période dans la **Plage relative** ou dans la **Plage absolue** en haut à droite, vous pouvez uniquement saisir ou sélectionner la date et l’heure du rapport d’analyse au cours de cette période. Si vous sélectionnez la période d’analyse en dehors de cette période, un message d’erreur s’affiche.

    Pour définir la période, vous pouvez effectuer l’une des opérations suivantes :
   + Appuyez sur l’un des curseurs du graphique de charge de base de données et faites-le glisser.

     La zone **Période d’analyse des performances** affiche la période sélectionnée et le graphique de charge de base de données met en évidence la période sélectionnée.
   + Choisissez les paramètres **Date de début**, **Heure de début**,**Date de fin** et **Heure de fin** dans la zone **Période d’analyse des performances**.  
![\[Tableau de bord d’analyse des performances avec la période d’analyse sélectionnée\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/PI_CreateAnalysisRep_TimePeriod.png)

1. (Facultatif) Entrez **Clé** et **Valeur-*facultatif*** pour ajouter une balise pour le rapport.  
![\[Tableau de bord d’analyse des performances avec des champs pour ajouter une nouvelle balise\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/PI_CreateAnalysisRep_AddTag.png)

1. Choisissez **Analyser les performances**.

   Une bannière affiche un message indiquant si la génération du rapport est réussie ou a échoué. Le message fournit également le lien permettant de consulter le rapport.

   L’exemple suivant montre la bannière avec le message de réussite de création du rapport.  
![\[Bannière de message de réussite de création de rapport d’analyse\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/PI_CreateAnaysisRep_SuccessMsg.png)

   Le rapport peut être consulté dans l’onglet **Rapports d’analyse des performances : nouveau**. 

Vous pouvez créer un rapport d’analyse des performances à l’aide de l’interface AWS CLI. Pour un exemple expliquant comment créer un rapport à l'aide de AWS CLI, voir[Création d’un rapport d’analyse des performances pour une période donnée](USER_PerfInsights.API.Examples.md#USER_PerfInsights.API.Examples.CreatePerfAnalysisReport).

# Affichage d’un rapport d’analyse des performances dans Performance Insights
<a name="USER_PerfInsights.UsingDashboard.ViewPerfAnalysisReport"></a>

L’onglet **Rapports d’analyse des performances : nouveau** répertorie tous les rapports créés pour l’instance de base de données. Pour chaque test, les résultats des tests suivants sont affichés :
+ **ID** : identifiant unique du rapport.
+ **Nom** : clé de balise ajoutée au rapport.
+ **Heure de création du rapport** : heure à laquelle vous avez créé le rapport.
+ **Heure de début de l’analyse** : heure de début de l’analyse dans le rapport.
+ **Heure de fin de l’analyse** : heure de fin de l’analyse dans le rapport.

**Pour afficher un rapport d’analyse des performances**

1. Connectez-vous à la console Amazon RDS AWS Management Console et ouvrez-la à [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)l'adresse.

1. Dans le panneau de navigation gauche, choisissez **Performance Insights**.

1. Choisissez une instance de base de données pour laquelle vous souhaitez consulter le rapport d’analyse. 

1. Faites défiler la page vers le bas et choisissez l’onglet **Rapports d’analyse des performances : nouveau** dans le tableau de bord Performance Insights.

   Tous les rapports d’analyse pour les différentes périodes sont affichés.

1. Choisissez **ID** du rapport que vous souhaitez consulter.

   Le graphique de charge de base de données affiche la période d’analyse complète par défaut si plusieurs informations sont identifiées. Si le rapport a identifié une information, le graphique de charge de base de données affiche par défaut cette information. 

   Le tableau de bord répertorie également les balises du rapport dans la section **Balises**.

   L’exemple suivant montre l’ensemble de la période d’analyse du rapport.  
![\[Graphique de charge de base de données montrant la période complète du rapport d’analyse\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/PI_EntireAnalysisRep.png)

1. Choisissez l’information dans la liste **Informations de charge de base de données** que vous souhaitez consulter si plusieurs informations sont identifiées dans le rapport.

   Le tableau de bord affiche le message d’information, le graphique de charge de base de données mettant en évidence la période couverte par les informations, l’analyse et les recommandations, ainsi que la liste des balises de rapport.

   L’exemple suivant montre l’information de charge de base de données dans le rapport.   
![\[Graphique de charge de base de données montrant l’information dans le rapport\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/PI_AnalysisRepInsight_chart.png)  
![\[Section d’analyse et de recommandation des informations de rapport\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/PI_AnalysisRepInsight_Recommendations.png)

# Ajout de balises à un rapport d’analyse des performances dans Performance Insights
<a name="USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags"></a>

Vous pouvez ajouter une balise lorsque vous créez ou consultez un rapport. Vous pouvez ajouter jusqu’à 50 balises par rapport.

Vous avez besoin d’autorisations pour ajouter les balises. Pour plus d’informations sur les stratégies d’accès pour l’analyse des performances, consultez [Configuration des politiques d’accès pour Performance Insights](USER_PerfInsights.access-control.md).

Pour ajouter une ou plusieurs balises lors de la création d’un rapport, consultez l’étape 6 de la procédure [Création d’un rapport d’analyse des performances dans Performance Insights](USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport.md).

**Pour ajouter une ou plusieurs balises lors de la consultation d’un rapport**

1. Ouvrez la console Amazon RDS à l'adresse [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Dans le panneau de navigation gauche, choisissez **Performance Insights**.

1. Choisissez une instance de base de données. 

   Le tableau de bord Performance Insights correspondant à cette instance de base de données s’affiche.

1. Faites défiler la page vers le bas et choisissez **Rapports d’analyse des performances : nouveau**.

1. Choisissez le rapport pour lequel vous souhaitez ajouter les balises.

   Le tableau de bord affiche le rapport.

1. Faites défiler vers le bas jusqu’à **Balises** et choisissez **Gérer les balises**.

1. Sélectionnez **Ajouter une nouvelle balise**.

1. Entrez la **Clé** et **Valeur : *facultatif***, puis choisissez **Ajouter une nouvelle balise**.

   L’exemple suivant fournit la possibilité d’ajouter une nouvelle balise pour le rapport sélectionné.  
![\[Fenêtre Gérer les balises pour ajouter de nouvelles balises au rapport\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/PI_AddTag_ManageTags.png)

   Une nouvelle balise est créée pour le rapport.

   La liste des balises du rapport est affichée dans la section **Balises** du tableau de bord. Si vous souhaitez supprimer une balise du rapport, choisissez **Supprimer** à côté de la balise.

# Suppression d’un rapport d’analyse des performances dans Performance Insights
<a name="USER_PerfInsights.UsingDashboard.DeletePerfAnalysisReport"></a>

Vous pouvez supprimer un rapport de la liste des rapports affichée dans l’onglet **Rapports d’analyse des performances** ou lors de l’affichage d’un rapport. 

**Pour supprimer un rapport**

1. Ouvrez la console Amazon RDS à l'adresse [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Dans le panneau de navigation gauche, choisissez **Performance Insights**.

1. Choisissez une instance de base de données. 

   Le tableau de bord Performance Insights correspondant à cette instance de base de données s’affiche.

1. Faites défiler la page vers le bas et choisissez **Rapports d’analyse des performances : nouveau**.

1. Sélectionnez le rapport que vous souhaitez supprimer et choisissez **Supprimer** en haut à droite.  
![\[Tableau de bord d’analyse des performances à supprimer avec un rapport sélectionné pour suppression\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/PI_DeleteAnalysisRep.png)

   Une fenêtre de confirmation s’affiche. Le rapport est supprimé une fois que vous avez choisi de confirmer.

1. (Facultatif) Choisissez l’**ID** du rapport que vous souhaitez supprimer.

   Dans le coin supérieur droit de la page du rapport, choisissez **Supprimer**.

   Une fenêtre de confirmation s’affiche. Le rapport est supprimé une fois que vous avez choisi de confirmer.

# Analyse des requêtes à l’aide de l’onglet Top SQL dans Performance Insights
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics"></a>

Dans le tableau de bord Amazon RDS Performance Insights, vous pouvez trouver des informations sur les requêtes en cours d'exécution et récentes dans l'onglet **Top SQL** (Principaux éléments SQL) du tableau **Top dimensions** (Dimensions principales). Vous pouvez utiliser ces informations pour régler vos requêtes.

**Topics**
+ [Présentation de l'onglet Top SQL (Principaux éléments SQL)](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL)
+ [Accès à plus de texte SQL dans le tableau de bord Performance Insights](USER_PerfInsights.UsingDashboard.SQLTextSize.md)
+ [Affichage des statistiques SQL dans le tableau de bord de Performance Insights](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.AnalyzingSQLLevel.md)

## Présentation de l'onglet Top SQL (Principaux éléments SQL)
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL"></a>

Par défaut, l'onglet **Top SQL** (SQL maximum) présente les 25 requêtes qui contribuent le plus à la charge de la base de données. Pour faciliter le réglage de vos requêtes, vous pouvez analyser certaines informations comme le texte de la requête et les statistiques SQL. Vous pouvez également choisir les statistiques à afficher dans l'onglet **Top SQL (Principaux éléments SQL)**.

**Topics**
+ [Texte SQL](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.text)
+ [Statistiques SQL](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.statistics)
+ [Load by waits (AAS) [Charge par attentes (AAS)]](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Load-by-waits)
+ [Affichage des informations SQL](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.SQL-information)
+ [Choix des préférences de statistiques](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Preferences)

### Texte SQL
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.text"></a>

Par défaut, chaque ligne du tableau **Top SQL** (SQL maximum) affiche 500 octets de texte pour chaque instruction. 

![\[Texte SQL\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/sql-text-oracle.png)


Pour savoir comment afficher plus que les 500 octets de texte SQL par défaut, consultez [Accès à plus de texte SQL dans le tableau de bord Performance Insights](USER_PerfInsights.UsingDashboard.SQLTextSize.md).

Un *récapitulatif SQL* se compose de plusieurs requêtes réelles et structurellement similaires, mais dont les valeurs littérales peuvent être différentes. Le récapitulatif remplace les valeurs codées en dur par un point d'interrogation. Ainsi, `SELECT * FROM emp WHERE lname= ?` est un exemple de récapitulatif. Ce récapitulatif peut inclure les requêtes enfant suivantes :

```
SELECT * FROM emp WHERE lname = 'Sanchez'
SELECT * FROM emp WHERE lname = 'Olagappan'
SELECT * FROM emp WHERE lname = 'Wu'
```

Pour afficher les instructions SQL littérales dans un récapitulatif, sélectionnez la requête, puis choisissez le symbole plus (\$1). Dans l'exemple suivant, la requête sélectionnée est un récapitulatif.

![\[Récapitulatif SQL sélectionné\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_4b.png)


**Note**  
Un récapitulatif SQL regroupe des instructions SQL similaires, mais ne censure pas les informations sensibles.

Performance Insights peut afficher du texte Oracle SQL sous la forme**Unknown** (Inconnu). Le texte a ce statut dans les situations suivantes :
+ Un utilisateur de la base de données Oracle autre que `SYS` est actif mais n'émet pas d'instructions SQL. Par exemple, lorsqu'une requête parallèle se termine, le coordinateur de la requête attend que les processus d'assistance envoient leurs statistiques de session. Pendant la durée de l'attente, le texte de la requête affiche **Unknown** (Inconnu).
+ Pour une instance RDS for Oracle sur Standard Edition 2, Oracle Resource Manager limite le nombre de threads parallèles. Le processus en arrière-plan qui effectue ce travail fait que le texte de la requête s'affiche comme **Unknown** (Inconnu).

### Statistiques SQL
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.statistics"></a>

Les *statistiques SQL* sont des métriques de performances qui concernent les requêtes SQL. Par exemple, Performance Insights peut montrer le nombre d'exécutions par seconde ou le nombre de lignes traitées par seconde. Performance Insights collecte des statistiques uniquement pour les requêtes les plus courantes. Généralement, celles-ci correspondent aux requêtes les plus importantes par charge affichées dans le tableau de bord Performance Insights. 

Chaque ligne figurant dans le tableau **Top SQL (Principaux éléments SQL)** présente des statistiques pertinentes pour l'instruction ou le résumé SQL, comme le montre l'exemple suivant.

![\[Principaux éléments SQL\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_4.png)


Performance Insights peut renvoyer `0.00` et `-` (inconnu) pour les statistiques SQL. Cette situation se produit dans les conditions suivantes :
+ Il n'existe qu'un seul exemple. Par exemple, Performance Insights calcule les taux de modification pour les requêtes RDS PostgreSQL sur la base de plusieurs exemples de la vue `pg_stat_statements`. Lorsqu'une charge de travail est exécutée pendant une courte période, Performance Insights peut ne collecter qu'un seul exemple, ce qui signifie qu'il ne peut pas calculer le taux de modification. La valeur inconnue est représentée par un tiret (`-`).
+ Deux exemples ont les mêmes valeurs. Performance Insights ne peut pas calculer un taux de modification car aucun changement n'a eu lieu, il rapporte donc le taux comme `0.00`.
+ Il manque un identifiant valide à une déclaration RDS PostgreSQL. PostgreSQL crée un identifiant pour une déclaration seulement après l'analyse. Ainsi, une déclaration peut exister dans les structures internes en mémoire de PostgreSQL sans identifiant. Comme Performance Insights échantillonne les structures internes en mémoire une fois par seconde, les requêtes à faible latence peuvent n'apparaître que pour un seul exemple. Si l'identifiant de la requête n'est pas disponible pour cet exemple, Performance Insights ne peut pas associer cette déclaration à ses statistiques. La valeur inconnue est représentée par un tiret (`-`).

Pour obtenir une description des statistiques SQL pour les moteurs Amazon RDS, consultez [Statistiques SQL pour Performance Insights](sql-statistics.md).

### Load by waits (AAS) [Charge par attentes (AAS)]
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Load-by-waits"></a>

Dans **Top SQL (Principaux éléments SQL)**, la colonne **Load by waits (AAS) [Charge par attentes (AAS)]** illustre le pourcentage de la charge de base de données associée à chacun des principaux éléments de charge. Cette colonne reflète la charge pour cet élément selon le regroupement actuellement sélectionné dans **DB Load Chart (Graphique de charge de base de données)**. Pour plus d'informations sur la moyenne des sessions actives (AAS), consultez [Sessions actives en moyenne](USER_PerfInsights.Overview.ActiveSessions.md#USER_PerfInsights.Overview.ActiveSessions.AAS).

Par exemple, vous pouvez regrouper le graphique **DB Load (Charge de la base de données)** par états d'attente. Vous examinez les requêtes SQL dans le tableau des principaux éléments de charge. Dans ce cas, la dimension, la segmentation et le code de couleurs de la barre **DB Load by Waits (Charge de base de données par attente)** représentent la proportion du temps d'un état d'attente donné auquel cette requête contribue. Cette barre indique également les états d'attente qui affectent la requête sélectionnée.

![\[Charge de base de données par attentes\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_6.png)


### Affichage des informations SQL
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.SQL-information"></a>

Dans le tableau **Top SQL (Principaux éléments SQL)**, vous pouvez ouvrir une instruction pour examiner ses informations. Les informations s'affichent dans le volet inférieur.

![\[Tableau des principaux éléments SQL avec requête littérale sélectionnée\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf-insights-sql-ids-open.png)


Les types d'identifiants (ID) associés à des instructions SQL sont les suivants :
+ **ID SQL de support** – Valeur de hachage de l'ID SQL. Cette valeur est uniquement destinée à référencer un ID SQL lorsque vous utilisez AWS Support. AWS  Support n'a pas accès à vos ID SQL réels et au texte SQL.
+ **Support Digest ID (ID digest de support)** – Valeur de hachage de l'ID digest. Cette valeur est uniquement destinée à référencer un ID digest lorsque vous utilisez AWS Support. AWS  Support n'a pas accès à vos ID digest réels et au texte SQL.

### Choix des préférences de statistiques
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Preferences"></a>

Vous pouvez contrôler les statistiques qui s'affichent dans l'onglet **Top SQL (Principaux éléments SQL)** en choisissant l'icône **Preferences (Préférences)**.

![\[Préférences de statistiques\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf-insights-sql-ids-preferences-icon.png)


Lorsque vous choisissez l'icône **Préférences**, la fenêtre **Préférences** s'ouvre. La capture d'écran suivante est un exemple de la fenêtre **Preferences** (Préférences).

![\[Fenêtre Preferences (Préférences)\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf-insights-sql-ids-preferences.png)


Pour activer les statistiques afin de les faire apparaître dans l'onglet **Top SQL (Principaux éléments SQL)**, utilisez votre souris pour faire défiler l'écran jusqu'au bas de la fenêtre, puis choisissez **Continue (Continuer)**. 

Pour plus d'informations sur les statistiques par seconde ou par appel pour les moteurs Amazon RDS, consultez la section des statistiques SQL spécifiques au moteur dans [Statistiques SQL pour Performance Insights](sql-statistics.md)

# Accès à plus de texte SQL dans le tableau de bord Performance Insights
<a name="USER_PerfInsights.UsingDashboard.SQLTextSize"></a>

Par défaut, chaque ligne du tableau **Top SQL (Principaux éléments SQL)** affiche 500 octets de texte SQL pour chaque instruction SQL.

![\[500 octets de code SQL\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf-insights-top-sql-bytes.png)


Lorsqu'une instruction SQL dépasse 500 octets, vous pouvez afficher davantage de texte dans la section **SQL text** (Texte SQL) située sous le tableau **Top SQL** (Top SQL). Dans ce cas, la longueur maximale du texte affiché dans **SQL text** (Texte SQL) est de 4 Ko. Cette limite est imposée par la console et est soumise aux limites fixées par le moteur de base de données. Pour enregistrer le texte affiché dans **SQL text** (Texte SQL), sélectionnez **Download** (Télécharger).

**Topics**
+ [Limites de taille de texte pour les moteurs Amazon RDS](#sql-text-engine-limits)
+ [Définition de la limite de taille d’un texte SQL pour les instances de base de données Amazon RDS pour PostgreSQL](USER_PerfInsights.UsingDashboard.SQLTextLimit.md)
+ [Affichage et téléchargement de texte SQL dans le tableau de bord de Performance Insights](view-download-text.md)

## Limites de taille de texte pour les moteurs Amazon RDS
<a name="sql-text-engine-limits"></a>

Lorsque vous téléchargez du texte SQL, le moteur de la base de données détermine sa longueur maximale. Vous pouvez télécharger du texte SQL jusqu'aux limites suivantes par moteur.


| Moteur de base de données | Longueur maximale du texte téléchargé | 
| --- | --- | 
| Amazon RDS pour MySQL et MariaDB | La longueur est fixée à 4 096 octets lorsque le schéma de performance est activé. Lorsque le schéma de performance n’est pas activé, la longueur est fixée à 65 535 octets. | 
| Amazon RDS for Microsoft SQL Server | 4,096 caractères | 
| Amazon RDS for Oracle | 1 000 octets | 

La section **SQL text** (Texte SQL) de la console Performance Insights affiche jusqu'au la taille maximum renvoyée par le moteur. Par exemple, si MySQL renvoie au plus 1 Ko à Performance Insights, celui-ci ne peut collecter et afficher que 1 Ko, même si la requête d'origine est plus volumineuse. Ainsi, lorsque vous visualisez la requête en **SQL text** (Texte SQL) ou que vous la téléchargez, Performance Insights renvoie le même nombre d'octets.

Si vous utilisez l’AWS CLI ou l’API, Performance Insights n’a pas la limite de 4 Ko imposée par la console. `DescribeDimensionKeys` et `GetResourceMetrics` renvoient au maximum 500 octets. 

**Note**  
`GetDimensionKeyDetails` renvoie la requête complète, mais la taille dépend de la limite du moteur.

# Définition de la limite de taille d’un texte SQL pour les instances de base de données Amazon RDS pour PostgreSQL
<a name="USER_PerfInsights.UsingDashboard.SQLTextLimit"></a>

Amazon RDS pour PostgreSQL gère le texte différemment. Vous pouvez définir la limite de taille du texte avec le paramètre `track_activity_query_size` de l’instance de base de données. Ce paramètre possède les caractéristiques suivantes :

Taille de texte par défaut  
Sur Amazon RDS pour PostgreSQL version 9.6, la valeur par défaut du paramètre `track_activity_query_size` est 1 024 octets. Sur Amazon RDS pour PostgreSQL version 10 ou versions ultérieures, la valeur par défaut est 4 096 octets.

Taille maximale du text  
La limite de `track_activity_query_size` est de 102 400 octets pour Amazon RDS pour PostgreSQL version 12 et versions inférieures. Le maximum est de 1 Mo pour la version 13 et versions ultérieures.   
Si le moteur renvoie 1 Mo à Performance Insights, la console affiche uniquement les 4 premiers Ko. Si vous téléchargez la requête, vous obtenez la totalité des 1 Mo. Dans ce cas, l’affichage et le téléchargement renvoient des quantités différentes d’octets. Pour plus d’informations sur le paramètre `track_activity_query_size` d’instance de base de données, consultez [Run-time Statistics](https://www.postgresql.org/docs/current/runtime-config-statistics.html) dans la documentation PostgreSQL.

Pour augmenter la taille du texte SQL, augmentez la limite `track_activity_query_size`. Pour modifier ce paramètre, modifiez sa valeur dans le groupe de paramètres associé à l’instance de base de données Amazon RDS pour PostgreSQL.

**Pour modifier le paramètre lorsque l’instance utilise le groupe de paramètres par défaut**

1. Créez un nouveau groupe de paramètres pour l’instance de base de données, associé au moteur de base de données et à sa version appropriés.

1. Définissez le paramètre dans le nouveau groupe de paramètres.

1. Associez le nouveau groupe de paramètres à l’instance de base de données.

Pour plus d’informations sur la définition d’un paramètre d’instance de base de données, consultez [Modification de paramètres dans un groupe de paramètres de base de données dans Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).

# Affichage et téléchargement de texte SQL dans le tableau de bord de Performance Insights
<a name="view-download-text"></a>

Dans le tableau de bord de Performance Insights, vous pouvez afficher ou télécharger le texte SQL.

**Pour afficher du texte SQL supplémentaire dans le tableau de bord de Performance Insights**

1. Ouvrez la console Amazon RDS à l'adresse [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Dans le panneau de navigation, choisissez **Performance Insights**.

1. Choisissez une instance de base de données.

1. Faites défiler la page jusqu’à l’onglet **Principaux SQL** dans le tableau de bord Performance Insights.

1. Choisissez le signe plus pour développer une synthèse SQL et choisissez l’une des requêtes enfants de la synthèse.

   Les instructions SQL dont la taille du texte est supérieure à 500 octets ressemblent à l’image ci-dessous.  
![\[Instructions SQL dont le texte est volumineux\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf-insights-large-text-1.png)

1. Faites défiler jusqu’à l’onglet **SQL text** (Texte SQL).  
![\[La section relative aux informations SQL montre plus de texte SQL\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf-insights-large-text-2.png)

   Le tableau de bord de Performance Insights peut afficher jusqu’à 4 096 octets par instruction SQL.

1. (Facultatif) Choisissez **Copy (Copier)** pour copier l’instruction SQL affichée ou **Download (Télécharger)** pour télécharger l’instruction SQL et en afficher le texte jusqu’à la limite du moteur de base de données.
**Note**  
Pour copier ou télécharger l’instruction SQL, désactivez les bloqueurs de fenêtres contextuelles. 

# Affichage des statistiques SQL dans le tableau de bord de Performance Insights
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.AnalyzingSQLLevel"></a>

Dans le tableau de bord de Performance Insights, les statistiques SQL sont disponibles dans l’onglet **Top SQL** (Principaux éléments SQL) du graphique **Database load** (Charge de la base de données).

**Pour afficher les statistiques SQL**

1. Ouvrez la console Amazon RDS à l'adresse [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Dans le panneau de navigation gauche, choisissez **Performance Insights**.

1. En haut de la page, choisissez la base de données dont vous voulez voir les statistiques SQL.

1. Faites défiler jusqu’au bas de la page et choisissez l’onglet **Top SQL** (Principaux éléments SQL).

1. Choisissez une déclaration individuelle (Aurora MySQL uniquement) ou une requête récapitulative.  
![\[Affichage des métriques pour les requêtes en cours d’exécution\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_sql.png)

1. Choisissez les statistiques à afficher en sélectionnant l’icône en forme d’engrenage dans le coin supérieur droit du graphique. Pour obtenir des descriptions des statistiques SQL pour les moteurs Amazon RDS, consultez [Statistiques SQL pour Performance Insights](sql-statistics.md).

   L’exemple suivant montre les préférences de statistiques pour les instances de base de données Oracle.  
![\[Préférences des métriques pour les requêtes en cours d’exécution pour les instances de bases de données Oracle\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_pref_oracle.png)

   L’exemple suivant montre les préférences pour les instances de base de données MariaDB et MySQL.  
![\[Préférences en matière de métriques pour des requêtes en cours d’exécution pour des instances de base de données MariaDB et MySQL.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_pref_ams.png)

1. Choisissez Save (Enregistrer) pour enregistrer vos préférences.

   La table **Top SQL** (Principaux éléments SQL) s’actualise.

   L’exemple suivant montre les statistiques d’une requête SQL Oracle.  
![\[Statistiques d’une requête SQL\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_stats_oracle.png)

# Analyse de la charge maximale de PDB Oracle
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.TopPDB"></a>

Lorsque vous analysez la charge sur une base de données de conteneur (CDB) Oracle, vous voudrez peut-être savoir quelles bases de données enfichables (PDB) contribuent le plus à la charge de la base de données. Vous pouvez également comparer les performances de chaque PDB exécutant des requêtes similaires afin d’optimiser les performances. Pour plus d’informations sur les CDB Oracle, consultez [Architecture de base de données RDS for Oracle](oracle-multi-architecture.md).

Dans le tableau de bord Analyse des performances d’Amazon RDS, vous pouvez trouver des informations sur les bases de données enfichables (PDB) sous l’onglet **Principales PDB** de l’onglet **Dimensions**.

Pour obtenir les informations de prise en charge de la région, du moteur de base de données et de la classe d’instance pour cette fonctionnalité, consultez [Support du moteur de base de données Amazon RDS pour les fonctionnalités Performance Insights](USER_PerfInsights.Overview.Engines.md#USER_PerfInsights.Overview.PIfeatureEngnRegSupport).

**Pour analyser la charge de la PDB principale dans un CDB Oracle**

1. Connectez-vous à la AWS Management Console et ouvrez la console Amazon RDS à l’adresse [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Dans le panneau de navigation gauche, sélectionnez **Performance Insights**.

1. Choisissez une instance de CDB Oracle.

   Le tableau de bord Performance Insights correspondant à cette instance de base de données s’affiche.

1. Dans la section **Charge de base de données**, choisissez **Base de données enfichable (PDB)** à côté de Division par.

   Le graphique Sessions actives moyennes affiche la PDB avec le chargement le plus élevé. Les identifiants de PDB apparaissent à droite des carrés à code couleur. Chaque identifiant identifie de manière unique une PDB.  
![\[Graphique Sessions actives moyennes pour un chargement de PDB\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_topPDB_AAS.png)

1. Faites défiler jusqu’à l’onglet **Top SQL** (Principaux éléments SQL).

   Dans l’exemple suivant, vous pouvez voir la même requête SQL et la charge qu’elle entraîne sur plusieurs PDB.  
![\[Charge d’une même requête SQL pour plusieurs PDB\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_topPDB_ex1.png)

   Dans l’exemple suivant, une seule PDB supporte une charge plus élevée que les autres PDB de la CDB.  
![\[Charge de requête SQL élevée pour PDB\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_topPDB_ex2.png)

   Pour plus d’informations sur les CDB Oracle, consultez [CDB et PDB](https://docs.oracle.com/en/database/oracle/oracle-database/21/cncpt/CDBs-and-PDBs.html#GUID-FC2EB562-ED31-49EF-8707-C766B6FE66B8).

# Analyse des plans d’exécution à l’aide du tableau de bord Performance Insights pour Amazon RDS
<a name="USER_PerfInsights.UsingDashboard.AnalyzingPlans"></a>

Dans le tableau de bord Analyse des performances d’Amazon RDS, vous pouvez trouver des informations sur les plans d’exécution pour les instances de base de données Oracle et SQL Server. Vous pouvez utiliser ces informations pour savoir quels plans contribuent le plus à la charge de base de données.

Pour analyser les plans d’exécution Oracle ou SQL Server, consultez les rubriques suivantes.

**Analyse des plans d’exécution**
+ [Analyse des plans d’exécution Oracle à l’aide du tableau de bord Performance Insights pour Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlans.md)
+ [Analyse des plans d’exécution de SQL Server à l’aide du tableau de bord Performance Insights pour Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlansSqlServer.md)

## Présentation de l’analyse des plans d’exécution pour Amazon RDS
<a name="USER_PerfInsights.UsingDashboard.AnalyzingPlans.Overview"></a>

Vous pouvez utiliser le tableau de bord Analyse des performances d’Amazon RDS pour savoir quels plans contribuent le plus à la charge de base de données pour les instances de base de données Oracle et SQL Server. 

 Par exemple, les principales instructions SQL à un moment donné peuvent utiliser les plans présentés dans la table suivante.


****  

| Principaux éléments SQL | Plan | 
| --- | --- | 
|  SELECT SUM(amount\$1sold) FROM sales WHERE prod\$1id = 10  |  Plan A  | 
|  SELECT SUM(amount\$1sold) FROM sales WHERE prod\$1id = 521  |  Plan B  | 
|  SELECT SUM(s\$1total) FROM sales WHERE region = 10  |  Plan A  | 
|  SELECT \$1 FROM emp WHERE emp\$1id = 1000  |  Plan C  | 
|  SELECT SUM(amount\$1sold) FROM sales WHERE prod\$1id = 72  |  Plan A  | 

Avec la fonction de plan de Performance Insights, vous pouvez effectuer les opérations suivantes :
+ Découvrez quels plans sont utilisés par les principales requêtes SQL. 

  Par exemple, vous pouvez découvrir que la majeure partie de la charge de base de données est générée par des requêtes utilisant le plan A et le plan B, avec seulement un faible pourcentage utilisant le plan C.
+ Comparez différents plans pour la même requête. 

  Dans l'exemple précédent, trois requêtes sont identiques à l'exception de l'ID du produit. Deux requêtes utilisent le plan A, mais une requête utilise le plan B. Pour voir la différence entre les deux plans, vous pouvez utiliser Performance Insights.
+ Découvrez quand une requête est passée à un nouveau plan. 

  Vous pouvez voir qu'une requête a utilisé le plan A, puis est passée au plan B à un moment donné. Y a-t-il eu un changement dans la base de données à ce moment ? Par exemple, si une table est vide, l'optimiseur peut choisir une analyse complète de table. Si la table est chargée avec un million de lignes, l'optimiseur peut passer à une analyse de plage d'index.
+ Examinez les étapes spécifiques d'un plan présentant le coût le plus élevé.

  Par exemple, le plan pour une requête longue durée peut indiquer une condition de jointure manquante dans une équijointure. Cette condition manquante mène à une jointure cartésienne, qui joint toutes les lignes de deux tables.

Vous pouvez effectuer les tâches précédentes à l'aide de la fonction de capture de plan de Performance Insights. Tout comme vous pouvez trancher les requêtes en fonction des événements d’attente et des principaux éléments SQL, vous pouvez les trancher en fonction de la dimension de plan.

# Analyse des plans d’exécution Oracle à l’aide du tableau de bord Performance Insights pour Amazon RDS
<a name="USER_PerfInsights.UsingDashboard.AccessPlans"></a>

Lorsque vous analysez la charge de base de données sur une base de données Oracle, vous voudrez peut-être savoir quels plans contribuent le plus à la charge de la base de données. Vous pouvez déterminer quels plans contribuent le plus à la charge de base de données à l’aide de la fonctionnalité de capture de plan de Performance Insights. 

**Pour analyser les plans d’exécution Oracle à l’aide de la console**

1. Ouvrez la console Amazon RDS à l'adresse [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Dans le panneau de navigation, choisissez **Performance Insights**.

1. Choisissez une instance de base de données Oracle. Le tableau de bord de Performance Insights s’affiche pour cette instance de base de données.

1. Dans la section **Database load (DB load)** (Charge de base de données), choisissez **Plans** à côté de **Slice by** (Trancher par).

   Le graphique Average active sessions (Sessions actives moyennes) affiche les plans utilisés par vos principales instructions SQL. Les valeurs de hachage du plan apparaissent à droite des carrés à code couleur. Chaque valeur de hachage identifie de manière unique un plan.  
![\[Trancher par plans\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/pi-slice-by-plans.png)

1. Faites défiler jusqu’à l’onglet **Top SQL** (Principaux éléments SQL).

   Dans l’exemple suivant, le récapitulatif SQL principal comporte deux plans. Vous pouvez deviner qu’il s’agit d’un récapitulatif grâce au point d’interrogation de l’instruction.   
![\[Choisir un plan récapitulatif\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/top-sql-plans-unselected.png)

1. Choisissez le récapitulatif pour afficher ses instructions de composants.

   Dans l’exemple suivant, l’instruction `SELECT` est une requête récapitulative. Les requêtes de composants du récapitulatif utilisent deux plans différents. Les couleurs des plans correspondent au graphique de charge de base de données. Le nombre total de plans dans le récapitulatif est indiqué dans la deuxième colonne.  
![\[Choisir un plan récapitulatif\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/pi-digest-plan.png)

1. Faites défiler et choisissez deux **Plans** à comparer dans la liste **Plans for digest query** (Plans pour requête récapitulative).

   Vous pouvez afficher un ou deux plans pour une requête à la fois. La capture d’écran suivante compare les deux plans du récapitulatif, avec le hachage 2032253151 et le hachage 1117438016. Dans l’exemple suivant, 62 % des sessions actives moyennes exécutant cette requête récapitulative utilisent le plan de gauche, tandis que 38 % utilisent celui de droite.  
![\[Comparez les plans côte à côte\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/pi-compare-plan.png)

   Dans cet exemple, les plans diffèrent d’une manière importante. L’étape 2 du plan 2032253151 utilise une analyse d’index, tandis que le plan 1117438016 utilise une analyse de table complète. Pour une table comportant un grand nombre de lignes, la requête d’une seule ligne est presque toujours plus rapide avec une analyse d’index.  
![\[Comparez les plans côte à côte\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/pi-table-access.png)

1. (Facultatif) Choisissez **Copy** (Copier) pour copier le plan dans le presse-papier, ou **Download** (Téléchargement) pour enregistrer le plan sur votre disque dur. 

# Analyse des plans d’exécution de SQL Server à l’aide du tableau de bord Performance Insights pour Amazon RDS
<a name="USER_PerfInsights.UsingDashboard.AccessPlansSqlServer"></a>

Lorsque vous analysez la charge de base de données sur une base de données SQL Server, vous voudrez peut-être savoir quels plans contribuent le plus à la charge de la base de données. Vous pouvez déterminer quels plans contribuent le plus à la charge de base de données à l’aide de la fonctionnalité de capture de plan de Performance Insights. 

**Pour analyser les plans d’exécution de SQL Server à l’aide de la console**

1. Ouvrez la console Amazon RDS à l’adresse [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Dans le panneau de navigation, choisissez **Performance Insights**.

1. Choisissez une instance de base de données SQL Server. Le tableau de bord Performance Insights s’affiche pour cette instance de base de données.

1. Dans la section **Database load (DB load)** (Charge de base de données), choisissez **Plans** à côté de **Slice by** (Trancher par).

   Le graphique Average active sessions (Sessions actives moyennes) affiche les plans utilisés par vos principales instructions SQL. Les valeurs de hachage du plan apparaissent à droite des carrés à code couleur. Chaque valeur de hachage identifie de manière unique un plan.  
![\[Trancher par plans\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/pi-slice-by-plans-sqlserver.png)

1. Faites défiler jusqu’à l’onglet **Top SQL** (Principaux éléments SQL).

   Dans l’exemple suivant, la synthèse SQL principale comporte trois plans. La présence d’un point d’interrogation dans l’instruction SQL indique que l’instruction est une synthèse. Pour afficher l’instruction SQL complète, choisissez une valeur dans la colonne **Instructions SQL**.  
![\[Choix d’un plan de synthèse\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/top-sql-plans-unselected-sqlserver.png)

1. Choisissez le récapitulatif pour afficher ses instructions de composants.

   Dans l’exemple suivant, l’instruction `SELECT` est une requête de synthèse. Les requêtes de composants de la synthèse utilisent trois plans d’exécution différents. Les couleurs affectées aux plans correspondent au graphique de charge de base de données.  
![\[Choix d’un plan de synthèse\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/pi-digest-plan-sqlserver.png)

1. Faites défiler et choisissez deux **Plans** à comparer dans la liste **Plans for digest query** (Plans pour requête récapitulative).

   Vous pouvez afficher un ou deux plans pour une requête à la fois. La capture d’écran suivante compare les deux plans de la synthèse. Dans l’exemple suivant, 40 % des sessions actives moyennes exécutant cette requête récapitulative utilisent le plan de gauche, tandis que 28 % utilisent celui de droite.  
![\[Comparez les plans côte à côte\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/pi-compare-plan-sqlserver.png)

   Dans l’exemple précédent, les plans diffèrent d’une manière importante. L’étape 2 du plan de gauche utilise une analyse de table, tandis que le plan de droite utilise une analyse d’index mis en cluster. Pour une table comportant un grand nombre de lignes, la requête d’une seule ligne est presque toujours plus rapide avec une analyse d’index mis en cluster.

1. (Facultatif) Cliquez sur l’icône **Paramètres** dans la table Détails du plan pour personnaliser la visibilité et l’ordre des colonnes. La capture d’écran suivante montre la table Détails du plan avec la colonne **Liste des résultats** comme deuxième colonne.  
![\[Personnalisez la visibilité et l’ordre des colonnes dans la table Détails du plan\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/pi-plan-fields-sql-server.png)

1. (Facultatif) Choisissez **Copy** (Copier) pour copier le plan dans le presse-papier, ou **Download** (Téléchargement) pour enregistrer le plan sur votre disque dur. 

**Note**  
Performance Insights affiche les plans d’exécution estimés à l’aide d’une arborescence hiérarchique. La table inclut les informations d’exécution partielle pour chaque instruction. Pour plus d’informations sur les colonnes de la table Détails du plan, consultez [SET SHOWPLAN\$1ALL](https://learn.microsoft.com/en-us/sql/t-sql/statements/set-showplan-all-transact-sql) dans la documentation de SQL Server. Pour afficher les informations d’exécution complètes d’un plan d’exécution estimé, choisissez **Télécharger** pour télécharger le plan, puis téléchargez-le dans SQL Server Management Studio. Pour plus d’informations sur l’affichage d’un plan d’exécution estimé à l’aide de SQL Server Management Studio, consultez [Afficher un plan d’exécution estimé](https://learn.microsoft.com/en-us/sql/relational-databases/performance/display-the-estimated-execution-plan) dans la documentation de SQL Server. 