Generazione di report sulle prestazioni con AWR (Automatic Workload Repository) - Amazon Relational Database Service
Utilizzo di report AWR in RDSParametri comuniGenerazione di un report AWREstrazione di dati AWRGenerazione di un report ADDMGenerazione di un report ASHAccesso ai report AWR

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Generazione di report sulle prestazioni con AWR (Automatic Workload Repository)

Per raccogliere i dati sulle prestazioni e generare report, Oracle consiglia AWR (Automatic Workload Repository). AWR richiede Oracle Database Enterprise Edition e una licenza per i pacchetti di diagnostica e ottimizzazione. Per abilitare AWR, impostare il parametro di inizializzazione CONTROL_MANAGEMENT_PACK_ACCESS su DIAGNOSTIC o DIAGNOSTIC+TUNING.

Utilizzo di report AWR in RDS

Per generare report AWR, puoi eseguire script quali awrrpt.sql. Questi script vengono installati nel server host del database. In Amazon RDS non è possibile accedere direttamente all'host. Tuttavia, puoi ottenere copie di script SQL da un'altra installazione di Oracle Database.

È inoltre possibile utilizzare AWR eseguendo le procedure nel SYS.DBMS_WORKLOAD_REPOSITORY PL/SQL pacchetto. Puoi utilizzare questo pacchetto per gestire baseline e snapshot, nonché visualizzare report ASH e AWR. Ad esempio, per generare un report AWR in formato di testo, esegui la procedura DBMS_WORKLOAD_REPOSITORY.AWR_REPORT_TEXT. Tuttavia, non puoi raggiungere questi report AWR da Console di gestione AWS.

Quando utilizzi AWR, ti consigliamo di utilizzare le procedure rdsadmin.rdsadmin_diagnostic_util. Puoi utilizzare queste procedure per generare quanto segue:

  • Report AWR

  • Report ASH (Active Session History)

  • Report ADDM (Automatic Database Diagnostic Monitor)

  • File di dump di Export di Oracle Data Pump di dati AWR

Le procedure rdsadmin_diagnostic_util salvano i report nel file system dell'istanza database. Puoi accedere a questi report dalla console. Puoi inoltre accedere ai report utilizzando le procedure rdsadmin.rds_file_util e accedere ai report copiati in Simple Storage Service (Amazon S3) mediante l'opzione Integrazione S3. Per ulteriori informazioni, consulta Lettura dei file in una directory di istanze database e Integrazione Amazon S3.

Puoi utilizzare le procedure rdsadmin_diagnostic_util nelle seguente per versioni del motore database Amazon RDS for Oracle:

  • Tutte le versioni di Oracle Database 21c

  • 19.0.0.0.ru-2020-04.rur-2020-04.r1 e versioni successive di Oracle Database 19c

Per un blog che spiega come utilizzare i report diagnostici in uno scenario di replica, consulta il post relativo alla generazione di report AWR per le repliche di lettura di Amazon RDS per Oracle.

Parametri comuni per il pacchetto di utilità di diagnostica

In genere i seguenti parametri vengono utilizzati durante la gestione di AWR e ADDM con il pacchetto rdsadmin_diagnostic_util.

Parametro Tipo di dati Default Campo obbligatorio Descrizione

begin_snap_id

NUMBER

—

Sì

ID dello snapshot iniziale.

end_snap_id

NUMBER

—

Sì

ID dello snapshot finale.

dump_directory

VARCHAR2

BDUMP

No

La directory in cui scrivere il report o esportare il file. Se si specifica una directory non predefinita, l'utente che esegue le procedure rdsadmin_diagnostic_util deve disporre delle autorizzazioni di scrittura per la directory.

p_tag

VARCHAR2

—

No

Una stringa che può essere utilizzata per distinguere tra i backup per indicare lo scopo o l'utilizzo dei backup, ad esempio incremental o daily.

Puoi specificare fino a 30 caratteri. I caratteri validi sono: a-z, A-Z, 0-9, un carattere di sottolineatura (_), un trattino (-) e un punto (.). Il tag non rileva la distinzione tra maiuscole e minuscole. RMAN memorizza sempre i tag in maiuscolo, indipendentemente dalle maiuscole e minuscole utilizzate durante l'inserimento.

I tag non devono essere univoci, quindi più backup possono avere lo stesso tag. Se non si specifica un tag, RMAN assegna automaticamente un tag predefinito utilizzando il formatoTAGYYYYMMDDTHHMMSS, dove YYYY è l'anno, MM il mese, DD il giorno, HH l'ora (nel formato a 24 ore), MM i minuti e SS i secondi. La data e l'ora indicano quando RMAN ha avviato il backup. Ad esempio, un backup con il tag di default TAG20190927T214517 indica un backup iniziato il 27/09/2019 alle 21:45:17.

Il parametro p_tag è supportato nelle seguenti versioni del motore database RDS for Oracle:

  • Oracle Database 21c (21.0.0)

  • Oracle Database 19c (19.0.0), usando le versioni 19.0.0.0.ru-2021-10.rur-2021-10.r1 e successive

report_type

VARCHAR2

HTML

No

Il formato del report. I valori validi sono TEXT e HTML.

dbid

NUMBER

—

No

