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. # Génération de rapports de performance avec AWR (Automatic Workload Repository) Pour collecter des données de performance et générer des rapports, Oracle recommande AWR (Automatic Workload Repository). AWR nécessite Oracle Database Enterprise Edition et une licence pour les packs Diagnostics et Tuning. Pour activer AWR, définissez le paramètre d'initialisation `CONTROL_MANAGEMENT_PACK_ACCESS` sur `DIAGNOSTIC` ou `DIAGNOSTIC+TUNING`. ## Utilisation des rapports AWR dans RDS Pour générer des rapports AWR, vous pouvez exécuter des scripts tels que `awrrpt.sql`. Ces scripts sont installés sur le serveur hôte de base de données. Dans Amazon RDS, vous n'avez pas d'accès direct à l'hôte. Toutefois, vous pouvez obtenir des copies de scripts SQL à partir d'une autre installation d'Oracle Database. Vous pouvez également utiliser AWR en exécutant des procédures dans le `SYS.DBMS_WORKLOAD_REPOSITORY` PL/SQL package. Vous pouvez utiliser ce package pour gérer les références et les instantanés, mais aussi pour afficher les rapports ASH et AWR. Par exemple, pour générer un rapport AWR au format texte, exécutez la procédure `DBMS_WORKLOAD_REPOSITORY.AWR_REPORT_TEXT`. Toutefois, vous ne pouvez pas accéder à ces rapports AWR à partir de la AWS Management Console. Lorsque vous travaillez avec AWR, nous vous recommandons d'utiliser les procédures `rdsadmin.rdsadmin_diagnostic_util`. Vous pouvez utiliser ces procédures pour générer les éléments suivants : + Rapports AWR + Rapports ASH (Active Session History) + Rapports ADDM (Automatic Database Diagnostic Monitor) + Fichiers de vidage Oracle Data Pump Export des données AWR Les procédures `rdsadmin_diagnostic_util` enregistrent les rapports dans le système de fichiers de l'instance de base de données. Vous pouvez accéder à ces rapports à partir de la console. Vous pouvez également accéder aux rapports à l'aide des procédures `rdsadmin.rds_file_util`. Vous pouvez accéder aux rapports copiés dans Amazon S3 à l'aide de l'option S3 Integration. Pour plus d’informations, consultez [Lecture de fichiers dans un répertoire d'instance de base de données](Appendix.Oracle.CommonDBATasks.Misc.md#Appendix.Oracle.CommonDBATasks.ReadingFiles) et [Intégration Amazon S3](oracle-s3-integration.md). Vous pouvez utiliser les procédures `rdsadmin_diagnostic_util` pour les versions suivantes du moteur de base de données Amazon RDS for Oracle : + Toutes les versions de Oracle Database 21c + 19.0.0.0.ru-2020-04.rur-2020-04.r1 et versions ultérieures de Oracle Database 19c Pour consulter un blog expliquant comment utiliser les rapports de diagnostic dans un scénario de réplication, consultez [Générer des rapports AWR pour les réplicas en lecture Amazon RDS for Oracle](https://aws.amazon.com/blogs/database/generate-awr-reports-for-amazon-rds-for-oracle-read-replicas/) (langue française non garantie). ## Paramètres communs pour le package d'utilitaires de diagnostic Vous utilisez généralement les paramètres suivants lors de la gestion d'AWR et d'ADDM avec le package `rdsadmin_diagnostic_util`. | Paramètre | Type de données | Par défaut | Obligatoire | Description | | --- | --- | --- | --- | --- | | `begin_snap_id` | `NUMBER` | — | Oui | ID de l'instantané de début. | | `end_snap_id` | `NUMBER` | — | Oui | ID de l'instantané de fin. | | `dump_directory` | `VARCHAR2` | `BDUMP` | Non | Répertoire dans lequel le rapport ou le fichier d'exportation sera écrit. Si vous spécifiez un répertoire autre que le répertoire par défaut, l'utilisateur qui exécute les procédures `rdsadmin_diagnostic_util` doit disposer des autorisations en écriture pour le répertoire. | | `p_tag` | `VARCHAR2` | — | Non | Chaîne pouvant être utilisée pour distinguer les sauvegardes afin d'indiquer leur but ou leur utilisation, telles que `incremental` ou `daily`.
Vous pouvez spécifier jusqu'à 30 caractères. Les caractères valides sont `a-z`, `A-Z`, `0-9`, un trait de soulignement (`_`), un tiret (`-`), et un point (`.`). L'identification n'est pas sensible à la casse. RMAN stocke toujours les identifications en majuscules, quel que soit la casse utilisée lors de leur saisie.
Les identifications n'ont pas besoin d'être uniques, de sorte que plusieurs sauvegardes peuvent avoir la même. Si vous ne spécifiez aucune balise, RMAN attribue automatiquement une balise par défaut en utilisant le format`TAG{{YYYYMMDDTHHMMSS}}`, où {{YYYY}} est l'année, {{MM}} le mois, {{DD}} le jour, {{HH}} l'heure (au format 24 heures), {{MM}} les minutes et les {{SS}} secondes. La date et l'heure indiquent quand RMAN a démarré la sauvegarde. Par exemple, une sauvegarde avec l'identification par défaut `TAG20190927T214517` indique une sauvegarde qui a commencé le 27 septembre 2019 à 21:45:17.
Le paramètre `p_tag` est pris en charge pour les versions suivantes du moteur de base de données RDS for Oracle :[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/Appendix.Oracle.CommonDBATasks.AWR.html) | | `report_type` | `VARCHAR2` | `HTML` | Non | Format du rapport. Les valeurs valides sont `TEXT` et `HTML`. | | `dbid` | `NUMBER` | — | Non | Identifiant de base de données valide (DBID) affiché dans la vue `DBA_HIST_DATABASE_INSTANCE` pour Oracle. Si ce paramètre n'est pas spécifié, RDS utilise le DBID actuel affiché dans la vue `V$DATABASE.DBID`. | Vous utilisez généralement les paramètres suivants lors de la gestion d'ASH avec le package rdsadmin\_diagnostic\_util. | Paramètre | Type de données | Par défaut | Obligatoire | Description | | --- | --- | --- | --- | --- | | `begin_time` | `DATE` | — | Oui | Heure de début de l'analyse ASH. | | `end_time` | `DATE` | — | Oui | Heure de fin de l'analyse ASH. | | `slot_width` | `NUMBER` | `0` | Non | Durée des emplacements (en secondes) utilisés dans la section « Top Activity (Activité principale) » du rapport ASH. Si ce paramètre n'est pas spécifié, l'intervalle de temps entre `begin_time` et `end_time` n'utilise pas plus de 10 emplacements. | | `sid` | `NUMBER` | Null | Non | ID de session. | | `sql_id` | `VARCHAR2` | Null | Non | ID SQL. | | `wait_class` | `VARCHAR2` | Null | Non | Nom de la classe d'attente. | | `service_hash` | `NUMBER` | Null | Non | Hachage du nom de service. | | `module_name` | `VARCHAR2` | Null | Non | Nom du module. | | `action_name` | `VARCHAR2` | Null | Non | Nom de l'action. | | `client_id` | `VARCHAR2` | Null | Non | ID spécifique à l'application de la session de base de données. | | `plsql_entry` | `VARCHAR2` | Null | Non | Le point PL/SQL d'entrée. | ## Génération d'un rapport AWR Pour générer un rapport AWR, utilisez la procédure `rdsadmin.rdsadmin_diagnostic_util.awr_report`. L'exemple suivant génère un rapport AWR pour la plage d'instantanés comprise entre 101 et 106. Le fichier texte en sortie est nommé `awrrpt_101_106.txt`. Vous pouvez accéder à ce rapport à partir d AWS Management Console. ``` EXEC rdsadmin.rdsadmin_diagnostic_util.awr_report(101,106,'TEXT'); ``` L'exemple suivant génère un rapport HTML pour la plage d'instantanés comprise entre 63 et 65. Le fichier HTML en sortie est nommé `awrrpt_63_65.html`. La procédure écrit le rapport dans un répertoire de base de données autre que le répertoire par défaut et nommé `AWR_RPT_DUMP`. ``` EXEC rdsadmin.rdsadmin_diagnostic_util.awr_report(63,65,'HTML','AWR_RPT_DUMP'); ``` ## Extraction de données AWR dans un fichier de vidage Pour extraire des données AWR dans un fichier de vidage, utilisez la procédure `rdsadmin.rdsadmin_diagnostic_util.awr_extract`. Vous ne pouvez utiliser cette fonction qu'au niveau du PDB. L'exemple suivant extrait la plage d'instantanés comprise entre 101 et 106. Le fichier de vidage en sortie est nommé `awrextract_101_106.dmp`. Vous pouvez accéder à ce fichier via la console. ``` EXEC rdsadmin.rdsadmin_diagnostic_util.awr_extract(101,106); ``` L'exemple suivant extrait la plage d'instantanés comprise entre 63 et 65. Le fichier de vidage en sortie est nommé `awrextract_63_65.dmp`. Le fichier est stocké dans un répertoire de base de données autre que le répertoire par défaut et nommé `AWR_RPT_DUMP`. ``` EXEC rdsadmin.rdsadmin_diagnostic_util.awr_extract(63,65,'AWR_RPT_DUMP'); ``` ## Génération d'un rapport ADDM Pour générer un rapport ADDM, utilisez la procédure `rdsadmin.rdsadmin_diagnostic_util.addm_report`. L'exemple suivant génère un rapport HTML pour la plage d'instantanés comprise entre 101 et 106. Le fichier texte en sortie est nommé `addmrpt_101_106.txt`. Vous pouvez accéder au rapport via la console. ``` EXEC rdsadmin.rdsadmin_diagnostic_util.addm_report(101,106); ``` L'exemple suivant génère un rapport ADDM pour la plage d'instantanés comprise entre 63 et 65. Le fichier texte en sortie est nommé `addmrpt_63_65.txt`. Le fichier est stocké dans un répertoire de base de données autre que le répertoire par défaut et nommé `ADDM_RPT_DUMP`. ``` EXEC rdsadmin.rdsadmin_diagnostic_util.addm_report(63,65,'ADDM_RPT_DUMP'); ``` ## Génération d'un rapport ASH Pour générer un rapport ASH, utilisez la procédure `rdsadmin.rdsadmin_diagnostic_util.ash_report`. L'exemple suivant génère un rapport ASH qui inclut les données des 14 dernières minutes. Le nom du fichier en sortie utilise le format `ashrpt{{begin_time}}{{end_time}}.txt`, où `{{begin_time}}` et `{{end_time}}` utilisent le format `YYYYMMDDHH24MISS`. Vous pouvez accéder au fichier via la console. ``` BEGIN rdsadmin.rdsadmin_diagnostic_util.ash_report( begin_time => SYSDATE-14/1440, end_time => SYSDATE, report_type => 'TEXT'); END; / ``` L'exemple suivant génère un rapport ASH qui inclut les données depuis le 18 novembre 2019 à 18h07 jusqu'au 18 novembre 2019 à 18h15. Le nom du rapport HTML en sortie est `ashrpt_20190918180700_20190918181500.html`. Le rapport est stocké dans un répertoire de base de données autre que le répertoire par défaut et nommé `AWR_RPT_DUMP`. ``` BEGIN rdsadmin.rdsadmin_diagnostic_util.ash_report( begin_time => TO_DATE('2019-09-18 18:07:00', 'YYYY-MM-DD HH24:MI:SS'), end_time => TO_DATE('2019-09-18 18:15:00', 'YYYY-MM-DD HH24:MI:SS'), report_type => 'html', dump_directory => 'AWR_RPT_DUMP'); END; / ``` ## Accès aux rapports AWR à partir de la console ou de la CLI Pour accéder aux rapports AWR ou exporter des fichiers de vidage, vous pouvez utiliser le AWS Management Console ou AWS CLI. Pour de plus amples informations, veuillez consulter [Téléchargement d’un fichier journal de base de données](USER_LogAccess.Procedural.Downloading.md).