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](Appendix.Oracle.CommonDBATasks.Misc.md#Appendix.Oracle.CommonDBATasks.ReadingFiles) e [Integrazione Amazon S3](oracle-s3-integration.md). 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](https://aws.amazon.com/blogs/database/generate-awr-reports-for-amazon-rds-for-oracle-read-replicas/). ## 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 formato`TAG{{YYYYMMDDTHHMMSS}}`, 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:[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/Appendix.Oracle.CommonDBATasks.AWR.html) | | `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 `ashrpt{{begin_time}}{{end_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](USER_LogAccess.Procedural.Downloading.md).