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. # Surveillance de la charge de la base de données avec Performance Insights sur Amazon RDS **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/). Performance Insights développe les fonctions de surveillance existantes d’Amazon RDS pour illustrer et vous aider à analyser les performances de votre base de données. Avec le tableau de bord Performance Insights, vous pouvez visualiser la charge de la base de données de votre Charge d’instance de base de données Amazon RDS et filtrer la charge par attentes, instructions SQL, hôtes ou utilisateurs. Pour plus d’informations sur l’utilisation de Performance Insights avec Amazon DocumentDB, consultez le *[Guide du développeur Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/performance-insights.html)*. **Topics** + [ # Présentation de Performance Insights sur Amazon RDS ](USER_PerfInsights.Overview.md) + [ # Activation ou désactivation de l’Analyse des performances pour Amazon RDS ](USER_PerfInsights.Enabling.md) + [ # Présentation du schéma de performance pour Performance Insights sur Amazon RDS for MariaDB ou MySQL ](USER_PerfInsights.EnableMySQL.md) + [ # Configuration des politiques d’accès pour Performance Insights ](USER_PerfInsights.access-control.md) + [ # Analyse des métriques à l’aide du tableau de bord de Performance Insights ](USER_PerfInsights.UsingDashboard.md) + [ # Affichage des recommandations proactives de Performance Insights ](USER_PerfInsights.InsightsRecommendationViewDetails.md) + [ # Récupération de métriques avec l’API Performance Insights pour Amazon RDS ](USER_PerfInsights.API.md) + [ # Journalisation des appels Performance Insights avec AWS CloudTrail ](USER_PerfInsights.CloudTrail.md) + [ # API Performance Insights et points de terminaison de VPC d’interface (AWS PrivateLink) ](pi-vpc-interface-endpoints.md) # Présentation de Performance Insights sur Amazon RDS **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/). Par défaut, RDS active Performance Insights dans l’assistant de création de console pour les moteurs Amazon RDS. Si vous disposez de plusieurs bases de données sur une instance de base de données, Performance Insights regroupe les données de performance. Vous trouverez un aperçu de Performance Insights pour Amazon RDS dans la vidéo suivante. [![AWS Videos](http://img.youtube.com/vi/yOeWcPBT458/0.jpg)](http://www.youtube.com/watch?v=yOeWcPBT458) **Important** Les rubriques suivantes expliquent comment utiliser Analyse des performances d’Amazon RDS avec des moteurs de base de données non Aurora. Pour plus d’informations sur l’utilisation de l’analyse des performances d’Amazon RDS avec Amazon Aurora, consultez [Utilisation de l’analyse des performances d’Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.html) dans le *Guide de l’utilisateur Amazon Aurora*. **Topics** + [ # Charge de base de données ](USER_PerfInsights.Overview.ActiveSessions.md) + [ # Utilisation maximale de l'UC ](USER_PerfInsights.Overview.MaxCPU.md) + [ # Support du moteur de base de données Amazon RDS pour Performance Insights ](USER_PerfInsights.Overview.Engines.md) + [ # Tarification et conservation des données pour Performance Insights ](USER_PerfInsights.Overview.cost.md) # Charge de base de données *Charge de base de données* mesure le niveau d’activité de la session de votre base de données. `DBLoad` est la métrique clé de Performance Insights, et Performance Insights collecte la charge de base de données chaque seconde. **Topics** + [ ## Sessions actives ](#USER_PerfInsights.Overview.ActiveSessions.active-sessions) + [ ## Sessions actives en moyenne ](#USER_PerfInsights.Overview.ActiveSessions.AAS) + [ ## Exécutions actives moyennes ](#USER_PerfInsights.Overview.ActiveSessions.AAE) + [ ## Dimensions ](#USER_PerfInsights.Overview.ActiveSessions.dimensions) ## Sessions actives Une *session de base de données* représente le dialogue d'une application avec une base de données relationnelle. Une session active est une connexion qui a transmis du travail au moteur de base de données et qui attend une réponse. Une session est active lorsqu'elle s'exécute sur le processeur (CPU) ou attend qu'une ressource devienne disponible pour pouvoir continuer. Par exemple, une session active peut attendre qu'une page (ou un bloc) soit lue en mémoire avant d'utiliser le processeur pendant la lecture des données de la page. ## Sessions actives en moyenne Les *sessions actives en moyenne (AAS)* représentent l'unité de la métrique `DBLoad` de Performance Insights. Elle mesure le nombre de sessions actives simultanément sur la base de données. Toutes les secondes, Performance Insights échantillonne le nombre de sessions exécutant simultanément une requête. Pour chaque session active, Performance Insights collecte les données suivantes : + Instruction SQL + État de la session (en cours d'exécution sur le processeur ou en attente) + Host (Hôte) + Utilisateur exécutant le SQL Performance Insights calcule les AAS en divisant le nombre total de sessions par le nombre d'échantillons pour une période déterminée. Par exemple, la table suivante présente 5 échantillons consécutifs d'une requête en cours d'exécution, prélevés à des intervalles d'une seconde. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html) Dans l'exemple précédent, la charge de la base de données pour l'intervalle de temps était de 2 AAS. Cette mesure signifie qu'en moyenne, deux sessions étaient actives à la fois à n'importe quel moment au cours de la période où les cinq échantillons ont été prélevés. ## Exécutions actives moyennes La moyenne des exécutions actives (AAE) par seconde est liée à l'AAS. Pour calculer l'AAE, Performance Insights divise la durée totale d'exécution d'une requête par l'intervalle de temps. Le tableau suivant présente le calcul de l'AAE pour la même requête que dans le tableau précédent. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html) Dans la plupart des cas, l'AAS et l'AAE d'une requête sont approximativement identiques. Cela dit, comme les données utilisées pour les calculs proviennent de sources différentes, les calculs varient souvent légèrement. ## Dimensions La métrique `db.load` est différente des autres métriques de séries chronologiques, car vous pouvez la décomposer en sous-composants appelés dimensions. Vous pouvez considérer les dimensions comme des catégories de « tranches » pour les différentes caractéristiques de la métrique `DBLoad`. Lorsque vous diagnostiquez des problèmes de performances, les dimensions suivantes sont souvent les plus utiles : **Topics** + [ ### Événements d'attente ](#USER_PerfInsights.Overview.ActiveSessions.waits) + [ ### Principaux éléments SQL ](#USER_PerfInsights.Overview.ActiveSessions.top-sql) + [ ### Plans ](#USER_PerfInsights.Overview.ActiveSessions.plans) Pour obtenir la liste complète des dimensions des moteurs Amazon RDS, consultez [Charge de base de données tranchée par dimensions](USER_PerfInsights.UsingDashboard.Components.md#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.dims). ### Événements d'attente Un *événement d'attente* fait qu'une instruction SQL attend qu'un événement spécifique se produise avant de pouvoir continuer à s'exécuter. Les événements d'attente constituent une dimension (ou catégorie) importante pour la charge de la base de données, car ils indiquent les points de blocage du travail. Chaque session active est soit en cours d'exécution au niveau du processeur soit en attente. Par exemple, les sessions sollicitent le processeur lorsqu'elles recherchent un tampon dans la mémoire, effectuent un calcul ou exécutent du code procédural. Lorsque les sessions ne sollicitent pas le processeur, c'est peut-être qu'elles attendent qu'un tampon de mémoire se libère, qu'un fichier de données soit lu ou qu'un journal soit écrit. Le temps que passe une session à attendre des ressources est autant de temps en moins qu'elle passe à s'exécuter au niveau du processeur. Lorsque vous réglez une base de données, vous cherchez souvent à identifier les ressources que les sessions attendent. Par exemple, deux ou trois événements d'attente peuvent représenter 90 % de la charge de la base de données. Cette mesure signifie qu'en moyenne, les sessions actives passent la majeure partie de leur temps à attendre un petit nombre de ressources. Si vous trouvez la cause de ces attentes, vous pouvez tenter une solution. Les événements d'attente varient en fonction du moteur de base de données : + Pour plus d’informations sur tous les événements d’attente MariaDB et MySQL, consultez [Wait Event Summary Tables](https://dev.mysql.com/doc/refman/8.0/en/performance-schema-wait-summary-tables.html) dans la documentation MySQL. + Pour plus d'informations sur tous les événements d'attente PostgreSQL, consultez [The Statistics Collector > Wait Event tables](https://www.postgresql.org/docs/current/monitoring-stats.html#WAIT-EVENT-TABLE) dans la documentation de PostgreSQL. + Pour plus d’informations sur tous les événements d’attente Oracle, consultez [Descriptions of Wait Events](https://docs.oracle.com/database/121/REFRN/GUID-2FDDFAA4-24D0-4B80-A157-A907AF5C68E2.htm#REFRN-GUID-2FDDFAA4-24D0-4B80-A157-A907AF5C68E2) dans la documentation Oracle. + Pour plus d’informations sur tous les événements d’attente SQL Server, consultez [ Types of Waits](https://docs.microsoft.com/en-us/sql/relational-databases/system-dynamic-management-views/sys-dm-os-wait-stats-transact-sql?view=sql-server-2017#WaitTypes) dans la documentation SQL Server. **Note** Pour Oracle, les processus en arrière-plan s'exécutent parfois sans instruction SQL associée. Dans ce cas, Performance Insights communique le type de processus en arrière-plan concaténé avec le signe deux-points, et la classe d'attente associée à ce processus en arrière-plan. Parmi les types de processus en arrière-plan figurent `LGWR`, `ARC0`, `PMON`, etc. Par exemple, lorsque le programme d'archivage effectue des opérations d'I/O, le rapport Performance Insights correspondant est similaire à `ARC1:System I/O`. Parfois, le type du processus en arrière-plan est également omis et Performance Insights communique uniquement la classe d'attente, par exemple `:System I/O`. ### Principaux éléments SQL Là où les événements d'attente présentent des goulots d'étranglement, les principaux éléments SQL indiquent quelles requêtes contribuent le plus à la charge de la base de données. Par exemple, de nombreuses requêtes peuvent être en cours d'exécution sur la base de données, mais une seule d'entre elles peut consommer 99 % de la charge de la base de données. Dans ce cas, la charge élevée peut indiquer un problème avec la requête. Par défaut, la console Performance Insights affiche les principales requêtes SQL qui contribuent à la charge de la base de données. La console affiche également des statistiques pertinentes pour chaque instruction. Pour diagnostiquer les problèmes de performances d'une instruction spécifique, vous pouvez examiner son plan d'exécution. ### Plans Un *plan d'exécution*, également appelé simplement un *plan*, est une séquence d'étapes qui accèdent aux données. Par exemple, un plan de jonction de tables `t1` et `t2` peut parcourir toutes les lignes de `t1` et comparer chaque ligne à une ligne de `t2`. Dans une base de données relationnelle, un *optimiseur* est un code intégré qui détermine le plan le plus efficace pour une requête SQL. Pour les instances de base de données, Performance Insights collecte automatiquement les plans d’exécution. Pour diagnostiquer les problèmes de performances SQL, examinez les plans capturés pour les requêtes SQL à ressources élevées. Les plans montrent comment la base de données a analysé et exécuté des requêtes. Pour découvrir comment analyser la charge de base de données à l’aide de plans, consultez : + Oracle: [Analyse des plans d’exécution Oracle à l’aide du tableau de bord Performance Insights pour Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlans.md) + SQL Server : [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) #### Capture du plan Toutes les cinq minutes, Performance Insights identifie les requêtes les plus gourmandes en ressources et capture leurs plans. Ainsi, vous n'avez pas besoin de collecter et de gérer manuellement un grand nombre de plans. Au lieu de cela, vous pouvez utiliser l'onglet **Top SQL** (Principaux éléments SQL) pour vous concentrer sur les plans des requêtes les plus problématiques. **Note** Performance Insights ne capture pas de plans pour les requêtes dont le texte dépasse la limite maximale de texte de requête collectable. Pour plus d’informations, consultez [Accès à plus de texte SQL dans le tableau de bord Performance Insights](USER_PerfInsights.UsingDashboard.SQLTextSize.md). La période de conservation des plans d'exécution est la même que pour vos données Performance Insights. Le paramètre de conservation est **Par défaut (7 jours)**. Pour conserver vos données de performance plus longtemps, indiquez 1 à 24 mois. Pour obtenir plus d’informations sur les périodes de conservation, consultez [Tarification et conservation des données pour Performance Insights](USER_PerfInsights.Overview.cost.md). #### Requêtes récapitulatives L'onglet **Top SQL** (Principaux éléments SQL) affiche les requêtes récapitulatives par défaut. Une requête récapitulative n'a pas elle-même de plan, mais toutes les requêtes utilisant des valeurs littérales ont des plans. Par exemple, une requête récapitulative peut inclure le texte `WHERE `email`=?`. Le récapitulatif peut contenir deux requêtes, l'une avec le texte `WHERE email=user1@example.com` et l'autre avec `WHERE email=user2@example.com`. Chacune de ces requêtes littérales peut inclure plusieurs plans. Lorsque vous sélectionnez une requête de synthèse, la console affiche tous les plans pour les instructions enfant de la synthèse sélectionnée. Par conséquent, vous n'avez pas besoin de parcourir toutes les instructions enfant pour trouver le plan. Vous pouvez voir des plans qui ne figurent pas dans la liste affichée des 10 premières instructions enfant. La console affiche les plans pour toutes les requêtes enfant pour lesquelles des plans ont été collectés, que les requêtes figurent ou non dans les 10 premières requêtes. # Utilisation maximale de l'UC Dans le tableau de bord, le graphique **Database load** (Charge de base de données)collecte, regroupe et affiche les informations de session. Pour voir si les sessions actives dépassent l’utilisation maximale de l’UC, examinez leur relation sur la ligne **Max vCPU** (UC virtuelle max). Performance Insights détermine la valeur de **vCPU maximum** par le nombre de cœurs de vCPU (UC virtuelle) pour votre instance de base de données. Un seul processus peut être exécuté sur un vCPU à la fois. Si le nombre de processus dépasse le nombre de vCPU, les processus sont mis en file d’attente. Lorsque le nombre de processus en file d’attente augmente, les performances de la base de données diminuent. Si la charge de la base de données est souvent au-dessus de la ligne **Max vCPU** (UC virtuelle max)et que l'état d'attente principal est CPU, cela signifie que l'UC est surchargée. Dans ce cas, vous pouvez décider de limiter les connexions à l'instance, de régler les requêtes SQL avec une charge d'UC élevée, ou envisager l'utilisation d'une classe d'instance plus grande. Quel que soit leur état d'attente, les instances élevées et régulières indiquent que des problèmes de goulots d'étranglement ou de conflits de ressources devront peut-être être résolus. Cela peut être vrai même si la charge de la base de données ne dépasse pas la ligne **Max vCPU** (UC virtuelle max). # Support du moteur de base de données Amazon RDS pour Performance Insights **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 suivant fournit les moteurs de base de données Amazon RDS qui prennent en charge l’analyse des performances. **Note** Pour Amazon Aurora, consultez [Prise en charge de Performance Insights par les moteurs de base de données Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.Overview.Engines.html) dans le *Guide de l’utilisateur Amazon Aurora*. | Moteur de base de données Amazon RDS | Versions et régions soumises à la gestion des versions du moteur | Restrictions de classe d’instance | | --- | --- | --- | | Amazon RDS for MariaDB | Pour obtenir plus d’informations sur la disponibilité des versions et des régions de Performance Insights avec RDS for MariaDB, consultez [Régions et moteurs de base de données pris en charge pour Performance Insights dans Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md). | Performance Insights n’est pas pris en charge pour les classes d’instance suivantes : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.Engines.html) | | RDS for MySQL | Pour obtenir plus d’informations sur la disponibilité des versions et des régions de Performance Insights avec RDS for MySQL, consultez [Régions et moteurs de base de données pris en charge pour Performance Insights dans Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md). | Performance Insights n’est pas pris en charge pour les classes d’instance suivantes : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.Engines.html) | | Amazon RDS for Microsoft SQL Server | Pour obtenir plus d’informations sur la disponibilité des versions et des régions de Performance Insights avec RDS for SQL Server, consultez [Régions et moteurs de base de données pris en charge pour Performance Insights dans Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md). | N/A | | Amazon RDS pour PostgreSQL | Pour obtenir plus d’informations sur la disponibilité des versions et des régions de Performance Insights avec RDS pour PostgreSQL Server, consultez [Régions et moteurs de base de données pris en charge pour Performance Insights dans Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md). | N/A | | Amazon RDS for Oracle | Pour obtenir plus d’informations sur la disponibilité des versions et des régions de Performance Insights avec RDS for Oracle, consultez [Régions et moteurs de base de données pris en charge pour Performance Insights dans Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md). | N/A | ## Support du moteur de base de données Amazon RDS pour les fonctionnalités Performance Insights Le tableau suivant fournit les moteurs de base de données Amazon RDS qui prennent en charge les fonctionnalités d’analyse des performances. | Fonctionnalité | [Niveau de tarification](https://aws.amazon.com/rds/performance-insights/pricing/) | [Régions prises en charge](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html#Concepts.RegionsAndAvailabilityZones.Regions) | [ Moteurs de base de données pris en charge](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Welcome.html#Welcome.Concepts.DBInstance) | [Classes d’instance prises en charge](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html#Concepts.DBInstanceClass.Types) | | --- | --- | --- | --- | --- | | [Statistiques SQL pour Performance Insights](sql-statistics.md) | Tous | Tous | Tous | Tous | | [Analyse des plans d’exécution Oracle à l’aide du tableau de bord Performance Insights pour Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlans.md) | Tous | Tous | RDS for Oracle | Tous | | [Analyse des performances de base de données pour une période donnée](USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.md) | Niveau payant uniquement | Tous | RDS pour PostgreSQL | Tous | | [Affichage des recommandations proactives de Performance Insights](USER_PerfInsights.InsightsRecommendationViewDetails.md) | Niveau payant uniquement | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.Engines.html) | Tous | Tous | # Tarification et conservation des données pour Performance Insights Par défaut, Performance Insights qui comprend 7 jours d’historique des données de performance et 1 million de demandes API par mois. Vous pouvez également acheter des périodes de conservation plus longues. Pour des informations complètes sur les prix, consultez la section [Performance Insights Pricing](https://aws.amazon.com/rds/performance-insights/pricing/) (Tarification de Performance Insights). Dans la console RDS, vous pouvez choisir l'une des périodes de conservation suivantes pour vos données Performance Insights : + **Par défaut (7 jours)** + ***n* mois**, où ***n*** est un nombre allant de 1 à 24 ![\[Choisissez une période de conservation pour vos données Performance Insights.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/pi-retention-periods.png) Pour savoir comment définir une période de conservation à l'aide de AWS CLI, consultez [Activation ou désactivation de l’Analyse des performances pour Amazon RDS](USER_PerfInsights.Enabling.md). **Note** L’arrêt d’une instance de base de données ou d’un cluster de bases de données multi-AZ alors que Performance Insights est activé n’a aucune incidence sur la conservation des données. En cas d’arrêt d’une instance de base de données ou d’un cluster de bases de données multi-AZ, Performance Insights ne collecte aucune donnée. # Activation ou désactivation de l’Analyse des performances pour Amazon RDS **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/). Vous pouvez activer Performance Insights pour votre instance de base de données ou votre cluster de bases de données multi-AZ lors de sa création. Si nécessaire, vous pouvez le désactiver ultérieurement en modifiant l’instance de base de données depuis la console. L’activation ou la désactivation de Performance Insights ne provoquent pas de durée d’indisponibilité, de redémarrage ni de basculement. **Note** Le schéma de performance est un outil de performance facultatif utilisé par Amazon RDS for MariaDB ou MySQL. Si vous activez ou désactivez le schéma de performance, un redémarrage est requis. Toutefois, si vous activez ou désactivez Performance Insights, aucun redémarrage n’est requis. Pour de plus amples informations, veuillez consulter [Présentation du schéma de performance pour Performance Insights sur Amazon RDS for MariaDB ou MySQL](USER_PerfInsights.EnableMySQL.md). L’agent Performance Insights consomme une quantité limitée d’UC et de mémoire sur l’hôte de base de données. Lorsque la charge de base de données est élevée, l’agent limite l’impact sur les performances en collectant des données moins fréquemment. ------ #### [ Console ] Dans la console, vous pouvez activer ou désactiver Performance Insights lorsque vous créez ou modifiez une instance de base de données ou un cluster de bases de données Multi-AZ. **Activation ou désactivation de Performance Insights lors de la création d’une instance de base de données ou d’un cluster de bases de données multi-AZ** Après avoir créé une instance de base de données ou un cluster de bases de données multi-AZ, Amazon RDS active Performance Insights par défaut. Pour désactiver Performance Insights , choisissez l’option **Database Insights – Standard** et désélectionnez l’option **Activer Performance Insights**. Pour plus d’informations, consultez les rubriques suivantes. + Pour créer une instance de base de données, suivez les instructions relatives à votre moteur de base de données dans [Création d'une instance de base de données Amazon RDS](USER_CreateDBInstance.md). + Pour créer un cluster de bases de données Multi-AZ, suivez les instructions relatives à votre moteur de base de données présentées dans [Création d’un cluster de bases de données Multi-AZ pour Amazon RDS](create-multi-az-db-cluster.md). L’image suivante représente la section **Performance Insights**. ![\[Activer Performance Insights lors de la création d’une instance de base de données ou cluster de bases de données Multi-AZ avec la console\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_enabling.png) Vous disposez des options suivantes lorsque vous choisissez **Activer Performance Insights** : + **Conservation** (pour le mode Standard de Database Insights uniquement) : durée de conservation des données de Performance Insights. Le paramètre de conservation est **Par défaut (7 jours)**. Pour conserver vos données de performance plus longtemps, indiquez 1 à 24 mois. Pour obtenir plus d’informations sur les périodes de conservation, consultez [Tarification et conservation des données pour Performance Insights](USER_PerfInsights.Overview.cost.md). + **AWS KMS key**— Spécifiez votre AWS KMS key. Performance Insights chiffre toutes les données potentiellement sensibles à l’aide votre clé KMS. Les données sont chiffrées en transit et au repos. Pour plus d’informations, consultez [Modification d'une AWS KMS politique pour Performance Insights](USER_PerfInsights.access-control.cmk-policy.md). **Activation ou désactivation de Performance Insights lors de la modification d’une instance de base de données ou d’un cluster de bases de données multi-AZ** Dans la console, vous pouvez modifier une instance de base de données ou un cluster de bases de données multi-AZ pour gérer Performance Insights. **Pour activer ou désactiver Performance Insights pour une instance de base de donnée ou un cluster de bases de données multi-AZ en utilisant la console** 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. Choisissez **Databases** (Bases de données). 1. Choisissez une instance de base de données ou un cluster de bases de données multi-AZ, et choisissez **Modifier**. 1. Pour activer Performance Insights, sélectionnez **Activer Performance Insights**. Pour désactiver Performance Insights , choisissez l’option **Database Insights – Standard** et désélectionnez l’option **Activer Performance Insights**. Vous disposez des options suivantes lorsque vous choisissez **Activer Performance Insights** : + **Conservation** (pour le mode Standard de Database Insights uniquement) : durée de conservation des données de Performance Insights. Le paramètre de conservation est **Par défaut (7 jours)**. Pour conserver vos données de performance plus longtemps, indiquez 1 à 24 mois. Pour obtenir plus d’informations sur les périodes de conservation, consultez [Tarification et conservation des données pour Performance Insights](USER_PerfInsights.Overview.cost.md). + **AWS KMS key** – Spécifiez votre clé KMS. Performance Insights chiffre toutes les données potentiellement sensibles à l’aide votre clé KMS. Les données sont chiffrées en transit et au repos. Pour plus d’informations, consultez [Chiffrement des ressources Amazon RDS](Overview.Encryption.md). 1. Choisissez **Continuer**. 1. Pour **Scheduling of Modifications** (Planification des modifications), choisissez Apply immediately (Appliquer immédiatement). Si vous choisissez Apply during the next scheduled maintenance window (Appliquer lors de la prochaine fenêtre de maintenance planifiée), votre instance ignore ce paramètre et active immédiatement Performance Insights. 1. Choisissez **Modify instance** (Modifier l’instance). ------ #### [ AWS CLI ] Lorsque vous utilisez la [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) AWS CLI commande, activez Performance Insights en spécifiant `--enable-performance-insights` et en `--database-insights-mode` réglant sur `advanced` ou`standard`. Pour désactiver Performance Insights, spécifiez `--no-enable-performance-insights` et définissez `database-insights-mode` sur `standard`. Vous pouvez également spécifier ces valeurs à l'aide des AWS CLI commandes suivantes : + [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html) + [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) + [create-db-instance-read-réplique](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance-read-replica.html) + [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) + [restore-db-instance-from-s3](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-s3.html) Lorsque vous activez Performance Insights dans l’interface CLI, vous pouvez éventuellement spécifier le nombre de jours pour conserver les données de Performance Insights avec l’option `--performance-insights-retention-period`. Vous pouvez spécifier `7` *month* \$1 31 (où *month* est un nombre compris entre 1 et 23) ou`731`. Par exemple, si vous souhaitez conserver vos données de performance pendant 3 mois, indiquez `93`, soit 3 \$1 31. La durée par défaut est de `7` jours. Pour obtenir plus d’informations sur les périodes de conservation, consultez [Tarification et conservation des données pour Performance Insights](USER_PerfInsights.Overview.cost.md). L’exemple suivant active Performance Insights pour `sample-db-cluster` et spécifie que les données de Performance Insights sont conservées pendant 93 jours (3 mois). Pour Linux, macOS ou Unix : ``` aws rds modify-db-cluster \ --database-insights-mode standard \ --db-cluster-identifier sample-db-instance \ --enable-performance-insights \ --performance-insights-retention-period 93 ``` Pour Windows : ``` aws rds modify-db-cluster ^ --database-insights-mode standard ^ --db-cluster-identifier sample-db-instance ^ --enable-performance-insights ^ --performance-insights-retention-period 93 ``` Si vous spécifiez une période de conservation telle que 94 jours, qui n’est pas une valeur valide, RDS émet une erreur. ``` An error occurred (InvalidParameterValue) when calling the CreateDBInstance operation: Invalid Performance Insights retention period. Valid values are: [7, 31, 62, 93, 124, 155, 186, 217, 248, 279, 310, 341, 372, 403, 434, 465, 496, 527, 558, 589, 620, 651, 682, 713, 731] ``` **Note** Vous ne pouvez activer Performance Insights que pour une instance d’un cluster de bases de données où Performance Insights n’est pas géré au niveau du cluster. ------ #### [ RDS API ] Lorsque vous créez une nouvelle instance de base de données de bases de données à l'aide de l'DBInstanceopération [Create](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) operation Amazon RDS API, activez Performance Insights en définissant `EnablePerformanceInsights` sur. `True` Pour désactiver Performance Insights, définissez `EnablePerformanceInsights` sur `False` et `DatabaseInsightsMode` sur `standard`. Vous pouvez également spécifier la valeur `EnablePerformanceInsights` à l’aide des opérations d’API suivantes : + [Créer DBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html) (cluster de base de données multi-AZ) + [Modifier DBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) (cluster de bases de données multi-AZ) + [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) + [CréerDBInstanceReadReplica](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstanceReadReplica.html) + [Restaurer à DBInstance partir de S3](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromS3.html) Lorsque vous activez Performance Insights, vous pouvez facultativement spécifier la durée, en jours, de conservation des données de Performance Insights avec le paramètre `PerformanceInsightsRetentionPeriod`. Vous pouvez spécifier `7` *month* \$1 31 (où *month* est un nombre compris entre 1 et 23) ou`731`. Par exemple, si vous souhaitez conserver vos données de performance pendant 3 mois, indiquez `93`, soit 3 \$1 31. La durée par défaut est de `7` jours. Pour obtenir plus d’informations sur les périodes de conservation, consultez [Tarification et conservation des données pour Performance Insights](USER_PerfInsights.Overview.cost.md). ------ # Présentation du schéma de performance pour Performance Insights sur Amazon RDS for MariaDB ou MySQL Le schéma de performance est une fonctionnalité facultative pour la surveillance des performances d’exécution d’Amazon RDS for MariaDB ou MySQL à un faible niveau de détails. Le schéma de performance est conçu pour avoir un impact minimal sur les performances de base de données. Performance Insights est une fonctionnalité distincte que vous pouvez utiliser avec ou sans le schéma de performance. **Topics** + [ ## Présentation du schéma de performance ](#USER_PerfInsights.EnableMySQL.overview) + [ ## Performance Insights et le schéma de performance ](#USER_PerfInsights.effect-of-pfs) + [ ## Gestion automatique du schéma de performance par Performance Insights ](#USER_PerfInsights.EnableMySQL.options) + [ ## Effet d’un redémarrage sur le schéma de performance ](#USER_PerfInsights.EnableMySQL.reboot) + [ # Déterminer si Performance Insights gère le schéma de performance ](USER_PerfInsights.EnableMySQL.determining-status.md) + [ # Activation du schéma de performance sur Amazon RDS for MariaDB ou MySQL ](USER_PerfInsights.EnableMySQL.RDS.md) ## Présentation du schéma de performance Le schéma de performance surveille les événements dans les bases de données MariaDB et MySQL. Un *événement* est une action du serveur de base de données qui consomme du temps et qui a été instrumentée de manière à ce que des informations temporelles puissent être collectées. Voici quelques exemples d’événements : + Appels de fonction + Attend le système d’exploitation + Étapes de l’exécution SQL + Groupes d’instructions SQL Le moteur de stockage `PERFORMANCE_SCHEMA` est un mécanisme de mise en œuvre de la fonctionnalité de schéma de performance. Ce moteur collecte les données d’événement à l’aide d’une instrumentation dans le code source de la base de données. Le moteur stocke les événements dans des tables à mémoire uniquement dans la base de données `performance_schema`. Vous pouvez interroger `performance_schema` tout comme vous pouvez interroger d’autres tables. Pour plus d’informations, consultez [MySQL Performance Schema](https://dev.mysql.com/doc/refman/8.0/en/performance-schema.html) (Schéma de performance MySQL) dans le *Manuel de référence de MySQL*. ## Performance Insights et le schéma de performance Performance Insights et Performance Schema sont des fonctionnalités distinctes, mais elles sont liées. Le comportement de Performance Insights pour Amazon RDS for MariaDB ou MySQL dépend de l’activation ou non du schéma de performance, et si oui, si Performance Insights gère automatiquement le schéma de performance. Le tableau suivant décrit le comportement. | Schéma de performance activé | Mode de gestion de Performance Insights | Comportement de Performance Insights | | --- | --- | --- | | Oui | Automatique | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_PerfInsights.EnableMySQL.html) | | Oui | Manuelle | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_PerfInsights.EnableMySQL.html) | | Non | N/A | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_PerfInsights.EnableMySQL.html) | ## Gestion automatique du schéma de performance par Performance Insights Le schéma de performance est également activé lorsque vous créez une instance de base de données Amazon RDS for MariaDB ou MySQL avec Performance Insights activé. Le cas échéant, Performance Insights gère automatiquement vos paramètres de schéma de performance. Il s’agit de la configuration recommandée. Lorsque Performance Insights gère automatiquement le schéma de performance, la **source** de `performance_schema` est `System default`. **Note** La gestion automatique du schéma de performance n’est pas prise en charge pour la classe d’instance t4g.medium. Si vous modifiez la valeur du paramètre `performance_schema` manuellement et que vous souhaitez ensuite passer à la gestion automatique, consultez [Activation du schéma de performance sur Amazon RDS for MariaDB ou MySQL](USER_PerfInsights.EnableMySQL.RDS.md). **Important** Lorsque Performance Insights active le schéma de performance, il ne modifie pas les valeurs du groupe de paramètres. Toutefois, les valeurs sont modifiées sur les instances de base de données en cours d’exécution. La seule façon de voir les valeurs modifiées est d’exécuter la commande `SHOW GLOBAL VARIABLES`. ## Effet d’un redémarrage sur le schéma de performance Performance Insights et le schéma de performance diffèrent dans leurs exigences en matière de redémarrage des instances de base de données : **Schéma de performance** Pour activer ou désactiver cette fonction, vous devez redémarrer l’instance de base de données. **Performance Insights** Pour activer ou désactiver cette fonction, il n’est pas nécessaire de redémarrer l’instance de base de données. Si le schéma de performance n’est pas activé et que vous activez Performance Insights sans redémarrer l’instance de base de données, le schéma de performance ne sera pas activé. # Déterminer si Performance Insights gère le schéma de performance Pour savoir si Performance Insights gère actuellement le schéma de performance pour toutes les versions majeures du moteur prises en charge, consultez le tableau suivant. | Définition du paramètre performance\$1schema | Paramétrage de la colonne Source | Performance Insights gère le schéma de performance | | --- | --- | --- | | 0 | System default | Oui | | 0 ou 1 | Modified | Non | Dans la procédure suivantes, vous déterminez si Performance Insights gère automatiquement le schéma de performance. **Pour déterminer si Performance Insights gère automatiquement le schéma de performance** 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. Choisissez **Groupes de paramètres**. 1. Sélectionnez le nom du groupe de paramètres pour votre instance de base de données. 1. Entrez **performance\$1schema** dans la barre de recherche. 1. Vérifiez que **Source** est la valeur par défaut du système et que le champ **Valeurs** est défini sur **0**. Si c’est le cas, Performance Insights gère automatiquement le schéma de performance. Dans cet exemple, Performance Insights ne gère pas automatiquement le schéma de performance. ![\[Indique que les paramètres du paramètre performance_schema ont été modifiés.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_schema_user.png) # Activation du schéma de performance sur Amazon RDS for MariaDB ou MySQL Supposons que Performance Insights soit activé pour votre instance de base de données ou votre cluster de base de données Multi-AZ mais qu'il ne gère pas actuellement le schéma de performance. Si vous voulez permettre à Performance Insights de gérer automatiquement le schéma de performance, suivez les étapes suivantes. **Pour configurer le schéma de performance pour une gestion automatique** 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. Choisissez **Groupes de paramètres**. 1. Sélectionnez le nom du groupe de paramètres pour votre instance de base de données ou votre cluster de base de données Multi-AZ. 1. Choisissez **Modifier**. 1. Entrez **performance\$1schema** dans la barre de recherche. 1. Sélectionnez le paramètre `performance_schema`. 1. Choisissez **Définir sur la valeur par défaut**. 1. Confirmez en choisissant **Réinitialiser les valeurs par défaut**. 1. Choisissez **Save Changes (Enregistrer les modifications)**. 1. Redémarrage de l'instance de base de données ou du cluster de base de données Multi-AZ. **Important** Chaque fois que vous activez ou désactivez le schéma de performance, veillez à redémarrer l'instance de base de données ou le cluster de base de données Multi-AZ. Pour plus d'informations sur la modification des paramètres 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). Pour plus d’informations sur le tableau de bord, consultez [Analyse des métriques à l’aide du tableau de bord de Performance Insights](USER_PerfInsights.UsingDashboard.md). Pour plus d’informations sur le schéma de performance MySQL, consultez les sections [MySQL Performance Schema](https://dev.mysql.com/doc/refman/8.0/en/performance-schema.html) (pour 8.0) et [MySQL Performance Schema](https://dev.mysql.com/doc/refman/8.4/en/performance-schema.html) (pour 8.4) dans la documentation MySQL. # Configuration des politiques d’accès pour Performance Insights Pour accéder à Performance Insights, un directeur doit disposer des autorisations appropriées auprès de Gestion des identités et des accès AWS (IAM). **Note** Pour utiliser Performance Insights avec une clé gérée par le client, accordez aux utilisateurs les `kms:GenerateDataKey` autorisations `kms:Decrypt` et autorisations associées à votre AWS AWS KMS clé. Accédez à Performance Insights à l'aide des méthodes suivantes : + [Joindre la politique `AmazonRDSPerformanceInsightsReadOnly` gérée pour un accès en lecture seule](USER_PerfInsights.access-control.managed-policy.md) + [Joignez la politique `AmazonRDSPerformanceInsightsFullAccess` gérée pour accéder à toutes les opérations de l'API Performance Insights](USER_PerfInsights.access-control.FullAccess-managed-policy.md) + [Créez une politique IAM personnalisée avec des autorisations spécifiques](USER_PerfInsights.access-control.custom-policy.md) + [Configuration AWS KMS des autorisations pour les données Performance Insights chiffrées](USER_PerfInsights.access-control.cmk-policy.md) + [Configurez un accès détaillé à l'aide d'autorisations au niveau des ressources](USER_PerfInsights.access-control.dimensionAccess-policy.md) + [Utilisez le contrôle d'accès basé sur des balises pour gérer les autorisations via des balises de ressources](USER_PerfInsights.access-control.tag-based-policy.md) # Associer la politique AmazonRDSPerformanceInsightsReadOnly à un principal IAM `AmazonRDSPerformanceInsightsReadOnly`est une politique AWS gérée qui donne accès à toutes les opérations en lecture seule de l'API Amazon RDS Performance Insights. Si vous vous associez `AmazonRDSPerformanceInsightsReadOnly` à un ensemble d'autorisations ou à un rôle, vous devez également associer les CloudWatch autorisations suivantes : + `GetMetricStatistics` + `ListMetrics` + `GetMetricData` Avec ces autorisations, le destinataire peut utiliser Performance Insights avec d'autres fonctionnalités de console. Pour plus d'informations sur CloudWatch les autorisations, consultez la [référence CloudWatch des autorisations Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html). Pour plus d’informations sur `AmazonRDSPerformanceInsightsReadOnly`, consultez [AWS politique gérée : Amazon RDSPerformance InsightsReadOnly](rds-security-iam-awsmanpol.md#rds-security-iam-awsmanpol-AmazonRDSPerformanceInsightsReadOnly). # Associer la politique AmazonRDSPerformanceInsightsFullAccess à un principal IAM `AmazonRDSPerformanceInsightsFullAccess`est une politique AWS gérée qui donne accès à toutes les opérations de l'API Amazon RDS Performance Insights. Si vous vous associez `AmazonRDSPerformanceInsightsFullAccess` à un ensemble d'autorisations ou à un rôle, vous devez également associer les CloudWatch autorisations suivantes : + `GetMetricStatistics` + `ListMetrics` + `GetMetricData` Avec ces autorisations, le destinataire peut utiliser Performance Insights avec d'autres fonctionnalités de console. Pour plus d'informations sur CloudWatch les autorisations, consultez la [référence CloudWatch des autorisations Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html). Pour plus d’informations sur `AmazonRDSPerformanceInsightsFullAccess`, consultez [AWS politique gérée : Amazon RDSPerformance InsightsFullAccess](rds-security-iam-awsmanpol.md#rds-security-iam-awsmanpol-AmazonRDSPerformanceInsightsFullAccess). # Création d’une politique IAM personnalisée pour Performance Insights Pour les utilisateurs qui ne bénéficient pas de la politique `AmazonRDSPerformanceInsightsReadOnly` ou `AmazonRDSPerformanceInsightsFullAccess`, vous pouvez accorder l’accès à l’analyse des performances en créant ou modifiant une politique IAM gérée par l’utilisateur. Quand vous attachez la politique à un jeu d’autorisations ou à un rôle IAM, le destinataire peut utiliser Performance Insights. **Créer une stratégie personnalisée** 1. Ouvrez la console IAM à l’adresse [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Dans le panneau de navigation, choisissez **Politiques**. 1. Choisissez **Create Policy** (Créer une politique). 1. Sur la page **Créer une politique**, choisissez l’option **JSON**. 1. Copiez et collez le texte fourni dans la section du *document de politique JSON* du *Guide de référence des politiques AWS gérées* pour notre politique [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonRDSPerformanceInsightsReadOnly.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonRDSPerformanceInsightsReadOnly.html) ou [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonRDSPerformanceInsightsFullAccess.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonRDSPerformanceInsightsFullAccess.html). 1. Choisissez **Examiner une politique**. 1. Indiquez un nom pour la stratégie et éventuellement une description, puis choisissez **Créer une stratégie**. Vous pouvez désormais attacher la politique à un jeu d’autorisations ou à un rôle. La procédure suivante suppose que vous disposez déjà d’un utilisateur à cette fin. **Pour attacher la politique à un utilisateur** 1. Ouvrez la console IAM à l’adresse [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Dans le panneau de navigation, choisissez **utilisateurs**. 1. Choisissez un utilisateur existant dans la liste. **Important** Pour utiliser Performance Insights, assurez-vous que vous avez accès à Amazon RDS en plus de l’accès à la politique personnalisée. Par exemple, la stratégie prédéfinie `AmazonRDSPerformanceInsightsReadOnly` fournit un accès en lecture seule à Amazon RDS. Pour plus d’informations, consultez [Gestion de l’accès à l’aide de politiques](UsingWithRDS.IAM.md#security_iam_access-manage). 1. Sur la page **Récapitulatif**, choisissez **Ajouter des autorisations**. 1. Choisissez **Attacher directement les stratégies existantes**. Pour **Recherche**, tapez les premiers caractères du nom de votre politique, comme illustré dans l’image suivante. ![\[Choisissez une politique\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf_insights_attach_iam_policy.png) 1. Choisissez votre stratégie, puis sélectionnez **Suivant : Vérification**. 1. Choisissez **Add permissions**. # Modification d'une AWS KMS politique pour Performance Insights Performance Insights utilise un AWS KMS key pour chiffrer les données sensibles. Lorsque vous activez Performance Insights via l’API ou la console, vous pouvez effectuer l’une ou l’autre des opérations suivantes : + Choisissez la valeur par défaut Clé gérée par AWS. Amazon RDS utilise le Clé gérée par AWS pour votre nouvelle instance de base de données. Amazon RDS crée une Clé gérée par AWS pour votre Compte AWS. Vous Compte AWS avez un Amazon RDS différent Clé gérée par AWS pour chacun Région AWS d'entre eux. + Choisissez une clé gérée par le client. Si vous spécifiez une clé gérée par le client, les utilisateurs de votre compte qui appellent l’API Performance Insights ont besoin des autorisations `kms:Decrypt` et `kms:GenerateDataKey` sur la clé KMS. Vous pouvez configurer ces autorisations via des politiques IAM. Toutefois, nous vous recommandons de gérer ces autorisations via votre politique de clé KMS. Pour plus d’informations, consultez [Politiques de clé dans AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html) dans le *Guide du développeur AWS Key Management Service *. **Example** L’exemple suivant montre comment ajouter des instructions à votre politique KMS. Ces instructions permettent d’accéder à Performance Insights. Selon la façon dont vous utilisez la clé KMS, vous pouvez modifier certaines restrictions. Avant d’ajouter des instructions à votre politique, supprimez tous les commentaires. **** ``` { "Version":"2012-10-17", "Id" : "your-policy", "Statement" : [ { "Sid" : "AllowViewingRDSPerformanceInsights", "Effect": "Allow", "Principal": { "AWS": [ "arn:aws:iam::444455556666:role/Role1" ] }, "Action": [ "kms:Decrypt", "kms:GenerateDataKey" ], "Resource": "*", "Condition" : { "StringEquals" : { "kms:ViaService" : "rds.us-east-1.amazonaws.com" }, "ForAnyValue:StringEquals": { "kms:EncryptionContext:aws:pi:service": "rds", "kms:EncryptionContext:service": "pi", "kms:EncryptionContext:aws:rds:db-id": "db-AAAAABBBBBCCCCDDDDDEEEEE" } } } ] } ``` ## Comment Performance Insights utilise les clés gérées par le AWS KMS client L’analyse des performances utilise les clés gérées par le client pour chiffrer les données sensibles. Lorsque vous activez l’analyse des performances, vous pouvez fournir une clé AWS KMS via l’API. Performance Insights crée AWS KMS des autorisations sur cette clé. Il utilise la clé et effectue les opérations nécessaires au traitement des données sensibles. Les données sensibles incluent des champs tels que l’utilisateur, la base de données, l’application et le texte de requête SQL. L’analyse des performances garantit que les données restent chiffrées à la fois au repos et en transit. ## Comment fonctionne Performance Insights IAM AWS KMS IAM accorde des autorisations à des personnes spécifiques APIs. Performance Insights possède le public suivant APIs, que vous pouvez restreindre à l'aide de politiques IAM : + `DescribeDimensionKeys` + `GetDimensionKeyDetails` + `GetResourceMetadata` + `GetResourceMetrics` + `ListAvailableResourceDimensions` + `ListAvailableResourceMetrics` Vous pouvez utiliser les demandes d’API suivantes pour obtenir des données sensibles. + `DescribeDimensionKeys` + `GetDimensionKeyDetails` + `GetResourceMetrics` Lorsque vous utilisez l’API pour obtenir des données sensibles, l’analyse des performances exploite les informations d’identification de l’appelant. Cette vérification garantit que l’accès aux données sensibles est limité aux personnes ayant accès à la clé KMS. Lorsque vous les appelez APIs, vous avez besoin d'autorisations pour appeler l'API via la politique IAM et d'autorisations pour invoquer l'`kms:decrypt`action via la politique AWS KMS clé. L’API `GetResourceMetrics` peut renvoyer des données sensibles et non sensibles. Les paramètres de demande déterminent si la réponse doit inclure des données sensibles. L’API renvoie des données sensibles lorsque la demande inclut une dimension sensible dans les paramètres de filtre ou de regroupement. Pour plus d'informations sur les dimensions que vous pouvez utiliser avec l'`GetResourceMetrics`API, consultez [DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html). **Example Exemples** L’exemple suivant demande les données sensibles pour le groupe `db.user` : ``` POST / HTTP/1.1 Host: Accept-Encoding: identity X-Amz-Target: PerformanceInsightsv20180227.GetResourceMetrics Content-Type: application/x-amz-json-1.1 User-Agent: X-Amz-Date: Authorization: AWS4-HMAC-SHA256 Credential=, SignedHeaders=, Signature= Content-Length: { "ServiceType": "RDS", "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W", "MetricQueries": [ { "Metric": "db.load.avg", "GroupBy": { "Group": "db.user", "Limit": 2 } } ], "StartTime": 1693872000, "EndTime": 1694044800, "PeriodInSeconds": 86400 } ``` **Example** L’exemple suivant demande les données non sensibles pour la métrique `db.load.avg` : ``` POST / HTTP/1.1 Host: Accept-Encoding: identity X-Amz-Target: PerformanceInsightsv20180227.GetResourceMetrics Content-Type: application/x-amz-json-1.1 User-Agent: X-Amz-Date: Authorization: AWS4-HMAC-SHA256 Credential=, SignedHeaders=, Signature= Content-Length: { "ServiceType": "RDS", "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W", "MetricQueries": [ { "Metric": "db.load.avg" } ], "StartTime": 1693872000, "EndTime": 1694044800, "PeriodInSeconds": 86400 } ``` # Octroi d’accès affiné pour Performance Insights Le contrôle d’accès affiné offre des moyens supplémentaires de contrôler l’accès à vos données sur Performance Insights. Ce contrôle d’accès permet d’autoriser ou de refuser l’accès à des dimensions individuelles pour les actions Performance Insights `GetResourceMetrics`, `DescribeDimensionKeys` et `GetDimensionKeyDetails`. Pour utiliser un accès affiné, spécifiez les dimensions dans la politique IAM à l’aide de clés de condition. L’évaluation de l’accès suit la logique d’évaluation de la politique IAM. Pour plus d’informations, consultez [Logique d’évaluation des politiques](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_evaluation-logic.html) dans le *Guide de l’utilisateur IAM*. Si la déclaration de politique IAM ne spécifie aucune dimension, elle contrôle l’accès à toutes les dimensions pour l’action spécifiée. Pour obtenir la liste des dimensions disponibles, consultez [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html). Pour connaître les dimensions auxquelles vos informations d’identification sont autorisées à accéder, utilisez le paramètre `AuthorizedActions` dans `ListAvailableResourceDimensions` et spécifiez l’action. Les valeurs autorisées pour `AuthorizedActions` sont les suivantes : + `GetResourceMetrics` + `DescribeDimensionKeys` + `GetDimensionKeyDetails` Par exemple, si vous spécifiez `GetResourceMetrics` pour le paramètre `AuthorizedActions`, `ListAvailableResourceDimensions` renvoie la liste des dimensions auxquelles l’action `GetResourceMetrics` est autorisée à accéder. Si vous spécifiez plusieurs actions dans le paramètre `AuthorizedActions`, il `ListAvailableResourceDimensions` renvoie une intersection de dimensions auxquelles ces actions sont autorisées à accéder. **Example** L’exemple suivant fournit l’accès aux dimensions pour les actions `GetResourceMetrics` et `DescribeDimensionKeys`. **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowToDiscoverDimensions", "Effect": "Allow", "Action": [ "pi:ListAvailableResourceDimensions" ], "Resource": [ "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W" ] }, { "Sid": "SingleAllow", "Effect": "Allow", "Action": [ "pi:GetResourceMetrics", "pi:DescribeDimensionKeys" ], "Resource": [ "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W" ], "Condition": { "ForAllValues:StringEquals": { "pi:Dimensions": [ "db.sql_tokenized.id", "db.sql_tokenized.statement" ] } } } ] } ``` Voici la réponse pour la dimension demandée : ``` // ListAvailableResourceDimensions API // Request { "ServiceType": "RDS", "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W", "Metrics": [ "db.load" ], "AuthorizedActions": ["DescribeDimensionKeys"] } // Response { "MetricDimensions": [ { "Metric": "db.load", "Groups": [ { "Group": "db.sql_tokenized", "Dimensions": [ { "Identifier": "db.sql_tokenized.id" }, // { "Identifier": "db.sql_tokenized.db_id" }, // not included because not allows in the IAM Policy { "Identifier": "db.sql_tokenized.statement" } ] } ] } ] } ``` L’exemple suivant indique une autorisation et deux refus d’accès pour les dimensions. **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowToDiscoverDimensions", "Effect": "Allow", "Action": [ "pi:ListAvailableResourceDimensions" ], "Resource": [ "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W" ] }, { "Sid": "O01AllowAllWithoutSpecifyingDimensions", "Effect": "Allow", "Action": [ "pi:GetResourceMetrics", "pi:DescribeDimensionKeys" ], "Resource": [ "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W" ] }, { "Sid": "O01DenyAppDimensionForAll", "Effect": "Deny", "Action": [ "pi:GetResourceMetrics", "pi:DescribeDimensionKeys" ], "Resource": [ "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W" ], "Condition": { "ForAnyValue:StringEquals": { "pi:Dimensions": [ "db.application.name" ] } } }, { "Sid": "O01DenySQLForGetResourceMetrics", "Effect": "Deny", "Action": [ "pi:GetResourceMetrics" ], "Resource": [ "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W" ], "Condition": { "ForAnyValue:StringEquals": { "pi:Dimensions": [ "db.sql_tokenized.statement" ] } } } ] } ``` Voici les réponses pour les dimensions demandées : ``` // ListAvailableResourceDimensions API // Request { "ServiceType": "RDS", "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W", "Metrics": [ "db.load" ], "AuthorizedActions": ["GetResourceMetrics"] } // Response { "MetricDimensions": [ { "Metric": "db.load", "Groups": [ { "Group": "db.application", "Dimensions": [ // removed from response because denied by the IAM Policy // { "Identifier": "db.application.name" } ] }, { "Group": "db.sql_tokenized", "Dimensions": [ { "Identifier": "db.sql_tokenized.id" }, { "Identifier": "db.sql_tokenized.db_id" }, // removed from response because denied by the IAM Policy // { "Identifier": "db.sql_tokenized.statement" } ] }, ... ] } ] } ``` ``` // ListAvailableResourceDimensions API // Request { "ServiceType": "RDS", "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W", "Metrics": [ "db.load" ], "AuthorizedActions": ["DescribeDimensionKeys"] } // Response { "MetricDimensions": [ { "Metric": "db.load", "Groups": [ { "Group": "db.application", "Dimensions": [ // removed from response because denied by the IAM Policy // { "Identifier": "db.application.name" } ] }, { "Group": "db.sql_tokenized", "Dimensions": [ { "Identifier": "db.sql_tokenized.id" }, { "Identifier": "db.sql_tokenized.db_id" }, // allowed for DescribeDimensionKeys because our IAM Policy // denies it only for GetResourceMetrics { "Identifier": "db.sql_tokenized.statement" } ] }, ... ] } ] } ``` # Utilisation du contrôle d'accès basé sur des balises pour Performance Insights Vous pouvez contrôler l'accès aux métriques de Performance Insights à l'aide de balises héritées de l'instance de base de données parent. Pour contrôler l'accès aux opérations Performance Insights, utilisez les politiques IAM. Ces politiques peuvent vérifier les balises de votre instance de base de données pour déterminer les autorisations. ## Comment les tags fonctionnent avec Performance Insights Performance Insights applique automatiquement les balises de votre instance de base de données pour autoriser les métriques Performance Insights. Lorsque vous ajoutez des balises à votre instance de base de données, vous pouvez immédiatement les utiliser pour contrôler l'accès aux données Performance Insights. + Pour ajouter ou mettre à jour des balises pour les métriques Performance Insights, modifiez les balises de votre instance de base de données. + Pour consulter les balises des métriques Performance Insights, faites appel `ListTagsForResource` à la ressource métrique Performance Insights. Il renverra les balises de l'instance de base de données associée à la métrique. **Note** Les `UntagResource` opérations `TagResource` et renvoient une erreur si vous essayez de les utiliser directement sur les métriques Performance Insights. ## Création de politiques IAM basées sur des balises Pour contrôler l'accès aux opérations Performance Insights, utilisez la clé de `aws:ResourceTag` condition dans vos politiques IAM. Ces politiques vérifient les balises de votre instance de base de données. **Example** Cette politique empêche l'accès aux métriques Performance Insights pour les bases de données de production. La politique interdit l'`pi:GetResourceMetrics`opération dans Performance Insights pour toute ressource de base de données étiquetée avec`env:prod`. ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Deny", "Action": "pi:GetResourceMetrics", "Resource": "*", "Condition": { "StringEquals": { "aws:ResourceTag/env": "prod" } } } ] } ``` # Analyse des métriques à l’aide du tableau de bord de Performance Insights **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 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 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) 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) 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 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 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 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 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 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 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 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 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 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 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 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) 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 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 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)] 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 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 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 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 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 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 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 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 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 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 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 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 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. # Affichage des recommandations proactives de Performance Insights Analyse des performances d’Amazon RDS surveille des indicateurs spécifiques et crée automatiquement des seuils en analysant les niveaux susceptibles de poser problème pour une ressource spécifique. Lorsque les nouvelles valeurs métriques dépassent un seuil prédéfini sur une période donnée, Performance Insights génère une recommandation proactive. Cette recommandation permet d’éviter tout impact futur sur les performances de la base de données. Pour bénéficier de ces recommandations proactives, vous devez activer Performance Insights avec une période de conservation payante. 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 en savoir plus sur la tarification et la conservation des données pour Performance Insights, consultez [Tarification et conservation des données pour Performance Insights](USER_PerfInsights.Overview.cost.md). Pour connaître les régions, les moteurs de base de données et les classes d’instance pris en charge pour les recommandations proactives, 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). Vous pouvez afficher l’analyse détaillée et les investigations recommandées concernant les recommandations proactives sur la page de détails des recommandations. Pour plus d’informations sur les recommandations, consultez [Recommandations d’Amazon RDS](monitoring-recommendations.md). **Pour afficher l’analyse détaillée d’une recommandation proactive** 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, effectuez l’une des opérations suivantes : + Choisissez **Recommandations**. La page **Recommandations** affiche une liste de recommandations triées par gravité pour toutes les ressources de votre compte. + Dans la page des bases de données, choisissez **Bases de données**, puis **Recommandations** pour une ressource. L’onglet **Recommandations** affiche les recommandations et leurs détails pour la ressource sélectionnée. 1. Trouvez une recommandation proactive et choisissez **Afficher les détails**. La page des détails de la recommandation s’affiche. Le titre indique le nom de la ressource concernée ainsi que le problème détecté et sa gravité. Les composants de la page de détails des recommandations sont les suivants : + **Résumé des recommandations** : problème détecté, statut de la recommandation et du problème, heure de début et de fin du problème, heure de modification de la recommandation et type de moteur. ![\[Page Détails de la recommandation pour la recommandation proactive affichant la section Récapitulatif de la recommandation dans la console\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/RecommendationProactive-RecSummary.png) + **Métriques** : graphiques du problème détecté. Chaque graphique affiche un seuil déterminé par le comportement de base de la ressource et les données de la métrique rapportées depuis le début du problème. ![\[Page Détails de la recommandation pour la recommandation proactive affichant la section Métriques dans la console\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/RecommedationProactive_Metrics.png) + **Analyse et recommandations** : recommandation et motif de la recommandation suggérée. ![\[Page Détails de la recommandation pour la recommandation proactive affichant la section Analyse et recommandations dans la console\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/ProactiveRecommendation-AnalysisAndRec.png) Vous pouvez examiner la cause du problème, puis exécuter les actions recommandées pour résoudre le problème, ou choisir **Ignorer** dans le coin supérieur droit pour ignorer la recommandation. # Récupération de métriques avec l’API Performance Insights pour Amazon RDS Lorsque l'analyse des performances est activée, l'API fournit une visibilité sur les performances des instances. Amazon CloudWatch Logs fournit la source faisant autorité pour les métriques de surveillance vendues pour les services AWS. Performance Insights offre une vue spécifique au domaine de la charge de base de données mesurée en tant que moyenne des sessions actives (AAS). Cette métrique est présentée aux consommateurs de l'API sous la forme d'un ensemble de données de série chronologique bidimensionnel. La dimension temporelle des données fournit les données de charge de la base de données pour chaque point temporel de la plage de temps interrogée. Chaque point dans te temps décompose la charge globale par rapport aux dimensions demandées, par exemple, `SQL`, `Wait-event`, `User` ou `Host`, mesurée à ce point dans le temps. Amazon RDS Performance Insights surveille votre instance de base de données Amazon RDS pour vous permettre d'analyser les performances de votre base de données et de résoudre les problèmes associés. Vous pouvez consulter les données de Performance Insights dans AWS Management Console. Performance Insights fournit également une API publique qui vous permet d'interroger vos propres données. Vous pouvez utiliser l'API pour effectuer les opérations suivantes : + Déchargement des données dans une base de données + Ajout de données Performance Insights aux tableaux de bord de surveillance existants + Création d'outils de surveillance Pour utiliser l'API Performance Insights, activez Performance Insights sur l'une de vos instances de base de données Amazon RDS. 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 plus d’informations sur l’API Performance Insights, consultez la [Référence d’API Amazon RDS Performance Insights](https://docs.aws.amazon.com/performance-insights/latest/APIReference/Welcome.html). L'API Performance Insights fournit les opérations suivantes. **** | Action Performance Insights | AWS CLI commande | Description | | --- | --- | --- | | [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_CreatePerformanceAnalysisReport.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_CreatePerformanceAnalysisReport.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/CreatePerformanceAnalysisReport.html](https://docs.aws.amazon.com/cli/latest/reference/pi/CreatePerformanceAnalysisReport.html) | Crée un rapport d'analyse des performances pour une période spécifique pour l'instance de base de données. Le résultat est `AnalysisReportId` qui est l'identifiant unique du rapport. | | [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DeletePerformanceAnalysisReport.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DeletePerformanceAnalysisReport.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/DeletePerformanceAnalysisReport.html](https://docs.aws.amazon.com/cli/latest/reference/pi/DeletePerformanceAnalysisReport.html) | Supprime un rapport d'analyse des performances. | | [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DescribeDimensionKeys.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DescribeDimensionKeys.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/describe-dimension-keys.html](https://docs.aws.amazon.com/cli/latest/reference/pi/describe-dimension-keys.html) | Récupère les N premières clés de dimension d'une mesure sur une période spécifique. | | [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetDimensionKeyDetails.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetDimensionKeyDetails.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/get-dimension-key-details.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-dimension-key-details.html) | Récupère les attributs du groupe de dimensions spécifié pour une instance de base de données ou une source de données. Par exemple, si vous spécifiez un ID SQL et si les détails de la dimension sont disponibles, `GetDimensionKeyDetails` récupère le texte intégral de la dimension `db.sql.statement` associée à cet ID. Cette opération est utile, car `GetResourceMetrics` et `DescribeDimensionKeys` ne prennent pas en charge la récupération de texte d’instruction SQL volumineux. | | [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetPerformanceAnalysisReport.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetPerformanceAnalysisReport.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/GetPerformanceAnalysisReport.html](https://docs.aws.amazon.com/cli/latest/reference/pi/GetPerformanceAnalysisReport.html) | Récupère le rapport, y compris les informations du rapport. Le résultat inclut l'état du rapport, l'ID du rapport, les détails temporels du rapport, les informations et les recommandations. | | [GetResourceMetadata](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetResourceMetadata.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metadata.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metadata.html) | Récupérez les métadonnées de différentes fonctions. Par exemple, les métadonnées peuvent indiquer qu'une fonction est activée ou désactivée sur une instance de base de données spécifique. | | [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetResourceMetrics.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetResourceMetrics.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html) | Récupère les métriques Performance Insights d'un ensemble de sources de données, au cours d'une période. Vous pouvez fournir des groupes de dimensions et des dimensions spécifiques, ainsi que des critères d'agrégation et de filtrage, pour chaque groupe. | | [ListAvailableResourceDimensions](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListAvailableResourceDimensions.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-dimensions.html](https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-dimensions.html) | Récupérez les dimensions pouvant être interrogées pour chaque type de métrique spécifié sur une instance spécifiée. | | [ListAvailableResourceMetrics](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListAvailableResourceMetrics.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-metrics.html) | Récupérez toutes les métriques disponibles des types de métriques spécifiés pouvant être interrogés pour une instance de base de données spécifiée. | | `[ListPerformanceAnalysisReports](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListPerformanceAnalysisReports.html)` | [https://docs.aws.amazon.com/cli/latest/reference/pi/list-performance-analysis-reports.html](https://docs.aws.amazon.com/cli/latest/reference/pi/list-performance-analysis-reports.html) | Récupère tous les rapports d'analyse disponibles pour l'instance de base de données. Les rapports sont répertoriés en fonction de l'heure de début de chaque rapport. | | `[ListTagsForResource](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListTagsForResource.html)` | [https://docs.aws.amazon.com/cli/latest/reference/pi/list-tags-for-resource.html](https://docs.aws.amazon.com/cli/latest/reference/pi/list-tags-for-resource.html) | Répertorie toutes les balises de métadonnées ajoutées à la ressource. La liste inclut le nom et la valeur de la balise. | | `[TagResource](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_TagResource.html)` | [https://docs.aws.amazon.com/cli/latest/reference/pi/tag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/pi/tag-resource.html) | Ajoute des balises de métadonnées à la ressource Amazon RDS. La balise inclut un nom et une valeur. | | `[UntagResource](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_UntagResource.html)` | [https://docs.aws.amazon.com/cli/latest/reference/pi/untag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/pi/untag-resource.html) | Supprime la balise de métadonnées de la ressource. | Pour plus d’informations sur la récupération des métriques de séries chronologiques et des exemples d’AWS CLI pour Performance Insights, consultez les rubriques ci-dessous. **Topics** + [ # Récupération de métriques de séries chronologiques pour Performance Insights ](USER_PerfInsights.API.TimeSeries.md) + [ # AWS CLI exemples de Performance Insights ](USER_PerfInsights.API.Examples.md) # Récupération de métriques de séries chronologiques pour Performance Insights L'opération `GetResourceMetrics` récupère une ou plusieurs métriques de série chronologique à partir des données de Performance Insights. `GetResourceMetrics` exige une métrique et une période, et renvoie une réponse contenant la liste des points de données. Par exemple, AWS Management Console utilise `GetResourceMetrics` pour renseigner le graphique **Counter Metrics (Métriques de compteur)** et le graphique **Database Load (Charge de base de données)**, comme illustré dans l'image ci-dessous. ![\[Graphiques Counter Metrics (Métriques de compteur) et Database Load (Charge de base de données)\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf-insights-api-charts.png) Toutes les métriques renvoyées par `GetResourceMetrics` sont des métriques de série chronologique standard, à l'exception de `db.load`. Elle apparaît dans le graphique **Database Load** (Charge de base de données). La métrique `db.load` est différente des autres métriques de séries chronologiques, car vous pouvez la décomposer en sous-composants appelés *dimensions*. Dans l'image précédente, `db.load` est décomposé et regroupé en fonction des états d'attente qui constituent `db.load`. **Note** `GetResourceMetrics` peut également renvoyer la métrique `db.sampleload`, mais la métrique `db.load` est appropriée dans la plupart des cas. Pour plus d’informations sur les métriques de compteur renvoyées par `GetResourceMetrics`, consultez [Métrique de compteur de Performance Insights](USER_PerfInsights_Counters.md). Les calculs suivants sont pris en charge pour les métriques : + Moyenne – Moyenne de la métrique sur une période. Ajoutez `.avg` au nom de la métrique. + Minimum – Valeur minimale de la métrique sur une période. Ajoutez `.min` au nom de la métrique. + Maximum – Valeur maximale de la métrique sur une période. Ajoutez `.max` au nom de la métrique. + Somme – Somme des valeurs de la métrique sur une période. Ajoutez `.sum` au nom de la métrique. + Nombre échantillon – Nombre de fois où la métrique a été collectée sur une période. Ajoutez `.sample_count` au nom de la métrique. Par exemple, supposons qu'une métrique soit collectée pendant 300 secondes (5 minutes) et qu'elle soit collectée une fois toutes les minutes. Les valeurs pour chaque minute sont 1, 2, 3, 4 et 5. Dans ce cas, les calculs suivants sont renvoyés : + Moyenne – 3 + Minimum – 1 + Maximum – 5 + Somme – 15 + Nombre échantillon – 5 Pour plus d'informations sur l'utilisation de la commande AWS CLI `get-resource-metrics`, consultez [https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html). Pour l'option `--metric-queries`, spécifiez une ou plusieurs requêtes pour lesquelles vous souhaitez obtenir les résultats. Chaque requête se compose d'un paramètre `Metric` obligatoire et des paramètres `GroupBy` et `Filter` facultatifs. Voici un exemple de spécification de l'option `--metric-queries`. ``` { "Metric": "string", "GroupBy": { "Group": "string", "Dimensions": ["string", ...], "Limit": integer }, "Filter": {"string": "string" ...} ``` # AWS CLI exemples de Performance Insights Dans les sections suivantes, découvrez le AWS Command Line Interface (AWS CLI) pour Performance Insights et des AWS CLI exemples d'utilisation. **Topics** + [ ## Aide intégrée AWS CLI pour Performance Insights ](#USER_PerfInsights.API.CLI) + [ ## Récupération de métriques de compteur ](#USER_PerfInsights.API.Examples.CounterMetrics) + [ ## Récupération de la charge de base de données moyenne pour les principaux événements d’attente ](#USER_PerfInsights.API.Examples.DBLoadAverage) + [ ## Récupération de la charge de base de données moyenne pour les principales instructions SQL ](#USER_PerfInsights.API.Examples.DBLoadAverageTop10SQL) + [ ## Récupération de la charge de base de données moyenne filtrée par instruction SQL ](#USER_PerfInsights.API.Examples.DBLoadAverageFilterBySQL) + [ ## Récupération du texte complet d’une instruction SQL ](#USER_PerfInsights.API.Examples.GetDimensionKeyDetails) + [ ## Création d’un rapport d’analyse des performances pour une période donnée ](#USER_PerfInsights.API.Examples.CreatePerfAnalysisReport) + [ ## Récupération d’un rapport d’analyse des performances ](#USER_PerfInsights.API.Examples.GetPerfAnalysisReport) + [ ## Établissement de la liste de tous les rapports d’analyse des performances pour l’instance de base de données ](#USER_PerfInsights.API.Examples.ListPerfAnalysisReports) + [ ## Suppression d’un rapport d’analyse des performances ](#USER_PerfInsights.API.Examples.DeletePerfAnalysisReport) + [ ## Ajout d’une balise à un rapport d’analyse des performances ](#USER_PerfInsights.API.Examples.TagPerfAnalysisReport) + [ ## Établissement de la liste de toutes les balises pour un rapport d’analyse des performances ](#USER_PerfInsights.API.Examples.ListTagsPerfAnalysisReport) + [ ## Suppression des balises d’un rapport d’analyse des performances ](#USER_PerfInsights.API.Examples.UntagPerfAnalysisReport) ## Aide intégrée AWS CLI pour Performance Insights Vous pouvez consulter les données de Performance Insights à l’aide d AWS CLI. Vous pouvez consulter l'aide relative aux AWS CLI commandes de Performance Insights en saisissant ce qui suit sur la ligne de commande. ``` aws pi help ``` Si ce n'est pas le AWS CLI cas, reportez-vous à la section [Installation du AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) *guide de l'AWS CLI utilisateur* pour plus d'informations sur son installation. ## Récupération de métriques de compteur L’image suivante illustre deux graphiques de métriques de compteur dans AWS Management Console. ![\[Graphiques Counter Metrics (Métriques de compteur).\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf-insights-api-counters-charts.png) L'exemple suivant montre comment collecter les mêmes données que celles AWS Management Console utilisées pour générer les deux graphiques contre-métriques. Pour Linux, macOS ou Unix : ``` aws pi get-resource-metrics \ --service-type RDS \ --identifier db-ID \ --start-time 2018-10-30T00:00:00Z \ --end-time 2018-10-30T01:00:00Z \ --period-in-seconds 60 \ --metric-queries '[{"Metric": "os.cpuUtilization.user.avg" }, {"Metric": "os.cpuUtilization.idle.avg"}]' ``` Pour Windows : ``` aws pi get-resource-metrics ^ --service-type RDS ^ --identifier db-ID ^ --start-time 2018-10-30T00:00:00Z ^ --end-time 2018-10-30T01:00:00Z ^ --period-in-seconds 60 ^ --metric-queries '[{"Metric": "os.cpuUtilization.user.avg" }, {"Metric": "os.cpuUtilization.idle.avg"}]' ``` Vous pouvez également simplifier la lecture d’une commande en spécifiant un fichier pour l’option `--metrics-query`. L’exemple suivant utilise un fichier nommé query.json pour l’option. Le contenu du fichier est le suivant. ``` [ { "Metric": "os.cpuUtilization.user.avg" }, { "Metric": "os.cpuUtilization.idle.avg" } ] ``` Exécutez la commande suivante pour utiliser le fichier. Pour Linux, macOS ou Unix : ``` aws pi get-resource-metrics \ --service-type RDS \ --identifier db-ID \ --start-time 2018-10-30T00:00:00Z \ --end-time 2018-10-30T01:00:00Z \ --period-in-seconds 60 \ --metric-queries file://query.json ``` Pour Windows : ``` aws pi get-resource-metrics ^ --service-type RDS ^ --identifier db-ID ^ --start-time 2018-10-30T00:00:00Z ^ --end-time 2018-10-30T01:00:00Z ^ --period-in-seconds 60 ^ --metric-queries file://query.json ``` L’exemple précédent spécifie les valeurs suivantes pour les options : + `--service-type` – `RDS` pour Amazon RDS + `--identifier` : ID de ressource de l’instance de base de données + `--start-time` et `--end-time` : valeurs `DateTime` conformes à l’ISO 8601 pour la période à interroger, avec plusieurs formats pris en charge L’interrogation se déroule pendant un intervalle d’une heure : + `--period-in-seconds` – `60` pour une requête toutes les minutes + `--metric-queries` : tableau de deux requêtes s’appliquant chacune à une métrique. Le nom de la métrique utilise des points pour classifier la métrique dans une catégorie utile, l’élément final étant une fonction. Dans l’exemple, la fonction est `avg` pour chaque requête. Comme pour Amazon CloudWatch, les fonctions prises en charge sont `min``max`,`total`, et`avg`. La réponse ressemble à ce qui suit. ``` { "Identifier": "db-XXX", "AlignedStartTime": 1540857600.0, "AlignedEndTime": 1540861200.0, "MetricList": [ { //A list of key/datapoints "Key": { "Metric": "os.cpuUtilization.user.avg" //Metric1 }, "DataPoints": [ //Each list of datapoints has the same timestamps and same number of items { "Timestamp": 1540857660.0, //Minute1 "Value": 4.0 }, { "Timestamp": 1540857720.0, //Minute2 "Value": 4.0 }, { "Timestamp": 1540857780.0, //Minute 3 "Value": 10.0 } //... 60 datapoints for the os.cpuUtilization.user.avg metric ] }, { "Key": { "Metric": "os.cpuUtilization.idle.avg" //Metric2 }, "DataPoints": [ { "Timestamp": 1540857660.0, //Minute1 "Value": 12.0 }, { "Timestamp": 1540857720.0, //Minute2 "Value": 13.5 }, //... 60 datapoints for the os.cpuUtilization.idle.avg metric ] } ] //end of MetricList } //end of response ``` La réponse contient les éléments `Identifier`, `AlignedStartTime` et `AlignedEndTime`. Étant donné que la valeur de `--period-in-seconds` était définie sur `60`, les heures de début et de fin ont été arrondies à la minute près. Si `--period-in-seconds` était défini sur `3600`, les heures de début et de fin auraient été arrondies à l’heure près. L’élément `MetricList` dans la réponse comporte un certain nombre d’entrées, chacune associée à une entrée `Key` et `DataPoints`. Chaque élément `DataPoint` comporte une entrée `Timestamp` et `Value`. Chaque liste `Datapoints` répertorie 60 points de données, car les requêtes sont exécutées toutes les minutes pendant une heure, avec `Timestamp1/Minute1`, `Timestamp2/Minute2`, etc. jusqu’à `Timestamp60/Minute60`. Étant donné que la requête s’applique à deux métriques de compteur différentes, contient deux élément `MetricList`. ## Récupération de la charge de base de données moyenne pour les principaux événements d’attente L'exemple suivant est la même requête que celle AWS Management Console utilisée pour générer un graphique linéaire à aires empilées. Il récupère la valeur de `db.load.avg` sur la dernière heure en divisant la charge conformément aux sept principaux événements d’attente. La commande est identique à la commande de la rubrique [Récupération de métriques de compteur](#USER_PerfInsights.API.Examples.CounterMetrics). Le contenu du fichier query.json est cependant différent : ``` [ { "Metric": "db.load.avg", "GroupBy": { "Group": "db.wait_event", "Limit": 7 } } ] ``` Exécutez la commande suivante. Pour Linux, macOS ou Unix : ``` aws pi get-resource-metrics \ --service-type RDS \ --identifier db-ID \ --start-time 2018-10-30T00:00:00Z \ --end-time 2018-10-30T01:00:00Z \ --period-in-seconds 60 \ --metric-queries file://query.json ``` Pour Windows : ``` aws pi get-resource-metrics ^ --service-type RDS ^ --identifier db-ID ^ --start-time 2018-10-30T00:00:00Z ^ --end-time 2018-10-30T01:00:00Z ^ --period-in-seconds 60 ^ --metric-queries file://query.json ``` L’exemple spécifie la métrique de `db.load.avg` et exécute une action `GroupBy` pour les sept principaux événements d’attente. Pour plus de détails sur les valeurs valides pour cet exemple, consultez [DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html)le manuel *Performance Insights API Reference.* La réponse ressemble à ce qui suit. ``` { "Identifier": "db-XXX", "AlignedStartTime": 1540857600.0, "AlignedEndTime": 1540861200.0, "MetricList": [ { //A list of key/datapoints "Key": { //A Metric with no dimensions. This is the total db.load.avg "Metric": "db.load.avg" }, "DataPoints": [ //Each list of datapoints has the same timestamps and same number of items { "Timestamp": 1540857660.0, //Minute1 "Value": 0.5166666666666667 }, { "Timestamp": 1540857720.0, //Minute2 "Value": 0.38333333333333336 }, { "Timestamp": 1540857780.0, //Minute 3 "Value": 0.26666666666666666 } //... 60 datapoints for the total db.load.avg key ] }, { "Key": { //Another key. This is db.load.avg broken down by CPU "Metric": "db.load.avg", "Dimensions": { "db.wait_event.name": "CPU", "db.wait_event.type": "CPU" } }, "DataPoints": [ { "Timestamp": 1540857660.0, //Minute1 "Value": 0.35 }, { "Timestamp": 1540857720.0, //Minute2 "Value": 0.15 }, //... 60 datapoints for the CPU key ] }, //... In total we have 8 key/datapoints entries, 1) total, 2-8) Top Wait Events ] //end of MetricList } //end of response ``` Dans cette réponse, comporte huit entrée `MetricList`. Une entrée s’applique à la valeur totale de `db.load.avg` et les sept autres entrées s’appliquent à chacune des valeurs de `db.load.avg` divisées conformément à l’un des sept principaux événements d’attente. Contrairement au premier exemple qui comportait une dimension de regroupement, cet exemple doit définir un élément Key pour chaque regroupement de la métrique. Un seul élément Key peut être associé à chaque métrique, comme dans le cas d’utilisation de la métrique de compteur de base. ## Récupération de la charge de base de données moyenne pour les principales instructions SQL L’exemple suivant regroupe `db.wait_events` par les 10 principales instructions SQL. Il existe deux groupes différents pour les instructions SQL : + `db.sql` – Instruction SQL complète, telle que `select * from customers where customer_id = 123` + `db.sql_tokenized` – Instruction SQL tokenisée, telle que `select * from customers where customer_id = ?` Lors de l’analyse des performances de base de données, il peut s’avérer utile de considérer les instructions SQL dont les paramètres sont différents comme un seul élément logique. Vous pouvez donc utiliser `db.sql_tokenized` lors de l’interrogation. Toutefois, en particulier si vous êtes intéressé par les plans d’explication, il est parfois plus utile d’examiner les instructions SQL complètes avec leurs paramètres, et le regroupement des requêtes par `db.sql`. Il existe une relation parent-enfant entre une instruction SQL tokenisée et une instruction SQL complète, où plusieurs instructions SQL complètes (enfants) sont regroupées sous la même instruction SQL tokenisée (parent). La commande illustrée dans cet exemple est identique à la commande de la rubrique [Récupération de la charge de base de données moyenne pour les principaux événements d’attente](#USER_PerfInsights.API.Examples.DBLoadAverage). Le contenu du fichier query.json est cependant différent : ``` [ { "Metric": "db.load.avg", "GroupBy": { "Group": "db.sql_tokenized", "Limit": 10 } } ] ``` L’exemple suivant utilise `db.sql_tokenized`. Pour Linux, macOS ou Unix : ``` aws pi get-resource-metrics \ --service-type RDS \ --identifier db-ID \ --start-time 2018-10-29T00:00:00Z \ --end-time 2018-10-30T00:00:00Z \ --period-in-seconds 3600 \ --metric-queries file://query.json ``` Pour Windows : ``` aws pi get-resource-metrics ^ --service-type RDS ^ --identifier db-ID ^ --start-time 2018-10-29T00:00:00Z ^ --end-time 2018-10-30T00:00:00Z ^ --period-in-seconds 3600 ^ --metric-queries file://query.json ``` Cet exemple demande plus de 24 heures, avec une heure period-in-seconds. L’exemple spécifie la métrique de `db.load.avg` et exécute une action `GroupBy` pour les sept principaux événements d’attente. Pour plus de détails sur les valeurs valides pour cet exemple, consultez [DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html)le manuel *Performance Insights API Reference.* La réponse ressemble à ce qui suit. ``` { "AlignedStartTime": 1540771200.0, "AlignedEndTime": 1540857600.0, "Identifier": "db-XXX", "MetricList": [ //11 entries in the MetricList { "Key": { //First key is total "Metric": "db.load.avg" } "DataPoints": [ //Each DataPoints list has 24 per-hour Timestamps and a value { "Value": 1.6964980544747081, "Timestamp": 1540774800.0 }, //... 24 datapoints ] }, { "Key": { //Next key is the top tokenized SQL "Dimensions": { "db.sql_tokenized.statement": "INSERT INTO authors (id,name,email) VALUES\n( nextval(?) ,?,?)", "db.sql_tokenized.db_id": "pi-2372568224", "db.sql_tokenized.id": "AKIAIOSFODNN7EXAMPLE" }, "Metric": "db.load.avg" }, "DataPoints": [ //... 24 datapoints ] }, // In total 11 entries, 10 Keys of top tokenized SQL, 1 total key ] //End of MetricList } //End of response ``` Cette réponse comporte 11 entrées dans `MetricList` (1 correspondant au total, les 10 autres correspondant aux principales instructions SQL tokenisées), chaque entrée étant associée à 24 `DataPoints` par heure. Pour les instructions SQL tokenisées, chaque liste de dimensions répertorie trois entrées : + `db.sql_tokenized.statement` – Instruction SQL tokenisée. + `db.sql_tokenized.db_id ` : ID de base de données native utilisé pour faire référence à l’instruction SQL, ou ID synthétique généré par Performance Insights si l’ID de base de données native n’est pas disponible. Cet exemple renvoie l’ID synthétique `pi-2372568224`. + `db.sql_tokenized.id` – ID de la requête dans Performance Insights. Dans le AWS Management Console, cet ID est appelé Support ID. Il est nommé ainsi parce que l'ID est une donnée que le AWS Support peut examiner pour vous aider à résoudre un problème lié à votre base de données. AWS prend très au sérieux la sécurité et la confidentialité de vos données, et presque toutes les données sont stockées cryptées avec votre AWS KMS clé. Par conséquent, personne à l'intérieur ne AWS peut consulter ces données. Dans l’exemple précédent, `tokenized.statement` et `tokenized.db_id` sont tous les deux stockés sous forme chiffrée. Si vous rencontrez un problème avec votre base de données, le AWS Support peut vous aider en faisant référence à l'ID de support. Lors de l’interrogation, il peut s’avérer utile de spécifier une entrée `Group` dans `GroupBy`. Toutefois, pour contrôler les données renvoyées de manière plus précise, spécifier la liste des dimensions. Par exemple, si `db.sql_tokenized.statement` est le seul élément nécessaire, un attribut `Dimensions` peut être ajouté au fichier query.json. ``` [ { "Metric": "db.load.avg", "GroupBy": { "Group": "db.sql_tokenized", "Dimensions":["db.sql_tokenized.statement"], "Limit": 10 } } ] ``` ## Récupération de la charge de base de données moyenne filtrée par instruction SQL ![\[Graphique de filtrage par instruction SQL.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf-insights-api-filter-chart.png) L’image précédente indique qu’une requête particulière est sélectionnée et que le graphique en aires empilées Average active sessions (Sessions actives en moyenne) qui apparaît dans la section supérieure s’y applique. Bien que la requête concerne toujours les sept principaux événements d’attente globaux, la valeur de la réponse est filtrée. Le filtre permet à la requête de prendre uniquement en compte les sessions qui correspondent à un filtre en particulier. La requête d’API correspondante illustrée dans cet exemple est identique à la commande de la rubrique [Récupération de la charge de base de données moyenne pour les principales instructions SQL](#USER_PerfInsights.API.Examples.DBLoadAverageTop10SQL). Le contenu du fichier query.json est cependant différent : ``` [ { "Metric": "db.load.avg", "GroupBy": { "Group": "db.wait_event", "Limit": 5 }, "Filter": { "db.sql_tokenized.id": "AKIAIOSFODNN7EXAMPLE" } } ] ``` Pour Linux, macOS ou Unix : ``` aws pi get-resource-metrics \ --service-type RDS \ --identifier db-ID \ --start-time 2018-10-30T00:00:00Z \ --end-time 2018-10-30T01:00:00Z \ --period-in-seconds 60 \ --metric-queries file://query.json ``` Pour Windows : ``` aws pi get-resource-metrics ^ --service-type RDS ^ --identifier db-ID ^ --start-time 2018-10-30T00:00:00Z ^ --end-time 2018-10-30T01:00:00Z ^ --period-in-seconds 60 ^ --metric-queries file://query.json ``` La réponse ressemble à ce qui suit. ``` { "Identifier": "db-XXX", "AlignedStartTime": 1556215200.0, "MetricList": [ { "Key": { "Metric": "db.load.avg" }, "DataPoints": [ { "Timestamp": 1556218800.0, "Value": 1.4878117913832196 }, { "Timestamp": 1556222400.0, "Value": 1.192823803967328 } ] }, { "Key": { "Metric": "db.load.avg", "Dimensions": { "db.wait_event.type": "io", "db.wait_event.name": "wait/io/aurora_redo_log_flush" } }, "DataPoints": [ { "Timestamp": 1556218800.0, "Value": 1.1360544217687074 }, { "Timestamp": 1556222400.0, "Value": 1.058051341890315 } ] }, { "Key": { "Metric": "db.load.avg", "Dimensions": { "db.wait_event.type": "io", "db.wait_event.name": "wait/io/table/sql/handler" } }, "DataPoints": [ { "Timestamp": 1556218800.0, "Value": 0.16241496598639457 }, { "Timestamp": 1556222400.0, "Value": 0.05163360560093349 } ] }, { "Key": { "Metric": "db.load.avg", "Dimensions": { "db.wait_event.type": "synch", "db.wait_event.name": "wait/synch/mutex/innodb/aurora_lock_thread_slot_futex" } }, "DataPoints": [ { "Timestamp": 1556218800.0, "Value": 0.11479591836734694 }, { "Timestamp": 1556222400.0, "Value": 0.013127187864644107 } ] }, { "Key": { "Metric": "db.load.avg", "Dimensions": { "db.wait_event.type": "CPU", "db.wait_event.name": "CPU" } }, "DataPoints": [ { "Timestamp": 1556218800.0, "Value": 0.05215419501133787 }, { "Timestamp": 1556222400.0, "Value": 0.05805134189031505 } ] }, { "Key": { "Metric": "db.load.avg", "Dimensions": { "db.wait_event.type": "synch", "db.wait_event.name": "wait/synch/mutex/innodb/lock_wait_mutex" } }, "DataPoints": [ { "Timestamp": 1556218800.0, "Value": 0.017573696145124718 }, { "Timestamp": 1556222400.0, "Value": 0.002333722287047841 } ] } ], "AlignedEndTime": 1556222400.0 } //end of response ``` Dans cette réponse, toutes les valeurs sont filtrées en fonction de la contribution de l'AKIAIOSFODNN7EXEMPLE SQL tokenisé spécifié dans le fichier query.json. Les éléments Key peuvent également suivre un ordre différent d’une requête sans filtre, car ils correspondent aux cinq principaux événements d’attente qui ont affecté l’instruction SQL filtrée. ## Récupération du texte complet d’une instruction SQL L’exemple suivant montre comment récupérer le texte intégral d’une instruction SQL pour une instance de base de données `db-10BCD2EFGHIJ3KL4M5NO6PQRS5`. Le `--group` est `db.sql` et l’`--group-identifier` est `db.sql.id`. Dans cet exemple, *my-sql-id* représente un ID SQL récupéré en invoquant `pi get-resource-metrics` ou`pi describe-dimension-keys`. Exécutez la commande suivante. Pour Linux, macOS ou Unix : ``` aws pi get-dimension-key-details \ --service-type RDS \ --identifier db-10BCD2EFGHIJ3KL4M5NO6PQRS5 \ --group db.sql \ --group-identifier my-sql-id \ --requested-dimensions statement ``` Pour Windows : ``` aws pi get-dimension-key-details ^ --service-type RDS ^ --identifier db-10BCD2EFGHIJ3KL4M5NO6PQRS5 ^ --group db.sql ^ --group-identifier my-sql-id ^ --requested-dimensions statement ``` Dans cet exemple, les détails des dimensions sont disponibles. Ainsi, Performance Insights récupère le texte intégral de l’instruction SQL, sans le tronquer. ``` { "Dimensions":[ { "Value": "SELECT e.last_name, d.department_name FROM employees e, departments d WHERE e.department_id=d.department_id", "Dimension": "db.sql.statement", "Status": "AVAILABLE" }, ... ] } ``` ## Création d’un rapport d’analyse des performances pour une période donnée L’exemple suivant crée un rapport d’analyse des performances avec l’heure de début `1682969503` et l’heure de fin `1682979503` pour la base de données `db-loadtest-0`. ``` aws pi create-performance-analysis-report \ --service-type RDS \ --identifier db-loadtest-0 \ --start-time 1682969503 \ --end-time 1682979503 \ --region us-west-2 ``` La réponse est l’identifiant unique `report-0234d3ed98e28fb17` du rapport. ``` { "AnalysisReportId": "report-0234d3ed98e28fb17" } ``` ## Récupération d’un rapport d’analyse des performances L’exemple suivant extrait les détails du rapport d’analyse pour le rapport `report-0d99cc91c4422ee61`. ``` aws pi get-performance-analysis-report \ --service-type RDS \ --identifier db-loadtest-0 \ --analysis-report-id report-0d99cc91c4422ee61 \ --region us-west-2 ``` La réponse fournit l’état du rapport, son identifiant, les détails temporels et des informations. ``` { "AnalysisReport": { "Status": "Succeeded", "ServiceType": "RDS", "Identifier": "db-loadtest-0", "StartTime": 1680583486.584, "AnalysisReportId": "report-0d99cc91c4422ee61", "EndTime": 1680587086.584, "CreateTime": 1680587087.139, "Insights": [ ... (Condensed for space) ] } } ``` ## Établissement de la liste de tous les rapports d’analyse des performances pour l’instance de base de données L’exemple suivant répertorie tous les rapports d’analyse des performances disponibles pour la base de données `db-loadtest-0`. ``` aws pi list-performance-analysis-reports \ --service-type RDS \ --identifier db-loadtest-0 \ --region us-west-2 ``` La réponse répertorie tous les rapports avec l’ID du rapport, le statut et les détails temporels de la période. ``` { "AnalysisReports": [ { "Status": "Succeeded", "EndTime": 1680587086.584, "CreationTime": 1680587087.139, "StartTime": 1680583486.584, "AnalysisReportId": "report-0d99cc91c4422ee61" }, { "Status": "Succeeded", "EndTime": 1681491137.914, "CreationTime": 1681491145.973, "StartTime": 1681487537.914, "AnalysisReportId": "report-002633115cc002233" }, { "Status": "Succeeded", "EndTime": 1681493499.849, "CreationTime": 1681493507.762, "StartTime": 1681489899.849, "AnalysisReportId": "report-043b1e006b47246f9" }, { "Status": "InProgress", "EndTime": 1682979503.0, "CreationTime": 1682979618.994, "StartTime": 1682969503.0, "AnalysisReportId": "report-01ad15f9b88bcbd56" } ] } ``` ## Suppression d’un rapport d’analyse des performances L’exemple suivant supprime le rapport d’analyse pour la base de données `db-loadtest-0`. ``` aws pi delete-performance-analysis-report \ --service-type RDS \ --identifier db-loadtest-0 \ --analysis-report-id report-0d99cc91c4422ee61 \ --region us-west-2 ``` ## Ajout d’une balise à un rapport d’analyse des performances L’exemple suivant ajoute une balise avec une clé `name` et une valeur `test-tag` au rapport `report-01ad15f9b88bcbd56`. ``` aws pi tag-resource \ --service-type RDS \ --resource-arn arn:aws:pi:us-west-2:356798100956:perf-reports/RDS/db-loadtest-0/report-01ad15f9b88bcbd56 \ --tags Key=name,Value=test-tag \ --region us-west-2 ``` ## Établissement de la liste de toutes les balises pour un rapport d’analyse des performances L’exemple suivant répertorie toutes les balises pour le rapport `report-01ad15f9b88bcbd56`. ``` aws pi list-tags-for-resource \ --service-type RDS \ --resource-arn arn:aws:pi:us-west-2:356798100956:perf-reports/RDS/db-loadtest-0/report-01ad15f9b88bcbd56 \ --region us-west-2 ``` La réponse répertorie la valeur et la clé de toutes les balises ajoutées au rapport : ``` { "Tags": [ { "Value": "test-tag", "Key": "name" } ] } ``` ## Suppression des balises d’un rapport d’analyse des performances L’exemple suivant montre comment supprimer la balise `name` du rapport `report-01ad15f9b88bcbd56`. ``` aws pi untag-resource \ --service-type RDS \ --resource-arn arn:aws:pi:us-west-2:356798100956:perf-reports/RDS/db-loadtest-0/report-01ad15f9b88bcbd56 \ --tag-keys name \ --region us-west-2 ``` Une fois la balise supprimée, l’appel de l’API `list-tags-for-resource` ne répertorie pas cette balise. # Journalisation des appels Performance Insights avec AWS CloudTrail Performance Insights s'exécute avec AWS CloudTrail, un service qui fournit un enregistrement des actions entreprises par un utilisateur, un rôle ou un service AWS dans Performance Insights. CloudTrail capture tous les appels d'API pour Performance Insights en tant qu'événements. Cette capture inclut les appels de la console Amazon RDS et les appels de code aux opérations de l'API Performance Insights. Si vous créez un journal de suivi, vous pouvez activer la diffusion en continu des événements CloudTrail dans un compartiment Amazon S3, y compris les événements concernant Performance Insights. Si vous ne configurez pas de journal de suivi, vous pouvez toujours afficher les événements les plus récents dans la console CloudTrail dans **Event history (Historique des événements)**. Grâce aux données collectées par CloudTrail, vous pouvez déterminer certaines informations. Ces informations incluent la demande qui a été envoyée à Performance Insights, l'adresse IP à partir de laquelle la demande a été effectuée, l'auteur de la demande et sa date. Elles comprennent également des détails supplémentaires. Pour en savoir plus sur CloudTrail, consultez le [Guide de l’utilisateur AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/). ## Utilisation des informations Performance Insights dans CloudTrail CloudTrail est activé dans votre compte AWS lors de la création de ce dernier. Quand une activité se produit dans Performance Insights, cette activité est enregistrée dans un événement CloudTrail avec d'autres événements de service AWS dans la console CloudTrail, dans **Event history (Historique des événements)**. Vous pouvez afficher, rechercher et télécharger les événements récents dans votre compte AWS. Pour plus d'informations, consultez [Affichage des événements avec l'historique des événements CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html) dans le *Guide de l’utilisateur AWS CloudTrail*. Pour un enregistrement continu des événements dans votre compte AWS, y compris des événements concernant Performance Insights, créez un journal de suivi. Un *journal de suivi* permet à CloudTrail de livrer des fichiers journaux dans un compartiment Amazon S3. Par défaut, lorsque vous créez un journal de suivi dans la console, il s’applique à toutes les régions AWS. Le journal d'activité consigne les événements de toutes les Régions dans la partition AWSAWS et transfère les fichiers journaux dans le compartiment Amazon S3 de votre choix. En outre, vous pouvez configurer d’autres services AWS pour analyser et agir sur les données d’événements collectées dans les journaux CloudTrail. Pour plus d'informations, consultez les rubriques suivantes dans le *Guide de l'utilisateur AWS CloudTrail* : + [Présentation de la création d’un journal d’activité](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) + [Intégrations et services pris en charge par CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations) + [Configuration des notifications d’Amazon SNS pour CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html) + [Réception des fichiers journaux CloudTrail de plusieurs régions](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) et [Réception des fichiers journaux CloudTrail de plusieurs comptes](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) Toutes les opérations de Performance Insights sont consignées par CloudTrail et documentées dans la [Référence d'API Performance Insights](https://docs.aws.amazon.com/performance-insights/latest/APIReference/Welcome.html). Par exemple, les appels aux opérations `DescribeDimensionKeys` et `GetResourceMetrics` génèrent des entrées dans les fichiers journaux CloudTrail. Chaque événement ou entrée du journal contient des informations sur la personne qui a généré la demande. Les informations relatives à l’identité permettent de déterminer les éléments suivants : + Si la demande a été effectuée avec des informations d’identification d’utilisateur root ou IAM. + Si la demande a été effectuée avec des informations d’identification de sécurité temporaires pour un rôle ou un utilisateur fédéré. + Si la demande a été effectuée par un autre service AWS. Pour plus d’informations, consultez l’[élément userIdentity CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html). ## Entrées du fichier journal Performance Insights Un *journal de suivi* est une configuration qui permet la livraison d'événements sous forme de fichiers journaux vers un compartiment Amazon S3 que vous spécifiez. Les fichiers journaux CloudTrail peuvent contenir une ou plusieurs entrées de journal. Un *événement* représente une demande individuelle d'une source quelconque. Chaque événement comprend des informations sur l'opération demandée, la date et l'heure de l'opération, les paramètres de la demande, etc. Les fichiers journaux CloudTrail ne constituent pas une série ordonnée retraçant les appels d'API publics. Ils ne suivent aucun ordre précis. L'exemple suivant montre une entrée de journal CloudTrail qui illustre l'opération `GetResourceMetrics`. ``` { "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "AKIAIOSFODNN7EXAMPLE", "arn": "arn:aws:iam::123456789012:user/johndoe", "accountId": "123456789012", "accessKeyId": "AKIAI44QH8DHBEXAMPLE", "userName": "johndoe" }, "eventTime": "2019-12-18T19:28:46Z", "eventSource": "pi.amazonaws.com", "eventName": "GetResourceMetrics", "awsRegion": "us-east-1", "sourceIPAddress": "72.21.198.67", "userAgent": "aws-cli/1.16.240 Python/3.7.4 Darwin/18.7.0 botocore/1.12.230", "requestParameters": { "identifier": "db-YTDU5J5V66X7CXSCVDFD2V3SZM", "metricQueries": [ { "metric": "os.cpuUtilization.user.avg" }, { "metric": "os.cpuUtilization.idle.avg" } ], "startTime": "Dec 18, 2019 5:28:46 PM", "periodInSeconds": 60, "endTime": "Dec 18, 2019 7:28:46 PM", "serviceType": "RDS" }, "responseElements": null, "requestID": "9ffbe15c-96b5-4fe6-bed9-9fccff1a0525", "eventID": "08908de0-2431-4e2e-ba7b-f5424f908433", "eventType": "AwsApiCall", "recipientAccountId": "123456789012" } ``` # API Performance Insights et points de terminaison de VPC d’interface (AWS PrivateLink) Vous pouvez l'utiliser AWS PrivateLink pour créer une connexion privée entre votre VPC et Amazon RDS Performance Insights. Vous pouvez accéder à Performance Insights comme s'il se trouvait dans votre VPC, sans passer par une passerelle Internet, un appareil NAT, une connexion VPN ou Direct Connect une connexion. Les instances de votre VPC ne nécessitent pas d’adresses IP publiques pour accéder à Performance Insights. Vous établissez cette connexion privée en créant un *point de terminaison d’interface* optimisé par AWS PrivateLink. Nous créons une interface réseau de point de terminaison dans chaque sous-réseau que vous activez pour le point de terminaison d’interface. Il s’agit d’interfaces réseau gérées par le demandeur qui servent de point d’entrée pour le trafic destiné à Performance Insights. Pour plus d'informations, consultez la section [Accès Services AWS par AWS PrivateLink le biais](https://docs.aws.amazon.com/vpc/latest/privatelink/privatelink-access-aws-services.html) du *AWS PrivateLink guide*. ## Considérations relatives à Performance Insights Avant de configurer un point de terminaison d’interface pour Performance Insights, consultez [Considérations](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html#considerations-interface-endpoints) dans le *Guide AWS PrivateLink *. Performance Insights prend en charge les appels vers toutes ses actions d’API via le point de terminaison d’interface. Par défaut, l’accès complet à Performance Insights est autorisé via le point de terminaison d’interface. Pour contrôler le trafic vers Performance Insights via le point de terminaison d’interface, associez un groupe de sécurité aux interfaces réseau de ce point de terminaison. ## Disponibilité L'API Performance Insights prend actuellement en charge les points de terminaison VPC compatibles avec Performance Insights. Régions AWS Pour en savoir plus sur la disponibilité de Performance Insights, consulter [Régions et moteurs de base de données pris en charge pour Performance Insights dans Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md) . ## Créez un point de terminaison d’interface pour Performance Insights Vous pouvez créer un point de terminaison d'interface pour Performance Insights à l'aide de la console Amazon VPC ou du AWS Command Line Interface ()AWS CLI. Pour plus d’informations, consultez [Création d’un point de terminaison d’interface](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html#create-interface-endpoint-aws) dans le *Guide AWS PrivateLink *. Créez un point de terminaison d’interface pour Performance Insights à l’aide du nom de service suivant : Si vous activez le DNS privé pour le point de terminaison d’interface, vous pouvez adresser des demandes d’API à Performance Insights en utilisant son nom DNS par défaut pour la région. Par exemple, `pi.us-east-1.amazonaws.com`. ## Création d’une stratégie de point de terminaison de VPC pour l’API Performance Insights Une politique de point de terminaison est une ressource IAM que vous pouvez attacher à votre point de terminaison d’interface. La politique de point de terminaison par défaut autorise un accès complet aux API Performance Insights via le point de terminaison d’interface. Pour contrôler l’accès autorisé à Performance Insights depuis votre VPC, attachez une politique de point de terminaison personnalisée au point de terminaison de l’interface. Une politique de point de terminaison spécifie les informations suivantes : + Les principaux qui peuvent effectuer des actions (Comptes AWS, utilisateurs IAM et rôles IAM). + Les actions qui peuvent être effectuées. + La ressource sur laquelle les actions peuvent être effectuées. Pour plus d’informations, consultez [Contrôle de l’accès aux services à l’aide de politiques de point de terminaison](https://docs.aws.amazon.com/vpc/latest/privatelink/vpc-endpoints-access.html) dans le *Guide AWS PrivateLink *. **Exemple : politique de point de terminaison d’un VPC pour les actions Performance Insights** Voici un exemple de politique de point de terminaison personnalisée. Lorsque vous attachez cette politique à votre point de terminaison d’interface, elle accorde l’accès aux actions Performance Insights répertoriées pour tous les principaux sur toutes les ressources. ``` { "Statement":[ { "Principal":"*", "Effect":"Allow", "Action":[ "rds:CreatePerformanceAnalysisReport", "rds:DeletePerformanceAnalysisReport", "rds:GetPerformanceAnalysisReport" ], "Resource":"*" } ] } ``` **Exemple : politique de point de terminaison VPC qui refuse tout accès depuis un compte spécifié AWS** La politique de point de terminaison VPC suivante refuse au AWS compte `123456789012` tout accès aux ressources utilisant le point de terminaison. La politique autorise toutes les actions provenant d’autres comptes. ``` { "Statement": [ { "Action": "*", "Effect": "Allow", "Resource": "*", "Principal": "*" }, { "Action": "*", "Effect": "Deny", "Resource": "*", "Principal": { "AWS": [ "123456789012" ] } } ] } ``` ## Adressage IP pour Performance Insights Les adresses IP permettent aux ressources de votre VPC de communiquer entre elles et avec les ressources sur Internet. Performance Insights prend en charge les deux protocoles IPv4 ainsi que les protocoles d' IPv6 adressage. Par défaut, Performance Insights et Amazon VPC utilisent le protocole d' IPv4 adressage. Vous ne pouvez pas désactiver ce comportement. Lorsque vous créez un VPC, assurez-vous de spécifier un bloc IPv4 CIDR (une plage d'adresses privées IPv4 ). Vous pouvez éventuellement attribuer un bloc IPv6 CIDR à votre VPC et à vos sous-réseaux, et IPv6 attribuer les adresses de ce bloc aux ressources RDS de votre sous-réseau. Support du IPv6 protocole augmente le nombre d'adresses IP prises en charge. En utilisant le IPv6 protocole, vous vous assurez de disposer de suffisamment d'adresses disponibles pour la future croissance d'Internet. Les ressources et IPv6 adresses RDS nouvelles et existantes peuvent être utilisées IPv4 au sein de votre VPC. La configuration, la sécurisation et la traduction du trafic réseau entre les deux protocoles utilisés dans les différentes parties d’une application peuvent entraîner une surcharge opérationnelle. Vous pouvez standardiser le IPv6 protocole des ressources Amazon RDS afin de simplifier la configuration de votre réseau. Pour plus d’informations sur les points de terminaison de service et les quotas, consultez [Points de terminaison de service et quotas Amazon Relational Database Service](https://docs.aws.amazon.com/general/latest/gr/rds-service.html). Pour plus d’informations sur l’adressage IP Amazon RDS, consultez [Adressage IP Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html#USER_VPC.IP_addressing).