Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memantau dengan Wawasan Kinerja
Performance Insights menambahkan fitur pemantauan Amazon DocumentDB yang ada untuk menggambarkan kinerja klaster Anda dan membantu Anda menganalisis masalah apa pun yang mempengaruhinya. Dengan dasbor Performance Insights, Anda dapat memvisualisasikan pemuatan database dan memfilter beban berdasarkan menunggu, pernyataan kueri, host, atau aplikasi.
**catatan**
Performance Insights hanya tersedia untuk klaster berbasis instans Amazon DocumentDB 3.6, 4.0, 5.0, dan 8.0.
**Bagaimana ini berguna?**
+ Visualisasikan kinerja database - Visualisasikan beban untuk menentukan kapan dan di mana beban berada di database
+ Tentukan apa yang menyebabkan beban pada database - Tentukan kueri, host, dan aplikasi mana yang berkontribusi terhadap pemuatan instans Anda
+ Tentukan kapan ada pemuatan pada database Anda — Perbesar dasbor Performance Insights untuk fokus pada peristiwa tertentu atau memperkecil untuk melihat tren di rentang waktu yang lebih besar
+ Peringatan tentang pemuatan basis data - Akses metrik pemuatan basis data baru secara otomatis dari CloudWatch tempat Anda dapat memantau metrik pemuatan DB bersama metrik Amazon DocumentDB lainnya dan setel peringatan padanya
**Apa batasan Amazon DocumentDB Performance Insights?**
+ Performance Insights di wilayah AWS GovCloud (AS-Timur) dan AWS GovCloud (AS-Barat) tidak tersedia
+ Performance Insights untuk Amazon DocumentDB mempertahankan data kinerja hingga 7 hari
+ Kueri yang lebih panjang dari 1.024 byte tidak digabungkan dalam Performance Insights
**Topics**
+ [Konsep Performance Insights](performance-insights-concepts.md)
+ [Mengaktifkan dan menonaktifkan Wawasan Kinerja](performance-insights-enabling.md)
+ [Mengonfigurasi kebijakan akses untuk Wawasan Performa](performance-insights-policies.md)
+ [Menganalisis metrik dengan dasbor Wawasan Performa](performance-insights-analyzing.md)
+ [Mengambil metrik dengan API Wawasan Performa](performance-insights-metrics.md)
+ [CloudWatch Metrik Amazon untuk Performance Insights](performance-insights-cloudwatch.md)
+ [Performance Insights untuk metrik penghitung](performance-insights-counter-metrics.md)
# Konsep Performance Insights
**Topics**
+ [Sesi aktif rata-rata](#performance-insights-concepts-sessions)
+ [Dimensi](#performance-insights-concepts-dimensions)
+ [Maks vCPU](#performance-insights-concepts-maxvcpu)
## Sesi aktif rata-rata
Beban basis data (beban DB) mengukur tingkat aktivitas dalam database Anda. Metrik utama dalam Wawasan Performa adalah `DB Load`, yang dikumpulkan setiap detik. Unit untuk `DBLoad` metrik adalah *Average Active Sessions (AAS)* untuk instance Amazon DocumentDB.
Sesi *aktif* adalah koneksi yang telah mengirimkan pekerjaan ke instance Amazon DocumentDB dan sedang menunggu tanggapan. Misalnya, jika Anda mengirimkan kueri ke instance Amazon DocumentDB, sesi database aktif saat instance memproses kueri.
Untuk mendapatkan sesi aktif rata-rata, Wawasan Kinerja mengambil sampel jumlah sesi yang secara bersamaan menjalankan kueri. AAS adalah jumlah total sesi dibagi dengan jumlah total sampel. Tabel berikut menunjukkan lima sampel berturut-turut dari query berjalan.
| Sampel | Jumlah sesi yang menjalankan kueri | AAS | Penghitungan |
| --- | --- | --- | --- |
| 1 | 2 | 2 | 2 sesi / 1 sampel |
| 2 | 0 | 1 | 2 sesi / 2 sampel |
| 3 | 4 | 2 | 6 sesi / 3 sampel |
| 4 | 0 | 1.5 | 6 sesi / 4 sampel |
| 5 | 4 | 2 | 10 sesi / 5 sampel |
Pada contoh sebelumnya, Beban DB untuk interval waktu dari 1-5 adalah 2 AAS. Peningkatan beban DB berarti, rata-rata, lebih banyak sesi berjalan di database.
## Dimensi
Metrik `DB Load` berbeda dari metrik seri waktu lainnya karena Anda dapat membaginya menjadi subkomponen yang disebut dimensi. Anda dapat menganggap dimensi sebagai kategori untuk karakteristik `DB Load` metrik yang berbeda. Saat Anda mendiagnosis masalah kinerja, dimensi yang paling berguna adalah **status tunggu** dan **kueri teratas**.
**tunggu negara**
*Status tunggu* menyebabkan pernyataan kueri menunggu peristiwa tertentu terjadi sebelum dapat terus berjalan. Misalnya, pernyataan kueri mungkin menunggu hingga sumber daya yang terkunci dibuka. Dengan menggabungkan `DB Load` dengan status tunggu, Anda bisa mendapatkan gambaran lengkap tentang status sesi. Berikut adalah berbagai status tunggu Amazon DocumentDB:
| Status tunggu Amazon DocumentDB | Tunggu Deskripsi Negara |
| --- | --- |
| Kait | Status tunggu Latch terjadi saat sesi menunggu halaman kumpulan buffer. Sering paging masuk dan keluar dari buffer pool dapat terjadi lebih sering ketika sering ada kueri besar yang diproses oleh sistem, pemindaian koleksi, atau ketika kumpulan buffer terlalu kecil untuk menangani set kerja. |
| CPU | Status menunggu CPU terjadi ketika sesi sedang menunggu pada CPU. |
| CollectionLock | Status CollectionLock tunggu terjadi ketika sesi menunggu untuk mendapatkan kunci pada koleksi. Peristiwa ini terjadi ketika ada operasi DDL pada koleksi. |
| DocumentLock | Status DocumentLock tunggu terjadi ketika sesi menunggu untuk memperoleh kunci pada dokumen. Jumlah penulisan bersamaan yang tinggi ke dokumen yang sama akan berkontribusi pada lebih banyak status DocumentLock menunggu pada dokumen itu. |
| SystemLock | Status SystemLock tunggu terjadi ketika sesi sedang menunggu di sistem. Hal ini dapat terjadi ketika sering ada query berjalan lama, transaksi berjalan lama, atau konkurensi tinggi pada sistem. |
| IO | Status tunggu IO terjadi ketika sesi menunggu IO selesai. |
| BufferLock | Status BufferLock tunggu terjadi ketika sesi menunggu untuk memperoleh kunci pada halaman bersama di buffer. BufferLockstatus tunggu dapat diperpanjang jika proses lain menahan kursor terbuka pada halaman yang diminta. |
| LowMemThrottle | Status LowMemThrottle tunggu terjadi ketika sesi menunggu karena tekanan memori yang berat pada instance Amazon DocumentDB. Jika status ini berlanjut untuk waktu yang lama, pertimbangkan untuk meningkatkan instance untuk menyediakan memori tambahan. Untuk informasi lebih lanjut, lihat [Gubernur Sumber Daya](https://docs.aws.amazon.com/documentdb/latest/developerguide/how-it-works.html). |
| BackgroundActivity | Status BackgroundActivity tunggu terjadi ketika sesi sedang menunggu proses sistem internal. |
| Lainnya | Status tunggu lainnya adalah keadaan tunggu internal. Jika status ini bertahan lama, pertimbangkan untuk menghentikan kueri ini. Untuk informasi selengkapnya, lihat [Bagaimana Cara Menemukan dan Menghentikan Kueri Berjalan Lama atau Diblokir?](https://docs.aws.amazon.com/documentdb/latest/developerguide/user_diagnostics.html#user_diagnostics-query_terminating.html) |
**Kueri teratas**
Sementara status tunggu menunjukkan kemacetan, kueri teratas menunjukkan kueri mana yang paling berkontribusi pada pemuatan DB. Misalnya, saat ini mungkin ada banyak kueri yang berjalan di database, tetapi kueri tunggal mungkin menggunakan 99% dari muatan DB. Dalam hal ini, muatan tinggi mungkin menunjukkan masalah dalam kueri.
## Maks vCPU
Di dasbor, bagan **Basis data muatan** mengumpulkan, menggabungkan, dan menampilkan informasi sesi. Untuk mengetahui apakah sesi aktif melebihi CPU maksimum, lihat hubungannya dengan baris **vCPU Maks**. Nilai **Max vCPU** ditentukan oleh jumlah inti vCPU (virtual CPU) untuk instans Amazon DocumentDB Anda.
Jika muatan DB sering melampaui baris **vCPU Maks** dan status tunggu utamanya adalah CPU, CPU akan kelebihan muatan. Dalam hal ini, Anda mungkin ingin membatasi koneksi ke instance, menyetel kueri apa pun dengan beban CPU yang 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. Hal ini bisa terjadi meski muatan DB tidak melampaui baris **vCPU Maks**.
# Mengaktifkan dan menonaktifkan Wawasan Kinerja
Untuk menggunakan Wawasan Kinerja, aktifkan di instans DB Anda. Anda dapat menonaktifkannya nanti jika perlu. Mengaktifkan dan menonaktifkan Wawasan Kinerja tidak menyebabkan waktu henti, boot ulang, atau kegagalan.
Agen Wawasan Performa menggunakan CPU dan memori terbatas di host DB. Ketika muatan DB tinggi, agen membatasi dampak performa dengan mengurangi frekuensi pengumpulan data.
## Mengaktifkan Performance Insights saat membuat klaster
Di konsol, Anda dapat mengaktifkan atau menonaktifkan Wawasan Kinerja saat membuat atau mengubah instans DB baru.
### Menggunakan Konsol Manajemen AWS
Di konsol, Anda dapat mengaktifkan Performance Insights saat membuat klaster Amazon DocumentDB. **Saat Anda membuat klaster Amazon DocumentDB baru, aktifkan Performance Insights dengan memilih Aktifkan Performance Insights di bagian **Performance Insights**.**
**Instruksi konsol**
1. Untuk membuat cluster, ikuti petunjuk untuk [Membuat cluster Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-create.html).
1. Pilih **Aktifkan Performance Insights** di bagian Performance Insights.
![\[Bagian Performance Insights dengan Aktifkan Performance Insights dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/select-performance-insights.png)
**catatan**
Periode retensi data Performance Insights akan berlangsung selama tujuh hari.
** AWS KMS kunci** — Tentukan kunci AWS KMS Anda. Performance Insights mengenkripsi semua data yang berpotensi sensitif menggunakan kunci Anda. AWS KMS Data dienkripsi saat dipindahkan dan saat tidak aktif. Untuk informasi selengkapnya, lihat Mengonfigurasi AWS AWS KMS kebijakan untuk Performance Insights.
## Mengaktifkan dan menonaktifkan saat memodifikasi instance
Anda dapat mengubah instans DB untuk mengaktifkan atau menonaktifkan Performance Insights menggunakan konsol atau. AWS CLI
------
#### [ Using the Konsol Manajemen AWS ]
**Instruksi konsol**
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Pilih **Klaster**.
1. Pilih instans DB, lalu pilih **Modifikasi**.
1. **Di bagian Performance Insights, pilih Aktifkan Performance **Insights atau Nonaktifkan Performance** Insights.**
**catatan**
Jika memilih **Aktifkan Performance Insights**, Anda dapat menentukan kunci. AWS AWS KMS Performance Insights mengenkripsi semua data yang berpotensi sensitif menggunakan kunci Anda. AWS KMS Data dienkripsi saat dipindahkan dan saat tidak aktif. Untuk informasi selengkapnya, lihat [Mengenkripsi Data Amazon DocumentDB saat Istirahat](https://docs.aws.amazon.com/documentdb/latest/developerguide/encryption-at-rest.html).
1. Pilih **Lanjutkan**.
1. Untuk **Penjadwalan Modifikasi**, pilih **Langsung terapkan**. Jika Anda memilih **Terapkan selama jendela pemeliharaan terjadwal berikutnya**, instans Anda akan mengabaikan setelan ini dan segera mengaktifkan Performance Insights.
1. Pilih **Ubah instans**.
------
#### [ Using the AWS CLI ]
Saat menggunakan `modify-db-instance` AWS AWS CLI perintah `create-db-instance` atau, Anda dapat mengaktifkan Performance Insights dengan menentukan`--enable-performance-insights`, atau menonaktifkannya dengan menentukan. `--no-enable-performance-insights`
Prosedur berikut menjelaskan cara mengaktifkan atau menonaktifkan Wawasan Kinerja untuk instans DB menggunakan AWS AWS CLI.
**AWS AWS CLI instruksi**
Panggil `modify-db-instance` AWS AWS CLI perintah dan berikan nilai-nilai berikut:
+ `--db-instance-identifer`— Nama instans DB
+ `--enable-performance-insights` untuk mengaktifkan atau `--no-enable-performance-insights` untuk menonaktifkan
**Example**
Contoh berikut memungkinkan Performance Insights untuk: `sample-db-instance`
```
aws docdb modify-db-instance \
--db-instance-identifier sample-db-instance \
--enable-performance-insights
```
```
aws docdb modify-db-instance ^
--db-instance-identifier sample-db-instance ^
--enable-performance-insights
```
------
# Mengonfigurasi kebijakan akses untuk Wawasan Performa
Untuk mengakses Wawasan Kinerja, Anda harus memiliki izin yang sesuai dari AWS Identity and Access Management (IAM). Anda memiliki opsi berikut untuk memberikan akses:
+ Lampirkan kebijakan `AmazonRDSPerformanceInsightsReadOnly` terkelola ke set izin atau peran.
+ Membuat kebijakan IAM kustom dan melampirkannya ke kumpulan izin atau peran.
Selain itu, jika Anda menetapkan kunci terkelola pelanggan saat mengaktifkan Performance Insights, pastikan pengguna di akun Anda memiliki izin `kms:Decrypt` dan `kms:GenerateDataKey` izin pada kunci KMS.
**catatan**
[Untuk encryption-at-rest dengan manajemen AWS KMS kunci dan grup keamanan, Amazon DocumentDB memanfaatkan teknologi operasional yang dibagikan dengan Amazon RDS.](https://aws.amazon.com/rds)
## Melampirkan RDSPerformance InsightsReadOnly kebijakan Amazon ke kepala sekolah IAM
`AmazonRDSPerformanceInsightsReadOnly`adalah kebijakan AWS terkelola yang memberikan akses ke semua operasi hanya-baca dari Amazon DocumentDB Performance Insights API. Saat ini, semua operasi di API ini hanya-baca. Jika Anda melampirkan `AmazonRDSPerformanceInsightsReadOnly` ke kumpulan izin atau peran, penerima dapat menggunakan Wawasan Performa beserta fitur konsol lainnya.
## Membuat kebijakan IAM kustom untuk Wawasan Performa
Untuk pengguna yang tidak memiliki `AmazonRDSPerformanceInsightsReadOnly` kebijakan, Anda dapat memberikan akses ke Performance Insights dengan membuat atau memodifikasi kebijakan IAM yang dikelola pengguna. Jika Anda melampirkan kebijakan ke set izin atau peran, penerima dapat menggunakan Performance Insights.
**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. Di halaman **Buat Kebijakan**, pilih tab JSON.
1. Salin dan tempel teks berikut, ganti *us-east-1* dengan nama AWS Wilayah Anda dan *111122223333* dengan nomor akun pelanggan Anda.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "rds:DescribeDBInstances",
"Resource": "*"
},
{
"Effect": "Allow",
"Action": "rds:DescribeDBClusters",
"Resource": "*"
},
{
"Effect": "Allow",
"Action": "pi:DescribeDimensionKeys",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
},
{
"Effect": "Allow",
"Action": "pi:GetDimensionKeyDetails",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
},
{
"Effect": "Allow",
"Action": "pi:GetResourceMetadata",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
},
{
"Effect": "Allow",
"Action": "pi:GetResourceMetrics",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
},
{
"Effect": "Allow",
"Action": "pi:ListAvailableResourceDimensions",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
},
{
"Effect": "Allow",
"Action": "pi:ListAvailableResourceMetrics",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
}
]
}
```
------
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 Performance Insights, pastikan Anda memiliki akses ke Amazon DocumentDB selain kebijakan kustom. [Misalnya, kebijakan yang **AmazonDocDBReadOnlyAccess**telah ditentukan menyediakan akses hanya-baca ke Amazon docdb.Untuk informasi selengkapnya, lihat Mengelola akses menggunakan kebijakan.](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAM.html#security_iam_access-manage)
1. Di halaman **Ringkasan**, pilih **Tambahkan izin**.
1. Pilih **Lampirkan kebijakan yang sudah ada secara langsung**. Untuk **Pencarian**, ketik beberapa karakter pertama dari nama kebijakan Anda, seperti yang ditampilkan di bawah ini.
![\[Pilih Kebijakan\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/pi-add-permissions.png)
1. Pilih kebijakan Anda, lalu pilih **Berikutnya: Tinjauan**.
1. Pilih **Tambahkan izin**.
## Mengonfigurasi AWS KMS kebijakan untuk Performance Insights
Performance Insights menggunakan perangkat AWS KMS key untuk mengenkripsi data sensitif. Saat mengaktifkan Wawasan Kinerja melalui API atau konsol, Anda akan memiliki opsi berikut:
+ Pilih default Kunci yang dikelola AWS.
Amazon DocumentDB menggunakan Kunci yang dikelola AWS instans DB baru Anda. Amazon DocumentDB membuat untuk Kunci yang dikelola AWS akun Anda. AWS AWS Akun Anda memiliki Amazon DocumentDB yang berbeda Kunci yang dikelola AWS untuk setiap 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 [ Menggunakan kebijakan kunci dalam KMS AWS](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html).
**Example**
Contoh kebijakan kunci berikut menunjukkan cara menambahkan pernyataan ke kebijakan kunci KMS Anda. Pernyataan ini mengizinkan akses ke Wawasan Performa. Tergantung pada bagaimana Anda menggunakan AWS KMS, Anda mungkin ingin mengubah beberapa batasan. Sebelum menambahkan pernyataan ke kebijakan, hapus semua komentar.
# Menganalisis metrik dengan dasbor Wawasan Performa
Dasbor Wawasan Performa berisi informasi performa basis data untuk membantu Anda menganalisis dan memecahkan masalah performa. Pada halaman dasbor utama, Anda dapat melihat informasi tentang beban database (beban DB). Anda dapat “mengiris” beban DB berdasarkan dimensi seperti status tunggu atau kueri.
**Topics**
+ [Ikhtisar dasbor Wawasan Performa](performance-insights-dashboard-overview.md)
+ [Membuka dasbor Wawasan Kinerja](performance-insights-dashboard-opening.md)
+ [Menganalisis beban basis data dengan status tunggu](performance-insights-analyzing-db-load.md)
+ [Ikhtisar tab Kueri teratas](performance-insights-top-queries.md)
+ [Memperbesar bagan beban database](performance-insights-zoom-db-load.md)
# Ikhtisar dasbor Wawasan Performa
Dasbor adalah cara termudah untuk berinteraksi dengan Wawasan Performa. Contoh berikut menunjukkan dasbor untuk instance Amazon DocumentDB. Secara default, dasbor Wawasan Kinerja menunjukkan data selama satu jam terakhir.
![\[Dasbor Performance Insights yang menampilkan pemanfaatan CPU dan pemuatan basis data dari waktu ke waktu untuk instans Amazon DocumentDB.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/overview-dashboard.png)
Dasbor dibagi menjadi beberapa bagian berikut:
1. **Metrik penghitung** — Menampilkan data untuk metrik penghitung kinerja tertentu.
1. **Beban basis data** - Menunjukkan bagaimana beban DB dibandingkan dengan kapasitas instans DB seperti yang diwakili oleh baris **vCPU Max**.
1. **Dimensi teratas** - Menunjukkan dimensi teratas yang berkontribusi terhadap beban DB. Dimensi ini meliputi`waits`,`queries`,`hosts`,`databases`, dan`applications`.
**Topics**
+ [Bagan metrik penghitung](#performance-insights-overview-metrics)
+ [Bagan muatan basis data](#performance-insights-overview-db-load-chart)
+ [Tabel Dimensi teratas](#performance-insights-overview-top-dimensions)
## Bagan metrik penghitung
Dengan metrik penghitung, Anda dapat menyesuaikan dasbor Wawasan Performa untuk menyertakan hingga 10 grafik tambahan. Grafik ini menunjukkan pilihan lusinan metrik sistem operasi. Anda dapat menghubungkan informasi ini dengan muatan DB untuk membantu mengidentifikasi dan menganalisis masalah performa.
Bagan **Metrik Penghitung** menampilkan data untuk penghitung performa.
![\[Bagan metrik penghitung yang menunjukkan pemanfaatan CPU dari waktu ke waktu.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/counter-metrics.png)
Untuk mengubah penghitung kinerja, pilih **Kelola metrik**. Anda dapat memilih beberapa **metrik OS** seperti yang ditunjukkan pada gambar berikut. Untuk melihat detail setiap metrik, arahkan kursor ke nama metrik.
![\[Antarmuka pemilihan metrik dasbor Performance Insights dengan opsi metrik OS.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/overview-os-metrics.png)
## Bagan muatan basis data
Bagan **beban Database** menunjukkan bagaimana aktivitas database dibandingkan dengan kapasitas instance seperti yang diwakili oleh baris **Max vCPU**. Secara default, bagan garis bertumpuk mewakili muatan DB sebagai sesi aktif rata-rata per unit waktu. Muatan DB diiris (dikelompokkan) berdasarkan status tunggu.
![\[Bagan beban basis data menunjukkan sesi aktif rata-rata dari waktu ke waktu, dengan penggunaan CPU melonjak mendekati akhir.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/database-load.png)
**Muatan DB diiris berdasarkan dimensi**
Anda dapat memilih untuk menampilkan muatan sebagai sesi aktif yang dikelompokkan berdasarkan dimensi yang didukung. Gambar berikut menunjukkan dimensi untuk instance Amazon DocumentDB.
![\[Grafik yang menunjukkan beban database dengan berbagai opsi “Slice by” ditampilkan dalam daftar dropdown.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/database-load-sliced.png)
**Detail muatan DB untuk item dimensi**
Untuk melihat detail tentang item muatan DB dalam dimensi, arahkan kursor ke nama item. Gambar berikut menunjukkan rincian untuk pernyataan query.
![\[Grafik batang yang menunjukkan beban database dengan detail tambahan ditampilkan saat mengarahkan kursor ke nama item.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/database-load-details.png)
Untuk melihat detail setiap item selama periode waktu yang dipilih dalam legenda, arahkan kursor ke item tersebut.
![\[Grafik batang menunjukkan beban basis data dengan detail tambahan ditampilkan saat melayang di atas bilah.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/database-load-hover.png)
## Tabel Dimensi teratas
**Tabel dimensi atas** mengiris beban DB dengan dimensi yang berbeda. Dimensi adalah kategori atau “irisan menurut” untuk karakteristik muatan DB yang berbeda. Jika dimensinya adalah kueri, **Kueri teratas** menunjukkan pernyataan kueri yang berkontribusi paling besar pada beban DB.
Pilih salah satu tab dimensi berikut.
![\[Tab Dimensi kueri teratas yang menampilkan dua kueri teratas.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/top-dimensions.png)
Tabel berikut memberikan deskripsi singkat dari setiap tab.
| Tab | Deskripsi |
| --- | --- |
| Tunggu teratas | Peristiwa di mana backend basis data sedang menunggu |
| Kueri teratas | Pernyataan kueri yang sedang berjalan |
| Host teratas | IP host dan port klien yang terhubung |
| Basis data teratas | Nama basis data yang terhubung ke klien |
| Aplikasi teratas | Nama aplikasi yang terhubung ke basis data |
Untuk mempelajari cara menganalisis kueri menggunakan tab **Kueri teratas**, lihat. [Ikhtisar tab Kueri teratas](performance-insights-top-queries.md)
# Membuka dasbor Wawasan Kinerja
**Untuk melihat dasbor Performance Insights di AWS Management Console, gunakan langkah-langkah berikut:**
1. Buka konsol Performance Insights di. [https://console.aws.amazon.com/docdb/](https://console.aws.amazon.com/docdb/home#performance-insights)
1. Pilih instans DB. Dasbor Performance Insights ditampilkan untuk instans Amazon DocumentDB tersebut.
Untuk instans Amazon DocumentDB dengan Performance Insights diaktifkan, Anda juga dapat mencapai dasbor dengan **memilih item Sessions dalam daftar** instance. 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. Ketika bar kosong, instance adalah idle. Saat muatan meningkat, bilah akan terisi dengan warna biru. Ketika beban melewati jumlah virtual CPUs (vCPUs) pada kelas instance, bilah berubah menjadi merah, menunjukkan potensi kemacetan.
![\[Halaman Clusters menampilkan kluster regional Amazon DocumentDB dan CPU serta aktivitas saat ini dari setiap instance cluster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/opening-clusters.png)
1. (Opsional) Pilih interval waktu yang berbeda dengan memilih tombol di kanan atas. Misalnya, untuk mengubah interval menjadi 1 jam, pilih **1 jam**.
![\[Tombol interval waktu mulai dari lima menit hingga satu minggu.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/opening-time.png)
Pada tangkapan layar berikut, interval beban DB adalah 1 jam.
![\[Grafik batang yang menunjukkan beban database yang diukur dalam sesi aktif rata-rata.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/opening-db-load.png)
1. Untuk menyegarkan data Anda secara otomatis, aktifkan **Penyegaran otomatis**.
![\[Tombol auto refresh diaktifkan, muncul di sebelah tombol interval waktu.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/opening-auto-refresh.png)
Dasbor Wawasan Kinerja secara otomatis menyegarkan kembali data baru. Kecepatan penyegaran tergantung pada jumlah data yang ditampilkan:
+ 5 menit menyegarkan setiap 5 detik.
+ 1 jam menyegarkan setiap menit.
+ 5 jam menyegarkan setiap menit.
+ 24 jam menyegarkan setiap 5 menit.
+ 1 minggu menyegarkan setiap jam.
# Menganalisis beban basis data dengan status tunggu
Jika bagan **beban Database (beban DB)** menunjukkan kemacetan, Anda dapat mengetahui dari mana beban itu berasal. Untuk melakukannya, lihat tabel item muatan teratas di bawah bagan **Muatan basis data**. Pilih item tertentu, seperti kueri atau aplikasi, untuk menelusuri item itu dan melihat detailnya.
Beban DB yang dikelompokkan berdasarkan menunggu dan kueri teratas biasanya memberikan wawasan paling banyak tentang masalah kinerja. Muatan DB yang dikelompokkan berdasarkan peristiwa tunggu menunjukkan apakah ada sumber daya atau kemacetan konkurensi dalam basis data. Dalam hal ini, tab **Kueri teratas** pada tabel item pemuatan atas menunjukkan kueri mana yang mendorong pemuatan itu.
Alur kerja tipikal Anda untuk mendiagnosis masalah performa adalah sebagai berikut:
1. Tinjau bagan **Muatan basis data** dan lihat apakah ada insiden muatan basis data yang melebihi baris **CPU Maks**.
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 tab **Kueri teratas** di tabel item pemuatan atas yang paling berkontribusi pada status tunggu tersebut. Anda dapat mengidentifikasi ini dengan kolom **Load by Wait (AAS)**.
1. Pilih salah satu kueri intisari ini di tab **Kueri teratas** untuk memperluasnya dan melihat kueri anak yang terdiri darinya.
Anda juga dapat melihat host atau aplikasi mana yang berkontribusi paling banyak dengan memilih **Host teratas** atau **Aplikasi teratas**, masing-masing. Nama aplikasi ditentukan dalam string koneksi ke instance Amazon DocumentDB. `Unknown`menunjukkan bahwa bidang aplikasi tidak ditentukan.
Misalnya, di dasbor berikut, **CPU** menunggu sebagian besar beban DB. Memilih kueri teratas di bawah **Kueri teratas** akan mencakup bagan pemuatan Database untuk fokus pada beban terbanyak yang disumbangkan oleh kueri pilih.
![\[Bagan beban database yang menunjukkan lonjakan penggunaan CPU. Tab Kueri Teratas yang sesuai menunjukkan kueri yang berkontribusi paling banyak untuk status menunggu.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/db-load-1.png)
![\[Bagan beban database yang menunjukkan lonjakan penggunaan CPU untuk kueri yang paling berkontribusi pada status menunggu. Tab Kueri Teratas yang sesuai menunjukkan kueri turunan kueri tersebut.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/db-load-2.png)
# Ikhtisar tab Kueri teratas
Secara default, tab **Kueri teratas** menunjukkan kueri yang paling berkontribusi pada pemuatan DB. Anda dapat menganalisis teks kueri untuk membantu menyetel kueri Anda.
**Topics**
+ [Intisari kueri](#performance-insights-top-queries-digests)
+ [Muatan berdasarkan status tunggu (AAS)](#performance-insights-top-queries-aas)
+ [Melihat informasi kueri terperinci](#performance-insights-top-queries-query-info)
+ [Mengakses teks kueri pernyataan](#performance-insights-top-queries-accessing-text)
+ [Melihat dan mengunduh teks permintaan pernyataan](#performance-insights-top-queries-viewing-downloading)
## Intisari kueri
*Intisari kueri* 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, intisari kueri mungkin terlihat seperti ini:
```
{"find":"customerscollection","filter":{"FirstName":"?"},"sort":{"key":{"$numberInt":"?"}},"limit":{"$numberInt":"?"}}
```
Digest ini dapat mencakup kueri turunan berikut:
```
{"find":"customerscollection","filter":{"FirstName":"Karrie"},"sort":{"key":{"$numberInt":"1"}},"limit":{"$numberInt":"3"}}
{"find":"customerscollection","filter":{"FirstName":"Met"},"sort":{"key":{"$numberInt":"1"}},"limit":{"$numberInt":"3"}}
{"find":"customerscollection","filter":{"FirstName":"Rashin"},"sort":{"key":{"$numberInt":"1"}},"limit":{"$numberInt":"3"}}
```
Untuk melihat pernyataan kueri literal dalam intisari, pilih kueri, lalu pilih simbol plus (`+`). Di tangkapan layar berikut, kueri yang dipilih adalah sebuah intisari.
![\[Tabel kueri Top menunjukkan intisari kueri yang diperluas dengan satu kueri anak yang dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/top-queries-literal.png)
**catatan**
Intisari kueri mengelompokkan pernyataan kueri serupa, tetapi tidak menyunting informasi sensitif.
## Muatan berdasarkan status tunggu (AAS)
Di **Kueri teratas**, kolom **Load by waits (AAS)** menggambarkan persentase beban database yang terkait dengan setiap item pemuatan teratas. Kolom ini mencerminkan beban untuk item tersebut dengan pengelompokan apa pun yang saat ini dipilih dalam **bagan beban DB**. Misalnya, Anda mungkin mengelompokkan bagan **Muatan DB** berdasarkan status tunggu. 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.
![\[Bagan batang yang menunjukkan beban basis data yang dikelompokkan berdasarkan CPU, IO, dan status tunggu kait. Tabel yang sesuai menunjukkan kueri teratas berdasarkan beban dengan menunggu.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/top-queries-aas.png)
## Melihat informasi kueri terperinci
Dalam tabel **kueri Top**, Anda dapat membuka *pernyataan intisari* untuk melihat informasinya. Informasi ini muncul di panel bawah.
![\[Tabel kueri Top menunjukkan pernyataan kueri yang dipilih dan informasi kueri di bawah ini.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/top-queries-detailed.png)
Jenis identifier (IDs) berikut dikaitkan dengan pernyataan query:
1. **Support query ID** - Nilai hash dari ID kueri. Nilai ini hanya untuk mereferensikan ID kueri saat Anda bekerja dengan AWS Support. AWS Support tidak memiliki akses ke kueri IDs dan teks kueri Anda yang sebenarnya.
1. **Support digest ID** — Nilai hash dari ID intisari. Nilai ini hanya untuk mereferensikan ID intisari saat Anda bekerja dengan Support AWS . AWS Support tidak memiliki akses ke intisari IDs dan teks kueri Anda yang sebenarnya.
## Mengakses teks kueri pernyataan
Secara default, setiap baris dalam tabel **Kueri Top** menunjukkan 500 byte teks kueri untuk setiap pernyataan kueri. Jika pernyataan intisari melebihi 500 byte, Anda dapat melihat teks lainnya dengan membuka pernyataan di dasbor Performance Insights. Dalam hal ini, panjang maksimum untuk kueri yang ditampilkan adalah 1 KB. Jika Anda melihat pernyataan kueri lengkap, Anda juga dapat memilih **Unduh**.
## Melihat dan mengunduh teks permintaan pernyataan
Di dasbor Performance Insights, Anda dapat melihat atau mengunduh teks kueri.
**Untuk melihat teks kueri lainnya di dasbor Performance Insights**
1. Buka konsol Amazon DocumentDB di: [https://console.aws.amazon.com/docdb/](https://console.aws.amazon.com/docdb/)
1. Di panel navigasi, pilih **Wawasan Performa**.
1. Pilih instans DB. Dasbor Wawasan Kinerja ditampilkan untuk instans DB tersebut.
Pernyataan kueri dengan teks yang lebih besar dari 500 byte akan terlihat seperti gambar berikut:
![\[Tabel kueri Top dengan kueri anak dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/top-queries-statement.png)
1. Periksa bagian informasi kueri untuk melihat lebih banyak teks kueri.
![\[Bagian Informasi kueri yang menampilkan teks lengkap dari kueri yang dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/top-queries-query-text.png)
Dasbor Performance Insights dapat menampilkan hingga 1 KB untuk setiap pernyataan kueri lengkap.
**catatan**
Untuk menyalin atau mengunduh pernyataan kueri, nonaktifkan pemblokir pop-up apa pun.
# Memperbesar bagan beban database
Anda dapat menggunakan fitur lain di antarmuka pengguna Wawasan Kinerja untuk membantu menganalisis data kinerja.
**Click-and-Drag Memperbesar**
Dalam antarmuka Wawasan Kinerja, Anda dapat memilih sebagian kecil bagan muatan dan memperbesar detailnya.
![\[Bagan batang menunjukkan beban database, dengan sebagian disorot untuk diperbesar.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/pi-zoom-1.png)
Untuk memperbesar sebagian bagan muatan, pilih waktu mulai dan seret ke akhir periode waktu yang Anda inginkan. Saat melakukannya, area yang dipilih akan disorot. Saat Anda melepaskan mouse, bagan beban memperbesar area yang dipilih, dan tabel ***Item* teratas** dihitung ulang.
![\[Bagan batang beban basis data menunjukkan bagian yang diperbesar, dengan tabel tunggu Top yang sesuai di bawah ini.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/pi-zoom-2.png)
# Mengambil metrik dengan API Wawasan Performa
Saat Wawasan Kinerja diaktifkan, API menyediakan visibilitas ke dalam kinerja instans. Amazon CloudWatch Logs menyediakan sumber otoritatif untuk metrik pemantauan terjual untuk layanan. AWS
Wawasan Performa menawarkan tampilan spesifik domain dari muatan basis data yang diukur sebagai sesi aktif rata-rata (AAS). Metrik ini muncul sebagai set data deret waktu dua dimensi bagi konsumen API. 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 `Query`, `Wait-state`, `Application`, atau `Host`, yang diukur pada titik waktu tersebut.
Amazon DocumentDB Performance Insights memantau instans Amazon DocumentDB DB Anda sehingga Anda dapat menganalisis dan memecahkan masalah kinerja database. Salah satu cara untuk menampilkan data Wawasan Performa dapat ditemukan di Konsol Manajemen AWS. Wawasan Performa juga menyediakan API publik sehingga Anda dapat mengueri data Anda sendiri. Anda dapat menggunakan API untuk melakukan tindakan berikut:
+ Membongkar data ke dalam basis data
+ Menambahkan data Wawasan Performa ke dasbor pemantauan yang ada
+ Merancang alat pemantauan
Untuk menggunakan API Performance Insights, aktifkan Performance Insights di salah satu instans Amazon DocumentDB Anda. Untuk informasi tentang cara mengaktifkan Wawasan Performa, lihat [Mengaktifkan dan menonaktifkan Wawasan Kinerja](performance-insights-enabling.md). Untuk informasi selengkapnya tentang API Performance Insights, lihat Referensi API [Performance Insights](https://docs.aws.amazon.com/performance-insights/latest/APIReference/Welcome.html).
API Wawasan Performa menyediakan operasi berikut.
****
| Tindakan Wawasan Performa | AWS CLI perintah | Deskripsi |
| --- | --- | --- |
| [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 dalam jangka 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 ID kueri, dan jika detail dimensi tersedia, `GetDimensionKeyDetails` mengambil teks lengkap dari dimensi yang `db.query.statement` terkait dengan ID ini. Operasi ini berguna karena `GetResourceMetrics` dan `DescribeDimensionKeys` tidak mendukung pengambilan teks pernyataan kueri besar. |
| [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. |
**Topics**
+ [AWS CLI untuk Performance Insights](#performance-insights-metrics-CLI)
+ [Mengambil metrik deret waktu](#performance-insights-metrics-time-series)
+ [AWS CLI contoh untuk Performance Insights](#performance-insights-metrics-api-examples)
## AWS CLI untuk Performance Insights
Anda dapat melihat data Wawasan Performa menggunakan AWS CLI. Anda dapat menampilkan bantuan untuk perintah AWS CLI untuk Wawasan Performa dengan memasukkan berikut ini di baris perintah.
```
aws pi help
```
Jika Anda belum menginstal, lihat AWS CLI [Menginstal Antarmuka Baris AWS Perintah](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) di *Panduan AWS CLI Pengguna* untuk informasi tentang menginstalnya.
## Mengambil metrik deret waktu
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/documentdb/latest/developerguide/images/performance-insights/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 [Performance Insights untuk metrik penghitung](performance-insights-counter-metrics.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
Contoh berikut menunjukkan cara menggunakan Performance AWS CLI Insights.
**Topics**
+ [Mengambil metrik penghitung](#performance-insights-metrics-api-examples.CounterMetrics)
+ [Mengambil rata-rata beban DB untuk status tunggu teratas](#performance-insights-metrics-api-examples.DBLoadAverage)
+ [Mengambil rata-rata beban DB untuk Query teratas](#performance-insights-metrics-api-examples.topquery)
+ [Mengambil rata-rata beban DB yang disaring oleh Query](#performance-insights-metrics-api-examples.DBLoadAverageByQuery)
### Mengambil metrik penghitung
Tangkapan layar berikut menunjukkan dua bagan metrik penghitung dalam Konsol Manajemen AWS.
![\[Bagan Metrik Penghitung.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/performance-insights/perf-insights-api-counters-charts.png)
Contoh berikut menunjukkan cara mengumpulkan data yang sama yang digunakan oleh Konsol Manajemen AWS untuk menghasilkan dua bagan metrik penghitung.
Untuk Linux, macOS, atau Unix:
```
aws pi get-resource-metrics \
--service-type DOCDB \
--identifier db-ID \
--start-time 2022-03-13T8:00:00Z \
--end-time 2022-03-13T9: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 DOCDB ^
--identifier db-ID ^
--start-time 2022-03-13T8:00:00Z ^
--end-time 2022-03-13T9:00:00Z ^
--period-in-seconds 60 ^
--metric-queries '[{"Metric": "os.cpuUtilization.user.avg" },
{"Metric": "os.cpuUtilization.idle.avg"}]'
```
Anda juga dapat membuat perintah menjadi lebih mudah dibaca 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 DOCDB \
--identifier db-ID \
--start-time 2022-03-13T8:00:00Z \
--end-time 2022-03-13T9:00:00Z \
--period-in-seconds 60 \
--metric-queries file://query.json
```
Untuk Windows:
```
aws pi get-resource-metrics ^
--service-type DOCDB ^
--identifier db-ID ^
--start-time 2022-03-13T8:00:00Z ^
--end-time 2022-03-13T9:00:00Z ^
--period-in-seconds 60 ^
--metric-queries file://query.json
```
Contoh sebelumnya menentukan nilai-nilai berikut untuk opsi:
+ `--service-type`- `DOCDB` untuk Amazon DocumentDB
+ `--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.
```
{
"AlignedStartTime": "2022-03-13T08:00:00+00:00",
"AlignedEndTime": "2022-03-13T09:00:00+00:00",
"Identifier": "db-NQF3TTMFQ3GTOKIMJODMC3KQQ4",
"MetricList": [
{
"Key": {
"Metric": "os.cpuUtilization.user.avg"
},
"DataPoints": [
{
"Timestamp": "2022-03-13T08:01:00+00:00", //Minute1
"Value": 3.6
},
{
"Timestamp": "2022-03-13T08:02:00+00:00", //Minute2
"Value": 2.6
},
//.... 60 datapoints for the os.cpuUtilization.user.avg metric
{
"Key": {
"Metric": "os.cpuUtilization.idle.avg"
},
"DataPoints": [
{
"Timestamp": "2022-03-13T08:01:00+00:00",
"Value": 92.7
},
{
"Timestamp": "2022-03-13T08:02:00+00:00",
"Value": 93.7
},
//.... 60 datapoints for the os.cpuUtilization.user.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 beban DB untuk status tunggu teratas
Contoh berikut adalah query yang sama yang Konsol Manajemen AWS digunakan untuk menghasilkan grafik garis area bertumpuk. Contoh ini mengambil `db.load.avg` untuk jam terakhir dengan beban dibagi menurut tujuh status tunggu teratas. Perintah ini sama dengan perintah dalam [Mengambil metrik penghitung](#performance-insights-metrics-api-examples.CounterMetrics). Namun, file query.json berisi konten berikut.
```
[
{
"Metric": "db.load.avg",
"GroupBy": { "Group": "db.wait_state", "Limit": 7 }
}
]
```
Jalankan perintah berikut.
Untuk Linux, macOS, atau Unix:
```
aws pi get-resource-metrics \
--service-type DOCDB \
--identifier db-ID \
--start-time 2022-03-13T8:00:00Z \
--end-time 2022-03-13T9:00:00Z \
--period-in-seconds 60 \
--metric-queries file://query.json
```
Untuk Windows:
```
aws pi get-resource-metrics ^
--service-type DOCDB ^
--identifier db-ID ^
--start-time 2022-03-13T8:00:00Z ^
--end-time 2022-03-13T9:00:00Z ^
--period-in-seconds 60 ^
--metric-queries file://query.json
```
Contoh menentukan metrik `db.load.avg` dan a `GroupBy` dari tujuh status 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": "2022-04-04T06:00:00+00:00",
"AlignedEndTime": "2022-04-04T06:15:00+00:00",
"Identifier": "db-NQF3TTMFQ3GTOKIMJODMC3KQQ4",
"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": "2022-04-04T06:01:00+00:00",//Minute1
"Value": 0.0
},
{
"Timestamp": "2022-04-04T06:02:00+00:00",//Minute2
"Value": 0.0
},
//... 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_state.name": "CPU"
}
},
"DataPoints": [
{
"Timestamp": "2022-04-04T06:01:00+00:00",//Minute1
"Value": 0.0
},
{
"Timestamp": "2022-04-04T06:02:00+00:00",//Minute2
"Value": 0.0
},
//... 60 datapoints for the CPU key
]
},//... In total we have 3 key/datapoints entries, 1) total, 2-3) Top Wait States
] //end of MetricList
} //end of response
```
Dalam tanggapan ini, ada tiga entri dalam. `MetricList` Ada satu entri untuk total`db.load.avg`, dan tiga entri masing-masing untuk `db.load.avg` dibagi menurut salah satu dari tiga negara tunggu teratas. Karena ada dimensi pengelompokan (tidak seperti contoh pertama), harus 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 beban DB untuk Query teratas
Contoh berikut dikelompokkan `db.wait_state` oleh 10 pernyataan kueri teratas. Ada dua kelompok berbeda untuk pernyataan kueri:
+ `db.query`— Pernyataan kueri lengkap, seperti `{"find":"customers","filter":{"FirstName":"Jesse"},"sort":{"key":{"$numberInt":"1"}}}`
+ `db.query_tokenized`— Pernyataan kueri tokenized, seperti `{"find":"customers","filter":{"FirstName":"?"},"sort":{"key":{"$numberInt":"?"}},"limit":{"$numberInt":"?"}}`
Saat menganalisis kinerja database, akan berguna untuk mempertimbangkan pernyataan kueri yang hanya berbeda dengan parameternya sebagai satu item logika. Jadi, Anda dapat menggunakan `db.query_tokenized` saat melakukan kueri. Namun, terutama ketika Anda tertarik`explain()`, terkadang lebih berguna untuk memeriksa pernyataan kueri lengkap dengan parameter. Ada hubungan orang tua-anak antara kueri tokenized dan full, dengan beberapa kueri lengkap (turunan) dikelompokkan di bawah kueri tokenized yang sama (induk).
Perintah dalam contoh ini terlihat seperti perintah dalam [Mengambil rata-rata beban DB untuk status tunggu teratas](#performance-insights-metrics-api-examples.DBLoadAverage). Namun, file query.json berisi konten berikut.
```
[
{
"Metric": "db.load.avg",
"GroupBy": { "Group": "db.query_tokenized", "Limit": 10 }
}
]
```
Contoh berikut menggunakan `db.query_tokenized`.
Untuk Linux, macOS, atau Unix:
```
aws pi get-resource-metrics \
--service-type DOCDB \
--identifier db-ID \
--start-time 2022-03-13T8:00:00Z \
--end-time 2022-03-13T9:00:00Z \
--period-in-seconds 3600 \
--metric-queries file://query.json
```
Untuk Windows:
```
aws pi get-resource-metrics ^
--service-type DOCDB ^
--identifier db-ID ^
--start-time 2022-03-13T8:00:00Z ^
--end-time 2022-03-13T9:00:00Z ^
--period-in-seconds 3600 ^
--metric-queries file://query.json
```
Contoh ini menanyakan lebih dari 1 jam, dengan satu menit period-in-seconds.
Contoh menentukan metrik `db.load.avg` dan a `GroupBy` dari tujuh status 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": "2022-04-04T06:00:00+00:00",
"AlignedEndTime": "2022-04-04T06:15:00+00:00",
"Identifier": "db-NQF3TTMFQ3GTOKIMJODMC3KQQ4",
"MetricList": [
{//A list of key/datapoints
"Key": {
"Metric": "db.load.avg"
},
"DataPoints": [
//... 60 datapoints for the total db.load.avg key
]
},
{
"Key": {//Next key are the top tokenized queries
"Metric": "db.load.avg",
"Dimensions": {
"db.query_tokenized.db_id": "pi-1064184600",
"db.query_tokenized.id": "77DE8364594EXAMPLE",
"db.query_tokenized.statement": "{\"find\":\"customers\",\"filter\":{\"FirstName\":\"?\"},\"sort\":{\"key\":{\"$numberInt\":\"?\"}},\"limit\"
:{\"$numberInt\":\"?\"},\"$db\":\"myDB\",\"$readPreference\":{\"mode\":\"primary\"}}"
}
},
"DataPoints": [
//... 60 datapoints
]
},
// In total 11 entries, 10 Keys of top tokenized queries, 1 total key
] //End of MetricList
} //End of response
```
Respons ini memiliki 11 entri dalam `MetricList` (total 1, 10 kueri tokenized teratas), dengan setiap entri memiliki 24 per jam. `DataPoints`
Untuk kueri tokenized, ada tiga entri di setiap daftar dimensi:
+ `db.query_tokenized.statement`— Pernyataan kueri tokenized.
+ `db.query_tokenized.db_id `— ID sintetis yang dihasilkan Performance Insights untuk Anda. Contoh ini menampilkan ID sintetis `pi-1064184600`.
+ `db.query_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 mengambil keamanan dan privasi data Anda dengan sangat serius, dan hampir semua data disimpan terenkripsi dengan Anda. AWS KMS key 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.query_tokenized.statement`, atribut `Dimensions` dapat ditambahkan ke file query.json.
```
[
{
"Metric": "db.load.avg",
"GroupBy": {
"Group": "db.query_tokenized",
"Dimensions":["db.query_tokenized.statement"],
"Limit": 10
}
}
]
```
### Mengambil rata-rata beban DB yang disaring oleh Query
Kueri API terkait dalam contoh ini sama seperti perintah di [Mengambil rata-rata beban DB untuk Query teratas](#performance-insights-metrics-api-examples.topquery). Namun, file query.json berisi konten berikut.
```
[
{
"Metric": "db.load.avg",
"GroupBy": { "Group": "db.wait_state", "Limit": 5 },
"Filter": { "db.query_tokenized.id": "AKIAIOSFODNN7EXAMPLE" }
}
]
```
Dalam tanggapan ini, semua nilai difilter sesuai dengan kontribusi kueri token AKIAIOSFODNN7 CONTOH yang ditentukan dalam file query.json. Kunci juga mungkin mengikuti urutan yang berbeda dari kueri tanpa filter, karena ini adalah lima status tunggu teratas yang memengaruhi kueri yang difilter.
# CloudWatch Metrik Amazon untuk Performance Insights
Performance Insights secara otomatis menerbitkan metrik ke Amazon. CloudWatch Data yang sama dapat ditanyakan dari Performance Insights, tetapi memiliki metrik CloudWatch memudahkan untuk menambahkan alarm. CloudWatch Ini juga memudahkan untuk menambahkan metrik ke Dasbor CloudWatch yang ada.
| Metrik | Deskripsi |
| --- | --- |
| DBLoad | Jumlah sesi aktif untuk Amazon DocumentDB. Biasanya, Anda menginginkan data untuk jumlah rata-rata sesi aktif. Dalam Wawasan Performa, data ini dikueri sebagai `db.load.avg`. |
| DBLoadCPU | Jumlah sesi aktif di mana tipe status tunggu adalah CPU. Di Performance Insights, data ini ditanyakan sebagai`db.load.avg`, difilter berdasarkan jenis status tunggu. `CPU` |
| DBLoadNonCPU | Jumlah sesi aktif di mana tipe status tunggu bukan CPU. |
**catatan**
Metrik ini dipublikasikan CloudWatch hanya jika ada beban pada instans DB.
Anda dapat memeriksa metrik ini menggunakan CloudWatch konsol, the AWS CLI, atau CloudWatch API.
Misalnya, Anda bisa mendapatkan statistik untuk `DBLoad` metrik dengan menjalankan [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html)perintah.
```
aws cloudwatch get-metric-statistics \
--region ap-south-1 \
--namespace AWS/DocDB \
--metric-name DBLoad \
--period 360 \
--statistics Average \
--start-time 2022-03-14T8:00:00Z \
--end-time 2022-03-14T9:00:00Z \
--dimensions Name=DBInstanceIdentifier,Value=documentdbinstance
```
Contoh ini menghasilkan output yang terlihat seperti berikut.
```
{
"Datapoints": [
{
"Timestamp": "2022-03-14T08:42:00Z",
"Average": 1.0,
"Unit": "None"
},
{
"Timestamp": "2022-03-14T08:24:00Z",
"Average": 2.0,
"Unit": "None"
},
{
"Timestamp": "2022-03-14T08:54:00Z",
"Average": 6.0,
"Unit": "None"
},
{
"Timestamp": "2022-03-14T08:36:00Z",
"Average": 5.7,
"Unit": "None"
},
{
"Timestamp": "2022-03-14T08:06:00Z",
"Average": 4.0,
"Unit": "None"
},
{
"Timestamp": "2022-03-14T08:00:00Z",
"Average": 5.2,
"Unit": "None"
}
],
"Label": "DBLoad"
}
```
Anda dapat menggunakan fungsi matematika `DB_PERF_INSIGHTS` metrik di CloudWatch konsol untuk menanyakan metrik penghitung Performance Insights Amazon DocumentDB. `DB_PERF_INSIGHTS`Fungsi ini juga mencakup `DBLoad` metrik pada interval sub-menit. Anda dapat mengatur CloudWatch alarm pada metrik ini. Untuk detail selengkapnya tentang cara membuat alarm, lihat [Membuat alarm di metrik penghitung Performance Insights dari database](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_alarm_database_performance_insights.html). AWS
Untuk informasi selengkapnya CloudWatch, lihat [Apa itu Amazon CloudWatch?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html) di *Panduan CloudWatch Pengguna Amazon*.
# Performance Insights untuk metrik penghitung
Metrik penghitung adalah metrik sistem operasi di dasbor Performance Insights. Untuk membantu mengidentifikasi dan menganalisis masalah performa, Anda dapat mengaitkan metrik penghitung dengan muatan DB.
## Penghitung sistem operasi Wawasan Performa
Penghitung sistem operasi berikut tersedia dengan Amazon DocumentDB Performance Insights.
| Penghitung | Jenis | Metrik |
| --- | --- | --- |
| aktif | memori | os.memory.active |
| buffer | memori | os.memory.buffers |
| dalam cache | memori | os.memory.cached |
| kotor | memori | os.memory.dirty |
| kosong | memori | os.memory.free |
| tidak aktif | memori | os.memory.inactive |
| dipetakan | memori | os.memory.mapped |
| pageTables | memori | os.memory.pageTables |
| lempengan | memori | os.memory.slab |
| total | memori | os.memory.total |
| tulis balik | memori | os.memory.writeback |
| diam | cpuUtilization | os.cpuUtilization.idle |
| sistem | cpuUtilization | os.cpuUtilization.system |
| total | cpuUtilization | os.cpuUtilization.total |
| pengguna | cpuUtilization | os.cpuUtilization.user |
| tunggu | cpuUtilization | os.cpuUtilization.wait |
| satu | loadAverageMinute | os. loadAverageMinute.satu |
| lima belas | loadAverageMinute | os. loadAverageMinute.lima belas |
| lima | loadAverageMinute | os. loadAverageMinute.lima |
| dalam cache | ganti | os.swap.cached |
| kosong | swap | os.swap.free |
| masuk | swap | os.swap.in |
| keluar | swap | os.swap.out |
| total | swap | os.swap.total |
| rx | jaringan | os.network.rx |
| tx | jaringan | os.network.tx |
| jumlah VCPUs | umum | os.general.num VCPUs |