Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Membuat laporan performa dengan Automatic Workload Repository (AWR)
Untuk mengumpulkan data performa dan membuat laporan, Oracle merekomendasikan Automatic Workload Repository (AWR). AWR memerlukan Oracle Database Enterprise Edition dan lisensi untuk paket Diagnostics and Tuning. Untuk mengaktifkan AWR, atur parameter inisiasi `CONTROL_MANAGEMENT_PACK_ACCESS` ke `DIAGNOSTIC` atau `DIAGNOSTIC+TUNING`.
## Bekerja dengan laporan AWR di RDS
Untuk membuat laporan AWR, Anda dapat menjalankan skrip seperti `awrrpt.sql`. Skrip ini diinstal di server host basis data. Di Amazon RDS, Anda tidak memiliki akses langsung ke host. Namun, Anda bisa mendapatkan salinan skrip SQL dari penginstalan Oracle Database lain.
Anda juga dapat menggunakan AWR dengan menjalankan prosedur dalam `SYS.DBMS_WORKLOAD_REPOSITORY` PL/SQL paket. Anda dapat menggunakan paket ini untuk mengelola baseline dan snapshot, dan juga untuk menampilkan laporan ASH dan AWR. Misalnya, untuk membuat laporan AWR dalam format teks, jalankan prosedur `DBMS_WORKLOAD_REPOSITORY.AWR_REPORT_TEXT`. Namun, Anda tidak dapat mengakses laporan AWR ini dari Konsol Manajemen AWS.
Saat bekerja dengan AWR, sebaiknya gunakan prosedur `rdsadmin.rdsadmin_diagnostic_util`. Anda dapat menggunakan prosedur ini untuk membuat:
+ Laporan AWR
+ Laporan Active Session History (ASH)
+ Laporan Database Diagnostic Monitor (ADDM)
+ File dump Oracle Data Pump Export dari data AWR
Prosedur `rdsadmin_diagnostic_util` menyimpan laporan ke sistem file instans DB. Anda dapat mengakses laporan ini dari konsol. Anda juga dapat mengakses laporan menggunakan prosedur `rdsadmin.rds_file_util` dan Anda dapat mengakses laporan yang disalin ke Amazon S3 menggunakan opsi Integrasi S3. Untuk informasi lebih lanjut, lihat [Membaca file di direktori instans DB](Appendix.Oracle.CommonDBATasks.Misc.md#Appendix.Oracle.CommonDBATasks.ReadingFiles) dan [Integrasi Amazon S3](oracle-s3-integration.md).
Anda dapat menggunakan prosedur `rdsadmin_diagnostic_util` di versi mesin DB Amazon RDS for Oracle berikut:
+ Semua versi Oracle Database 21c
+ 19.0.0.0.ru-2020-04.rur-2020-04.r1 dan versi Oracle Database 19c yang lebih baru
Untuk blog yang menjelaskan cara bekerja dengan laporan diagnostik dalam skenario replikasi, lihat [Membuat laporan AWR untuk replika baca Amazon RDS for Oracle](https://aws.amazon.com/blogs/database/generate-awr-reports-for-amazon-rds-for-oracle-read-replicas/).
## Parameter umum untuk paket utilitas diagnostik
Biasanya, Anda dapat menggunakan parameter berikut saat mengelola AWR dan ADDM dengan paket `rdsadmin_diagnostic_util`.
| Parameter | Tipe data | Default | Wajib | Deskripsi |
| --- | --- | --- | --- | --- |
| `begin_snap_id` | `NUMBER` | — | Ya | ID snapshot awal. |
| `end_snap_id` | `NUMBER` | — | Ya | ID snapshot akhir. |
| `dump_directory` | `VARCHAR2` | `BDUMP` | Tidak | Direktori untuk menulis laporan dan mengekspor file. Jika Anda menentukan direktori nondefault, pengguna yang menjalankan prosedur `rdsadmin_diagnostic_util` harus memiliki izin tulis untuk direktori tersebut. |
| `p_tag` | `VARCHAR2` | — | Tidak | String yang dapat digunakan untuk membedakan antara berbagai cadangan guna menunjukkan tujuan atau penggunaan backup, seperti `incremental` atau `daily`.
Anda dapat menentukan hingga 30 karakter. Karakter yang valid adalah `a-z`, `A-Z`, `0-9` garis bawah (`_`), tanda hubung (`-`), dan titik (`.`). Tag tidak peka huruf besar/kecil. RMAN selalu menyimpan tanda dalam huruf besar, terlepas dari huruf yang digunakan saat memasukkannya.
Tanda tidak harus unik. Jadi, beberapa cadangan dapat memiliki tanda yang sama. Jika Anda tidak menentukan tag, RMAN menetapkan tag default secara otomatis menggunakan format`TAG{{YYYYMMDDTHHMMSS}}`, di mana {{YYYY}} tahun, {{MM}} adalah bulan, {{DD}} adalah hari, {{HH}} adalah jam (dalam format 24 jam), {{MM}} adalah menit, dan {{SS}} detik. Tanggal dan waktu menunjukkan kapan RMAN memulai pencadangan. Misalnya, cadangan dengan tanda default `TAG20190927T214517` menunjukkan cadangan yang dimulai pada 27-09-2019 pukul 21.45.17.
Parameter `p_tag` didukung untuk versi mesin DB RDS for Oracle berikut:[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/Appendix.Oracle.CommonDBATasks.AWR.html) |
| `report_type` | `VARCHAR2` | `HTML` | Tidak | Format laporan. Nilai yang valid adalah `TEXT` dan `HTML`. |
| `dbid` | `NUMBER` | — | Tidak | Pengidentifikasi basis data (DBID) valid yang ditunjukkan di tampilan `DBA_HIST_DATABASE_INSTANCE` untuk Oracle. Jika parameter ini tidak ditentukan, RDS akan menggunakan DBID saat ini, yang ditunjukkan di tampilan `V$DATABASE.DBID`. |
Anda dapat menggunakan parameter berikut saat mengelola ASH dengan paket rdsadmin\_diagnostic\_util.
| Parameter | Tipe data | Default | Wajib | Deskripsi |
| --- | --- | --- | --- | --- |
| `begin_time` | `DATE` | — | Ya | Waktu mulai analisis ASH. |
| `end_time` | `DATE` | — | Ya | Waktu akhir analisis ASH. |
| `slot_width` | `NUMBER` | `0` | Tidak | Durasi slot (dalam detik) yang digunakan di bagian "Top Activity" pada laporan ASH. Jika parameter ini tidak ditentukan, interval waktu antara `begin_time` dan `end_time` menggunakan tidak lebih dari 10 slot. |
| `sid` | `NUMBER` | Null | Tidak | ID sesi. |
| `sql_id` | `VARCHAR2` | Null | Tidak | ID SQL. |
| `wait_class` | `VARCHAR2` | Null | Tidak | Nama kelas tunggu. |
| `service_hash` | `NUMBER` | Null | Tidak | Hash nama layanan. |
| `module_name` | `VARCHAR2` | Null | Tidak | Nama modul. |
| `action_name` | `VARCHAR2` | Null | Tidak | Nama tindakan. |
| `client_id` | `VARCHAR2` | Null | Tidak | ID khusus aplikasi untuk sesi basis data. |
| `plsql_entry` | `VARCHAR2` | Null | Tidak | Titik PL/SQL masuk. |
## Membuat laporan AWR
Untuk membuat laporan AWR, gunakan prosedur `rdsadmin.rdsadmin_diagnostic_util.awr_report`.
Contoh berikut membuat laporan AWR untuk rentang snapshot 101–106. File teks output diberi nama `awrrpt_101_106.txt`. Anda dapat mengakses laporan ini dari Konsol Manajemen AWS.
```
EXEC rdsadmin.rdsadmin_diagnostic_util.awr_report(101,106,'TEXT');
```
Contoh berikut membuat laporan HTML untuk rentang snapshot 63-65. File HTML output diberi nama `awrrpt_63_65.html`. Prosedur menulis laporan ke direktori basis data nondefault bernama `AWR_RPT_DUMP`.
```
EXEC rdsadmin.rdsadmin_diagnostic_util.awr_report(63,65,'HTML','AWR_RPT_DUMP');
```
## Mengekstrak data AWR ke dalam file dump
Untuk mengekstrak data AWR ke file dump, gunakan prosedur `rdsadmin.rdsadmin_diagnostic_util.awr_extract`. Anda dapat menggunakan fungsi ini hanya di tingkat PDB.
Contoh berikut mengekstrak rentang snapshot 101–106. File dump output diberi nama `awrextract_101_106.dmp`. Anda dapat mengakses file ini melalui konsol.
```
EXEC rdsadmin.rdsadmin_diagnostic_util.awr_extract(101,106);
```
Contoh berikut mengekstrak rentang snapshot 63-65. File dump output diberi nama `awrextract_63_65.dmp`. File disimpan dalam direktori basis data nondefault bernama `AWR_RPT_DUMP`.
```
EXEC rdsadmin.rdsadmin_diagnostic_util.awr_extract(63,65,'AWR_RPT_DUMP');
```
## Membuat laporan ADDM
Untuk membuat laporan ADDM, gunakan prosedur `rdsadmin.rdsadmin_diagnostic_util.addm_report`.
Contoh berikut membuat laporan ADDM untuk rentang snapshot 101-106. File teks output diberi nama `addmrpt_101_106.txt`. Anda dapat mengakses laporan ini melalui konsol.
```
EXEC rdsadmin.rdsadmin_diagnostic_util.addm_report(101,106);
```
Contoh berikut membuat laporan ADDM untuk rentang snapshot 63-65. File teks output diberi nama `addmrpt_63_65.txt`. File disimpan dalam direktori basis data nondefault bernama `ADDM_RPT_DUMP`.
```
EXEC rdsadmin.rdsadmin_diagnostic_util.addm_report(63,65,'ADDM_RPT_DUMP');
```
## Membuat laporan ASH
Untuk membuat laporan ASH, gunakan prosedur `rdsadmin.rdsadmin_diagnostic_util.ash_report`.
Contoh berikut membuat laporan ASH yang mencakup data dari 14 menit yang lalu hingga saat ini. Nama file output menggunakan format `ashrpt{{begin_time}}{{end_time}}.txt`, dengan `{{begin_time}}` dan `{{end_time}}` menggunakan format `YYYYMMDDHH24MISS`. Anda dapat mengakses file ini melalui konsol.
```
BEGIN
rdsadmin.rdsadmin_diagnostic_util.ash_report(
begin_time => SYSDATE-14/1440,
end_time => SYSDATE,
report_type => 'TEXT');
END;
/
```
Contoh berikut membuat laporan ASH yang mencakup data dari 18 November 2019, mulai pukul 18.07 hingga 18.15. Nama laporan output HTML adalah `ashrpt_20190918180700_20190918181500.html`. Laporan disimpan dalam direktori basis data nondefault bernama `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;
/
```
## Mengakses laporan AWR dari konsol atau CLI
Untuk mengakses laporan AWR atau mengekspor file dump, Anda dapat menggunakan atau. Konsol Manajemen AWS AWS CLI Lihat informasi yang lebih lengkap di [Mengunduh file log basis data](USER_LogAccess.Procedural.Downloading.md).