

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Memantau muatan DB dengan Wawasan Performa di Amazon RDS
<a name="USER_PerfInsights"></a>

**penting**  
 AWS telah mengumumkan end-of-life tanggal Performance Insights: 30 Juni 2026. Setelah tanggal ini, Amazon RDS tidak akan lagi mendukung pengalaman konsol Performance Insights, periode retensi fleksibel (1-24 bulan), dan harga terkait. Performance Insights API akan terus ada tanpa perubahan harga. Biaya untuk API Performance Insights akan muncul di AWS tagihan Anda dengan biaya CloudWatch Database Insights.   
 Sebaiknya Anda meningkatkan instans apa pun menggunakan tingkat berbayar Performance Insights ke mode Advanced Database Insights sebelum 30 Juni 2026. Untuk informasi tentang meningkatkan ke mode Advanced Database Insights, lihat. [](USER_DatabaseInsights.TurningOnAdvanced.md)   
 Jika Anda tidak mengambil tindakan, instans DB yang menggunakan Performance Insights akan secara default menggunakan mode Standar Database Insights. Dengan mode Standar Database Insights, Anda mungkin kehilangan akses ke riwayat data kinerja setelah 7 hari dan mungkin tidak dapat menggunakan paket eksekusi dan fitur analisis sesuai permintaan di konsol Amazon RDS. Setelah 30 Juni 2026, hanya mode Advanced Database Insights yang akan mendukung rencana eksekusi dan analisis sesuai permintaan.   
 Dengan CloudWatch Database Insights, Anda dapat memantau beban database untuk armada database Anda dan menganalisis serta memecahkan masalah kinerja dalam skala besar. Untuk informasi selengkapnya tentang Wawasan Database, lihat[Memantau database Amazon RDS Aurora dengan Database CloudWatch Insights](USER_DatabaseInsights.md). Untuk informasi harga, lihat [ CloudWatch Harga Amazon](https://aws.amazon.com/cloudwatch/pricing/). 

Wawasan Performa memperluas fitur pemantauan Amazon RDS yang sudah ada untuk mengilustrasikan dan membantu Anda menganalisis performa basis data. Dengan dasbor Wawasan Performa, Anda dapat memvisualisasikan muatan basis data pada muatan instans DB Amazon RDS dan memfilter muatan menurut peristiwa tunggu, pernyataan SQL, host, atau pengguna. Untuk informasi tentang cara menggunakan Wawasan Performa dengan Amazon DocumentDB, lihat *[Panduan Developer Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/performance-insights.html)*.

**Topics**
+ [Ikhtisar Wawasan Performa tentang Amazon RDS](USER_PerfInsights.Overview.md)
+ [Mengaktifkan dan menonaktifkan Performance Insights untuk Amazon RDS](USER_PerfInsights.Enabling.md)
+ [Ikhtisar Skema Kinerja untuk Performance Insights di MySQL Amazon RDS untuk MariaDB atau MySQL](USER_PerfInsights.EnableMySQL.md)
+ [Mengonfigurasi kebijakan akses untuk Wawasan Performa](USER_PerfInsights.access-control.md)
+ [Menganalisis metrik dengan dasbor Wawasan Performa](USER_PerfInsights.UsingDashboard.md)
+ [Melihat rekomendasi proaktif Performance Insights](USER_PerfInsights.InsightsRecommendationViewDetails.md)
+ [Mengambil metrik dengan Performance API Insights untuk Amazon RDS](USER_PerfInsights.API.md)
+ [Pencatatan panggilan Performance Insights menggunakan AWS CloudTrail](USER_PerfInsights.CloudTrail.md)
+ [Performance Insights API dan titik akhir VPC antarmuka ()AWS PrivateLink](pi-vpc-interface-endpoints.md)

# Ikhtisar Wawasan Performa tentang Amazon RDS
<a name="USER_PerfInsights.Overview"></a>

**penting**  
 AWS telah mengumumkan end-of-life tanggal Performance Insights: 30 Juni 2026. Setelah tanggal ini, Amazon RDS tidak akan lagi mendukung pengalaman konsol Performance Insights, periode retensi fleksibel (1-24 bulan), dan harga terkait. Performance Insights API akan terus ada tanpa perubahan harga. Biaya untuk API Performance Insights akan muncul di AWS tagihan Anda dengan biaya CloudWatch Database Insights.   
 Sebaiknya Anda meningkatkan instans apa pun menggunakan tingkat berbayar Performance Insights ke mode Advanced Database Insights sebelum 30 Juni 2026. Untuk informasi tentang meningkatkan ke mode Advanced Database Insights, lihat. [](USER_DatabaseInsights.TurningOnAdvanced.md)   
 Jika Anda tidak mengambil tindakan, instans DB yang menggunakan Performance Insights akan secara default menggunakan mode Standar Database Insights. Dengan mode Standar Database Insights, Anda mungkin kehilangan akses ke riwayat data kinerja setelah 7 hari dan mungkin tidak dapat menggunakan paket eksekusi dan fitur analisis sesuai permintaan di konsol Amazon RDS. Setelah 30 Juni 2026, hanya mode Advanced Database Insights yang akan mendukung rencana eksekusi dan analisis sesuai permintaan.   
 Dengan CloudWatch Database Insights, Anda dapat memantau beban database untuk armada database Anda dan menganalisis serta memecahkan masalah kinerja dalam skala besar. Untuk informasi selengkapnya tentang Wawasan Database, lihat[Memantau database Amazon RDS Aurora dengan Database CloudWatch Insights](USER_DatabaseInsights.md). Untuk informasi harga, lihat [ CloudWatch Harga Amazon](https://aws.amazon.com/cloudwatch/pricing/). 

Secara default, RDS mengaktifkan Performance Insights di wizard pembuatan konsol untuk semua engine Amazon RDS. Jika Anda memiliki lebih dari satu basis data di instans DB, Wawasan Performa akan menggabungkan data performa.

Anda dapat menemukan ikhtisar Wawasan Performa untuk Amazon RDS dalam video berikut.

[![AWS Videos](http://img.youtube.com/vi/yOeWcPBT458/0.jpg)](http://www.youtube.com/watch?v=yOeWcPBT458)


**penting**  
Topik berikut menjelaskan penggunaan Wawasan Performa Amazon RDS dengan mesin non-Aurora DB. Untuk informasi tentang penggunaan Wawasan Performa Amazon RDS dengan Amazon Aurora, lihat [Menggunakan Wawasan Performa Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.html) dalam *Panduan Pengguna Amazon Aurora*.

**Topics**
+ [Muatan basis data](USER_PerfInsights.Overview.ActiveSessions.md)
+ [Maksimum CPU](USER_PerfInsights.Overview.MaxCPU.md)
+ [Amazon RDS Aurora DB engine, Wilayah, dan dukungan kelas instans untuk Performance Insights](USER_PerfInsights.Overview.Engines.md)
+ [Harga dan retensi data untuk Wawasan Performa](USER_PerfInsights.Overview.cost.md)

# Muatan basis data
<a name="USER_PerfInsights.Overview.ActiveSessions"></a>

*Beban basis data (beban DB)* mengukur tingkat aktivitas sesi dalam database Anda. `DBLoad`adalah metrik kunci dalam Performance Insights, dan Performance Insights mengumpulkan beban DB setiap detik.

**Topics**
+ [Sesi aktif](#USER_PerfInsights.Overview.ActiveSessions.active-sessions)
+ [Sesi aktif rata-rata](#USER_PerfInsights.Overview.ActiveSessions.AAS)
+ [Eksekusi aktif rata-rata](#USER_PerfInsights.Overview.ActiveSessions.AAE)
+ [Dimensi](#USER_PerfInsights.Overview.ActiveSessions.dimensions)

## Sesi aktif
<a name="USER_PerfInsights.Overview.ActiveSessions.active-sessions"></a>

*Sesi basis data* mewakili dialog aplikasi dengan basis data relasional. Sesi aktif adalah koneksi yang mengirimkan tugas ke mesin DB dan sedang menunggu tanggapan. 

Sesi dianggap aktif jika berjalan di CPU atau menunggu sumber daya tersedia sehingga dapat dilanjutkan. Misalnya, sesi aktif mungkin menunggu halaman (atau blok) dibaca ke dalam memori, dan kemudian menggunakan CPU saat membaca data dari halaman. 

## Sesi aktif rata-rata
<a name="USER_PerfInsights.Overview.ActiveSessions.AAS"></a>

*Sesi aktif rata-rata (AAS)* adalah unit untuk metrik `DBLoad` dalam Wawasan Performa. Ini mengukur berapa banyak sesi yang aktif secara bersamaan di basis data.

Setiap detik, Wawasan Performa mengambil sampel jumlah sesi yang secara bersamaan menjalankan kueri. Untuk setiap sesi aktif, Wawasan Performa mengumpulkan data berikut:
+ Pernyataan SQL
+ Status sesi (berjalan pada CPU atau menunggu)
+ Host
+ Pengguna yang menjalankan SQL

Wawasan Performa menghitung AAS dengan membagi jumlah total sesi dengan jumlah sampel selama periode waktu tertentu. Misalnya, tabel berikut menunjukkan 5 sampel berturut-turut dari kueri yang berjalan yang diambil dengan interval 1 detik.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html)

Pada contoh sebelumnya, muatan DB untuk interval waktu tersebut adalah 2 AAS. Pengukuran ini berarti bahwa rata-rata ada 2 sesi aktif pada waktu tertentu selama interval tersebut ketika 5 sampel diambil.

## Eksekusi aktif rata-rata
<a name="USER_PerfInsights.Overview.ActiveSessions.AAE"></a>

Eksekusi aktif rata-rata (AAE) per detik berkaitan dengan AAS. Untuk menghitung AAE, Wawasan Performa membagi total waktu eksekusi kueri dengan interval waktu. Tabel berikut menunjukkan penghitungan AAE untuk kueri yang sama dalam tabel sebelumnya.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html)

Dalam kebanyakan kasus, AAS dan AAE untuk sebuah kueri kira-kira sama. Namun, karena input ke penghitungan berupa sumber data yang berbeda, penghitungannya sering sedikit berbeda.

## Dimensi
<a name="USER_PerfInsights.Overview.ActiveSessions.dimensions"></a>

Metrik `db.load` berbeda dengan metrik deret waktu lainnya karena Anda dapat membaginya menjadi beberapa sub-komponen yang disebut dimensi. Anda dapat menganggap dimensi sebagai kategori “potong menurut” untuk berbagai karakteristik metrik `DBLoad`.

Saat Anda mendiagnosis masalah performa, dimensi berikut sering kali paling berguna:

**Topics**
+ [Peristiwa tunggu](#USER_PerfInsights.Overview.ActiveSessions.waits)
+ [SQL Teratas](#USER_PerfInsights.Overview.ActiveSessions.top-sql)
+ [Rencana](#USER_PerfInsights.Overview.ActiveSessions.plans)

Untuk daftar lengkap dimensi untuk mesin Amazon RDS, lihat [Muatan DB diiris berdasarkan dimensi](USER_PerfInsights.UsingDashboard.Components.md#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.dims).

### Peristiwa tunggu
<a name="USER_PerfInsights.Overview.ActiveSessions.waits"></a>

*Peristiwa tunggu* menyebabkan pernyataan SQL menunggu peristiwa tertentu terjadi sebelum dapat terus berjalan. Peristiwa tunggu adalah dimensi penting, atau kategori, untuk muatan DB karena menunjukkan di mana pekerjaan terhambat. 

Setiap sesi aktif berjalan di CPU atau menunggu. Misalnya, sesi menggunakan CPU ketika mencari memori untuk buffer, melakukan penghitungan, atau menjalankan kode prosedural. Ketika tidak menggunakan CPU, sesi mungkin menunggu buffer memori menjadi kosong, file data dibaca, atau log untuk ditulis. Semakin banyak waktu untuk sesi menunggu sumber daya, semakin sedikit waktu untuk sesi dijalankan di CPU. 

Ketika Anda menyetel basis data, Anda sering mencoba mencari tahu sumber daya yang sedang menunggu sesi. Misalnya, dua atau tiga peristiwa tunggu mungkin menyumbang 90 persen dari muatan DB. Ukuran ini berarti bahwa, rata-rata, sesi aktif menghabiskan sebagian besar waktunya menunggu sejumlah kecil sumber daya. Jika Anda dapat mengetahui penyebab peristiwa tunggu ini, Anda dapat mencoba solusinya. 

Peristiwa tunggu bervariasi berdasarkan mesin DB: 
+ Untuk informasi tentang semua peristiwa tunggu MariaDB dan MySQL, lihat [Wait Event Summary Tables](https://dev.mysql.com/doc/refman/8.0/en/performance-schema-wait-summary-tables.html) dalam dokumentasi MySQL.
+ Untuk informasi tentang semua peristiwa tunggu PostgreSQL, lihat [The Statistics Collector > Wait Event tables](https://www.postgresql.org/docs/current/monitoring-stats.html#WAIT-EVENT-TABLE) dalam dokumentasi PostgreSQL.
+ Untuk informasi tentang semua peristiwa tunggu Oracle, lihat [Descriptions of Wait Events](https://docs.oracle.com/database/121/REFRN/GUID-2FDDFAA4-24D0-4B80-A157-A907AF5C68E2.htm#REFRN-GUID-2FDDFAA4-24D0-4B80-A157-A907AF5C68E2) dalam dokumentasi Oracle.
+ Untuk informasi tentang semua peristiwa tunggu SQL Server, lihat [Types of Waits](https://docs.microsoft.com/en-us/sql/relational-databases/system-dynamic-management-views/sys-dm-os-wait-stats-transact-sql?view=sql-server-2017#WaitTypes) dalam dokumentasi SQL Server.

**catatan**  
Untuk Oracle, proses latar belakang terkadang berfungsi tanpa pernyataan SQL terkait. Dalam kasus ini, Wawasan Performa melaporkan jenis proses latar belakang yang digabungkan dengan titik dua dan kelas tunggu yang terkait dengan proses latar belakang tersebut. Jenis proses latar belakang meliputi `LGWR`, `ARC0`, `PMON`, dan sebagainya.   
Sebagai contoh, ketika pengarsip melakukan I/O, laporan Wawasan Performa untuk I/O mirip dengan `ARC1:System I/O`. Kadang-kadang, jenis proses latar belakang juga hilang, dan Wawasan Performa hanya melaporkan kelas tunggu, misalnya `:System I/O`.

### SQL Teratas
<a name="USER_PerfInsights.Overview.ActiveSessions.top-sql"></a>

Saat peristiwa tunggu menunjukkan kemacetan, SQL teratas menunjukkan kueri mana yang paling berkontribusi pada pemuatan DB. Misalnya, saat ini mungkin ada banyak kueri yang berjalan di basis data, tetapi kueri tunggal mungkin menggunakan 99 persen dari muatan DB. Dalam hal ini, muatan tinggi mungkin menunjukkan masalah dalam kueri.

Secara default, konsol Wawasan Performa menampilkan kueri SQL teratas yang berkontribusi pada muatan basis data. Konsol juga menunjukkan statistik yang relevan untuk setiap pernyataan. Untuk mendiagnosis masalah performa untuk pernyataan tertentu, Anda dapat memeriksa rencana pelaksanaannya.

### Rencana
<a name="USER_PerfInsights.Overview.ActiveSessions.plans"></a>

*Rencana eksekusi*, juga cukup disebut *rencana*, adalah urutan langkah-langkah yang mengakses data. Misalnya, rencana untuk menggabungkan tabel `t1` dan `t2` mungkin mengulang semua baris di `t1` dan membandingkan setiap baris dengan baris di `t2`. Dalam basis data relasional, *pengoptimal* adalah kode default yang menentukan rencana paling efisien untuk kueri SQL.

Untuk instans DB, Performance Insights mengumpulkan rencana eksekusi secara otomatis. Untuk mendiagnosis masalah kinerja SQL, periksa rencana yang diambil untuk kueri SQL sumber daya tinggi. Rencana menunjukkan bagaimana database telah mengurai dan menjalankan kueri.

Untuk mempelajari cara menganalisis beban DB menggunakan rencana, lihat:
+ Oracle: [Menganalisis rencana eksekusi Oracle menggunakan dasbor Performance Insights untuk Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlans.md)
+ Server SQL: [Menganalisis paket eksekusi SQL Server menggunakan dasbor Performance Insights untuk Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlansSqlServer.md)

#### Penangkapan rencana
<a name="USER_PerfInsights.Overview.ActiveSessions.plans.capture"></a>

Setiap lima menit, Performance Insights mengidentifikasi kueri yang paling intensif sumber daya dan menangkap rencana mereka. Dengan demikian, Anda tidak perlu mengumpulkan dan mengelola rencana dalam jumlah besar secara manual. Sebagai alternatif, Anda dapat menggunakan tab **SQL Teratas** untuk berfokus pada rencana untuk kueri yang paling bermasalah. 

**catatan**  
Wawasan Performa tidak menangkap rencana untuk kueri yang teksnya melebihi batas teks kueri maksimum yang dapat dikumpulkan. Untuk informasi selengkapnya, lihat [Mengakses lebih banyak teks SQL di dasbor Wawasan Performa](USER_PerfInsights.UsingDashboard.SQLTextSize.md).

Periode retensi untuk rencana eksekusi sama dengan data Wawasan Performa Anda. Pengaturan retensi adalah **Default (7 hari)**. Untuk mempertahankan data performa Anda lebih lama, tetapkan 1–24 bulan. Untuk informasi selengkapnya tentang periode retensi, lihat [Harga dan retensi data untuk Wawasan Performa](USER_PerfInsights.Overview.cost.md).

#### Kueri digest
<a name="USER_PerfInsights.Overview.ActiveSessions.plans.digest"></a>

Tab **SQL Teratas** menunjukkan kueri digest secara default. Kueri digest sendiri tidak memiliki rencana, tetapi semua kueri yang menggunakan nilai literal memiliki rencana. Misalnya, kueri digest mungkin menyertakan teks `WHERE `email`=?`. Digest mungkin berisi dua kueri, satu dengan teks `WHERE email=user1@example.com` dan satu lagi dengan `WHERE email=user2@example.com` Masing-masing kueri literal ini mungkin mencakup beberapa rencana.

Saat Anda memilih kueri intisari, konsol akan menampilkan semua paket untuk pernyataan turunan dari intisari yang dipilih. Dengan demikian, Anda tidak perlu melihat semua pernyataan turunan untuk menemukan rencana. Anda mungkin melihat rencana yang tidak ada dalam daftar 10 pernyataan turunan teratas yang ditampilkan. Konsol menampilkan rencana untuk semua kueri turunan yang rencananya telah dikumpulkan, terlepas dari apakah kueri tercantum dalam daftar 10 teratas.

# Maksimum CPU
<a name="USER_PerfInsights.Overview.MaxCPU"></a>

Di dasbor, bagan **Basis data muatan** mengumpulkan, menggabungkan, dan menampilkan informasi sesi. Untuk melihat apakah sesi aktif melebihi maksimumCPU, lihat hubungannya dengan CPU garis **Max v**. Performance Insights menentukan CPU nilai **Max v** dengan jumlah inti v CPU (virtualCPU) untuk instans DB Anda. 

Satu proses dapat berjalan pada v CPU pada satu waktu. Jika jumlah proses melebihi jumlahvCPUs, proses mulai mengantri. Saat antrian meningkat, kinerja database menurun. Jika beban DB sering di atas CPU garis **Max v**, dan status tunggu utama adalahCPU, kelebihan beban. CPU Dalam kasus ini, Anda mungkin ingin membatasi koneksi ke instance, menyetel SQL kueri apa pun dengan CPU beban tinggi, atau mempertimbangkan kelas instance yang lebih besar. Instans yang tinggi dan konsisten dari setiap status tunggu menunjukkan bahwa mungkin terjadi kemacetan atau masalah pertentangan sumber daya yang perlu diselesaikan. Ini bisa benar bahkan jika beban DB tidak melewati CPU garis **Max v**.

# Amazon RDS Aurora DB engine, Wilayah, dan dukungan kelas instans untuk Performance Insights
<a name="USER_PerfInsights.Overview.Engines"></a>

**penting**  
 AWS telah mengumumkan end-of-life tanggal Performance Insights: 30 Juni 2026. Setelah tanggal ini, Amazon RDS tidak akan lagi mendukung pengalaman konsol Performance Insights, periode retensi fleksibel (1-24 bulan), dan harga terkait. Performance Insights API akan terus ada tanpa perubahan harga. Biaya untuk API Performance Insights akan muncul di AWS tagihan Anda dengan biaya CloudWatch Database Insights.   
 Sebaiknya Anda meningkatkan instans apa pun menggunakan tingkat berbayar Performance Insights ke mode Advanced Database Insights sebelum 30 Juni 2026. Untuk informasi tentang memutakhirkan ke mode Advanced Database Insights, lihat. [](USER_DatabaseInsights.TurningOnAdvanced.md)   
 Jika Anda tidak mengambil tindakan, instans DB yang menggunakan Performance Insights akan secara default menggunakan mode Standar Database Insights. Dengan mode Standar Database Insights, Anda mungkin kehilangan akses ke riwayat data kinerja setelah 7 hari dan mungkin tidak dapat menggunakan paket eksekusi dan fitur analisis sesuai permintaan di konsol Amazon RDS. Setelah 30 Juni 2026, hanya mode Advanced Database Insights yang akan mendukung rencana eksekusi dan analisis sesuai permintaan.   
 Dengan CloudWatch Database Insights, Anda dapat memantau beban database untuk armada database Anda dan menganalisis serta memecahkan masalah kinerja dalam skala besar. Untuk informasi selengkapnya tentang Wawasan Database, lihat[Memantau database Amazon RDS Aurora dengan Database CloudWatch Insights](USER_DatabaseInsights.md). Untuk informasi harga, lihat [ CloudWatch Harga Amazon](https://aws.amazon.com/cloudwatch/pricing/). 

Tabel berikut berisi mesin DB Amazon RDS yang mendukung Wawasan Performa.

**catatan**  
Untuk Amazon Aurora, lihat [Dukungan mesin DB Amazon Aurora untuk Wawasan Performa](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.Overview.Engines.html) di *Panduan Pengguna Amazon Aurora*.


|  Mesin DB Amazon RDS  | Versi mesin dan Wilayah yang didukung | Pembatasan kelas instans | 
| --- | --- | --- | 
|  Amazon RDS for MariaDB  |  Untuk informasi selengkapnya tentang versi dan ketersediaan Wilayah Wawasan Performa dengan RDS for MariaDB, lihat [Wilayah dan engine DB yang Didukung untuk Performance Insights di Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md).  |  Wawasan Performa tidak didukung untuk kelas instans berikut: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.Engines.html)  | 
|  RDS for MySQL  |  Untuk informasi selengkapnya tentang versi dan ketersediaan Wilayah Wawasan Performa dengan RDS for MySQL, lihat [Wilayah dan engine DB yang Didukung untuk Performance Insights di Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md).  |  Wawasan Performa tidak didukung untuk kelas instans berikut: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.Engines.html)  | 
|  Amazon RDS for Microsoft SQL Server  |  Untuk informasi lebih lanjut tentang versi dan ketersediaan Wilayah Wawasan Performa dengan RDS for SQL Server, lihat [Wilayah dan engine DB yang Didukung untuk Performance Insights di Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md).  |  N/A  | 
|  Amazon RDS for PostgreSQL  |  Untuk informasi selengkapnya tentang versi dan ketersediaan Wilayah Wawasan Performa dengan RDS for PostgreSQL, lihat [Wilayah dan engine DB yang Didukung untuk Performance Insights di Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md).  |  N/A  | 
|  Amazon RDS for Oracle  |  Untuk informasi selengkapnya tentang versi dan ketersediaan Wilayah Wawasan Performa dengan RDS for Oracle, lihat [Wilayah dan engine DB yang Didukung untuk Performance Insights di Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md).  |  N/A  | 

## Amazon RDS Aurora DB engine, Wilayah, dan dukungan kelas instans untuk fitur Performance Insights
<a name="USER_PerfInsights.Overview.PIfeatureEngnRegSupport"></a>

Tabel berikut berisi mesin DB Amazon RDS yang mendukung fitur Wawasan Performa.


| Fitur | [Tingkat harga](https://aws.amazon.com/rds/performance-insights/pricing/) |  [Wilayah yang didukung](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html#Concepts.RegionsAndAvailabilityZones.Regions)  |  [ Mesin DB yang didukung](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Welcome.html#Welcome.Concepts.DBInstance)  |  [Kelas instans yang didukung](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html#Concepts.DBInstanceClass.Types)  | 
| --- | --- | --- | --- | --- | 
| [Statistik SQL untuk Wawasan Performa](sql-statistics.md) | Semua | Semua |  Semua  | Semua | 
| [Menganalisis rencana eksekusi Oracle menggunakan dasbor Performance Insights untuk Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlans.md) | Semua | Semua |  RDS for Oracle  | Semua | 
| [Menganalisis performa basis data selama periode waktu tertentu](USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.md) | Khusus tingkat berbayar |  Semua  |  RDS for PostgreSQL  |  Semua  | 
|  [Melihat rekomendasi proaktif Performance Insights](USER_PerfInsights.InsightsRecommendationViewDetails.md) | Khusus tingkat berbayar | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.Engines.html)  |  Semua  | Semua  | 

# Harga dan retensi data untuk Wawasan Performa
<a name="USER_PerfInsights.Overview.cost"></a>

Secara default, Performance Insights mencakup 7 hari riwayat data kinerja dan 1 juta permintaan API per bulan. Anda juga dapat membeli periode retensi yang lebih lama. Untuk informasi harga selengkapnya, lihat [Harga Wawasan Performa](https://aws.amazon.com/rds/performance-insights/pricing/).

Di konsol RDS, Anda dapat memilih salah satu periode retensi berikut untuk data Wawasan Performa:
+ **Default (7 hari)**
+ ***n*bulan**, di ***n***mana angka dari 1—24

![\[Pilih salah satu periode retensi untuk data Wawasan Performa Anda.\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/pi-retention-periods.png)


Untuk mempelajari cara mengatur periode retensi menggunakan AWS CLI, lihat[Mengaktifkan dan menonaktifkan Performance Insights untuk Amazon RDS](USER_PerfInsights.Enabling.md).

**catatan**  
 

# Mengaktifkan dan menonaktifkan Performance Insights untuk Amazon RDS
<a name="USER_PerfInsights.Enabling"></a>

**penting**  
 AWS telah mengumumkan end-of-life tanggal Performance Insights: 30 Juni 2026. Setelah tanggal ini, Amazon RDS tidak akan lagi mendukung pengalaman konsol Performance Insights, periode retensi fleksibel (1-24 bulan), dan harga terkait. Performance Insights API akan terus ada tanpa perubahan harga. Biaya untuk API Performance Insights akan muncul di AWS tagihan Anda dengan biaya CloudWatch Database Insights.   
 Sebaiknya Anda meningkatkan instans apa pun menggunakan tingkat berbayar Performance Insights ke mode Advanced Database Insights sebelum 30 Juni 2026. Untuk informasi tentang meningkatkan ke mode Advanced Database Insights, lihat. [](USER_DatabaseInsights.TurningOnAdvanced.md)   
 Jika Anda tidak mengambil tindakan, instans DB yang menggunakan Performance Insights akan secara default menggunakan mode Standar Database Insights. Dengan mode Standar Database Insights, Anda mungkin kehilangan akses ke riwayat data kinerja setelah 7 hari dan mungkin tidak dapat menggunakan paket eksekusi dan fitur analisis sesuai permintaan di konsol Amazon RDS. Setelah 30 Juni 2026, hanya mode Advanced Database Insights yang akan mendukung rencana eksekusi dan analisis sesuai permintaan.   
 Dengan CloudWatch Database Insights, Anda dapat memantau beban database untuk armada database Anda dan menganalisis serta memecahkan masalah kinerja dalam skala besar. Untuk informasi selengkapnya tentang Wawasan Database, lihat[Memantau database Amazon RDS Aurora dengan Database CloudWatch Insights](USER_DatabaseInsights.md). Untuk informasi harga, lihat [ CloudWatch Harga Amazon](https://aws.amazon.com/cloudwatch/pricing/). 

Anda dapat mengaktifkan Performance Insights untuk instans DB atau klaster DB multi-AZ saat membuatnya. Jika diperlukan, Anda dapat mematikannya nanti dengan memodifikasi instans DB Anda dari konsol. Mengaktifkan dan menonaktifkan Wawasan Performa tidak menyebabkan waktu henti, boot ulang, atau failover.

**catatan**  
Skema Performa adalah alat performa opsional yang digunakan oleh Amazon RDS for MariaDB atau MySQL. Jika Anda mengaktifkan atau menonaktifkan Skema Performa, Anda perlu mem-boot ulang. Namun, jika Anda mengaktifkan atau menonaktifkan Wawasan Performa, Anda tidak perlu mem-boot ulang. Untuk informasi selengkapnya, lihat [Ikhtisar Skema Kinerja untuk Performance Insights di MySQL Amazon RDS untuk MariaDB atau MySQL](USER_PerfInsights.EnableMySQL.md).

Agen Wawasan Performa menggunakan CPU dan memori terbatas di host DB. Ketika muatan DB tinggi, agen membatasi dampak performa dengan mengurangi frekuensi pengumpulan data.

------
#### [ Console ]

Di konsol, Anda dapat mengaktifkan atau menonaktifkan Wawasan Performa saat membuat atau mengubah instans DB atau klaster DB Multi-AZ.

****

 **Untuk menonaktifkan Performance Insights , pilih opsi **Database Insights — Standard** dan batalkan pilihan opsi Aktifkan Performance Insights.**

Untuk informasi selengkapnya, lihat topik berikut. 
+ Untuk membuat instans DB, ikuti petunjuk untuk mesin DB Anda di [Membuat instans DB Amazon RDS](USER_CreateDBInstance.md).
+ Untuk membuat klaster DB Multi-AZ, ikuti petunjuk untuk mesin DB Anda di [Membuat cluster DB Multi-AZ untuk Amazon RDS](create-multi-az-db-cluster.md).

Tangkapan layar berikut menunjukkan bagian **Wawasan Performa**.

![\[Aktifkan Performance Insights selama instans DB atau pembuatan klaster DB multi-AZ dengan konsol\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_enabling.png)


Jika memilih **Aktifkan Wawasan Performa**, Anda akan memiliki opsi berikut:
+ **Retensi** (hanya untuk mode Standar Database Insights) — Jumlah waktu untuk menyimpan data Performance Insights. Pengaturan retensi adalah **Default (7 hari)**. Untuk mempertahankan data performa Anda lebih lama, tetapkan 1–24 bulan. Untuk informasi selengkapnya tentang periode retensi, lihat [Harga dan retensi data untuk Wawasan Performa](USER_PerfInsights.Overview.cost.md).
+ **AWS KMS key**— Tentukan Anda AWS KMS key. Wawasan Performa mengenkripsi semua data yang berpotensi sensitif menggunakan kunci KMS Anda. Data dienkripsi saat dipindahkan dan saat tidak aktif. Untuk informasi selengkapnya, lihat [Mengubah AWS KMS kebijakan untuk Performance Insights](USER_PerfInsights.access-control.cmk-policy.md).

**Mengaktifkan atau menonaktifkan Performance Insights saat memodifikasi instans DB multi-AZ**

Di konsol, Anda dapat memodifikasi cluster DB instans DB multi-AZ untuk mengelola Performance Insights. 

**Untuk mengelola Performance Insights untuk instans DB atau cluster DB cluster DB multi-AZ menggunakan**

1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon RDS di [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Pilih **Basis data**.

1. Pilih instans DB atau cluster DB multi-AZ, dan pilih **Modify**.

1. Untuk mengaktifkan Performance Insights, pilih **Aktifkan Performance Insights**. **Untuk menonaktifkan Performance Insights , pilih opsi **Database Insights — Standard** dan batalkan pilihan opsi Aktifkan Performance Insights.**

   Jika memilih **Aktifkan Wawasan Performa**, Anda akan memiliki opsi berikut:
   + **Retensi** (hanya untuk mode Standar Database Insights) — Jumlah waktu untuk menyimpan data Performance Insights. Pengaturan retensi adalah **Default (7 hari)**. Untuk mempertahankan data performa Anda lebih lama, tetapkan 1–24 bulan. Untuk informasi selengkapnya tentang periode retensi, lihat [Harga dan retensi data untuk Wawasan Performa](USER_PerfInsights.Overview.cost.md).
   + **AWS KMS key** – Tentukan kunci KMS Anda. Wawasan Performa mengenkripsi semua data yang berpotensi sensitif menggunakan kunci KMS Anda. Data dienkripsi saat dipindahkan dan saat tidak aktif. Untuk informasi selengkapnya, lihat [Mengenkripsi sumber daya Amazon RDS](Overview.Encryption.md).

1. Pilih **Lanjutkan**.

1. Untuk **Penjadwalan Modifikasi**, pilih Terapkan langsung. Jika Anda memilih Terapkan selama periode pemeliharaan terjadwal berikutnya, instans Anda akan mengabaikan pengaturan ini dan segera mengaktifkan Wawasan Performa.

1. Pilih **Ubah instans**.

------
#### [ AWS CLI ]

Saat Anda menggunakan [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) AWS CLI perintah, aktifkan Performance Insights dengan menentukan `--enable-performance-insights` dan menyetel `--database-insights-mode` ke salah satu atau. `advanced` `standard` Untuk menonaktifkan Performance Insights, tentukan `--no-enable-performance-insights` dan setel `database-insights-mode` ke. `standard`

Anda juga dapat menentukan nilai-nilai ini menggunakan AWS CLI perintah berikut:
+  [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html) 
+  [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) 
+  [create-db-instance-read-replika](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance-read-replica.html) 
+  [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) 
+  [restore-db-instance-from-s3](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-s3.html) 

Saat mengaktifkan Wawasan Performa di CLI, Anda dapat secara opsional menentukan jumlah hari untuk mempertahankan data Wawasan Performa dengan opsi `--performance-insights-retention-period`. Anda dapat menentukan`7`, *month* \$1 31 (di *month* mana angka dari 1-23), atau. `731` Misalnya, jika Anda ingin mempertahankan data performa selama 3 bulan, tentukan `93`, yakni 3 \$1 31. Nilai default-nya adalah `7` hari. Untuk informasi selengkapnya tentang periode retensi, lihat [Harga dan retensi data untuk Wawasan Performa](USER_PerfInsights.Overview.cost.md).

Contoh berikut mengaktifkan Wawasan Performa untuk `sample-db-cluster` dan menentukan bahwa data Wawasan Performa dipertahankan selama 93 hari (3 bulan).

Untuk Linux, macOS, atau Unix:

```
aws rds modify-db-cluster \
	--database-insights-mode standard \
    --db-cluster-identifier sample-db-instance \
    --enable-performance-insights \
    --performance-insights-retention-period 93
```

Untuk Windows:

```
aws rds modify-db-cluster ^
	--database-insights-mode standard ^
    --db-cluster-identifier sample-db-instance ^
    --enable-performance-insights ^
    --performance-insights-retention-period 93
```

Jika Anda menentukan periode retensi seperti 94 hari, yang bukan merupakan nilai yang valid, RDS akan mengeluarkan kesalahan.

```
An error occurred (InvalidParameterValue) when calling the CreateDBInstance operation: 
Invalid Performance Insights retention period. Valid values are: [7, 31, 62, 93, 124, 155, 186, 217, 
248, 279, 310, 341, 372, 403, 434, 465, 496, 527, 558, 589, 620, 651, 682, 713, 731]
```

**catatan**  
Anda hanya dapat mengaktifkan Performance Insights untuk instance di klaster DB yang Performance Insights tidak dikelola di tingkat klaster.

------
#### [ RDS API ]

Saat Anda membuat instans DB baru menggunakan DBInstance operasi [Create](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) operation Amazon RDS API, aktifkan Performance Insights dengan `EnablePerformanceInsights` menyetelnya. `True` Untuk menonaktifkan Performance Insights, setel `EnablePerformanceInsights` ke `False` dan setel `DatabaseInsightsMode` ke. `standard`

Anda juga dapat menentukan nilai `EnablePerformanceInsights` menggunakan operasi API berikut:
+  [Buat DBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html) (cluster DB multi-AZ) 
+  [Ubah DBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) (cluster DB multi-AZ) 
+  [Memodifikasi DBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) 
+  [Buat DBInstance ReadReplica](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstanceReadReplica.html) 
+  [Kembalikan DBInstance dari3](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromS3.html) 

Saat mengaktifkan Wawasan Performa, Anda dapat secara opsional menentukan jumlah waktu, dalam hari, untuk mempertahankan data Wawasan Performa dengan parameter `PerformanceInsightsRetentionPeriod`. Anda dapat menentukan`7`, *month* \$1 31 (di *month* mana angka dari 1-23), atau. `731` Misalnya, jika Anda ingin mempertahankan data performa selama 3 bulan, tentukan `93`, yakni 3 \$1 31. Nilai default-nya adalah `7` hari. Untuk informasi selengkapnya tentang periode retensi, lihat [Harga dan retensi data untuk Wawasan Performa](USER_PerfInsights.Overview.cost.md).

------

# Ikhtisar Skema Kinerja untuk Performance Insights di MySQL Amazon RDS untuk MariaDB atau MySQL
<a name="USER_PerfInsights.EnableMySQL"></a>

Skema Performa adalah fitur opsional untuk memantau performa runtime Amazon RDS for MariaDB atau MySQL dengan tingkat detail rendah. Skema Performa dirancang untuk memiliki dampak minimal terhadap performa basis data. Wawasan Performa adalah fitur terpisah yang dapat digunakan dengan atau tanpa Skema Performa.

**Topics**
+ [Ikhtisar Skema Performa](#USER_PerfInsights.EnableMySQL.overview)
+ [Wawasan Performa dan Skema Performa](#USER_PerfInsights.effect-of-pfs)
+ [Manajemen Skema Performa otomatis berdasarkan Wawasan Performa](#USER_PerfInsights.EnableMySQL.options)
+ [Pengaruh boot ulang pada Skema Performa](#USER_PerfInsights.EnableMySQL.reboot)
+ [Menentukan apakah Wawasan Performa mengelola Skema Performa](USER_PerfInsights.EnableMySQL.determining-status.md)
+ [Aktifkan Skema Kinerja untuk MySQL Amazon RDS untuk MariaDB atau MySQL](USER_PerfInsights.EnableMySQL.RDS.md)

## Ikhtisar Skema Performa
<a name="USER_PerfInsights.EnableMySQL.overview"></a>

Skema Performa memantau peristiwa dalam basis data MariaDB dan MySQL. *Peristiwa* adalah tindakan server basis data yang memakan waktu dan telah diinstrumentasi sehingga informasi waktu dapat dikumpulkan. Contoh peristiwa antara lain:
+ Panggilan fungsi
+ Peristiwa tunggu untuk sistem operasi
+ Tahapan eksekusi SQL
+ Grup pernyataan SQL

Mesin penyimpanan `PERFORMANCE_SCHEMA` adalah mekanisme untuk mengimplementasikan fitur Skema Performa. Mesin ini mengumpulkan data peristiwa menggunakan instrumentasi dalam kode sumber basis data. Mesin menyimpan peristiwa dalam tabel hanya memori di basis data `performance_schema`. Anda dapat mengueri `performance_schema` sama seperti Anda mengueri tabel lainnya. Untuk informasi selengkapnya, lihat [Skema Performa MySQL](https://dev.mysql.com/doc/refman/8.0/en/performance-schema.html) di *Panduan Referensi MySQL*.

## Wawasan Performa dan Skema Performa
<a name="USER_PerfInsights.effect-of-pfs"></a>

Wawasan Performa dan Skema Performa adalah fitur terpisah, tetapi terhubung. Perilaku Wawasan Performa untuk Amazon RDS for MariaDB or MySQL bergantung pada apakah Skema Performa diaktifkan, dan jika demikian, apakah Wawasan Performa mengelola Skema Performa secara otomatis. Tabel berikut menjelaskan perilaku tersebut.


| Skema Performa diaktifkan | Mode manajemen Wawasan Performa | Perilaku Wawasan Performa | 
| --- | --- | --- | 
|  Ya  |  Otomatis  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/USER_PerfInsights.EnableMySQL.html)  | 
|  Ya  |  Manual  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/USER_PerfInsights.EnableMySQL.html)  | 
|  Tidak  |  N/A  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/USER_PerfInsights.EnableMySQL.html)  | 

## Manajemen Skema Performa otomatis berdasarkan Wawasan Performa
<a name="USER_PerfInsights.EnableMySQL.options"></a>

Ketika Anda membuat instans DB Amazon RDS for MariaDB atau MySQL dengan Wawasan Performa diaktifkan, Skema Performa juga diaktifkan. Dalam kasus ini, Wawasan Performa secara otomatis mengelola parameter Skema Performa Anda. Ini adalah konfigurasi yang disarankan.

Saat Performance Insights mengelola Skema Kinerja secara otomatis, **Sumber** is. `performance_schema` `System default`

**catatan**  
Manajemen Skema Performa otomatis tidak didukung untuk kelas instans t4g.medium.

Jika Anda mengubah nilai parameter `performance_schema` secara manual, dan kemudian ingin mengubah ke manajemen otomatis di lain waktu, lihat [Aktifkan Skema Kinerja untuk MySQL Amazon RDS untuk MariaDB atau MySQL](USER_PerfInsights.EnableMySQL.RDS.md).

**penting**  
Saat Wawasan Performa mengaktifkan Skema Performa, nilai grup parameter tidak akan diubah. Namun, nilainya diubah pada instans DB yang sedang berjalan. Satu-satunya cara untuk melihat nilai yang diubah adalah dengan menjalankan perintah `SHOW GLOBAL VARIABLES`.

## Pengaruh boot ulang pada Skema Performa
<a name="USER_PerfInsights.EnableMySQL.reboot"></a>

Wawasan Performa dan Skema Performa berbeda dalam persyaratannya untuk boot ulang instans DB:

**Skema Performa**  
Untuk mengaktifkan atau menonaktifkan fitur ini, Anda harus mem-boot ulang instans DB.

**Wawasan Performa**  
Untuk mengaktifkan atau menonaktifkan fitur ini, Anda tidak harus mem-boot ulang instans DB.

Jika Skema Performa saat ini tidak diaktifkan, dan Anda mengaktifkan Wawasan Performa tanpa mem-boot ulang instans DB, Skema Performa tidak akan diaktifkan.

# Menentukan apakah Wawasan Performa mengelola Skema Performa
<a name="USER_PerfInsights.EnableMySQL.determining-status"></a>

Untuk mengetahui apakah Performance Insights saat ini mengelola Skema Kinerja untuk semua versi engine utama yang didukung, tinjau tabel berikut.


| Pengaturan parameter performance\$1schema | Pengaturan kolom Source | Wawasan Performa mengelola Skema Performa? | 
| --- | --- | --- | 
| 0 | System default | Ya | 
| 0 atau 1 | Modified | Tidak | 

Dalam prosedur berikut, Anda menentukan apakah Performance Insights mengelola Skema Kinerja secara otomatis.

**Untuk menentukan apakah Wawasan Performa mengelola Skema Performa secara otomatis**

1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon RDS di [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Pilih **Grup parameter**.

1. Pilih nama grup parameter untuk instans DB Anda.

1. Masukkan **performance\$1schema** ke bilah pencarian.

1. Periksa apakah **Sumber** adalah default sistem dan **Nilai** adalah **0**. Jika demikian, Wawasan Performa mengelola Skema Performa secara otomatis.

   Dalam contoh yang ditampilkan di sini, Performance Insights tidak mengelola Skema Kinerja secara otomatis.  
![\[Menunjukkan bahwa pengaturan untuk parameter performance_schema diubah.\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_schema_user.png)

# Aktifkan Skema Kinerja untuk MySQL Amazon RDS untuk MariaDB atau MySQL
<a name="USER_PerfInsights.EnableMySQL.RDS"></a>

Asumsikan bahwa Wawasan Performa diaktifkan untuk instans DB atau klaster DB multi-AZ, tetapi saat ini tidak mengelola Wawasan Performa. Jika Anda ingin mengizinkan Wawasan Performa mengelola Skema Performa secara otomatis, selesaikan langkah-langkah berikut.

**Untuk mengonfigurasi Skema Performa untuk manajemen otomatis**

1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon RDS di [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Pilih **Grup parameter**.

1. Pilih nama grup parameter untuk instans DB atau klaster DB Multi-AZ.

1. Pilih **Edit**.

1. Masukkan **performance\$1schema** ke bilah pencarian.

1. Pilih parameter `performance_schema`.

1. Pilih **Setel ke nilai default**.

1. Konfirmasikan dengan memilih **Tetapkan nilai ke default**.

1. Pilih **Simpan Perubahan**.

1. Boot ulang instans DB atau klaster DB multi-AZ.
**penting**  
Setiap kali Anda mengaktifkan atau menonaktifkan Skema Performa, pastikan untuk mem-boot ulang instans DB atau klaster DB multi-AZ.

Untuk informasi tentang cara mengubah parameter instans, lihat [](USER_WorkingWithParamGroups.Modifying.md). Untuk informasi selengkapnya tentang dasbor, lihat [Menganalisis metrik dengan dasbor Wawasan Performa](USER_PerfInsights.UsingDashboard.md). Untuk informasi selengkapnya tentang skema kinerja MySQL, [lihat MySQL Performance Schema (untuk 8.0) dan MySQL Performance](https://dev.mysql.com/doc/refman/8.0/en/performance-schema.html) [Schema (untuk 8.4) dalam dokumentasi MySQL](https://dev.mysql.com/doc/refman/8.4/en/performance-schema.html).

# Mengonfigurasi kebijakan akses untuk Wawasan Performa
<a name="USER_PerfInsights.access-control"></a>

Untuk mengakses Performance Insights, prinsipal harus memiliki izin yang sesuai dari AWS Identity and Access Management (IAM).

**catatan**  
Untuk menggunakan Performance Insights dengan kunci yang dikelola pelanggan, berikan pengguna `kms:Decrypt` dan `kms:GenerateDataKey` izin untuk kunci Anda. AWS AWS KMS 

Akses Performance Insights menggunakan metode berikut:
+ [Lampirkan kebijakan `AmazonRDSPerformanceInsightsReadOnly` terkelola untuk akses hanya-baca](USER_PerfInsights.access-control.managed-policy.md)
+ [Lampirkan kebijakan `AmazonRDSPerformanceInsightsFullAccess` terkelola untuk akses ke semua operasi API Performance Insights](USER_PerfInsights.access-control.FullAccess-managed-policy.md)
+ [Buat kebijakan IAM khusus dengan izin tertentu](USER_PerfInsights.access-control.custom-policy.md)
+ [Mengonfigurasi AWS KMS izin untuk data Performance Insights terenkripsi](USER_PerfInsights.access-control.cmk-policy.md)
+ [Siapkan akses berbutir halus menggunakan izin tingkat sumber daya](USER_PerfInsights.access-control.dimensionAccess-policy.md)
+ [Gunakan kontrol akses berbasis tag untuk mengelola izin melalui tag sumber daya](USER_PerfInsights.access-control.tag-based-policy.md)

# Melampirkan AmazonRDSPerformanceInsightsReadOnly kebijakan ke kepala IAM
<a name="USER_PerfInsights.access-control.managed-policy"></a>

`AmazonRDSPerformanceInsightsReadOnly`adalah kebijakan AWS terkelola yang memberikan akses ke semua operasi hanya-baca dari Amazon RDS Performance Insights API. 

Jika Anda melampirkan `AmazonRDSPerformanceInsightsReadOnly` ke set izin atau peran, Anda juga harus melampirkan CloudWatch izin berikut:
+ `GetMetricStatistics`
+ `ListMetrics`
+ `GetMetricData`

Dengan izin ini, penerima dapat menggunakan Performance Insights dengan fitur konsol lainnya.

 Untuk informasi selengkapnya tentang CloudWatch izin, lihat referensi [ CloudWatch izin Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html).

Untuk informasi selengkapnya tentang `AmazonRDSPerformanceInsightsReadOnly`, lihat [AWS kebijakan terkelola: Amazon RDSPerformance InsightsReadOnly](rds-security-iam-awsmanpol.md#rds-security-iam-awsmanpol-AmazonRDSPerformanceInsightsReadOnly).

# Melampirkan AmazonRDSPerformanceInsightsFullAccess kebijakan ke kepala IAM
<a name="USER_PerfInsights.access-control.FullAccess-managed-policy"></a>

`AmazonRDSPerformanceInsightsFullAccess`adalah kebijakan AWS terkelola yang memberikan akses ke semua operasi Amazon RDS Performance Insights API.

Jika Anda melampirkan `AmazonRDSPerformanceInsightsFullAccess` ke set izin atau peran, Anda juga harus melampirkan CloudWatch izin berikut:
+ `GetMetricStatistics`
+ `ListMetrics`
+ `GetMetricData`

Dengan izin ini, penerima dapat menggunakan Performance Insights dengan fitur konsol lainnya.

 Untuk informasi selengkapnya tentang CloudWatch izin, lihat referensi [ CloudWatch izin Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html).

Untuk informasi selengkapnya tentang `AmazonRDSPerformanceInsightsFullAccess`, lihat [AWS kebijakan terkelola: Amazon RDSPerformance InsightsFullAccess](rds-security-iam-awsmanpol.md#rds-security-iam-awsmanpol-AmazonRDSPerformanceInsightsFullAccess).

# Membuat kebijakan IAM kustom untuk Wawasan Performa
<a name="USER_PerfInsights.access-control.custom-policy"></a>

Untuk pengguna yang tidak memiliki `AmazonRDSPerformanceInsightsFullAccess` kebijakan `AmazonRDSPerformanceInsightsReadOnly` atau kebijakan, Anda dapat memberikan akses ke Performance Insights dengan membuat atau memodifikasi kebijakan IAM yang dikelola pengguna. Jika Anda melampirkan kebijakan ini ke kumpulan izin atau peran IAM, penerima dapat menggunakan Wawasan Performa.

**Untuk membuat kebijakan kustom**

1. Buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. Di panel navigasi, pilih **Kebijakan**.

1. Pilih **Buat kebijakan**.

1. Pada halaman **Buat Kebijakan**, pilih opsi **JSON**.

1. Salin dan tempel teks yang disediakan di bagian *dokumen kebijakan JSON* di *Panduan Referensi Kebijakan AWS Terkelola* untuk [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonRDSPerformanceInsightsReadOnly.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonRDSPerformanceInsightsReadOnly.html)atau [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonRDSPerformanceInsightsFullAccess.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonRDSPerformanceInsightsFullAccess.html)kebijakan.

1. Pilih **Tinjau kebijakan**.

1. Berikan nama untuk kebijakan tersebut dan secara opsional deskripsi, lalu pilih **Buat kebijakan**.

Sekarang, Anda dapat menyisipkan kebijakan ke kumpulan izin atau peran. Prosedur berikut mengasumsikan bahwa Anda sudah memiliki pengguna yang tersedia untuk tujuan ini.

**Untuk melampirkan kebijakan ini ke pengguna**

1. Buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. Di panel navigasi, pilih **Pengguna**.

1. Pilih pengguna yang ada dari daftar.
**penting**  
Untuk menggunakan Wawasan Performa, pastikan Anda memiliki akses ke Amazon RDS selain ke kebijakan kustom. Misalnya, kebijakan `AmazonRDSPerformanceInsightsReadOnly` yang ditentukan sebelumnya memberikan akses hanca-baca ke Amazon RDS. Untuk informasi selengkapnya, lihat [Mengelola akses menggunakan kebijakan](UsingWithRDS.IAM.md#security_iam_access-manage).

1. Di halaman **Ringkasan**, pilih **Tambahkan izin**.

1. Pilih **Lampirkan kebijakan yang sudah ada secara langsung**. Untuk **Penelusuran**, ketik beberapa karakter pertama dari nama kebijakan Anda, seperti yang ditunjukkan pada gambar berikut.   
![\[Pilih Kebijakan\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_attach_iam_policy.png)

1. Pilih kebijakan Anda, lalu pilih **Berikutnya: Tinjauan**.

1. Pilih **Tambahkan izin**.

# Mengubah AWS KMS kebijakan untuk Performance Insights
<a name="USER_PerfInsights.access-control.cmk-policy"></a>

Performance Insights menggunakan perangkat AWS KMS key untuk mengenkripsi data sensitif. Saat mengaktifkan Wawasan Performa melalui API atau konsol, Anda dapat melakukan salah satu tindakan berikut:
+ Pilih default Kunci yang dikelola AWS.

  Amazon RDS menggunakan instans DB baru Anda. Kunci yang dikelola AWS Amazon RDS membuat Kunci yang dikelola AWS untuk Akun AWS Anda. Anda Akun AWS memiliki yang berbeda Kunci yang dikelola AWS untuk Amazon RDS untuk masing-masing Wilayah AWS.
+ Memilih kunci yang dikelola pelanggan.

  Jika Anda menentukan kunci yang dikelola pelanggan, pengguna di akun Anda yang memanggil API Wawasan Performa memerlukan izin `kms:Decrypt` dan `kms:GenerateDataKey` pada kunci KMS. Anda dapat mengonfigurasi izin ini melalui kebijakan IAM. Namun, sebaiknya Anda mengelola izin ini melalui kebijakan kunci KMS Anda. Untuk informasi selengkapnya, lihat [Kebijakan kunci di AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html) di *Panduan Developer AWS Key Management Service *. 

**Example**  
Contoh berikut menunjukkan cara menambahkan pernyataan ke kebijakan kunci KMS Anda. Pernyataan ini mengizinkan akses ke Wawasan Performa. Bergantung pada bagaimana Anda menggunakan kunci KMS, sebaiknya Anda mengubah beberapa pembatasan. Sebelum menambahkan pernyataan ke kebijakan, hapus semua komentar.    
****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Id" : "your-policy",
    "Statement" : [ 
        {
            "Sid" : "AllowViewingRDSPerformanceInsights",
            "Effect": "Allow",
            "Principal": {
                "AWS": [
                    "arn:aws:iam::444455556666:role/Role1"
                ]
                },
             "Action": [
                "kms:Decrypt",
                "kms:GenerateDataKey"
                ],
            "Resource": "*",
            "Condition" : {
            "StringEquals" : {
                "kms:ViaService" : "rds.us-east-1.amazonaws.com"
                },
            "ForAnyValue:StringEquals": {
                "kms:EncryptionContext:aws:pi:service": "rds",
                "kms:EncryptionContext:service": "pi",
                "kms:EncryptionContext:aws:rds:db-id": "db-AAAAABBBBBCCCCDDDDDEEEEE"
                }
            }
        }
    ]
}
```

## Bagaimana Performance Insights menggunakan kunci yang dikelola AWS KMS pelanggan
<a name="USER_PerfInsights.access-control.PI-using-KMS-cmk-policy"></a>

Wawasan Performa menggunakan kunci yang dikelola pelanggan untuk mengenkripsi data sensitif. Jika mengaktifkan Wawasan Performa, Anda dapat memberikan kunci AWS KMS melalui API. Performance Insights membuat AWS KMS izin pada kunci ini. Ini menggunakan kunci dan melakukan operasi yang diperlukan untuk memproses data sensitif. Data sensitif mencakup kolom-kolom seperti pengguna, basis data, aplikasi, dan teks kueri SQL. Wawasan Performa memastikan bahwa data tetap terenkripsi baik saat tidak aktif maupun saat transit.

## Bagaimana Performance Insights IAM bekerja dengan AWS KMS
<a name="USER_PerfInsights.access-control.PI-work-with-kms"></a>

IAM memberikan izin untuk spesifik. APIs Performance Insights memiliki publik berikut APIs, yang dapat Anda batasi menggunakan kebijakan IAM:
+ `DescribeDimensionKeys`
+ `GetDimensionKeyDetails`
+ `GetResourceMetadata`
+ `GetResourceMetrics`
+ `ListAvailableResourceDimensions`
+ `ListAvailableResourceMetrics`

Anda dapat menggunakan permintaan API berikut untuk mendapatkan data sensitif.
+ `DescribeDimensionKeys`
+ `GetDimensionKeyDetails`
+ `GetResourceMetrics`

Saat Anda menggunakan API untuk mendapatkan data sensitif, Wawasan Performa memanfaatkan kredensial pemanggil. Pemeriksaan ini memastikan bahwa akses ke data sensitif dibatasi pada mereka yang memiliki akses ke kunci KMS.

Saat memanggil ini APIs, Anda memerlukan izin untuk memanggil API melalui kebijakan IAM dan izin untuk menjalankan `kms:decrypt` tindakan melalui kebijakan utama. AWS KMS 

API `GetResourceMetrics` dapat menampilkan data sensitif dan non-sensitif. Parameter permintaan menentukan apakah respons harus menyertakan data sensitif. API menampilkan data sensitif ketika permintaan menyertakan dimensi sensitif baik dalam parameter filter atau kelompokkan-menurut. 

Untuk informasi selengkapnya tentang dimensi yang dapat Anda gunakan dengan `GetResourceMetrics` API, lihat [DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html).

**Example Contoh**  
Contoh berikut meminta data sensitif untuk grup `db.user`:  

```
POST / HTTP/1.1
Host: <Hostname>
Accept-Encoding: identity
X-Amz-Target: PerformanceInsightsv20180227.GetResourceMetrics
Content-Type: application/x-amz-json-1.1
User-Agent: <UserAgentString>
X-Amz-Date: <Date> 
Authorization: AWS4-HMAC-SHA256 Credential=<Credential>, SignedHeaders=<Headers>, Signature=<Signature>
Content-Length: <PayloadSizeBytes>
{
  "ServiceType": "RDS",
  "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W",
  "MetricQueries": [
    {
      "Metric": "db.load.avg",
      "GroupBy": {
        "Group": "db.user",
        "Limit": 2
      }
    }
  ],
  "StartTime": 1693872000,
  "EndTime": 1694044800,
  "PeriodInSeconds": 86400
}
```

**Example**  
Contoh berikut meminta data non-sensitif untuk metrik `db.load.avg`:  

```
POST / HTTP/1.1
Host: <Hostname>
Accept-Encoding: identity
X-Amz-Target: PerformanceInsightsv20180227.GetResourceMetrics
Content-Type: application/x-amz-json-1.1
User-Agent: <UserAgentString>
X-Amz-Date: <Date> 
Authorization: AWS4-HMAC-SHA256 Credential=<Credential>, SignedHeaders=<Headers>, Signature=<Signature>
Content-Length: <PayloadSizeBytes>
{
    "ServiceType": "RDS",
    "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W",
    "MetricQueries": [
        {
            "Metric": "db.load.avg"
        }
    ],
    "StartTime": 1693872000,
    "EndTime": 1694044800,
    "PeriodInSeconds": 86400
}
```

# Memberikan akses halus untuk Performance Insights
<a name="USER_PerfInsights.access-control.dimensionAccess-policy"></a>

Kontrol akses berbutir halus menawarkan cara tambahan untuk mengontrol akses ke Performance Insights. Kontrol akses ini dapat mengizinkan atau menolak akses ke dimensi individual untuk `GetResourceMetrics``DescribeDimensionKeys`, dan tindakan `GetDimensionKeyDetails` Performance Insights. Untuk menggunakan akses berbutir halus, tentukan dimensi dalam kebijakan IAM dengan menggunakan tombol kondisi. Evaluasi akses mengikuti logika evaluasi kebijakan IAM. Untuk informasi selengkapnya, lihat [Logika evaluasi kebijakan](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_evaluation-logic.html) di *Panduan Pengguna IAM*. Jika pernyataan kebijakan IAM tidak menentukan dimensi apa pun, maka pernyataan tersebut mengontrol akses ke semua dimensi untuk tindakan yang ditentukan. Untuk daftar dimensi yang tersedia, lihat [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html).

Untuk mengetahui dimensi yang diizinkan untuk diakses oleh kredensi Anda, gunakan `AuthorizedActions` parameter `ListAvailableResourceDimensions` dan tentukan tindakannya. Nilai yang diizinkan untuk `AuthorizedActions` adalah sebagai berikut:
+ `GetResourceMetrics`
+ `DescribeDimensionKeys`
+ `GetDimensionKeyDetails`

Misalnya, jika Anda `GetResourceMetrics` menentukan `AuthorizedActions` parameter, `ListAvailableResourceDimensions` mengembalikan daftar dimensi yang diizinkan untuk diakses oleh `GetResourceMetrics` tindakan. Jika Anda menentukan beberapa tindakan dalam `AuthorizedActions` parameter, kemudian `ListAvailableResourceDimensions` mengembalikan persimpangan dimensi bahwa tindakan tersebut diizinkan untuk mengakses.

**Example**  
Contoh berikut menyediakan akses ke dimensi yang ditentukan untuk `GetResourceMetrics` dan `DescribeDimensionKeys` tindakan.    
****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "AllowToDiscoverDimensions",
            "Effect": "Allow",
            "Action": [
                "pi:ListAvailableResourceDimensions"
            ],
            "Resource": [
                "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W"
            ]
        },
        {
            "Sid": "SingleAllow",
            "Effect": "Allow",
            "Action": [
                "pi:GetResourceMetrics",
                "pi:DescribeDimensionKeys"
            ],
            "Resource": [
                "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W"
            ],
            "Condition": {
                "ForAllValues:StringEquals": {
                    "pi:Dimensions": [
                        "db.sql_tokenized.id",
                        "db.sql_tokenized.statement"
                    ]
                }
            }
        }
        

    ]
}
```
Berikut ini adalah respons untuk dimensi yang diminta:  

```
	// ListAvailableResourceDimensions API
// Request
{
    "ServiceType": "RDS",
    "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W",
    "Metrics": [ "db.load" ],
    "AuthorizedActions": ["DescribeDimensionKeys"]
}

// Response
{    
    "MetricDimensions": [ {
        "Metric": "db.load",
        "Groups": [
            {
                "Group": "db.sql_tokenized",
                "Dimensions": [
                    { "Identifier": "db.sql_tokenized.id" },
                  //  { "Identifier": "db.sql_tokenized.db_id" }, // not included because not allows in the IAM Policy
                    { "Identifier": "db.sql_tokenized.statement" }
                ] 
            }
            
        ] }
    ]
}
```
Contoh berikut menentukan satu izinkan dan dua tolak akses untuk dimensi.    
****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
          {
            "Sid": "AllowToDiscoverDimensions",
            "Effect": "Allow",
            "Action": [
                "pi:ListAvailableResourceDimensions"
            ],
            "Resource": [
                "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W"
            ]
          },

          {
            "Sid": "O01AllowAllWithoutSpecifyingDimensions",
            "Effect": "Allow",
            "Action": [
                "pi:GetResourceMetrics",
                "pi:DescribeDimensionKeys"
            ],
            "Resource": [
                "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W"
            ]
        },
        
        {
            "Sid": "O01DenyAppDimensionForAll",
            "Effect": "Deny",
            "Action": [
                "pi:GetResourceMetrics",
                "pi:DescribeDimensionKeys"
            ],
            "Resource": [
                "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W"
            ],
            "Condition": {
                "ForAnyValue:StringEquals": {
                    "pi:Dimensions": [
                        "db.application.name"
                    ]
                }
            }
        },
        
        {
            "Sid": "O01DenySQLForGetResourceMetrics",
            "Effect": "Deny",
            "Action": [
                "pi:GetResourceMetrics"
            ],
            "Resource": [
                "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W"
            ],
            "Condition": {
                "ForAnyValue:StringEquals": {
                    "pi:Dimensions": [
                        "db.sql_tokenized.statement"
                    ]
                }
            }
        }
    ]
}
```
Berikut ini adalah tanggapan untuk dimensi yang diminta:  

```
			// ListAvailableResourceDimensions API
// Request
{
    "ServiceType": "RDS",
    "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W",
    "Metrics": [ "db.load" ],
    "AuthorizedActions": ["GetResourceMetrics"]
}

// Response
{    
    "MetricDimensions": [ {
        "Metric": "db.load",
        "Groups": [
            {
                "Group": "db.application",
                "Dimensions": [
                
                  // removed from response because denied by the IAM Policy
                  //  { "Identifier": "db.application.name" }  
                ]
            },
            {
                "Group": "db.sql_tokenized",
                "Dimensions": [
                    { "Identifier": "db.sql_tokenized.id" },
                    { "Identifier": "db.sql_tokenized.db_id" },
                    
                  // removed from response because denied by the IAM Policy
                  //  { "Identifier": "db.sql_tokenized.statement" }
                ] 
            },
            ...
        ] }
    ]
}
```

```
// ListAvailableResourceDimensions API
// Request
{
    "ServiceType": "RDS",
    "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W",
    "Metrics": [ "db.load" ],
    "AuthorizedActions": ["DescribeDimensionKeys"]
}

// Response
{    
    "MetricDimensions": [ {
        "Metric": "db.load",
        "Groups": [
            {
                "Group": "db.application",
                "Dimensions": [
                  // removed from response because denied by the IAM Policy
                  //  { "Identifier": "db.application.name" }  
                ]
            },
            {
                "Group": "db.sql_tokenized",
                "Dimensions": [
                    { "Identifier": "db.sql_tokenized.id" },
                    { "Identifier": "db.sql_tokenized.db_id" },
                    
                  // allowed for DescribeDimensionKeys because our IAM Policy 
                  // denies it only for GetResourceMetrics
                    { "Identifier": "db.sql_tokenized.statement" }
                ] 
            },
            ...
        ] }
    ]
}
```

# Menggunakan kontrol akses berbasis tag untuk Performance Insights
<a name="USER_PerfInsights.access-control.tag-based-policy"></a>

Anda dapat mengontrol akses ke metrik Performance Insights menggunakan tag yang diwarisi dari instans DB induk. Untuk mengontrol akses ke operasi Performance Insights, gunakan kebijakan IAM. Kebijakan ini dapat memeriksa tag pada instans DB Anda untuk menentukan izin.

## Cara kerja tag dengan Performance Insights
<a name="USER_PerfInsights.access-control.tag-inheritance"></a>

Performance Insights secara otomatis menerapkan tag instans DB Anda untuk mengotorisasi metrik Performance Insights. Saat menambahkan tag ke instans DB, Anda dapat langsung menggunakan tag tersebut untuk mengontrol akses ke data Performance Insights.
+ Untuk menambahkan atau memperbarui tag untuk metrik Performance Insights, ubah tag pada instans DB Anda.
+ Untuk melihat tag untuk metrik Performance Insights, hubungi `ListTagsForResource` sumber daya metrik Performance Insights. Ini akan mengembalikan tag dari instance DB yang terkait dengan metrik.

**catatan**  
`UntagResource`Operasi `TagResource` dan menampilkan kesalahan jika Anda mencoba menggunakannya secara langsung di metrik Performance Insights.

## Membuat kebijakan IAM berbasis tag
<a name="USER_PerfInsights.access-control.tag-based-policies"></a>

Untuk mengontrol akses ke operasi Performance Insights, gunakan kunci `aws:ResourceTag` kondisi dalam kebijakan IAM Anda. Kebijakan ini memeriksa tag pada instans YourDB.

**Example**  
Kebijakan ini mencegah akses ke metrik Performance Insights untuk database produksi. Kebijakan ini menolak `pi:GetResourceMetrics` operasi di Performance Insights untuk sumber daya database apa pun yang ditandai. `env:prod`   

```
 {
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Deny",
            "Action": "pi:GetResourceMetrics",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "aws:ResourceTag/env": "prod"
                }
            }
        }
    ]
}
```

# Menganalisis metrik dengan dasbor Wawasan Performa
<a name="USER_PerfInsights.UsingDashboard"></a>

**penting**  
 AWS telah mengumumkan end-of-life tanggal Performance Insights: 30 Juni 2026. Setelah tanggal ini, Amazon RDS tidak akan lagi mendukung pengalaman konsol Performance Insights, periode retensi fleksibel (1-24 bulan), dan harga terkait. Performance Insights API akan terus ada tanpa perubahan harga. Biaya untuk API Performance Insights akan muncul di AWS tagihan Anda dengan biaya CloudWatch Database Insights.   
 Sebaiknya Anda meningkatkan instans apa pun menggunakan tingkat berbayar Performance Insights ke mode Advanced Database Insights sebelum 30 Juni 2026. Untuk informasi tentang meningkatkan ke mode Advanced Database Insights, lihat. [](USER_DatabaseInsights.TurningOnAdvanced.md)   
 Jika Anda tidak mengambil tindakan, instans DB yang menggunakan Performance Insights akan secara default menggunakan mode Standar Database Insights. Dengan mode Standar Database Insights, Anda mungkin kehilangan akses ke riwayat data kinerja setelah 7 hari dan mungkin tidak dapat menggunakan paket eksekusi dan fitur analisis sesuai permintaan di konsol Amazon RDS. Setelah 30 Juni 2026, hanya mode Advanced Database Insights yang akan mendukung rencana eksekusi dan analisis sesuai permintaan.   
 Dengan CloudWatch Database Insights, Anda dapat memantau beban database untuk armada database Anda dan menganalisis serta memecahkan masalah kinerja dalam skala besar. Untuk informasi selengkapnya tentang Wawasan Database, lihat[Memantau database Amazon RDS Aurora dengan Database CloudWatch Insights](USER_DatabaseInsights.md). Untuk informasi harga, lihat [ CloudWatch Harga Amazon](https://aws.amazon.com/cloudwatch/pricing/). 

Dasbor Wawasan Performa berisi informasi performa basis data untuk membantu Anda menganalisis dan memecahkan masalah performa. Di halaman dasbor utama, Anda dapat melihat informasi tentang muatan basis data. Anda dapat “mengiris” muatan DB berdasarkan dimensi seperti peristiwa tunggu atau SQL.

**Topics**
+ [Ikhtisar dasbor Wawasan Performa](USER_PerfInsights.UsingDashboard.Components.md)
+ [Mengakses dasbor Wawasan Performa](USER_PerfInsights.UsingDashboard.Opening.md)
+ [Menganalisis muatan DB menurut peristiwa tunggu](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.md)
+ [Menganalisis performa basis data selama periode waktu tertentu](USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.md)
+ [Menganalisis kueri dengan SQL tab Teratas di Performance Insights](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.md)
+ [Menganalisis beban Oracle PDB teratas](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.TopPDB.md)
+ [Menganalisis rencana eksekusi menggunakan dasbor Performance Insights untuk Amazon RDS](USER_PerfInsights.UsingDashboard.AnalyzingPlans.md)

# Ikhtisar dasbor Wawasan Performa
<a name="USER_PerfInsights.UsingDashboard.Components"></a>

Dasbor adalah cara termudah untuk berinteraksi dengan Wawasan Performa. Contoh berikut menunjukkan dasbor untuk instance PostgreSQL DB.

![\[Memfilter metrik\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_0b.png)


**Topics**
+ [Filter rentang waktu](#USER_PerfInsights.UsingDashboard.Components.time-range)
+ [Bagan metrik penghitung](#USER_PerfInsights.UsingDashboard.Components.Countermetrics)
+ [Bagan muatan basis data](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions)
+ [Tabel Dimensi teratas](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable)

## Filter rentang waktu
<a name="USER_PerfInsights.UsingDashboard.Components.time-range"></a>

Secara default, dasbor Wawasan Performa menampilkan muatan DB selama satu jam terakhir. Anda dapat menyesuaikan rentang ini menjadi sesingkat 5 menit atau selama 2 tahun. Anda juga dapat memilih rentang relatif kustom.

![\[Waktu relatif Wawasan Performa\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf-insights-relative-time.png)


Anda dapat memilih rentang absolut dengan tanggal dan waktu awal dan akhir. Contoh berikut menunjukkan rentang waktu yang dimulai pada tengah malam pada 9/25/24 dan berakhir pada 11:59 PM pada 9/28/24.

![\[Waktu absolut Wawasan Performa\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf-insights-absolute-time.png)


Secara default, zona waktu untuk dasbor Performance Insights adalah Coordinated Universal Time (UTC). Anda juga dapat memilih zona waktu setempat.

![\[Pilih zona waktu lokal untuk dasbor Performance Insights\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf-insights-local-time-zone.png)


## Bagan metrik penghitung
<a name="USER_PerfInsights.UsingDashboard.Components.Countermetrics"></a>

Dengan metrik penghitung, Anda dapat menyesuaikan dasbor Wawasan Performa untuk menyertakan hingga 10 grafik tambahan. Grafik ini menunjukkan pilihan dari sejumlah sistem operasi dan metrik performa basis data. Anda dapat menghubungkan informasi ini dengan muatan DB untuk membantu mengidentifikasi dan menganalisis masalah performa.

 Bagan **Metrik Penghitung** menampilkan data untuk penghitung performa. Metrik default bergantung pada mesin DB:
+ MySQL dan MariaDB – `db.SQL.Innodb_rows_read.avg`
+ Oracle – `db.User.user calls.avg`
+ Microsoft SQL Server – `db.Databases.Active Transactions(_Total).avg`
+ PostgreSQL – `db.Transactions.xact_commit.avg`

![\[Metrik penghitung\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/oracle_perf_insights_counters.png)


Untuk mengubah penghitung performa, pilih **Kelola Metrik**. Anda dapat memilih beberapa **Metrik OS** atau **Metrik basis data**, seperti yang ditunjukkan di tangkapan layar berikut. Untuk melihat detail setiap metrik, arahkan kursor ke nama metrik.

![\[Memfilter metrik\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_select_metrics.png)


Untuk deskripsi metrik penghitung yang dapat ditambahkan untuk setiap mesin DB, lihat [Metrik penghitung Wawasan Performa](USER_PerfInsights_Counters.md).

## Bagan muatan basis data
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions"></a>

Bagan **Muatan basis data** menunjukkan perbandingan aktivitas basis data dengan kapasitas instans DB seperti yang ditunjukkan oleh baris **vCPU Maks**. Secara default, bagan garis bertumpuk mewakili muatan DB sebagai sesi aktif rata-rata per unit waktu. Muatan DB diiris (dikelompokkan) berdasarkan status tunggu. 

![\[Muatan basis data\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_2.png)


### Muatan DB diiris berdasarkan dimensi
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.dims"></a>

Anda dapat memilih untuk menampilkan muatan sebagai sesi aktif yang dikelompokkan berdasarkan dimensi yang didukung. Tabel berikut menunjukkan dimensi yang didukung untuk mesin yang berbeda.


| Dimensi | Oracle | SQL Server | PostgreSQL | MySQL | 
| --- | --- | --- | --- | --- | 
|  Host  |  Ya  |  Ya  |  Ya  |  Ya  | 
|  SQL  |  Ya  |  Ya  |  Ya  |  Ya  | 
|  Pengguna  |  Ya  |  Ya  |  Ya  |  Ya  | 
|  Tunggu  |  Ya  |  Ya  |  Ya  |  Ya  | 
|  Rencana  |  Ya  |  Tidak  |  Tidak  |  Tidak  | 
|  Aplikasi  |  Tidak  |  Tidak  |  Ya  |  Tidak  | 
|  Basis data  |  Tidak  |  Tidak  |  Ya  |  Ya  | 
|  Jenis sesi  |  Tidak  |  Tidak  |  Ya  |  Tidak  | 

Gambar berikut menunjukkan dimensi untuk instans DB PostgreSQL.

![\[Memfilter metrik\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_2b.png)


### Detail muatan DB untuk item dimensi
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.item-details"></a>

Untuk melihat detail tentang item muatan DB dalam dimensi, arahkan kursor ke nama item. Gambar berikut menunjukkan rincian untuk pernyataan SQL.

![\[Detail item muatan basis data\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_2c.png)


Untuk melihat detail setiap item selama periode waktu yang dipilih dalam legenda, arahkan kursor ke item tersebut.

![\[Detail periode waktu untuk muatan DB\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_3.png)


## Tabel Dimensi teratas
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable"></a>

Tabel Dimensi teratas mengiris muatan DB dengan dimensi yang berbeda. Dimensi adalah kategori atau “irisan menurut” untuk karakteristik muatan DB yang berbeda. Jika dimensinya adalah SQL, **SQL Teratas** menunjukkan pernyataan SQL yang berkontribusi paling besar terhadap muatan DB.

![\[Dimensi N teratas\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_4c.png)


Pilih salah satu tab dimensi berikut.


| Tab | Deskripsi | Mesin yang didukung | 
| --- | --- | --- | 
|  SQL Teratas  |  Pernyataan SQL yang saat ini sedang berjalan  |  Semua  | 
|  Tunggu teratas  |  Peristiwa di mana backend basis data sedang menunggu  |  Semua  | 
|  Host teratas  |  Nama host klien yang terhubung  |  Semua  | 
|  Pengguna teratas  |  Pengguna yang masuk ke basis data  |  Semua  | 
|  Basis data teratas  |  Nama basis data yang terhubung ke klien  |  PostgreSQL, MySQL, MariaDB, dan SQL Server saja  | 
|  Aplikasi teratas  |  Nama aplikasi yang terhubung ke basis data  |    | 
|  Jenis sesi teratas  |  Jenis sesi saat ini  | Khusus PostgreSQL | 

Untuk mempelajari cara menganalisis kueri dengan menggunakan tab **SQL Teratas**, lihat [Ikhtisar SQL tab Top](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.md#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL).

# Mengakses dasbor Wawasan Performa
<a name="USER_PerfInsights.UsingDashboard.Opening"></a>

Amazon RDS menyediakan tampilan konsolidasi Performance Insights CloudWatch dan metrik di dasbor Performance Insights.

Untuk mengakses dasbor Wawasan Performa, gunakan prosedur berikut.

**Untuk melihat dasbor Performance Insights di Konsol Manajemen AWS**

1. Buka RDS konsol Amazon di [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Di panel navigasi kiri, pilih **Wawasan Performa**.

1. Pilih instans DB.

   Untuk instans DB dengan Performance Insights diaktifkan, Anda juga dapat mengakses dasbor Performance Insights dengan memilih item Sessions dalam **daftar** instans DB. Di bagian **Aktivitas saat ini**, item **Sesi** menunjukkan muatan basis data dalam sesi aktif rata-rata selama lima menit terakhir. Bilah ini secara grafis menunjukkan muatan. Jika bilah kosong, berarti instans DB sedang diam. Saat muatan meningkat, bilah akan terisi dengan warna biru. Ketika beban melewati jumlah virtual CPUs (vCPUs) pada kelas instans DB, bilah berubah menjadi merah, menunjukkan potensi kemacetan.  
![\[Memfilter metrik\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_0a.png)

1. (Opsional) Pilih rentang tanggal atau waktu di kanan atas dan tentukan interval waktu relatif atau absolut yang berbeda. Anda kini dapat menentukan periode waktu, dan menghasilkan laporan analisis performa basis data. Laporan ini berisi rekomendasi dan wawasan yang diidentifikasi. Untuk informasi selengkapnya, lihat [Membuat laporan analisis kinerja di Performance Insights](USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.md).  
![\[Memfilter metrik berdasarkan interval waktu\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_0c.png)

   Di tangkapan layar berikut, interval muatan DB adalah 5 jam.  
![\[Mengatur interval waktu ke 5 jam\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_1.png)

1. (Opsional) Untuk memperbesar sebagian bagan muatan DB, pilih waktu mulai dan seret ke akhir periode waktu yang diinginkan. 

   Area yang dipilih disorot dalam bagan muatan DB.  
![\[Muatan DB untuk interval waktu tertentu\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_zoom_in.png)

   Saat Anda melepaskan mouse, bagan beban DB memperbesar AWS Wilayah yang dipilih, dan tabel ***Dimensi* atas** dihitung ulang.  
![\[Memperbesar muatan DB yang dipilih\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_zoom_in_b.png)

1. (Opsional) Untuk menyegarkan data Anda secara otomatis, pilih **Segarkan otomatis**.  
![\[Mengatur penyegaran otomatis\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_1b.png)

   Dasbor Wawasan Performa secara otomatis disegarkan dengan data baru. Laju penyegaran bergantung pada jumlah data yang ditampilkan: 
   + Penyegaran 5 menit setiap 10 detik.
   + Penyegaran 1 jam setiap 5 menit.
   + Penyegaran 5 jam setiap 5 menit.
   + Penyegaran 24 jam setiap 30 menit.
   + Penyegaran 1 minggu setiap hari.
   + Penyegaran 1 bulan setiap hari.

# Menganalisis muatan DB menurut peristiwa tunggu
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad"></a>

Jika bagan **Muatan basis data** menunjukkan kemacetan, Anda dapat mengetahui dari mana muatan tersebut berasal. Untuk melakukannya, lihat tabel item muatan teratas di bawah bagan **Muatan basis data**. Pilih item tertentu, seperti SQL kueri atau pengguna, untuk menelusuri item itu dan melihat detailnya.

Beban DB yang dikelompokkan berdasarkan menunggu dan SQL kueri teratas adalah tampilan dasbor Performance Insights default. Kombinasi ini biasanya memberikan wawasan paling banyak tentang masalah performa. Muatan DB yang dikelompokkan berdasarkan peristiwa tunggu menunjukkan apakah ada sumber daya atau kemacetan konkurensi dalam basis data. Dalam hal ini, **SQL**tab tabel item pemuatan atas menunjukkan kueri mana yang mendorong beban itu.

Alur kerja tipikal Anda untuk mendiagnosis masalah performa adalah sebagai berikut:

1. Tinjau bagan **beban Database** dan lihat apakah ada insiden beban database yang melebihi garis **Max CPU**.

1. Jika ada, lihat bagan **Muatan basis data** dan identifikasi satu atau beberapa status tunggu yang paling bertanggung jawab.

1. Identifikasi kueri intisari yang menyebabkan pemuatan dengan melihat kueri mana yang paling banyak disumbangkan oleh **SQL**tab pada tabel item pemuatan teratas pada status tunggu tersebut. Anda dapat mengidentifikasinya berdasarkan kolom **Muatan DB berdasarkan peristiwa Tunggu**.

1. Pilih salah satu kueri intisari ini di **SQL**tab untuk memperluasnya dan melihat kueri anak yang terdiri darinya.

Misalnya, di dasbor berikut, peristiwa tunggu **sinkronisasi file log** menyumbang sebagian besar muatan DB. **LGWRSemua kelompok pekerja** menunggu juga tinggi. SQLBagan **teratas** menunjukkan apa yang menyebabkan **sinkronisasi file log** menunggu: `COMMIT` pernyataan yang sering. Dalam kasus ini, eksekusi yang lebih jarang akan mengurangi muatan DB.

![\[kesalahan sinkronisasi file log\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_7.png)


# Menganalisis performa basis data selama periode waktu tertentu
<a name="USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod"></a>

Menganalisis kinerja database dengan analisis on-demand dengan membuat laporan analisis kinerja untuk jangka waktu tertentu. Lihat laporan analisis kinerja untuk menemukan masalah kinerja, seperti kemacetan sumber daya atau perubahan dalam kueri di instans DB Anda. Dasbor Wawasan Performa memungkinkan Anda memilih periode waktu dan membuat laporan analisis performa. Anda juga dapat menambahkan satu tag atau lebih ke laporan. 

Untuk menggunakan fitur ini, Anda harus menggunakan periode retensi tingkat berbayar. Untuk informasi selengkapnya, silakan lihat [Harga dan retensi data untuk Wawasan Performa](USER_PerfInsights.Overview.cost.md)

Laporan ini dapat dipilih dan dilihat di tab **Laporan analisis performa - baru**. Laporan ini berisi wawasan, metrik terkait, dan rekomendasi untuk menyelesaikan masalah performa. Laporan ini dapat dilihat selama periode retensi Wawasan Performa.

Laporan dihapus jika waktu mulai periode analisis laporan berada di luar periode retensi. Anda juga dapat menghapus laporan sebelum periode retensi berakhir.

Untuk mendeteksi masalah performa dan menghasilkan laporan analisis untuk instans DB, Anda harus mengaktifkan Wawasan Performa. Untuk informasi selengkapnya tentang mengaktifkan Wawasan Performa, lihat [Mengaktifkan dan menonaktifkan Performance Insights untuk Amazon RDS](USER_PerfInsights.Enabling.md). 

Untuk informasi dukungan wilayah, mesin DB, dan kelas instans untuk fitur ini, lihat [Amazon RDS Aurora DB engine, Wilayah, dan dukungan kelas instans untuk fitur Performance Insights](USER_PerfInsights.Overview.Engines.md#USER_PerfInsights.Overview.PIfeatureEngnRegSupport)

Di bagian berikut, Anda dapat membuat, melihat, menambahkan tag, dan menghapus laporan analisis kinerja.

**Topics**
+ [Membuat laporan analisis kinerja di Performance Insights](USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport.md)
+ [Melihat laporan analisis kinerja di Performance Insights](USER_PerfInsights.UsingDashboard.ViewPerfAnalysisReport.md)
+ [Menambahkan tag ke laporan analisis kinerja di Performance Insights](USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.md)
+ [Menghapus laporan analisis kinerja di Performance Insights](USER_PerfInsights.UsingDashboard.DeletePerfAnalysisReport.md)

# Membuat laporan analisis kinerja di Performance Insights
<a name="USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport"></a>

Anda dapat membuat laporan analisis performa selama periode tertentu di dasbor Wawasan Performa. Anda dapat memilih periode waktu dan menambahkan satu tag atau lebih ke laporan analisis.

Periode analisis bisa berkisar dari 5 menit hingga 6 hari. Harus ada data performa setidaknya 24 jam sebelum waktu mulai analisis.

Untuk informasi dukungan wilayah, mesin DB, dan kelas instans untuk fitur ini, lihat [Amazon RDS Aurora DB engine, Wilayah, dan dukungan kelas instans untuk fitur Performance Insights](USER_PerfInsights.Overview.Engines.md#USER_PerfInsights.Overview.PIfeatureEngnRegSupport)

**Untuk membuat laporan analisis performa selama periode waktu tertentu**

1. Buka konsol Amazon RDS di [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Di panel navigasi kiri, pilih **Wawasan Performa**.

1. Pilih instans DB. 

1. Pilih **Analisis kinerja** di bagian **Pemuatan database** di dasbor Performance Insights.

   Kolom untuk mengatur periode waktu dan menambahkan satu atau beberapa tag ke laporan analisis performa ditampilkan.  
![\[Dasbor Wawasan Performa yang menampilkan kolom untuk membuat laporan analisis\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/PI_CreateAnalysisReport.png)

1. Pilih periode waktu. Jika menetapkan periode waktu dalam **Rentang relatif** atau **Rentang absolut** di kanan atas, Anda hanya dapat memasukkan atau memilih tanggal dan waktu laporan analisis dalam periode waktu ini. Jika Anda memilih periode analisis di luar periode waktu ini, pesan kesalahan akan muncul.

    Untuk mengatur periode waktu, Anda dapat mengikuti langkah-langkah berikut:
   + Tekan dan seret salah satu slider pada bagan muatan DB.

     Kotak **Periode analisis performa** menampilkan periode waktu yang dipilih dan bagan muatan DB menyoroti periode waktu yang dipilih.
   + Pilih **Tanggal mulai**, **Waktu mulai**, **Tanggal akhir**, dan **Waktu akhir** di kotak **Periode analisis performa**.  
![\[Dasbor Wawasan Performa dengan periode analisis yang dipilih\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/PI_CreateAnalysisRep_TimePeriod.png)

1. (Opsional) Masukkan **Kunci** dan **Nilai-*opsional*** untuk menambahkan tag untuk laporan.  
![\[Dasbor Wawasan Performa dengan kolom untuk menambahkan tag baru\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/PI_CreateAnalysisRep_AddTag.png)

1. Pilih **Analisis performa**.

   Spanduk menampilkan pesan apakah pembuatan laporan berhasil atau gagal. Pesan juga menyediakan tautan untuk melihat laporan.

   Contoh berikut menunjukkan spanduk dengan pesan pembuatan laporan berhasil.  
![\[Banner pesan pembuatan laporan spanduk berhasil\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/PI_CreateAnaysisRep_SuccessMsg.png)

   Laporan ini dapat dilihat di tab **Laporan analisis performa - baru**. 

Anda dapat membuat laporan analisis performa menggunakan AWS CLI. Untuk contoh tentang cara membuat laporan menggunakan AWS CLI, lihat[Membuat laporan analisis performa selama periode waktu tertentu](USER_PerfInsights.API.Examples.md#USER_PerfInsights.API.Examples.CreatePerfAnalysisReport).

# Melihat laporan analisis kinerja di Performance Insights
<a name="USER_PerfInsights.UsingDashboard.ViewPerfAnalysisReport"></a>

Tab **Laporan analisis performa - baru** mencantumkan semua laporan yang dibuat untuk instans DB. Berikut ini ditampilkan untuk setiap laporan:
+ **ID**: Pengidentifikasi unik laporan.
+ **Nama**: Kunci tag yang ditambahkan ke laporan.
+ **Waktu pembuatan laporan**: Waktu Anda membuat laporan.
+ **Waktu mulai analisis**: Waktu mulai analisis dalam laporan.
+ **Waktu akhir analisis**: Waktu akhir analisis dalam laporan.

**Untuk melihat laporan analisis performa**

1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon RDS di [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Di panel navigasi kiri, pilih **Wawasan Performa**.

1. Pilih instans DB yang laporan analisisnya ingin dilihat. 

1. Gulir ke bawah dan pilih **Laporan analisis kinerja - tab baru** di dasbor Performance Insights.

   Semua laporan analisis untuk periode waktu yang berbeda ditampilkan.

1. Pilih **ID** laporan yang ingin dilihat.

   Bagan muatan DB menampilkan seluruh periode analisis secara default jika ada lebih dari satu wawasan yang diidentifikasi. Jika laporan telah mengidentifikasi satu wawasan, bagan muatan DB akan menampilkan wawasan secara default. 

   Dasbor juga mencantumkan tag untuk laporan di bagian **Tag**.

   Contoh berikut menunjukkan seluruh periode analisis untuk laporan.  
![\[Bagan muatan DB yang menunjukkan seluruh periode laporan analisis\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/PI_EntireAnalysisRep.png)

1. Pilih wawasan dalam daftar **Wawasan muatan basis data** yang ingin dilihat jika ada lebih dari satu wawasan yang diidentifikasi dalam laporan.

   Dasbor menampilkan pesan wawasan, bagan muatan DB yang menyoroti periode waktu wawasan, analisis dan rekomendasi, serta daftar tag laporan.

   Contoh berikut menunjukkan wawasan muatan DB dalam laporan.   
![\[Bagan muatan DB yang menunjukkan wawasan dalam laporan\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/PI_AnalysisRepInsight_chart.png)  
![\[Bagian rekomendasi dan analisis wawasan laporan\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/PI_AnalysisRepInsight_Recommendations.png)

# Menambahkan tag ke laporan analisis kinerja di Performance Insights
<a name="USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags"></a>

Anda dapat menambahkan tag saat membuat atau melihat laporan. Anda dapat menambahkan hingga 50 tag untuk sebuah laporan.

Anda memerlukan izin untuk menambahkan tag. Untuk informasi selengkapnya tentang kebijakan akses untuk Wawasan Performa, lihat [Mengonfigurasi kebijakan akses untuk Wawasan Performa](USER_PerfInsights.access-control.md)

Untuk menambahkan satu atau beberapa tag saat membuat laporan, lihat langkah 6 dalam prosedur [Membuat laporan analisis kinerja di Performance Insights](USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport.md).

**Untuk menambahkan satu tag atau lebih saat melihat laporan**

1. Buka konsol Amazon RDS di [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Di panel navigasi kiri, pilih **Wawasan Performa**.

1. Pilih instans DB. 

   Dasbor Wawasan Performa muncul untuk instans DB.

1. Gulir ke bawah dan pilih tab **Laporan analisis performa - baru**.

1. Pilih laporan yang ingin diberi tag.

   Dasbor menampilkan laporan.

1. Gulir ke bawah ke **Tag** dan pilih **Kelola tag**.

1. Pilih **Tambahkan tag baru**.

1. Masukkan **Kunci** dan **Nilai - *opsional***, dan pilih **Tambahkan tag baru**.

   Contoh berikut memberikan opsi untuk menambahkan tag baru untuk laporan yang dipilih.  
![\[Jendela Kelola Tag untuk menambahkan tag baru ke laporan\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/PI_AddTag_ManageTags.png)

   Tag baru dibuat untuk laporan.

   Daftar tag untuk laporan ditampilkan di bagian **Tag** pada dasbor. Jika Anda ingin menghapus tag dari laporan, pilih **Hapus** di samping tag.

# Menghapus laporan analisis kinerja di Performance Insights
<a name="USER_PerfInsights.UsingDashboard.DeletePerfAnalysisReport"></a>

Anda dapat menghapus laporan dari daftar laporan yang ditampilkan di tab **Laporan analisis performa** atau saat melihat laporan. 

**Untuk menghapus laporan**

1. Buka konsol Amazon RDS di [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Di panel navigasi kiri, pilih **Wawasan Performa**.

1. Pilih instans DB. 

   Dasbor Wawasan Performa muncul untuk instans DB.

1. Gulir ke bawah dan pilih tab **Laporan analisis performa - baru**.

1. Pilih laporan yang ingin dihapus dan pilih **Hapus** di kanan atas.  
![\[Dasbor Wawasan Performa untuk dihapus dengan laporan yang dipilih untuk dihapus\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/PI_DeleteAnalysisRep.png)

   Jendela konfirmasi ditampilkan. Laporan akan dihapus setelah Anda memilih konfirmasi.

1. (Opsional) Pilih **ID** laporan yang ingin dihapus.

   Di halaman laporan, pilih **Hapus** di kanan atas.

   Jendela konfirmasi ditampilkan. Laporan akan dihapus setelah Anda memilih konfirmasi.

# Menganalisis kueri dengan SQL tab Teratas di Performance Insights
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics"></a>

Di dasbor Amazon RDS Performance Insights, Anda dapat menemukan informasi tentang menjalankan dan kueri terbaru di SQL tab **Atas** di tabel Dimensi **teratas**. Anda dapat menggunakan informasi ini untuk menyetel kueri Anda.

**Topics**
+ [Ikhtisar SQL tab Top](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL)
+ [Mengakses lebih banyak teks SQL di dasbor Wawasan Performa](USER_PerfInsights.UsingDashboard.SQLTextSize.md)
+ [Melihat statistik SQL di dasbor Wawasan Performa](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.AnalyzingSQLLevel.md)

## Ikhtisar SQL tab Top
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL"></a>

Secara default, SQL tab **Top** menunjukkan 25 kueri yang paling berkontribusi pada pemuatan DB. Untuk membantu menyetel kueri, Anda dapat menganalisis informasi seperti teks kueri dan SQL statistik. Anda juga dapat memilih statistik yang ingin Anda tampilkan di SQL tab **Atas**.

**Topics**
+ [SQLteks](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.text)
+ [SQLstatistik](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.statistics)
+ [Muat dengan menunggu () AAS](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Load-by-waits)
+ [Lihat SQL informasi](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.SQL-information)
+ [Pilih preferensi statistik](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Preferences)

### SQLteks
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.text"></a>

Secara default, setiap baris di SQL tabel **Top** menunjukkan 500 byte teks untuk setiap pernyataan. 

![\[SQLteks\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/sql-text-oracle.png)


Untuk mempelajari cara melihat lebih dari 500 byte SQL teks default, lihat[Mengakses lebih banyak teks SQL di dasbor Wawasan Performa](USER_PerfInsights.UsingDashboard.SQLTextSize.md).

*SQLIntisari* adalah gabungan dari beberapa kueri aktual yang secara struktural serupa tetapi mungkin memiliki nilai literal yang berbeda. Digest menggantikan nilai berkode keras dengan tanda tanya. Misalnya, digest mungkin berupa `SELECT * FROM emp WHERE lname= ?`. Digest ini dapat mencakup kueri turunan berikut:

```
SELECT * FROM emp WHERE lname = 'Sanchez'
SELECT * FROM emp WHERE lname = 'Olagappan'
SELECT * FROM emp WHERE lname = 'Wu'
```

Untuk melihat SQL pernyataan literal dalam intisari, pilih kueri, lalu pilih simbol plus (\$1). Dalam contoh berikut, kueri yang dipilih adalah digest.

![\[SQLIntisari yang dipilih\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_4b.png)


**catatan**  
SQLIntisari mengelompokkan SQL pernyataan serupa, tetapi tidak menyunting informasi sensitif.

**Performance Insights dapat menampilkan SQL teks Oracle sebagai Unknown.** Teks memiliki status ini dalam situasi berikut:
+ Pengguna database Oracle selain `SYS` aktif tetapi saat ini tidak mengeksekusiSQL. Misalnya, ketika kueri paralel selesai, koordinator kueri menunggu proses pembantu untuk mengirim statistik sesinya. Selama menunggu, teks kueri menunjukkan **Tidak Diketahui**.
+ RDSUntuk instance Oracle pada Standard Edition 2, Oracle Resource Manager membatasi jumlah thread paralel. Proses latar belakang yang melakukan pekerjaan ini menyebabkan teks kueri ditampilkan sebagai **Tidak Diketahui**.

### SQLstatistik
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.statistics"></a>

*SQLstatistik* adalah metrik terkait kinerja tentang kueri. SQL Misalnya, Wawasan Performa mungkin menampilkan eksekusi per detik atau baris yang diproses per detik. Wawasan Performa mengumpulkan statistik hanya untuk kueri yang paling umum. Biasanya, ini cocok dengan kueri teratas berdasarkan muatan yang ditampilkan di dasbor Wawasan Performa. 

Setiap baris di SQL Tabel **Top** menunjukkan statistik yang relevan untuk SQL pernyataan atau intisari, seperti yang ditunjukkan pada contoh berikut.

![\[Teratas SQL\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_4.png)


Performance Insights dapat melaporkan `0.00` dan `-` (tidak diketahui) untuk SQL statistik. Situasi ini terjadi dalam kondisi berikut:
+ Hanya ada satu sampel. Misalnya, Performance Insights menghitung tingkat perubahan untuk SQL kueri Postgre berdasarkan beberapa sampel dari tampilan. `pg_stat_statements` Ketika beban kerja berjalan untuk waktu yang singkat, Wawasan Performa mungkin hanya mengumpulkan satu sampel, yang berarti tidak dapat menghitung tingkat perubahan. Nilai yang tidak diketahui ditunjukkan dengan tanda hubung (`-`).
+ Dua sampel memiliki nilai yang sama. Wawasan Performa tidak dapat menghitung tingkat perubahan karena tidak ada perubahan yang terjadi, sehingga melaporkan tingkatnya sebagai `0.00`.
+ SQLPernyataan Postgre tidak memiliki pengenal yang valid. Postgre SQL membuat identifier untuk pernyataan hanya setelah parsing dan analisis. Dengan demikian, sebuah pernyataan dapat ada dalam struktur SQL internal dalam memori Postgre tanpa pengidentifikasi. Karena Wawasan Performa mengambil sampel struktur internal dalam memori sekali per detik, kueri latensi rendah mungkin muncul hanya untuk satu sampel. Jika ID kueri tidak tersedia untuk sampel ini, Wawasan Performa tidak dapat mengaitkan pernyataan ini dengan statistiknya. Nilai yang tidak diketahui ditunjukkan dengan tanda hubung (`-`).

Untuk deskripsi SQL statistik untuk mesin Amazon RDS , lihat. [Statistik SQL untuk Wawasan Performa](sql-statistics.md)

### Muat dengan menunggu () AAS
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Load-by-waits"></a>

Di **Atas SQL**, kolom **Load by waits (AAS)** menggambarkan persentase beban database yang terkait dengan setiap item beban teratas. Kolom ini menunjukkan muatan untuk item tersebut berdasarkan pengelompokan apa pun yang saat ini dipilih di **Bagan Muatan DB**. Untuk informasi selengkapnya tentang Rata-rata sesi aktif (AAS), lihat[Sesi aktif rata-rata](USER_PerfInsights.Overview.ActiveSessions.md#USER_PerfInsights.Overview.ActiveSessions.AAS).

Misalnya, Anda mungkin mengelompokkan bagan **Muatan DB** berdasarkan status tunggu. Anda memeriksa SQL kueri di tabel item pemuatan teratas. Dalam kasus ini, bilah **Muatan DB berdasarkan Status Tunggu** diberi ukuran, disegmentasi, dan diberi kode warna untuk menunjukkan seberapa banyak status tunggu tertentu yang dikontribusikan oleh kueri. Bilah ini juga menunjukkan status tunggu yang memengaruhi kueri yang dipilih.

![\[Muatan DB berdasarkan status tunggu\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_6.png)


### Lihat SQL informasi
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.SQL-information"></a>

Di SQL tabel **Atas**, Anda dapat membuka pernyataan untuk melihat informasinya. Informasi ini muncul di panel bawah.

![\[SQLTabel teratas dengan kueri literal dipilih\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf-insights-sql-ids-open.png)


Berikut jenis identifier (IDs) yang terkait dengan SQL pernyataan:
+ **Support SQL ID** — Nilai hash dari SQL ID. Nilai ini hanya untuk mereferensikan SQL ID saat Anda bekerja dengan AWS Support. AWS Support tidak memiliki akses ke aktual SQL IDs dan SQL teks Anda.
+ **Support Digest ID** – Nilai hash dari ID digest. Nilai ini hanya untuk mereferensikan ID intisari saat Anda bekerja dengan Support AWS . AWS Support tidak memiliki akses ke intisari IDs dan SQL teks Anda yang sebenarnya.

### Pilih preferensi statistik
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Preferences"></a>

Anda dapat mengontrol statistik yang ditampilkan di SQL tab **Atas** dengan memilih ikon **Preferensi**.

![\[Preferensi statistik\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf-insights-sql-ids-preferences-icon.png)


Saat memilih ikon **Preferensi**, jendela **Preferensi** akan terbuka. Tangkapan layar berikut adalah contoh jendela **Preferensi**.

![\[Jendela Preferensi\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf-insights-sql-ids-preferences.png)


Untuk mengaktifkan statistik yang ingin Anda tampilkan di SQL tab **Atas**, gunakan mouse Anda untuk menggulir ke bagian bawah jendela, lalu pilih **Lanjutkan**. 

Untuk informasi selengkapnya tentang statistik per detik atau per panggilan untuk mesin Amazon RDSAurora khusus mesin di SQL [Statistik SQL untuk Wawasan Performa](sql-statistics.md)

# Mengakses lebih banyak teks SQL di dasbor Wawasan Performa
<a name="USER_PerfInsights.UsingDashboard.SQLTextSize"></a>

Secara default, setiap baris dalam tabel **SQL Teratas** menunjukkan 500 byte teks SQL untuk setiap pernyataan SQL.

![\[500 byte SQL\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf-insights-top-sql-bytes.png)


Saat pernyataan SQL melebihi 500 byte, Anda dapat melihat lebih banyak teks di bagian **Teks SQL** di bawah tabel **SQL Teratas**. Dalam hal ini, panjang maksimum teks yang ditampilkan dalam **Teks SQL** adalah 4 KB. Batas ini diperkenalkan oleh konsol dan tunduk pada batas yang ditetapkan oleh mesin basis data. Untuk menyimpan teks yang ditampilkan dalam **Teks SQL**, pilih **Unduh**.

**Topics**
+ [Batas ukuran teks untuk mesin Amazon RDS](#sql-text-engine-limits)
+ [Mengatur batas teks SQL untuk instans DB Amazon RDS for PostgreSQL](USER_PerfInsights.UsingDashboard.SQLTextLimit.md)
+ [Melihat dan mengunduh teks SQL di dasbor Wawasan Performa](view-download-text.md)

## Batas ukuran teks untuk mesin Amazon RDS
<a name="sql-text-engine-limits"></a>

Saat Anda mengunduh teks SQL, mesin basis data menentukan panjang maksimumnya. Anda dapat mengunduh teks SQL hingga batas per mesin berikut.


| Mesin DB | Panjang maksimum teks yang diunduh | 
| --- | --- | 
| Amazon RDS for MySQL dan MariaDB | Panjangnya tetap pada 4.096 byte saat Skema Kinerja diaktifkan. Jika Skema Kinerja tidak diaktifkan, panjangnya ditetapkan pada 65.535 byte. | 
| Amazon RDS for Microsoft SQL Server | 4.096 karakter | 
| Amazon RDS for Oracle | 1.000 byte | 

Bagian **Teks SQL** dari konsol Wawasan Performa menampilkan hingga maksimum yang ditampilkan mesin. Misalnya, jika MySQL menampilkan paling banyak 1 KB ke Wawasan Performa, Aurora MySQL hanya dapat mengumpulkan dan menampilkan 1 KB, meskipun kueri asalnya lebih besar. Jadi, jika Anda melihat kueri dalam **Teks SQL** atau mengunduhnya, Wawasan Performa akan menampilkan jumlah byte yang sama.

Jika Anda menggunakan AWS CLI atau API, Performance Insights tidak memiliki batas 4 KB yang diberlakukan oleh konsol. `DescribeDimensionKeys`dan `GetResourceMetrics` kembali paling banyak 500 byte. 

**catatan**  
`GetDimensionKeyDetails`mengembalikan kueri lengkap, tetapi ukurannya tunduk pada batas mesin.

# Mengatur batas teks SQL untuk instans DB Amazon RDS for PostgreSQL
<a name="USER_PerfInsights.UsingDashboard.SQLTextLimit"></a>

Amazon RDS for PostgreSQL menangani teks secara berbeda. Anda dapat mengatur batas ukuran teks dengan parameter instans DB `track_activity_query_size`. Parameter ini memiliki karakteristik sebagai berikut:

Ukuran teks default  
Di Amazon RDS for PostgreSQL versi 9.6, pengaturan default untuk parameter `track_activity_query_size` adalah 1.024 byte. Di Amazon RDS for PostgreSQL versi 10 atau yang lebih baru, pengaturan default-nya adalah 4.096 byte.

Ukuran teks maksimum  
Batas untuk `track_activity_query_size` adalah 102.400 byte untuk Amazon RDS for PostgreSQL versi 12 dan versi yang lebih rendah. Ukuran maksimumnya adalah 1 MB untuk versi 13 dan yang lebih baru.   
Jika mesin menampilkan 1 MB ke Wawasan Performa, konsol hanya akan menampilkan 4 KB pertama. Jika mengunduh kueri, Anda akan mendapatkan 1 MB penuh. Dalam hal ini, melihat dan mengunduh menampilkan jumlah byte yang berbeda. Untuk informasi selengkapnya tentang parameter instans DB `track_activity_query_size`, lihat [Run-time Statistics](https://www.postgresql.org/docs/current/runtime-config-statistics.html) dalam dokumentasi PostgreSQL.

Untuk meningkatkan ukuran teks SQL, tingkatkan batas `track_activity_query_size`. Untuk memodifikasi parameter, ubah pengaturan parameter di grup parameter yang terkait dengan instans DB Amazon RDS for PostgreSQL.

**Untuk mengubah pengaturan saat instans menggunakan grup parameter default**

1. Buat grup parameter instans DB baru untuk mesin DB dan versi mesin DB yang sesuai.

1. Tetapkan parameter di grup parameter baru.

1. Hubungkan grup parameter baru dengan instans DB.

Untuk informasi tentang cara mengatur parameter instans DB, lihat [](USER_WorkingWithParamGroups.Modifying.md).

# Melihat dan mengunduh teks SQL di dasbor Wawasan Performa
<a name="view-download-text"></a>

Di dasbor Wawasan Performa, Anda dapat melihat atau mengunduh teks SQL.

**Untuk melihat lebih banyak teks SQL di dasbor Wawasan Performa**

1. Buka konsol Amazon RDS di [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Di panel navigasi, pilih **Wawasan Performa**.

1. Pilih instans DB.

1. Gulir ke bawah ke tab **SQL Teratas** di dasbor Performance Insights.

1. Pilih tanda plus untuk memperluas intisari SQL dan pilih salah satu kueri turunan intisari.

   Pernyataan SQL dengan teks yang lebih besar dari 500 byte terlihat hampir seperti gambar berikut.  
![\[Pernyataan SQL dengan teks besar\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf-insights-large-text-1.png)

1. Gulir ke bawah ke tab **Teks SQL**.  
![\[Bagian informasi SQL menunjukkan lebih banyak teks SQL\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf-insights-large-text-2.png)

   Dasbor Wawasan Performa dapat menampilkan hingga 4.096 byte untuk setiap pernyataan SQL.

1. (Opsional) Pilih **Salin** untuk menyalin pernyataan SQL yang ditampilkan, atau pilih **Unduh** untuk mengunduh pernyataan SQL guna menampilkan teks SQL hingga batas mesin DB.
**catatan**  
Untuk menyalin atau mengunduh pernyataan SQL, nonaktifkan pemblokir pop-up. 

# Melihat statistik SQL di dasbor Wawasan Performa
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.AnalyzingSQLLevel"></a>

Di dasbor Wawasan Performa, statistik SQL tersedia di tab **SQL Teratas** pada bagan **Muatan basis data**.

**Untuk melihat statistik SQL**

1. Buka konsol Amazon RDS di [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Di panel navigasi kiri, pilih **Wawasan Performa**.

1. Di bagian atas halaman, pilih basis data yang statistik SQL-nya ingin dilihat.

1. Gulir ke bagian bawah halaman dan pilih tab **SQL Teratas**.

1. Pilih setiap pernyataan atau kueri digest.  
![\[Melihat metrik untuk kueri yang berjalan\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_sql.png)

1. Pilih statistik yang akan ditampilkan dengan memilih ikon roda gigi di sudut kanan atas bagan. Untuk deskripsi statistik SQL untuk mesin Amazon RDS, lihat [Statistik SQL untuk Wawasan Performa](sql-statistics.md).

   Contoh berikut menunjukkan preferensi statistik untuk instans DB Oracle.  
![\[Preferensi metrik kueri yang berjalan untuk instans DB Oracle\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_pref_oracle.png)

   Contoh berikut menunjukkan preferensi untuk instans DB MariaDB dan MySQL.  
![\[Preferensi metrik kueri yang berjalan untuk instans DB MariaDB dan MySQL.\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_pref_ams.png)

1. Pilih Simpan untuk menyimpan preferensi Anda.

   Tabel **SQL Top** dimuat ulang.

   Contoh berikut menunjukkan statistik untuk query Oracle SQL.  
![\[Statistik kueri SQL\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_stats_oracle.png)

# Menganalisis beban Oracle PDB teratas
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.TopPDB"></a>

Saat menganalisis beban pada kontainer Oracle DB (CDB), Anda mungkin ingin mengidentifikasi database pluggable (PDBs) mana yang paling berkontribusi pada pemuatan DB. Anda mungkin juga ingin membandingkan kinerja individu PDBs yang menjalankan kueri serupa untuk menyempurnakan kinerja. Untuk informasi lebih lanjut tentang OracleCDBs, lihat[Arsitektur basis data RDS for Oracle](oracle-multi-architecture.md).

**Di dasbor Amazon RDS Performance Insights, Anda dapat menemukan informasi tentang database pluggable (PDBs) di bawah PDB tab **Top** di tab Dimensi.**

Untuk informasi dukungan region, engine DB, dan kelas instance untuk fitur ini, lihat[Amazon RDS Aurora DB engine, Wilayah, dan dukungan kelas instans untuk fitur Performance Insights](USER_PerfInsights.Overview.Engines.md#USER_PerfInsights.Overview.PIfeatureEngnRegSupport).

**Untuk menganalisis Top PDB load di Oracle CDB**

1. Masuk ke Konsol Manajemen AWS dan buka RDS konsol Amazon di [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Di panel navigasi kiri, pilih **Performance** Insights.

1. Pilih CDB contoh Oracle.

   Dasbor Wawasan Performa muncul untuk instans DB.

1. Di bagian **beban Database (beban DB)**, pilih **Pluggable database (PDB)** di sebelah Slice by.

   Grafik sesi aktif rata-rata menunjukkan PDB dengan beban tertinggi. PDBPengidentifikasi muncul di sebelah kanan kotak kode warna. Setiap pengidentifikasi secara unik mengidentifikasi a. PDB  
![\[Grafik sesi aktif rata-rata untuk PDB pemuatan\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_topPDB_AAS.png)

1. Gulir ke bawah ke SQL tab **Atas**.

   Dalam contoh berikut, Anda dapat melihat SQL kueri yang sama dan memuatnya ke beberapaPDBs.  
![\[Beban SQL kueri yang sama untuk beberapa PDBs\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_topPDB_ex1.png)

   Dalam contoh berikut, satu menangani beban PDB yang lebih tinggi daripada yang lain PDBs diCDB.  
![\[Beban SQL kueri tinggi untuk PDB\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf_insights_topPDB_ex2.png)

   Untuk informasi lebih lanjut tentang OracleCDBs, lihat [CDBsdan PDBs](https://docs.oracle.com/en/database/oracle/oracle-database/21/cncpt/CDBs-and-PDBs.html#GUID-FC2EB562-ED31-49EF-8707-C766B6FE66B8).

# Menganalisis rencana eksekusi menggunakan dasbor Performance Insights untuk Amazon RDS
<a name="USER_PerfInsights.UsingDashboard.AnalyzingPlans"></a>

Di dasbor Amazon RDS Performance Insights, Anda dapat menemukan informasi tentang rencana eksekusi untuk instans Oracle dan SQL Server DB. Anda dapat menggunakan informasi ini untuk mengetahui paket mana yang paling berkontribusi pada pemuatan DB.

Untuk menganalisis Oracle atau SQL Server rencana eksekusi, lihat topik berikut.

**Menganalisis rencana eksekusi**
+ [Menganalisis rencana eksekusi Oracle menggunakan dasbor Performance Insights untuk Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlans.md)
+ [Menganalisis paket eksekusi SQL Server menggunakan dasbor Performance Insights untuk Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlansSqlServer.md)

## Ikhtisar menganalisis rencana eksekusi untuk Amazon RDS
<a name="USER_PerfInsights.UsingDashboard.AnalyzingPlans.Overview"></a>

Anda dapat menggunakan dasbor Amazon RDS Performance Insights untuk mengetahui paket mana yang paling berkontribusi terhadap pemuatan DB untuk instans Oracle dan SQL Server DB. 

 Misalnya, SQL pernyataan teratas pada waktu tertentu mungkin menggunakan rencana yang ditunjukkan pada tabel berikut.


****  

| Teratas SQL | Rencana | 
| --- | --- | 
|  SELECTSUM(amount\$1sold) FROM penjualan WHERE prod\$1id = 10  |  Rencana A  | 
|  SELECTSUM(jumlah\$1terjual) FROM penjualan WHERE prod\$1id = 521  |  Rencana B  | 
|  SELECTSUM(s\$1total) WHERE wilayah FROM penjualan = 10  |  Rencana A  | 
|  SELECT\$1 FROM emp WHERE emp\$1id = 1000  |  Rencana C  | 
|  SELECTSUM(amount\$1sold) FROM penjualan WHERE prod\$1id = 72  |  Rencana A  | 

Dengan fitur rencana Wawasan Performa, Anda dapat melakukan tindakan berikut:
+ Cari tahu paket mana yang digunakan oleh SQL kueri teratas. 

  Misalnya, Anda mungkin mengetahui bahwa sebagian besar muatan DB dihasilkan oleh kueri yang menggunakan rencana A dan rencana B, dengan hanya sebagian kecil yang menggunakan paket C.
+ Bandingkan rencana yang berbeda untuk kueri yang sama. 

  Dalam contoh sebelumnya, tiga kueri identik kecuali untuk ID produk. Dua kueri menggunakan rencana A, tetapi satu kueri menggunakan rencana B. Untuk melihat perbedaan dalam dua rencana tersebut, Anda dapat menggunakan Wawasan Performa.
+ Cari tahu kapan kueri beralih ke rencana baru. 

  Anda mungkin melihat bahwa kueri menggunakan rencana A, lalu beralih ke rencana B pada waktu tertentu. Apakah ada perubahan dalam basis data pada saat ini? Misalnya, jika tabel kosong, pengoptimal mungkin memilih pemindaian tabel lengkap. Jika tabel dimuat dengan satu juta baris, pengoptimal mungkin beralih ke pemindaian rentang indeks.
+ Telusuri langkah-langkah rencana spesifik dengan biaya tertinggi.

  Misalnya, untuk kueri yang berjalan lama mungkin menunjukkan kondisi gabungan yang hilang dalam equi-join. Kondisi yang hilang ini memaksa penggabungan Cartesian, yang menggabungkan semua baris dari dua tabel.

Anda dapat melakukan tugas sebelumnya dengan menggunakan fitur pengambilan rencana dari Wawasan Performa. Sama seperti Anda dapat mengiris kueri dengan acara tunggu dan bagian atasSQL, Anda dapat mengirisnya berdasarkan dimensi rencana.

# Menganalisis rencana eksekusi Oracle menggunakan dasbor Performance Insights untuk Amazon RDS
<a name="USER_PerfInsights.UsingDashboard.AccessPlans"></a>

Saat menganalisis muatan DB di Oracle Database, sebaiknya Anda mengetahui paket yang paling berkontribusi terhadap muatan DB. Anda dapat menentukan paket mana yang paling berkontribusi terhadap pemuatan DB dengan menggunakan fitur pengambilan paket Performance Insights. 

**Untuk menganalisis rencana eksekusi Oracle menggunakan konsol**

1. Buka konsol Amazon RDS di [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Di panel navigasi, pilih **Wawasan Performa**.

1. Pilih instans DB Oracle. Dasbor Wawasan Performa ditampilkan untuk instans DB tersebut.

1. Di bagian **Muatan basis data (muatan DB)**, pilih **Rencana** di sebelah **Potong menurut**.

   Bagan Sesi aktif rata-rata menunjukkan rencana yang digunakan oleh pernyataan SQL teratas. Nilai hash rencana muncul di sebelah kanan kotak kode warna. Setiap nilai hash secara unik mengidentifikasi rencana.  
![\[Potong menurut rencana\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/pi-slice-by-plans.png)

1. Gulir ke bawah ke tab **SQL Teratas**.

   Dalam contoh berikut, digest SQL teratas memiliki dua rencana. Anda dapat beranggapan bahwa ini adalah digest dengan tanda tanya dalam pernyataan.   
![\[Pilih rencana digest\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/top-sql-plans-unselected.png)

1. Pilih digest untuk meluaskannya dalam pernyataan komponennya.

   Dalam contoh berikut, pernyataan `SELECT` merupakan kueri digest. Kueri komponen dalam digest menggunakan dua rencana yang berbeda. Warna rencana sesuai dengan bagan muatan basis data. Jumlah total rencana dalam digest ditampilkan di kolom kedua.  
![\[Pilih rencana digest\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/pi-digest-plan.png)

1. Gulir ke bawah dan pilih dua **Rencana** untuk dibandingkan dari daftar **Rencana untuk kueri digest**.

   Anda dapat melihat salah satu atau dua rencana untuk kueri sekaligus. Tangkapan layar berikut membandingkan dua rencana dalam digest, dengan hash 2032253151 dan hash 1117438016. Dalam contoh berikut, 62% dari sesi aktif rata-rata yang menjalankan kueri digest ini menggunakan rencana di sebelah kiri, sedangkan 38% menggunakan rencana di sebelah kanan.  
![\[Bandingkan kedua rencana secara berdampingan\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/pi-compare-plan.png)

   Dalam contoh ini, rencana ini sangat berbeda. Langkah 2 dalam rencana 2032253151 menggunakan pemindaian indeks, sedangkan rencana 1117438016 menggunakan pemindaian tabel lengkap. Untuk tabel dengan banyak baris, kueri satu baris hampir selalu lebih cepat dengan pemindaian indeks.  
![\[Bandingkan kedua rencana secara berdampingan\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/pi-table-access.png)

1. (Opsional) Pilih **Salin** untuk menyalin rencana ke papan klip, atau **Unduh** untuk menyimpan rencana ke hard drive Anda. 

# Menganalisis paket eksekusi SQL Server menggunakan dasbor Performance Insights untuk Amazon RDS
<a name="USER_PerfInsights.UsingDashboard.AccessPlansSqlServer"></a>

Saat menganalisis beban DB pada Database SQL Server, Anda mungkin ingin tahu paket mana yang paling berkontribusi pada pemuatan DB. Anda dapat menentukan paket mana yang paling berkontribusi terhadap pemuatan DB dengan menggunakan fitur pengambilan paket Performance Insights. 

**Untuk menganalisis rencana eksekusi SQL Server menggunakan konsol**

1. Buka RDS konsol Amazon di [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Di panel navigasi, pilih **Wawasan Performa**.

1. Pilih instans SQL Server DB. Dasbor Wawasan Performa ditampilkan untuk instans DB tersebut.

1. Di bagian **Muatan basis data (muatan DB)**, pilih **Rencana** di sebelah **Potong menurut**.

   Bagan sesi aktif rata-rata menunjukkan rencana yang digunakan oleh SQL pernyataan teratas Anda. Nilai hash rencana muncul di sebelah kanan kotak kode warna. Setiap nilai hash secara unik mengidentifikasi rencana.  
![\[Potong menurut rencana\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/pi-slice-by-plans-sqlserver.png)

1. Gulir ke bawah ke SQL tab **Atas**.

   Dalam contoh berikut, SQL intisari teratas memiliki tiga rencana. Kehadiran tanda tanya dalam SQL pernyataan menunjukkan bahwa pernyataan itu adalah intisari. Untuk melihat SQL pernyataan lengkap, pilih nilai di kolom **SQLpernyataan**.  
![\[Pilih rencana digest\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/top-sql-plans-unselected-sqlserver.png)

1. Pilih digest untuk meluaskannya dalam pernyataan komponennya.

   Dalam contoh berikut, pernyataan `SELECT` merupakan kueri digest. Kueri komponen dalam intisari menggunakan tiga rencana eksekusi yang berbeda. Warna yang ditetapkan untuk rencana sesuai dengan bagan beban database.  
![\[Pilih rencana digest\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/pi-digest-plan-sqlserver.png)

1. Gulir ke bawah dan pilih dua **Rencana** untuk dibandingkan dari daftar **Rencana untuk kueri digest**.

   Anda dapat melihat salah satu atau dua rencana untuk kueri sekaligus. Tangkapan layar berikut membandingkan dua paket dalam intisari. Dalam contoh berikut, 40% dari rata-rata sesi aktif yang menjalankan kueri intisari ini menggunakan paket di sebelah kiri, sedangkan 28% menggunakan paket di sebelah kanan.  
![\[Bandingkan kedua rencana secara berdampingan\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/pi-compare-plan-sqlserver.png)

   Dalam contoh sebelumnya, rencana berbeda dalam cara yang penting. Langkah 2 dalam rencana di sebelah kiri menggunakan pemindaian tabel, sedangkan rencana di sebelah kanan menggunakan pemindaian indeks berkerumun. Untuk tabel dengan sejumlah besar baris, kueri yang mengambil satu baris hampir selalu lebih cepat dengan pemindaian indeks berkerumun.

1. (Opsional) Pilih **Pengaturan** ikon pada tabel Rincian Rencana untuk menyesuaikan visibilitas dan urutan kolom. Tangkapan layar berikut menunjukkan tabel Rincian Rencana dengan kolom **daftar Output** sebagai kolom kedua.  
![\[Sesuaikan visibilitas dan urutan kolom dalam tabel Rincian Rencana\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/pi-plan-fields-sql-server.png)

1. (Opsional) Pilih **Salin** untuk menyalin rencana ke papan klip, atau **Unduh** untuk menyimpan rencana ke hard drive Anda. 

**catatan**  
Performance Insights menampilkan perkiraan rencana eksekusi menggunakan tabel pohon hierarkis. Tabel ini mencakup informasi eksekusi sebagian untuk setiap pernyataan. Untuk informasi selengkapnya tentang kolom dalam tabel Rincian Paket, lihat [SETSHOWPLAN\$1 ALL](https://learn.microsoft.com/en-us/sql/t-sql/statements/set-showplan-all-transact-sql) di dokumentasi SQL Server. Untuk menampilkan informasi eksekusi lengkap untuk perkiraan rencana eksekusi, pilih **Unduh** untuk mengunduh paket dan kemudian mengunggah paket ke SQL Server Management Studio. Untuk informasi selengkapnya tentang menampilkan perkiraan rencana eksekusi menggunakan Studio Manajemen SQL Server, lihat [Menampilkan Rencana Eksekusi yang Diperkirakan](https://learn.microsoft.com/en-us/sql/relational-databases/performance/display-the-estimated-execution-plan) dalam dokumentasi SQL Server. 

# Melihat rekomendasi proaktif Performance Insights
<a name="USER_PerfInsights.InsightsRecommendationViewDetails"></a>

Amazon RDS Performance Insights memantau metrik tertentu dan secara otomatis membuat ambang batas dengan menganalisis level apa yang mungkin berpotensi bermasalah untuk sumber daya tertentu. Ketika nilai metrik baru melewati ambang batas yang telah ditentukan selama periode waktu tertentu, Performance Insights menghasilkan rekomendasi proaktif. Rekomendasi ini membantu mencegah dampak kinerja database future. Untuk menerima rekomendasi proaktif ini, Anda harus mengaktifkan Performance Insights dengan periode retensi tingkat berbayar.

Untuk informasi selengkapnya tentang mengaktifkan Wawasan Performa, lihat [Mengaktifkan dan menonaktifkan Performance Insights untuk Amazon RDS](USER_PerfInsights.Enabling.md). Untuk informasi tentang harga dan retensi data untuk Performance Insights, lihat. [Harga dan retensi data untuk Wawasan Performa](USER_PerfInsights.Overview.cost.md)

Untuk mengetahui wilayah, mesin DB, dan kelas instance yang didukung untuk rekomendasi proaktif, lihat[Amazon RDS Aurora DB engine, Wilayah, dan dukungan kelas instans untuk fitur Performance Insights](USER_PerfInsights.Overview.Engines.md#USER_PerfInsights.Overview.PIfeatureEngnRegSupport). 

Anda dapat melihat analisis terperinci dan investigasi rekomendasi proaktif yang direkomendasikan di halaman detail rekomendasi.

Untuk informasi lebih lanjut tentang rekomendasi, lihat[Rekomendasi dari RDS](monitoring-recommendations.md).

**Untuk melihat analisis rinci dari rekomendasi proaktif**

1. Masuk ke Konsol Manajemen AWS dan buka RDS konsol Amazon di [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Di panel navigasi, lakukan salah satu hal berikut:
   + Pilih **Rekomendasi**.

     Halaman **Rekomendasi** menampilkan daftar rekomendasi yang diurutkan berdasarkan tingkat keparahan semua sumber daya di akun Anda.
   + Pilih **Database** dan kemudian pilih **Rekomendasi** untuk sumber daya di halaman database.

     Tab **Rekomendasi** menampilkan rekomendasi dan detailnya untuk sumber daya yang dipilih.

1. Temukan rekomendasi proaktif dan pilih **Lihat detail**.

   Halaman detail rekomendasi muncul. Judul memberikan nama sumber daya yang terpengaruh dengan masalah yang terdeteksi dan tingkat keparahannya.

   Berikut ini adalah komponen pada halaman detail rekomendasi:
   + **Ringkasan rekomendasi** — Masalah yang terdeteksi, status rekomendasi dan masalah, waktu mulai dan berakhir masalah, waktu modifikasi rekomendasi, dan jenis mesin.  
![\[Halaman detail rekomendasi untuk rekomendasi proaktif yang menampilkan bagian Ringkasan rekomendasi di konsol\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/RecommendationProactive-RecSummary.png)
   + **Metrik** — Grafik masalah yang terdeteksi. Setiap grafik menampilkan ambang batas yang ditentukan oleh perilaku dasar sumber daya dan data metrik yang dilaporkan dari waktu mulai masalah.  
![\[Halaman detail rekomendasi untuk rekomendasi proaktif yang menampilkan bagian Metrik di konsol\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/RecommedationProactive_Metrics.png)
   + **Analisis dan rekomendasi** — Rekomendasi dan alasan rekomendasi yang disarankan.  
![\[Halaman detail rekomendasi untuk rekomendasi proaktif yang menampilkan bagian Analisis dan rekomendasi di konsol\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/ProactiveRecommendation-AnalysisAndRec.png)

   Anda dapat meninjau penyebab masalah dan kemudian melakukan tindakan yang disarankan untuk memperbaiki masalah, atau memilih **Singkirkan** di kanan atas untuk mengabaikan rekomendasi.

# Mengambil metrik dengan Performance API Insights untuk Amazon RDS
<a name="USER_PerfInsights.API"></a>

Saat Performance Insights diaktifkan, maka akan API memberikan visibilitas ke performa instans. Amazon CloudWatch Logs menyediakan sumber otoritatif untuk metrik pemantauan terjual untuk layanan. AWS 

Performance Insights menawarkan tampilan khusus domain dari beban database yang diukur sebagai sesi aktif rata-rata (). AAS Metrik ini muncul bagi API konsumen sebagai kumpulan data deret waktu dua dimensi. Dimensi waktu data menyediakan data muatan DB untuk setiap titik waktu dalam rentang waktu yang dikueri. Setiap titik waktu menguraikan keseluruhan muatan dalam hubungannya dengan dimensi yang diminta, seperti `SQL`, `Wait-event`, `User`, atau `Host`, yang diukur pada titik waktu tersebut.

Amazon RDS Performance Insights memantau instans Amazon RDS DB cluster sehingga Anda dapat menganalisis dan memecahkan masalah kinerja database. Salah satu cara untuk menampilkan data Wawasan Performa dapat ditemukan di Konsol Manajemen AWS. Performance Insights juga menyediakan publik API sehingga Anda dapat melakukan kueri data Anda sendiri. Anda dapat menggunakan API untuk melakukan hal berikut:
+ Membongkar data ke dalam basis data
+ Menambahkan data Wawasan Performa ke dasbor pemantauan yang ada
+ Merancang alat pemantauan

Untuk menggunakan Performance InsightsAPI, aktifkan Performance Insights di salah satu instans Amazon RDS DB Anda. Untuk informasi tentang cara mengaktifkan Wawasan Performa, lihat [Mengaktifkan dan menonaktifkan Performance Insights untuk Amazon RDS](USER_PerfInsights.Enabling.md). Untuk informasi selengkapnya tentang Performance InsightsAPI, lihat Referensi [Performance RDS API Insights Amazon](https://docs.aws.amazon.com/performance-insights/latest/APIReference/Welcome.html).

Performance Insights API menyediakan operasi berikut.


****  

|  Tindakan Wawasan Performa  |  AWS CLI perintah  |  Deskripsi  | 
| --- | --- | --- | 
|  [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_CreatePerformanceAnalysisReport.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_CreatePerformanceAnalysisReport.html)  |  [https://docs.aws.amazon.com/cli/latest/reference/pi/CreatePerformanceAnalysisReport.html](https://docs.aws.amazon.com/cli/latest/reference/pi/CreatePerformanceAnalysisReport.html)  |  Membuat laporan analisis performa selama periode waktu tertentu untuk instans DB. Hasilnya adalah `AnalysisReportId`, yakni ID unik laporan.  | 
|  [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DeletePerformanceAnalysisReport.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DeletePerformanceAnalysisReport.html)  |  [https://docs.aws.amazon.com/cli/latest/reference/pi/DeletePerformanceAnalysisReport.html](https://docs.aws.amazon.com/cli/latest/reference/pi/DeletePerformanceAnalysisReport.html)  |  Menghapus laporan analisis performa.  | 
|  [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DescribeDimensionKeys.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DescribeDimensionKeys.html)  |  [https://docs.aws.amazon.com/cli/latest/reference/pi/describe-dimension-keys.html](https://docs.aws.amazon.com/cli/latest/reference/pi/describe-dimension-keys.html)  |  Mengambil kunci dimensi N teratas untuk metrik selama periode waktu tertentu.  | 
|  [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetDimensionKeyDetails.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetDimensionKeyDetails.html)  |  [https://docs.aws.amazon.com/cli/latest/reference/pi/get-dimension-key-details.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-dimension-key-details.html)  |  Mengambil atribut dari grup dimensi tertentu untuk instans DB atau sumber data. Misalnya, jika Anda menentukan SQL ID, dan jika detail dimensi tersedia, `GetDimensionKeyDetails` mengambil teks lengkap dari dimensi yang `db.sql.statement` terkait dengan ID ini. Operasi ini berguna karena `GetResourceMetrics` dan `DescribeDimensionKeys` tidak mendukung pengambilan teks SQL pernyataan besar.   | 
|  [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetPerformanceAnalysisReport.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetPerformanceAnalysisReport.html)  |  [https://docs.aws.amazon.com/cli/latest/reference/pi/GetPerformanceAnalysisReport.html](https://docs.aws.amazon.com/cli/latest/reference/pi/GetPerformanceAnalysisReport.html)  |  Mengambil laporan yang mencakup wawasan untuk laporan. Hasilnya mencakup status laporan, ID laporan, detail waktu laporan, wawasan, dan rekomendasi.  | 
| [GetResourceMetadata](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetResourceMetadata.html) |  [https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metadata.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metadata.html)  |  Mengambil metadata untuk fitur yang berbeda. Misalnya, metadata mungkin menunjukkan bahwa fitur diaktifkan atau dinonaktifkan pada instans DB tertentu.   | 
|  [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetResourceMetrics.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetResourceMetrics.html)  |  [https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html)  |  Mengambil metrik Wawasan Performa untuk sekumpulan sumber data, selama periode waktu tertentu. Anda dapat menyediakan grup dimensi dan dimensi tertentu, serta memberikan kriteria penggabungan dan pemfilteran untuk setiap grup.  | 
| [ListAvailableResourceDimensions](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListAvailableResourceDimensions.html) |  [https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-dimensions.html](https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-dimensions.html)  |  Mengambil dimensi yang dapat dikueri untuk setiap jenis metrik yang ditentukan pada instans tertentu.   | 
| [ListAvailableResourceMetrics](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListAvailableResourceMetrics.html) |  [https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-metrics.html)  |  Mengambil semua metrik jenis metrik tertentu yang tersedia yang dapat dikueri untuk instans DB tertentu.  | 
|  `[ListPerformanceAnalysisReports](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListPerformanceAnalysisReports.html)` |  [https://docs.aws.amazon.com/cli/latest/reference/pi/list-performance-analysis-reports.html](https://docs.aws.amazon.com/cli/latest/reference/pi/list-performance-analysis-reports.html)  | Mengambil semua laporan analisis yang tersedia untuk instans DB. Laporan dicantumkan berdasarkan waktu mulai setiap laporan. | 
|  `[ListTagsForResource](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListTagsForResource.html)` |  [https://docs.aws.amazon.com/cli/latest/reference/pi/list-tags-for-resource.html](https://docs.aws.amazon.com/cli/latest/reference/pi/list-tags-for-resource.html)  |  Daftar semua tag metadata yang ditambahkan ke sumber daya. Daftar ini mencakup nama dan nilai tag.  | 
|  `[TagResource](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_TagResource.html)` |  [https://docs.aws.amazon.com/cli/latest/reference/pi/tag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/pi/tag-resource.html)  |  Menambahkan tag metadata ke sumber daya AmazonRDS. Tag ini termasuk nama dan nilai.  | 
|  `[UntagResource](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_UntagResource.html)` |  [https://docs.aws.amazon.com/cli/latest/reference/pi/untag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/pi/untag-resource.html)  |  Menghapus tag metadata dari sumber daya.  | 

Untuk informasi selengkapnya tentang mengambil metrik deret waktu dan AWS CLI contoh untuk Performance Insights, lihat topik berikut.

**Topics**
+ [Mengambil metrik deret waktu untuk Performance Insights](USER_PerfInsights.API.TimeSeries.md)
+ [AWS CLI contoh untuk Performance Insights](USER_PerfInsights.API.Examples.md)

# Mengambil metrik deret waktu untuk Performance Insights
<a name="USER_PerfInsights.API.TimeSeries"></a>

Operasi `GetResourceMetrics` mengambil satu atau beberapa metrik deret waktu dari data Wawasan Performa. `GetResourceMetrics` memerlukan metrik dan periode waktu, dan menampilkan respons dengan daftar poin data. 

Misalnya, Konsol Manajemen AWS penggunaan `GetResourceMetrics` untuk mengisi bagan **Metrik Penghitung** dan bagan **Pemuatan Database**, seperti yang terlihat pada gambar berikut.

![\[Bagan Metrik Penghitung dan Muatan Basis Data\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf-insights-api-charts.png)


Semua metrik yang ditampilkan oleh `GetResourceMetrics` adalah metrik deret waktu standar, dengan pengecualian `db.load`. Metrik ini ditampilkan dalam bagan **Muatan Basis Data**. Metrik `db.load` berbeda dengan metrik deret waktu lainnya karena Anda dapat membaginya menjadi beberapa sub-komponen yang disebut *dimensi*. Di gambar sebelumnya, `db.load` dibagi dan dikelompokkan berdasarkan status tunggu yang membentuk `db.load`.

**catatan**  
`GetResourceMetrics` juga dapat menampilkan metrik `db.sampleload`, tetapi metrik `db.load` sesuai di sebagian besar kasus.

Untuk informasi tentang metrik penghitung yang ditampilkan oleh `GetResourceMetrics`, lihat [Metrik penghitung Wawasan Performa](USER_PerfInsights_Counters.md).

Penghitungan berikut didukung untuk metrik:
+ Rata-rata – Nilai rata-rata untuk metrik selama periode waktu tertentu. Tambahkan `.avg` ke nama metrik.
+ Minimum – Nilai minimum metrik selama periode waktu tertentu. Tambahkan `.min` ke nama metrik.
+ Maksimum – Nilai maksimum metrik selama periode waktu tertentu. Tambahkan `.max` ke nama metrik.
+ Jumlah – Jumlah nilai metrik selama periode waktu tertentu. Tambahkan `.sum` ke nama metrik.
+ Jumlah sampel – Frekuensi pengumpulan metrik selama periode waktu tertentu. Tambahkan `.sample_count` ke nama metrik.

Sebagai contoh, misalkan sebuah metrik dikumpulkan selama 300 detik (5 menit), dan metrik tersebut dikumpulkan satu kali setiap menit. Nilai untuk setiap menit adalah 1, 2, 3, 4, dan 5. Dalam kasus ini, penghitungan berikut ditampilkan:
+ Rata-rata – 3
+ Minimum – 1
+ Maksimum – 5
+ Jumlah – 15
+ Jumlah sampel – 5

Untuk informasi tentang menggunakan `get-resource-metrics` AWS CLI perintah, lihat [https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html).

Untuk opsi `--metric-queries`, tentukan satu atau beberapa kueri yang diinginkan untuk mendapatkan hasil. Setiap kueri terdiri dari `Metric` wajib dan `GroupBy` opsional serta parameter `Filter`. Berikut ini adalah contoh spesifikasi opsi `--metric-queries`.

```
{
   "Metric": "string",
   "GroupBy": {
     "Group": "string",
     "Dimensions": ["string", ...],
     "Limit": integer
   },
   "Filter": {"string": "string"
     ...}
```

# AWS CLI contoh untuk Performance Insights
<a name="USER_PerfInsights.API.Examples"></a>

Di bagian berikut, pelajari lebih lanjut tentang AWS Command Line Interface (AWS CLI) untuk Performance Insights dan gunakan AWS CLI contoh.

**Topics**
+ [Bantuan bawaan AWS CLI untuk Performance Insights](#USER_PerfInsights.API.CLI)
+ [Mengambil metrik penghitung](#USER_PerfInsights.API.Examples.CounterMetrics)
+ [Mengambil rata-rata muatan DB untuk peristiwa tunggu teratas](#USER_PerfInsights.API.Examples.DBLoadAverage)
+ [Mengambil rata-rata muatan DB untuk SQL teratas](#USER_PerfInsights.API.Examples.DBLoadAverageTop10SQL)
+ [Mengambil Rata-Rata Muatan DB yang difilter berdasarkan SQL](#USER_PerfInsights.API.Examples.DBLoadAverageFilterBySQL)
+ [Mengambil teks lengkap pernyataan SQL](#USER_PerfInsights.API.Examples.GetDimensionKeyDetails)
+ [Membuat laporan analisis performa selama periode waktu tertentu](#USER_PerfInsights.API.Examples.CreatePerfAnalysisReport)
+ [Mengambil laporan analisis performa](#USER_PerfInsights.API.Examples.GetPerfAnalysisReport)
+ [Daftar semua laporan analisis performa untuk instans DB](#USER_PerfInsights.API.Examples.ListPerfAnalysisReports)
+ [Menghapus laporan analisis performa](#USER_PerfInsights.API.Examples.DeletePerfAnalysisReport)
+ [Menambahkan tag ke laporan analisis performa](#USER_PerfInsights.API.Examples.TagPerfAnalysisReport)
+ [Mencantumkan semua tag untuk laporan analisis performa](#USER_PerfInsights.API.Examples.ListTagsPerfAnalysisReport)
+ [Menghapus tag dari laporan analisis performa](#USER_PerfInsights.API.Examples.UntagPerfAnalysisReport)

## Bantuan bawaan AWS CLI untuk Performance Insights
<a name="USER_PerfInsights.API.CLI"></a>

Anda dapat melihat data Wawasan Performa menggunakan AWS CLI. Anda dapat melihat bantuan untuk AWS CLI perintah untuk Performance Insights dengan memasukkan yang berikut ini pada baris perintah.

```
aws pi help
```

Jika Anda belum menginstal, lihat [Menginstal AWS CLI di](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) *Panduan AWS CLI Pengguna* untuk informasi tentang menginstalnya. AWS CLI 

## Mengambil metrik penghitung
<a name="USER_PerfInsights.API.Examples.CounterMetrics"></a>

Tangkapan layar berikut menunjukkan dua bagan metrik penghitung dalam Konsol Manajemen AWS.

![\[Bagan Metrik Penghitung.\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf-insights-api-counters-charts.png)


Contoh berikut menunjukkan cara mengumpulkan data yang sama yang Konsol Manajemen AWS digunakan untuk menghasilkan dua bagan metrik penghitung.

Untuk Linux, macOS, atau Unix:

```
aws pi get-resource-metrics \
   --service-type RDS \
   --identifier db-ID \
   --start-time 2018-10-30T00:00:00Z \
   --end-time   2018-10-30T01:00:00Z \
   --period-in-seconds 60 \
   --metric-queries '[{"Metric": "os.cpuUtilization.user.avg"  },
                      {"Metric": "os.cpuUtilization.idle.avg"}]'
```

Untuk Windows:

```
aws pi get-resource-metrics ^
   --service-type RDS ^
   --identifier db-ID ^
   --start-time 2018-10-30T00:00:00Z ^
   --end-time   2018-10-30T01:00:00Z ^
   --period-in-seconds 60 ^
   --metric-queries '[{"Metric": "os.cpuUtilization.user.avg"  },
                      {"Metric": "os.cpuUtilization.idle.avg"}]'
```

Anda juga dapat membaca perintah dengan lebih mudah dengan menentukan file untuk opsi `--metrics-query`. Contoh berikut menggunakan file yang disebut query.json untuk opsi tersebut. File memiliki konten berikut.

```
[
    {
        "Metric": "os.cpuUtilization.user.avg"
    },
    {
        "Metric": "os.cpuUtilization.idle.avg"
    }
]
```

Jalankan perintah berikut untuk menggunakan file.

Untuk Linux, macOS, atau Unix:

```
aws pi get-resource-metrics \
   --service-type RDS \
   --identifier db-ID \
   --start-time 2018-10-30T00:00:00Z \
   --end-time   2018-10-30T01:00:00Z \
   --period-in-seconds 60 \
   --metric-queries file://query.json
```

Untuk Windows:

```
aws pi get-resource-metrics ^
   --service-type RDS ^
   --identifier db-ID ^
   --start-time 2018-10-30T00:00:00Z ^
   --end-time   2018-10-30T01:00:00Z ^
   --period-in-seconds 60 ^
   --metric-queries file://query.json
```

Contoh sebelumnya menentukan nilai-nilai berikut untuk opsi:
+ `--service-type` – `RDS` untuk Amazon RDS
+ `--identifier` – ID sumber daya untuk instans DB
+ `--start-time` dan `--end-time` – Nilai `DateTime` ISO 8601 untuk periode kueri, dengan berbagai format yang didukung

Ini akan dikueri selama rentang waktu satu jam:
+ `--period-in-seconds` – `60` untuk kueri per menit
+ `--metric-queries` – Rangkaian dua kueri, masing-masing hanya untuk satu metrik.

  Nama metrik menggunakan titik untuk mengklasifikasikan metrik dalam kategori yang berguna, dengan elemen terakhir sebagai fungsi. Dalam contoh, fungsinya adalah `avg` untuk setiap kueri. Seperti halnya Amazon CloudWatch, fungsi yang didukung adalah `min``max`,`total`, dan`avg`.

Responsnya terlihat seperti berikut.

```
{
    "Identifier": "db-XXX",
    "AlignedStartTime": 1540857600.0,
    "AlignedEndTime": 1540861200.0,
    "MetricList": [
        { //A list of key/datapoints 
            "Key": {
                "Metric": "os.cpuUtilization.user.avg" //Metric1
            },
            "DataPoints": [
                //Each list of datapoints has the same timestamps and same number of items
                {
                    "Timestamp": 1540857660.0, //Minute1
                    "Value": 4.0
                },
                {
                    "Timestamp": 1540857720.0, //Minute2
                    "Value": 4.0
                },
                {
                    "Timestamp": 1540857780.0, //Minute 3
                    "Value": 10.0
                }
                //... 60 datapoints for the os.cpuUtilization.user.avg metric
            ]
        },
        {
            "Key": {
                "Metric": "os.cpuUtilization.idle.avg" //Metric2
            },
            "DataPoints": [
                {
                    "Timestamp": 1540857660.0, //Minute1
                    "Value": 12.0
                },
                {
                    "Timestamp": 1540857720.0, //Minute2
                    "Value": 13.5
                },
                //... 60 datapoints for the os.cpuUtilization.idle.avg metric 
            ]
        }
    ] //end of MetricList
} //end of response
```

Respons ini memiliki `Identifier`, `AlignedStartTime`, dan `AlignedEndTime`. B nilai `--period-in-seconds` adalah `60`, waktu mulai dan akhir telah disesuaikan dengan menit. Jika `--period-in-seconds` adalah `3600`, waktu mulai dan akhir akan disesuaikan dengan jam.

`MetricList` dalam respons memiliki sejumlah entri, masing-masing dengan entri `Key` dan `DataPoints`. Masing-masing `DataPoint` memiliki `Timestamp` dan `Value`. Masing-masing daftar `Datapoints` memiliki 60 poin data karena kueri tersebut adalah untuk data per menit selama satu jam, dengan `Timestamp1/Minute1`, `Timestamp2/Minute2`, dan seterusnya, hingga `Timestamp60/Minute60`. 

Karena kueri tersebut adalah untuk dua metrik penghitung yang berbeda, ada dua elemen dalam respons `MetricList`.

## Mengambil rata-rata muatan DB untuk peristiwa tunggu teratas
<a name="USER_PerfInsights.API.Examples.DBLoadAverage"></a>

Contoh berikut adalah query yang sama yang Konsol Manajemen AWS digunakan untuk menghasilkan grafik garis area bertumpuk. Contoh ini mengambil `db.load.avg` selama satu jam terakhir dengan muatan yang dibagi berdasarkan tujuh peristiwa tunggu teratas. Perintah ini sama dengan perintah dalam [Mengambil metrik penghitung](#USER_PerfInsights.API.Examples.CounterMetrics). Namun, file query.json berisi konten berikut.

```
[
    {
        "Metric": "db.load.avg",
        "GroupBy": { "Group": "db.wait_event", "Limit": 7 }
    }
]
```

Jalankan perintah berikut.

Untuk Linux, macOS, atau Unix:

```
aws pi get-resource-metrics \
   --service-type RDS \
   --identifier db-ID \
   --start-time 2018-10-30T00:00:00Z \
   --end-time   2018-10-30T01:00:00Z \
   --period-in-seconds 60 \
   --metric-queries file://query.json
```

Untuk Windows:

```
aws pi get-resource-metrics ^
   --service-type RDS ^
   --identifier db-ID ^
   --start-time 2018-10-30T00:00:00Z ^
   --end-time   2018-10-30T01:00:00Z ^
   --period-in-seconds 60 ^
   --metric-queries file://query.json
```

Contoh ini menentukan metrik `db.load.avg` dan `GroupBy` dari tujuh peristiwa tunggu teratas. Untuk detail tentang nilai yang valid untuk contoh ini, lihat [DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html) dalam *Referensi API Wawasan Kinerja.*

Responsnya terlihat seperti berikut.

```
{
    "Identifier": "db-XXX",
    "AlignedStartTime": 1540857600.0,
    "AlignedEndTime": 1540861200.0,
    "MetricList": [
        { //A list of key/datapoints 
            "Key": {
                //A Metric with no dimensions. This is the total db.load.avg
                "Metric": "db.load.avg"
            },
            "DataPoints": [
                //Each list of datapoints has the same timestamps and same number of items
                {
                    "Timestamp": 1540857660.0, //Minute1
                    "Value": 0.5166666666666667
                },
                {
                    "Timestamp": 1540857720.0, //Minute2
                    "Value": 0.38333333333333336
                },
                {
                    "Timestamp": 1540857780.0, //Minute 3
                    "Value": 0.26666666666666666
                }
                //... 60 datapoints for the total db.load.avg key
            ]
        },
        {
            "Key": {
                //Another key. This is db.load.avg broken down by CPU
                "Metric": "db.load.avg",
                "Dimensions": {
                    "db.wait_event.name": "CPU",
                    "db.wait_event.type": "CPU"
                }
            },
            "DataPoints": [
                {
                    "Timestamp": 1540857660.0, //Minute1
                    "Value": 0.35
                },
                {
                    "Timestamp": 1540857720.0, //Minute2
                    "Value": 0.15
                },
                //... 60 datapoints for the CPU key
            ]
        },
        //... In total we have 8 key/datapoints entries, 1) total, 2-8) Top Wait Events
    ] //end of MetricList
} //end of response
```

Dalam respons ini, ada delapan entri dalam `MetricList`. Ada satu entri untuk total `db.load.avg`, dan tujuh entri masing-masing untuk `db.load.avg` yang dibagi berdasarkan salah satu dari tujuh peristiwa tunggu teratas. Tidak seperti di contoh pertama, karena ada dimensi pengelompokan, pasti ada satu kunci untuk setiap pengelompokan metrik. Tidak boleh hanya ada satu kunci untuk setiap metrik, seperti dalam kasus penggunaan metrik penghitung dasar.

## Mengambil rata-rata muatan DB untuk SQL teratas
<a name="USER_PerfInsights.API.Examples.DBLoadAverageTop10SQL"></a>

Contoh berikut mengelompokkan `db.wait_events` berdasarkan 10 pernyataan SQL teratas. Ada dua grup berbeda untuk pernyataan SQL:
+ `db.sql` – Pernyataan SQL lengkap, seperti `select * from customers where customer_id = 123`
+ `db.sql_tokenized` – Pernyataan SQL token, seperti `select * from customers where customer_id = ?`

Saat menganalisis performa basis data, sebaiknya pertimbangkan pernyataan SQL yang hanya berbeda dari segi parameternya sebagai satu item logika. Jadi, Anda dapat menggunakan `db.sql_tokenized` saat melakukan kueri. Namun, terutama ketika Anda tertarik untuk menjelaskan rencana, terkadang lebih berguna untuk memeriksa pernyataan SQL lengkap beserta parameter, dan pengelompokan kueri berdasarkan `db.sql`. Ada hubungan induk-turunan antara SQL token dan lengkap, dengan beberapa SQL lengkap (turunan) yang dikelompokkan dalam SQL token (induk) yang sama.

Perintah dalam contoh ini terlihat seperti perintah dalam [Mengambil rata-rata muatan DB untuk peristiwa tunggu teratas](#USER_PerfInsights.API.Examples.DBLoadAverage). Namun, file query.json berisi konten berikut.

```
[
    {
        "Metric": "db.load.avg",
        "GroupBy": { "Group": "db.sql_tokenized", "Limit": 10 }
    }
]
```

Contoh berikut menggunakan `db.sql_tokenized`.

Untuk Linux, macOS, atau Unix:

```
aws pi get-resource-metrics \
   --service-type RDS \
   --identifier db-ID \
   --start-time 2018-10-29T00:00:00Z \
   --end-time   2018-10-30T00:00:00Z \
   --period-in-seconds 3600 \
   --metric-queries file://query.json
```

Untuk Windows:

```
aws pi get-resource-metrics ^
   --service-type RDS ^
   --identifier db-ID ^
   --start-time 2018-10-29T00:00:00Z ^
   --end-time   2018-10-30T00:00:00Z  ^
   --period-in-seconds 3600 ^
   --metric-queries file://query.json
```

Contoh ini menanyakan lebih dari 24 jam, dengan satu jam period-in-seconds.

Contoh ini menentukan metrik `db.load.avg` dan `GroupBy` dari tujuh peristiwa tunggu teratas. Untuk detail tentang nilai yang valid untuk contoh ini, lihat [DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html) dalam *Referensi API Wawasan Kinerja.*

Responsnya terlihat seperti berikut.

```
{
    "AlignedStartTime": 1540771200.0,
    "AlignedEndTime": 1540857600.0,
    "Identifier": "db-XXX",

    "MetricList": [ //11 entries in the MetricList
        {
            "Key": { //First key is total
                "Metric": "db.load.avg"
            }
            "DataPoints": [ //Each DataPoints list has 24 per-hour Timestamps and a value
                {
                    "Value": 1.6964980544747081,
                    "Timestamp": 1540774800.0
                },
                //... 24 datapoints
            ]
        },
        {
            "Key": { //Next key is the top tokenized SQL  
                "Dimensions": {
                    "db.sql_tokenized.statement": "INSERT INTO authors (id,name,email) VALUES\n( nextval(?)  ,?,?)",
                    "db.sql_tokenized.db_id": "pi-2372568224",
                    "db.sql_tokenized.id": "AKIAIOSFODNN7EXAMPLE"
                },
                "Metric": "db.load.avg"
            },
            "DataPoints": [ //... 24 datapoints 
            ]
        },
        // In total 11 entries, 10 Keys of top tokenized SQL, 1 total key 
    ] //End of MetricList
} //End of response
```

Respons ini memiliki 11 entri di `MetricList` (1 total, 10 SQL token teratas), dengan setiap entri memiliki 24 `DataPoints` per jam.

Untuk SQL token, ada tiga entri di setiap daftar dimensi:
+ `db.sql_tokenized.statement` – Pernyataan SQL token.
+ `db.sql_tokenized.db_id ` – Baik ID basis data native yang digunakan untuk merujuk ke SQL, maupun ID sintetis yang dihasilkan oleh Wawasan Performa untuk Anda jika ID basis data native tidak tersedia. Contoh ini menampilkan ID sintetis `pi-2372568224`.
+ `db.sql_tokenized.id` – ID kueri di dalam Wawasan Performa.

  Dalam Konsol Manajemen AWS, ID ini disebut Support ID. Ini dinamakan ini karena ID adalah data yang AWS Support dapat memeriksa untuk membantu Anda memecahkan masalah dengan database Anda. AWS menjaga keamanan dan privasi data Anda dengan sangat serius, dan hampir semua data disimpan terenkripsi dengan kunci Anda AWS KMS . Oleh karena itu, tidak ada orang di dalam yang AWS dapat melihat data ini. Di contoh sebelumnya, baik `tokenized.statement` maupun `tokenized.db_id` disimpan dengan enkripsi. Jika Anda memiliki masalah dengan database Anda, AWS Support dapat membantu Anda dengan mereferensikan ID Dukungan.

Ketika melakukan kueri, mungkin lebih mudah untuk menentukan `Group` dalam `GroupBy`. Namun, untuk kontrol lebih mendetail atas data yang ditampilkan, tentukan daftar dimensi. Misalnya, jika yang dibutuhkan hanya `db.sql_tokenized.statement`, atribut `Dimensions` dapat ditambahkan ke file query.json.

```
[
    {
        "Metric": "db.load.avg",
        "GroupBy": {
            "Group": "db.sql_tokenized",
            "Dimensions":["db.sql_tokenized.statement"],
            "Limit": 10
        }
    }
]
```

## Mengambil Rata-Rata Muatan DB yang difilter berdasarkan SQL
<a name="USER_PerfInsights.API.Examples.DBLoadAverageFilterBySQL"></a>

![\[Filter berdasarkan bagan SQL.\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/images/perf-insights-api-filter-chart.png)


Gambar sebelumnya menunjukkan bahwa kueri tertentu dipilih, dan grafik baris area bertumpuk sesi aktif rata-rata teratas dicakup ke kueri tersebut. Meskipun kueri masih diperuntukkan bagi tujuh peristiwa tunggu teratas secara keseluruhan, nilai respons-nya akan difilter. Filter menyebabkannya hanya memperhitungkan sesi yang cocok untuk filter tertentu.

Kueri API terkait dalam contoh ini sama seperti perintah di [Mengambil rata-rata muatan DB untuk SQL teratas](#USER_PerfInsights.API.Examples.DBLoadAverageTop10SQL). Namun, file query.json berisi konten berikut.

```
[
 {
        "Metric": "db.load.avg",
        "GroupBy": { "Group": "db.wait_event", "Limit": 5  }, 
        "Filter": { "db.sql_tokenized.id": "AKIAIOSFODNN7EXAMPLE" }
    }
]
```

Untuk Linux, macOS, atau Unix:

```
aws pi get-resource-metrics \
   --service-type RDS \
   --identifier db-ID \
   --start-time 2018-10-30T00:00:00Z \
   --end-time   2018-10-30T01:00:00Z \
   --period-in-seconds 60 \
   --metric-queries file://query.json
```

Untuk Windows:

```
aws pi get-resource-metrics ^
   --service-type RDS ^
   --identifier db-ID ^
   --start-time 2018-10-30T00:00:00Z ^
   --end-time   2018-10-30T01:00:00Z ^
   --period-in-seconds 60 ^
   --metric-queries file://query.json
```

Responsnya terlihat seperti berikut.

```
{
    "Identifier": "db-XXX", 
    "AlignedStartTime": 1556215200.0, 
    "MetricList": [
        {
            "Key": {
                "Metric": "db.load.avg"
            }, 
            "DataPoints": [
                {
                    "Timestamp": 1556218800.0, 
                    "Value": 1.4878117913832196
                }, 
                {
                    "Timestamp": 1556222400.0, 
                    "Value": 1.192823803967328
                }
            ]
        }, 
        {
            "Key": {
                "Metric": "db.load.avg", 
                "Dimensions": {
                    "db.wait_event.type": "io", 
                    "db.wait_event.name": "wait/io/aurora_redo_log_flush"
                }
            }, 
            "DataPoints": [
                {
                    "Timestamp": 1556218800.0, 
                    "Value": 1.1360544217687074
                }, 
                {
                    "Timestamp": 1556222400.0, 
                    "Value": 1.058051341890315
                }
            ]
        }, 
        {
            "Key": {
                "Metric": "db.load.avg", 
                "Dimensions": {
                    "db.wait_event.type": "io", 
                    "db.wait_event.name": "wait/io/table/sql/handler"
                }
            }, 
            "DataPoints": [
                {
                    "Timestamp": 1556218800.0, 
                    "Value": 0.16241496598639457
                }, 
                {
                    "Timestamp": 1556222400.0, 
                    "Value": 0.05163360560093349
                }
            ]
        }, 
        {
            "Key": {
                "Metric": "db.load.avg", 
                "Dimensions": {
                    "db.wait_event.type": "synch", 
                    "db.wait_event.name": "wait/synch/mutex/innodb/aurora_lock_thread_slot_futex"
                }
            }, 
            "DataPoints": [
                {
                    "Timestamp": 1556218800.0, 
                    "Value": 0.11479591836734694
                }, 
                {
                    "Timestamp": 1556222400.0, 
                    "Value": 0.013127187864644107
                }
            ]
        }, 
        {
            "Key": {
                "Metric": "db.load.avg", 
                "Dimensions": {
                    "db.wait_event.type": "CPU", 
                    "db.wait_event.name": "CPU"
                }
            }, 
            "DataPoints": [
                {
                    "Timestamp": 1556218800.0, 
                    "Value": 0.05215419501133787
                }, 
                {
                    "Timestamp": 1556222400.0, 
                    "Value": 0.05805134189031505
                }
            ]
        }, 
        {
            "Key": {
                "Metric": "db.load.avg", 
                "Dimensions": {
                    "db.wait_event.type": "synch", 
                    "db.wait_event.name": "wait/synch/mutex/innodb/lock_wait_mutex"
                }
            }, 
            "DataPoints": [
                {
                    "Timestamp": 1556218800.0, 
                    "Value": 0.017573696145124718
                }, 
                {
                    "Timestamp": 1556222400.0, 
                    "Value": 0.002333722287047841
                }
            ]
        }
    ], 
    "AlignedEndTime": 1556222400.0
} //end of response
```

Dalam tanggapan ini, semua nilai difilter sesuai dengan kontribusi SQL AKIAIOSFODNN7 EXAMPLE tokenized yang ditentukan dalam file query.json. Kunci mungkin juga mengikuti urutan yang berbeda dari kueri tanpa filter, karena lima peristiwa tunggu teratas tersebutlah yang memengaruhi SQL yang difilter.

## Mengambil teks lengkap pernyataan SQL
<a name="USER_PerfInsights.API.Examples.GetDimensionKeyDetails"></a>

Contoh berikut mengambil teks lengkap pernyataan SQL untuk instans DB `db-10BCD2EFGHIJ3KL4M5NO6PQRS5`. `--group` adalah `db.sql`, dan `--group-identifier` adalah `db.sql.id`. Dalam contoh ini, *my-sql-id* merupakan ID SQL diambil dengan memanggil `pi get-resource-metrics` atau. `pi describe-dimension-keys`

Jalankan perintah berikut.

Untuk Linux, macOS, atau Unix:

```
aws pi get-dimension-key-details \
   --service-type RDS \
   --identifier db-10BCD2EFGHIJ3KL4M5NO6PQRS5 \
   --group db.sql \
   --group-identifier my-sql-id \
   --requested-dimensions statement
```

Untuk Windows:

```
aws pi get-dimension-key-details ^
   --service-type RDS ^
   --identifier db-10BCD2EFGHIJ3KL4M5NO6PQRS5 ^
   --group db.sql ^
   --group-identifier my-sql-id ^
   --requested-dimensions statement
```

Dalam contoh ini, detail dimensinya tersedia. Dengan demikian, Wawasan Performa mengambil teks lengkap pernyataan SQL, tanpa memotongnya.

```
{
    "Dimensions":[
    {
        "Value": "SELECT e.last_name, d.department_name FROM employees e, departments d WHERE e.department_id=d.department_id",
        "Dimension": "db.sql.statement",
        "Status": "AVAILABLE"
    },
    ...
    ]
}
```

## Membuat laporan analisis performa selama periode waktu tertentu
<a name="USER_PerfInsights.API.Examples.CreatePerfAnalysisReport"></a>

Contoh berikut membuat laporan analisis performa dengan waktu mulai `1682969503` dan waktu akhir `1682979503` untuk basis data `db-loadtest-0`.

```
aws pi create-performance-analysis-report \
        --service-type RDS \
        --identifier db-loadtest-0 \
        --start-time 1682969503 \
        --end-time 1682979503 \
        --region us-west-2
```

Responsnya adalah ID unik `report-0234d3ed98e28fb17` untuk laporan tersebut.

```
{
   "AnalysisReportId": "report-0234d3ed98e28fb17"
}
```

## Mengambil laporan analisis performa
<a name="USER_PerfInsights.API.Examples.GetPerfAnalysisReport"></a>

Contoh berikut mengambil detail laporan analisis untuk laporan `report-0d99cc91c4422ee61`.

```
aws pi get-performance-analysis-report \
--service-type RDS \
--identifier db-loadtest-0 \
--analysis-report-id report-0d99cc91c4422ee61 \
--region us-west-2
```

Respons memberikan status laporan, ID, detail waktu, dan wawasan.

```
        {
    "AnalysisReport": {
        "Status": "Succeeded", 
        "ServiceType": "RDS", 
        "Identifier": "db-loadtest-0", 
        "StartTime": 1680583486.584, 
        "AnalysisReportId": "report-0d99cc91c4422ee61", 
        "EndTime": 1680587086.584, 
        "CreateTime": 1680587087.139, 
        "Insights": [
           ... (Condensed for space)
        ]
    }
}
```

## Daftar semua laporan analisis performa untuk instans DB
<a name="USER_PerfInsights.API.Examples.ListPerfAnalysisReports"></a>

Contoh berikut mencantumkan semua laporan analisis performa yang tersedia untuk basis data `db-loadtest-0`.

```
aws pi list-performance-analysis-reports \
--service-type RDS \
--identifier db-loadtest-0 \
--region us-west-2
```

Respons ini mencantumkan semua laporan dengan ID laporan, status, dan detail periode waktu.

```
{
    "AnalysisReports": [
        {
            "Status": "Succeeded", 
            "EndTime": 1680587086.584, 
            "CreationTime": 1680587087.139, 
            "StartTime": 1680583486.584, 
            "AnalysisReportId": "report-0d99cc91c4422ee61"
        }, 
        {
            "Status": "Succeeded", 
            "EndTime": 1681491137.914, 
            "CreationTime": 1681491145.973, 
            "StartTime": 1681487537.914, 
            "AnalysisReportId": "report-002633115cc002233"
        }, 
        {
            "Status": "Succeeded", 
            "EndTime": 1681493499.849, 
            "CreationTime": 1681493507.762, 
            "StartTime": 1681489899.849, 
            "AnalysisReportId": "report-043b1e006b47246f9"
        }, 
        {
            "Status": "InProgress", 
            "EndTime": 1682979503.0, 
            "CreationTime": 1682979618.994, 
            "StartTime": 1682969503.0, 
            "AnalysisReportId": "report-01ad15f9b88bcbd56"
        }
    ]
}
```

## Menghapus laporan analisis performa
<a name="USER_PerfInsights.API.Examples.DeletePerfAnalysisReport"></a>

Contoh berikut menghapus laporan analisis untuk basis data `db-loadtest-0`.

```
aws pi delete-performance-analysis-report \
--service-type RDS \
--identifier db-loadtest-0 \
--analysis-report-id report-0d99cc91c4422ee61 \
--region us-west-2
```

## Menambahkan tag ke laporan analisis performa
<a name="USER_PerfInsights.API.Examples.TagPerfAnalysisReport"></a>

Contoh berikut menambahkan tag dengan kunci `name` dan nilai `test-tag` ke laporan `report-01ad15f9b88bcbd56`.

```
aws pi tag-resource \
--service-type RDS \
--resource-arn arn:aws:pi:us-west-2:356798100956:perf-reports/RDS/db-loadtest-0/report-01ad15f9b88bcbd56 \
--tags Key=name,Value=test-tag \
--region us-west-2
```

## Mencantumkan semua tag untuk laporan analisis performa
<a name="USER_PerfInsights.API.Examples.ListTagsPerfAnalysisReport"></a>

Contoh berikut mencantumkan semua tag untuk laporan `report-01ad15f9b88bcbd56`.

```
aws pi list-tags-for-resource \
--service-type RDS \
--resource-arn arn:aws:pi:us-west-2:356798100956:perf-reports/RDS/db-loadtest-0/report-01ad15f9b88bcbd56 \
--region us-west-2
```

Respons ini mencantumkan nilai dan kunci untuk semua tag yang ditambahkan ke laporan:

```
{
    "Tags": [
        {
            "Value": "test-tag", 
            "Key": "name"
        }
    ]
}
```

## Menghapus tag dari laporan analisis performa
<a name="USER_PerfInsights.API.Examples.UntagPerfAnalysisReport"></a>

Contoh berikut menghapus tag `name` dari laporan `report-01ad15f9b88bcbd56`.

```
aws pi untag-resource \
--service-type RDS \
--resource-arn arn:aws:pi:us-west-2:356798100956:perf-reports/RDS/db-loadtest-0/report-01ad15f9b88bcbd56 \
--tag-keys name \
--region us-west-2
```

Setelah tag dihapus, pemanggilan API `list-tags-for-resource` tidak akan mencantumkan tag ini.

# Pencatatan panggilan Performance Insights menggunakan AWS CloudTrail
<a name="USER_PerfInsights.CloudTrail"></a>

Performance Insights berjalan dengan AWS CloudTrail, layanan yang menyediakan catatan tindakan yang diambil oleh pengguna, peran, atau AWS layanan di Performance Insights. CloudTrailmenangkap semua API panggilan untuk Performance Insights sebagai acara. Tangkapan ini mencakup panggilan dari RDS konsol Amazon dan dari panggilan kode ke operasi Performance InsightsAPI. 

Jika Anda membuat jejak, Anda dapat mengaktifkan pengiriman acara secara berkelanjutan ke bucket Amazon S3, termasuk CloudTrail peristiwa untuk Performance Insights. Jika Anda tidak mengonfigurasi jejak, Anda masih dapat melihat peristiwa terbaru di CloudTrail konsol dalam **Riwayat acara**. Dengan menggunakan data yang dikumpulkan oleh CloudTrail, Anda dapat menentukan informasi tertentu. Informasi ini mencakup permintaan yang dibuat untuk Wawasan Performa, alamat IP asal permintaan, siapa yang membuat permintaan, dan kapan permintaan tersebut dibuat. Informasi ini juga mencakup detail tambahan. 

Untuk mempelajari selengkapnya CloudTrail, lihat [Panduan AWS CloudTrail Pengguna](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).

## Bekerja dengan informasi Performance Insights di CloudTrail
<a name="USER_PerfInsights.CloudTrail.service-name-info"></a>

CloudTrail diaktifkan di AWS akun Anda saat Anda membuat akun. Saat aktivitas terjadi di Performance Insights, aktivitas tersebut direkam dalam suatu CloudTrail peristiwa bersama dengan peristiwa AWS layanan lainnya di CloudTrail konsol dalam riwayat **Peristiwa**. Anda dapat melihat, mencari, dan mengunduh acara terbaru di AWS akun Anda. Untuk informasi selengkapnya, lihat [Melihat Acara dengan Riwayat CloudTrail Acara](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html) di *Panduan AWS CloudTrail Pengguna.*

Untuk catatan peristiwa yang sedang berlangsung di AWS akun Anda, termasuk acara untuk Performance Insights, buat jejak. *Jejak* memungkinkan CloudTrail untuk mengirimkan file log ke bucket Amazon S3. Secara default, saat Anda membuat jejak di konsol, jejak tersebut berlaku untuk semua AWS Wilayah. Jejak mencatat peristiwa dari semua AWS Wilayah di AWS partisi dan mengirimkan file log ke bucket Amazon S3 yang Anda tentukan. Selain itu, Anda dapat mengonfigurasi AWS layanan lain untuk menganalisis lebih lanjut dan menindaklanjuti data peristiwa yang dikumpulkan dalam CloudTrail log. Untuk informasi selengkapnya, lihat topik berikut di *Panduan Pengguna AWS CloudTrail :*
+ [Ikhtisar Pembuatan Jejak](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail Layanan dan Integrasi yang Didukung](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Mengkonfigurasi SNS Pemberitahuan Amazon untuk CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [Menerima File CloudTrail Log dari Beberapa Wilayah](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) dan [Menerima File CloudTrail Log dari Beberapa Akun](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)

Semua operasi Performance Insights dicatat oleh CloudTrail dan didokumentasikan dalam Referensi [Performance API Insights](https://docs.aws.amazon.com/performance-insights/latest/APIReference/Welcome.html). Misalnya, panggilan ke `DescribeDimensionKeys` dan `GetResourceMetrics` operasi menghasilkan entri dalam file CloudTrail log. 

Setiap entri peristiwa atau log berisi informasi tentang siapa yang membuat permintaan tersebut. Informasi identitas membantu Anda menentukan hal berikut: 
+ Baik permintaan tersebut dibuat dengan kredensial pengguna root atau IAM.
+ Apakah permintaan tersebut dibuat dengan kredensial keamanan sementara untuk satu peran atau pengguna terfederasi.
+ Apakah permintaan itu dibuat oleh AWS layanan lain.

Untuk informasi selengkapnya, lihat [CloudTrail userIdentityElemen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).

## Entri file log Wawasan Performa
<a name="USER_PerfInsights.CloudTrail.service-name-entries"></a>

*Trail* adalah konfigurasi yang memungkinkan pengiriman peristiwa sebagai file log ke bucket Amazon S3 yang Anda tentukan. CloudTrail file log berisi satu atau lebih entri log. *Peristiwa* menunjukkan satu permintaan dari sumber mana pun. Setiap acara mencakup informasi tentang operasi yang diminta, tanggal dan waktu operasi, parameter permintaan, dan sebagainya. CloudTrailfile log bukanlah jejak tumpukan yang diurutkan dari API panggilan publik, sehingga tidak muncul dalam urutan tertentu. 

Contoh berikut menunjukkan entri CloudTrail log yang menunjukkan `GetResourceMetrics` operasi.

```
{
    "eventVersion": "1.05",
    "userIdentity": {
        "type": "IAMUser",
         "principalId": "AKIAIOSFODNN7EXAMPLE",
        "arn": "arn:aws:iam::123456789012:user/johndoe",
        "accountId": "123456789012",
        "accessKeyId": "AKIAI44QH8DHBEXAMPLE",
        "userName": "johndoe"
    },
    "eventTime": "2019-12-18T19:28:46Z",
    "eventSource": "pi.amazonaws.com",
    "eventName": "GetResourceMetrics",
    "awsRegion": "us-east-1",
    "sourceIPAddress": "72.21.198.67",
    "userAgent": "aws-cli/1.16.240 Python/3.7.4 Darwin/18.7.0 botocore/1.12.230",
    "requestParameters": {
        "identifier": "db-YTDU5J5V66X7CXSCVDFD2V3SZM",
        "metricQueries": [
            {
                "metric": "os.cpuUtilization.user.avg"
            },
            {
                "metric": "os.cpuUtilization.idle.avg"
            }
        ],
        "startTime": "Dec 18, 2019 5:28:46 PM",
        "periodInSeconds": 60,
        "endTime": "Dec 18, 2019 7:28:46 PM",
        "serviceType": "RDS"
    },
    "responseElements": null,
    "requestID": "9ffbe15c-96b5-4fe6-bed9-9fccff1a0525",
    "eventID": "08908de0-2431-4e2e-ba7b-f5424f908433",
    "eventType": "AwsApiCall",
    "recipientAccountId": "123456789012"
}
```

# Performance Insights API dan titik akhir VPC antarmuka ()AWS PrivateLink
<a name="pi-vpc-interface-endpoints"></a>

Anda dapat menggunakannya AWS PrivateLink untuk membuat koneksi pribadi antara VPC dan Amazon RDS Performance Insights. Anda dapat mengakses Performance Insights seolah-olah berada di VPC Anda, tanpa menggunakan gateway internet, perangkat NAT, koneksi VPN, atau koneksi. Direct Connect Instans di VPC Anda tidak memerlukan alamat IP publik untuk mengakses Performance Insights.

Anda membuat koneksi pribadi ini dengan membuat *titik akhir antarmuka*, yang didukung oleh AWS PrivateLink. Kami membuat antarmuka jaringan endpoint di setiap subnet yang Anda aktifkan untuk titik akhir antarmuka. Ini adalah antarmuka jaringan yang dikelola pemohon yang berfungsi sebagai titik masuk untuk lalu lintas yang ditujukan untuk Performance Insights.

Untuk informasi selengkapnya, lihat [Akses Layanan AWS melalui AWS PrivateLink](https://docs.aws.amazon.com/vpc/latest/privatelink/privatelink-access-aws-services.html) di *AWS PrivateLink Panduan*.

## Pertimbangan untuk Performance Insights
<a name="vpc-endpoint-considerations"></a>

*Sebelum menyiapkan titik akhir antarmuka untuk Performance Insights, [tinjau](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html#considerations-interface-endpoints) Pertimbangan dalam Panduan.AWS PrivateLink *

Performance Insights mendukung panggilan ke semua tindakan API-nya melalui titik akhir antarmuka.

Secara default, akses penuh ke Performance Insights diizinkan melalui titik akhir antarmuka. Untuk mengontrol lalu lintas ke Performance Insights melalui titik akhir antarmuka, kaitkan grup keamanan dengan antarmuka jaringan titik akhir.

## Ketersediaan
<a name="rds-and-vpc-interface-endpoints-availability"></a>

Performance Insights API saat ini mendukung titik akhir VPC yang mendukung Wilayah AWS Performance Insights. Untuk informasi tentang ketersediaan Performance Insights, lihat. [Wilayah dan engine DB yang Didukung untuk Performance Insights di Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md) 

## Membuat titik akhir antarmuka untuk Performance Insights
<a name="vpc-endpoint-create"></a>

Anda dapat membuat titik akhir antarmuka untuk Performance Insights menggunakan konsol Amazon VPC atau (). AWS Command Line Interface AWS CLI Untuk informasi selengkapnya, lihat [Membuat titik akhir antarmuka](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html#create-interface-endpoint-aws) di *AWS PrivateLink Panduan*.

Membuat titik akhir antarmuka untuk Performance Insights menggunakan nama layanan berikut:

Jika Anda mengaktifkan DNS pribadi untuk titik akhir antarmuka, Anda dapat membuat permintaan API ke Performance Insights menggunakan nama DNS Regional defaultnya. Misalnya, `pi.us-east-1.amazonaws.com`.

## Membuat kebijakan titik akhir VPC untuk API Performance Insights
<a name="vpc-endpoint-policy"></a>

Kebijakan endpoint adalah sumber daya IAM yang dapat Anda lampirkan ke titik akhir antarmuka. Kebijakan endpoint default memungkinkan akses penuh ke Performance Insights melalui titik akhir antarmuka. Untuk mengontrol akses yang diizinkan ke Performance Insights dari VPC Anda, lampirkan kebijakan titik akhir kustom ke titik akhir antarmuka.

 kebijakan titik akhir mencantumkan informasi berikut:
+ Prinsipal yang dapat melakukan tindakan (Akun AWS, pengguna IAM, dan peran IAM).
+ Tindakan yang dapat dilakukan.
+ Sumber daya untuk melakukan tindakan.

Untuk informasi selengkapnya, lihat [Mengontrol akses ke layanan menggunakan kebijakan titik akhir](https://docs.aws.amazon.com/vpc/latest/privatelink/vpc-endpoints-access.html) di *Panduan AWS PrivateLink *.

**Contoh: Kebijakan titik akhir VPC untuk tindakan Performance Insights**  
Berikut ini adalah contoh kebijakan endpoint kustom. Saat Anda melampirkan kebijakan ini ke titik akhir antarmuka, kebijakan ini akan memberikan akses ke tindakan Performance Insights yang terdaftar untuk semua prinsipal di semua sumber daya.

```
{
   "Statement":[
      {
         "Principal":"*",
         "Effect":"Allow",
         "Action":[
            "rds:CreatePerformanceAnalysisReport",
            "rds:DeletePerformanceAnalysisReport",
            "rds:GetPerformanceAnalysisReport"
         ],
         "Resource":"*"
      }
   ]
}
```

**Contoh: Kebijakan titik akhir VPC yang menolak semua akses dari akun tertentu AWS**  
Kebijakan titik akhir VPC berikut menolak `123456789012` semua akses AWS akun ke sumber daya menggunakan titik akhir. Kebijakan ini mengizinkan semua tindakan dari akun lainnya.

```
{
  "Statement": [
    {
      "Action": "*",
      "Effect": "Allow",
      "Resource": "*",
      "Principal": "*"
    },
    {
      "Action": "*",
      "Effect": "Deny",
      "Resource": "*",
      "Principal": { "AWS": [ "123456789012" ] }
     }
   ]
}
```

## Pengalamatan IP untuk Performance Insights
<a name="pi-ip-addressing"></a>

Penentuan alamat IP memungkinkan sumber daya dalam VPC Anda berkomunikasi satu sama lain, dan dengan sumber daya melalui internet. Performance Insights mendukung protokol pengalamatan IPv4 dan IPv6 pengalamatan. Secara default, Performance Insights dan Amazon VPC menggunakan protokol pengalamatan. IPv4 Anda tidak dapat menonaktifkan perilaku ini. Saat Anda membuat VPC, pastikan untuk menentukan blok IPv4 CIDR (berbagai alamat pribadi IPv4 ). 

Anda dapat secara opsional menetapkan blok IPv6 CIDR ke VPC dan subnet Anda, dan menetapkan IPv6 alamat dari blok itu ke sumber daya RDS di subnet Anda. Support untuk IPv6 protokol memperluas jumlah alamat IP yang didukung. Dengan menggunakan IPv6 protokol, Anda memastikan bahwa Anda memiliki alamat yang cukup tersedia untuk pertumbuhan internet di masa depan. Sumber daya RDS baru dan yang sudah ada dapat digunakan IPv4 dan IPv6 alamat dalam VPC Anda. Mengonfigurasi, mengamankan, dan menerjemahkan lalu lintas jaringan di antara dua protokol yang digunakan di berbagai bagian aplikasi dapat menimbulkan overhead operasional. Anda dapat melakukan standarisasi pada IPv6 protokol untuk sumber daya Amazon RDS untuk menyederhanakan konfigurasi jaringan Anda. Untuk informasi selengkapnya tentang titik akhir dan kuota layanan, lihat titik akhir dan kuota [Amazon Relational Database Service](https://docs.aws.amazon.com/general/latest/gr/rds-service.html).

[Untuk informasi selengkapnya tentang pengalamatan IP Amazon RDS, lihat Amazon RDS.](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html#USER_VPC.IP_addressing)