Génération de rapports de performance avec Automatic Workload Repository (AWR) - 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 Automatic Workload Repository (AWR)

Pour recueillir des données de performance et générer des rapports, Oracle recommande Automatic Workload Repository (AWR). AWRnécessite Oracle Database Enterprise Edition et une licence pour les packs de diagnostic et de réglage. Pour l'activerAWR, définissez le paramètre CONTROL_MANAGEMENT_PACK_ACCESS d'initialisation sur DIAGNOSTIC ouDIAGNOSTIC+TUNING.

Utilisation de AWR rapports dans RDS

Pour générer des AWR rapports, vous pouvez exécuter des scripts tels queawrrpt.sql. Ces scripts sont installés sur le serveur hôte de base de données. Sur AmazonRDS, vous n'avez pas d'accès direct à l'hôte. Vous pouvez toutefois obtenir des copies de SQL scripts à partir d'une autre installation d'Oracle Database.

Vous pouvez également l'utiliser AWR en exécutant des procédures dans le SQL package SYS.DBMS_WORKLOAD_REPOSITORY PL/. Vous pouvez utiliser ce package pour gérer les lignes de base et les instantanés, ainsi que pour les ASH affichages et les rapports. AWR Par exemple, pour générer un AWR rapport au format texte, exécutez la DBMS_WORKLOAD_REPOSITORY.AWR_REPORT_TEXT procédure. Cependant, vous ne pouvez pas accéder à ces AWR rapports depuis le AWS Management Console.

Lorsque vous travaillez avecAWR, nous vous recommandons d'utiliser les rdsadmin.rdsadmin_diagnostic_util procédures. Vous pouvez utiliser ces procédures pour générer les éléments suivants :

  • AWRrapports

  • Rapports sur l'historique des sessions actives (ASH)

  • Rapports du moniteur de diagnostic automatique de base de données (ADDM)

  • Oracle Data Pump Exporte des fichiers de vidage de AWR données

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 rdsadmin_diagnostic_util procédures des versions suivantes du moteur de base de données Amazon RDS pour 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 Generate AWR reports for Amazon RDS for Oracle read replicas.

Paramètres communs pour le package d'utilitaires de diagnostic

Vous utilisez généralement les paramètres suivants lors de la gestion AWR et de ADDM l'utilisation du rdsadmin_diagnostic_util package.

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. RMANstocke toujours les étiquettes en majuscules, quelle que soit la majuscule 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 pas de balise, RMAN assigne automatiquement une balise par défaut en utilisant le formatTAGYYYYMMDDTHHMMSS, où YYYY c'est l'année, MM c'est le mois, DD c'est le jour, HH est l'heure (au format 24 heures), MM est le procès-verbal, et SS ce sont les secondes. La date et l'heure indiquent le RMAN début de 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 p_tag paramètre est pris en charge pour les versions suivantes RDS du moteur de base de données 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 DBA_HIST_DATABASE_INSTANCE vue pour Oracle. Si ce paramètre n'est pas spécifié, RDS utilise le courant DBID affiché dans la V$DATABASE.DBID vue.

Vous utilisez généralement les paramètres suivants lors de la gestion 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'ASHanalyse.

end_time

DATE

Oui

Heure de fin de l'ASHanalyse.

slot_width

NUMBER

0

Non

Durée des créneaux (en secondes) utilisés dans la section « Activité principale » du ASH rapport. 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

La SQL pièce d'identité.

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 d'SQLentrée PL/.

Génération d'un AWR rapport

Pour générer un AWR rapport, utilisez la rdsadmin.rdsadmin_diagnostic_util.awr_report procédure suivante.

L'exemple suivant génère un AWR rapport pour la plage de clichés 101 à 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 HTML rapport pour la plage de clichés 63 à 65. Le HTML fichier de 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 AWR données dans un fichier de vidage

Pour extraire AWR des données dans un fichier de vidage, rdsadmin.rdsadmin_diagnostic_util.awr_extract procédez comme suit.

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 ADDM rapport

Pour générer un ADDM rapport, utilisez la rdsadmin.rdsadmin_diagnostic_util.addm_report procédure suivante.

L'exemple suivant génère un ADDM rapport pour la plage de clichés 101 à 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 ADDM rapport pour la plage de clichés 63 à 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 ASH rapport

Pour générer un ASH rapport, utilisez la rdsadmin.rdsadmin_diagnostic_util.ash_report procédure suivante.

L'exemple suivant génère un ASH rapport qui inclut les données d'il y a 14 minutes jusqu'à l'heure actuelle. 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 ASH rapport qui inclut les données du 18 novembre 2019 à 18 h 07 au 18 novembre 2019 à 18 h 15. Le nom du HTML rapport de sortie estashrpt_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 AWR rapports depuis la console ou CLI

Pour accéder aux AWR rapports 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.