Generación de informes de rendimiento con Automatic Workload Repository (AWR)

Para recopilar datos de rendimiento y generar informes, Oracle recomienda Automatic Workload Repository (AWR). AWR requiere Oracle Database Enterprise Edition y una licencia para los paquetes Diagnostics and Tuning. Para habilitar AWR, establezca el parámetro de inicialización CONTROL_MANAGEMENT_PACK_ACCESS en DIAGNOSTIC o DIAGNOSTIC+TUNING.

Trabajar con informes de AWR en RDS

Para generar informes de AWR, puede ejecutar scripts como awrrpt.sql. Estos scripts se instalan en el servidor host de la base de datos. En Amazon RDS, no tiene acceso directo al host. Sin embargo, puede obtener copias de scripts SQL desde otra instalación de Oracle Database.

También puede utilizar AWR ejecutando procedimientos en el paquete SYS.DBMS_WORKLOAD_REPOSITORY PL/SQL. Puede utilizar este paquete para administrar bases de referencia e instantáneas, así como para mostrar informes ASH y AWR. Por ejemplo, para generar un informe AWR en formato de texto, ejecute el procedimiento DBMS_WORKLOAD_REPOSITORY.AWR_REPORT_TEXT. Sin embargo, no puede acceder a estos informes de AWR desde la AWS Management Console.

Cuando se trabaja con AWR, se recomienda utilizar los procedimientos rdsadmin.rdsadmin_diagnostic_util. Puede utilizar estos procedimientos para generar lo siguiente:

Los procedimientos rdsadmin_diagnostic_util guardan los informes en el sistema de archivos de instancia de base de datos. Puede acceder a estos informes desde la consola. También puede acceder a los informes mediante los procedimientos rdsadmin.rds_file_util y puede acceder a los informes que se copian en Amazon S3 mediante la opción Integración de S3. Para obtener más información, consulte Lectura de archivos de un directorio de instancia de base de datos y Integración de Amazon S3.

Puede utilizar los procedimientos rdsadmin_diagnostic_util en las siguientes versiones del motor para bases de datos de Amazon RDS for Oracle:

Para ver un blog que explica cómo trabajar con los informes de diagnóstico en un escenario de replicación, consulte Generate AWR reports for Amazon RDS for Oracle read replicas.

Parámetros comunes para el paquete de utilidad de diagnóstico

Normalmente se utilizan los siguientes parámetros al administrar AWR y ADDM con el paquete rdsadmin_diagnostic_util.

Normalmente, se utilizan los siguientes parámetros al administrar ASH con el paquete rdsadmin_diagnostic_util.

Generación de un informe AWR

Para generar un informe AWR, utilice el procedimiento rdsadmin.rdsadmin_diagnostic_util.awr_report.

En el ejemplo siguiente se genera un informe AWR para el rango de instantáneas 101–106. El archivo de texto de salida se denomina awrrpt_101_106.txt. Puede obtener acceso a este informe desde la AWS Management Console.

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

En el ejemplo siguiente se genera un informe HTML para el rango de instantáneas 63–65. El archivo HTML de salida se denomina awrrpt_63_65.html. El procedimiento escribe el informe en el directorio de base de datos no predeterminado denominado AWR_RPT_DUMP.

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

Extracción de datos de AWR en un archivo de volcado

Para extraer datos de AWR en un archivo de volcado, utilice el procedimiento rdsadmin.rdsadmin_diagnostic_util.awr_extract.

En el siguiente ejemplo se extrae el rango de instantáneas 101–106. El archivo de volcado de salida se denomina awrextract_101_106.dmp. Puede acceder a este archivo a través de la consola.

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

En el siguiente ejemplo se extrae el rango de instantáneas 63–65. El archivo de volcado de salida se denomina awrextract_63_65.dmp. El archivo se almacena en el directorio de base de datos no predeterminado denominado AWR_RPT_DUMP.

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

Generación de un informe ADDM

Para generar un informe ADDM, utilice el procedimiento rdsadmin.rdsadmin_diagnostic_util.addm_report.

En el ejemplo siguiente se genera un informe ADDM para el rango de instantáneas 101–106. El archivo de texto de salida se denomina addmrpt_101_106.txt. Puede acceder al informe a través de la consola.

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

En el ejemplo siguiente se genera un informe ADDM para el rango de instantáneas 63–65. El archivo de texto de salida se denomina addmrpt_63_65.txt. El archivo se almacena en el directorio de base de datos no predeterminado denominado ADDM_RPT_DUMP.

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

Generación de un informe ASH

Para generar un informe ASH, utilice el procedimiento rdsadmin.rdsadmin_diagnostic_util.ash_report.

En el ejemplo siguiente se genera un informe ASH que incluye los datos desde hace 14 minutos hasta la hora actual. El nombre del archivo de salida utiliza el formato ashrptbegin_timeend_time.txt, donde begin_time y end_time utilizan el formato YYYYMMDDHH24MISS. Puede acceder al archivo a través de la consola.

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

En el siguiente ejemplo se genera un informe ASH que incluye los datos del 18 de noviembre de 2019, a las 6:07 PM hasta el 18 de noviembre de 2019, a las 6:15 PM. El nombre del informe HTML de salida es ashrpt_20190918180700_20190918181500.html. El informe se almacena en el directorio de base de datos no predeterminado denominado 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;
/

Acceso a los informes de AWR desde la consola o la CLI

Para acceder a informes de AWR o exportar archivos de volcado, puede utilizar la AWS Management Console o la AWS CLI. Para obtener más información, consulte Descarga de un archivo de registro de base de datos.