Génération de rapports de performance avec AWR (Automatic Workload Repository) - Amazon Relational Database Service

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 et Intégration Amazon S3.

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 (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 formatTAGYYYYMMDDTHHMMSS, 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 :

  • Oracle Database 21c (21.0.0)

  • Oracle Database 19c (19.0.0), avec 19.0.0.0.ru-2021-10.rur-2021-10.r1 et versions ultérieures

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 ashrptbegin_timeend_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.