Un identificatore di database (DBID) valido visualizzato nella vista DBA_HIST_DATABASE_INSTANCE per Oracle. Se questo parametro non viene specificato, RDS utilizza il DBID corrente, mostrato nella vista V$DATABASE.DBID.

In genere i seguenti parametri vengono utilizzati durante la gestione di ASH con il pacchetto rdsadmin_diagnostic_util.

Parametro Tipo di dati Default Campo obbligatorio Descrizione

begin_time

DATE

—

Sì

L'ora di inizio dell'analisi ASH.

end_time

DATE

—

Sì

L'ora di fine dell'analisi ASH.

slot_width

NUMBER

0

No

La durata degli slot (in secondi) utilizzati nella sezione "Attività superiore" del report ASH. Se questo parametro non è specificato, l'intervallo di tempo tra begin_time e end_time utilizza un massimo di 10 slot.

sid

NUMBER

Null

No

L'ID della sessione

sql_id

VARCHAR2

Null

No

L'ID SQL.

wait_class

VARCHAR2

Null

No

Il nome della classe di attesa.

service_hash

NUMBER

Null

No

L'hash del nome del servizio.

module_name

VARCHAR2

Null

No

Il nome del modulo.

action_name

VARCHAR2

Null

No

Il nome dell'operazione.

client_id

VARCHAR2

Null

No

L'ID specifico dell'applicazione della sessione del database.

plsql_entry

VARCHAR2

Null

No

Il PL/SQL punto di ingresso.

Generazione di un report AWR

Per generare un report AWR, utilizza la procedura rdsadmin.rdsadmin_diagnostic_util.awr_report.

Nell'esempio seguente viene generato un report AWR per l'intervallo di snapshot da 101 a 106. Il file di testo di output è denominato awrrpt_101_106.txt. Puoi accedere a questo report da Console di gestione AWS. 

EXEC rdsadmin.rdsadmin_diagnostic_util.awr_report(101,106,'TEXT');

Nell'esempio seguente viene generato un report HTML per l'intervallo di snapshot da 63 a 65. Il file HTML di output è denominato awrrpt_63_65.html. La procedura scrive il report nella directory di database non predefinita denominata AWR_RPT_DUMP.

EXEC rdsadmin.rdsadmin_diagnostic_util.awr_report(63,65,'HTML','AWR_RPT_DUMP');

Estrazione di dati AWR in un file di dump

Per estrarre i dati AWR in un file di dump, utilizza la procedura rdsadmin.rdsadmin_diagnostic_util.awr_extract. È possibile utilizzare questa funzione solo a livello di PDB.

Nell'esempio seguente viene estratto l'intervallo di snapshot da 101 a 106. Il file di dump di output è denominato awrextract_101_106.dmp. Puoi accedere a questo file tramite la console.

EXEC rdsadmin.rdsadmin_diagnostic_util.awr_extract(101,106);

Nell'esempio seguente viene estratto l'intervallo di snapshot da 63 a 65. Il file di dump di output è denominato awrextract_63_65.dmp. Il file viene archiviato nella directory di database non predefinita denominata AWR_RPT_DUMP.

EXEC rdsadmin.rdsadmin_diagnostic_util.awr_extract(63,65,'AWR_RPT_DUMP');

Generazione di un report ADDM

Per generare un report ADDM, utilizza la procedura rdsadmin.rdsadmin_diagnostic_util.addm_report.

Nell'esempio seguente viene generato un report ADDM per l'intervallo di snapshot da 101 a 106. Il file di testo di output è denominato addmrpt_101_106.txt. È possibile accedere al report tramite la console.

EXEC rdsadmin.rdsadmin_diagnostic_util.addm_report(101,106);

Nell'esempio seguente viene generato un report ADDM per l'intervallo di snapshot da 63 a 65. Il file di testo di output è denominato addmrpt_63_65.txt. Il file viene archiviato nella directory di database non predefinita denominata ADDM_RPT_DUMP.

EXEC rdsadmin.rdsadmin_diagnostic_util.addm_report(63,65,'ADDM_RPT_DUMP');

Generazione di un report ASH

Per generare un report ASH, utilizza la procedura rdsadmin.rdsadmin_diagnostic_util.ash_report.

Nell'esempio seguente viene generato un report ASH che include i dati da 14 minuti fa fino all'ora corrente. Il nome del file di output utilizza il formato ashrptbegin_timeend_time.txt, dove begin_time e end_time utilizzano il formato YYYYMMDDHH24MISS. Puoi accedere al file tramite la console.

BEGIN
    rdsadmin.rdsadmin_diagnostic_util.ash_report(
        begin_time     =>     SYSDATE-14/1440,
        end_time       =>     SYSDATE,
        report_type    =>     'TEXT');
END;
/

Nell'esempio seguente viene generato un report ASH che include i dati dal 18 novembre 2019 alle 18.07 fino al 18 novembre 2019 alle 18.15. Il nome del report HTML di output è ashrpt_20190918180700_20190918181500.html. Il file viene archiviato nella directory di database non predefinita denominata 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;
/

Accesso ai report AWR dalla console o da CLI

Per accedere ai report AWR o esportare file di dump, puoi usare o. Console di gestione AWS AWS CLI Per ulteriori informazioni, consulta Download di un file di log di database.