Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memulai CloudWatch Contributor Insights for DynamoDB
Bagian ini menjelaskan cara mengaktifkan dan menggunakan Amazon CloudWatch Contributor Insights dalam mode yang berbeda untuk memenuhi kebutuhan pemantauan Anda menggunakan konsol Amazon DynamoDB atau (). AWS Command Line Interface AWS CLI
Dalam contoh berikut, Anda menggunakan tabel DynamoDB yang didefinisikan dalam tutorial [Mulai menggunakan DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GettingStartedDynamoDB.html).
**Topics**
+ [Memilih mode Wawasan Kontributor](#contributorinsights_tutorial.modes)
+ [Menggunakan Wawasan Kontributor (konsol)](#usecontributorinsights_console)
+ [Menggunakan Wawasan Kontributor (AWS CLI)](#usecontributorinsights_cli)
## Memilih mode Wawasan Kontributor
Sebelum mengaktifkan Contributor Insights, Anda harus memahami dua mode yang tersedia. Tinjau perbandingan mode untuk memilih opsi yang paling sesuai dengan kebutuhan spesifik Anda.
| Aspek | Mode tombol yang diakses dan dibatasi | Mode tombol terhambat |
| --- | --- | --- |
| Monitor | Semua permintaan (berhasil dan dibatasi) | Hanya permintaan yang dibatasi |
| Grafik | Item Paling Banyak Diakses\$1Item Paling Diblokir | Barang Paling Batas saja |
| Terbaik untuk | Analisis dan optimasi yang ditargetkan | Pemantauan pelambatan |
| Gunakan kapan | Anda membutuhkan visibilitas lengkap ke dalam pola akses. Anda melakukan analisis jangka pendek atau debugging. | Perhatian utama Anda adalah mengidentifikasi dan menyelesaikan masalah pelambatan. Anda ingin tetap mengaktifkan Contributor Insights secara terus menerus untuk peringatan pembatasan waktu nyata. |
## Menggunakan Wawasan Kontributor (konsol)
Konsol menyediakan cara intuitif untuk mengaktifkan Contributor Insights dan memilih mode yang sesuai untuk kebutuhan pemantauan Anda.
**Untuk menggunakan Contributor Insights di konsol**
1. Masuk ke Konsol Manajemen AWS dan buka konsol DynamoDB di. [https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/)
1. Di panel navigasi di sisi kiri konsol, pilih **Tabel**.
1. Pilih tabel `Music`.
1. Pilih tab **Pantau**.
1. Pilih **Aktifkan Wawasan CloudWatch Kontributor**.
![\[Tangkapan layar konsol yang menampilkan tombol dan tab pantau.\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/images/CI_ChooseAndManageNew.PNG)
1. Di kotak dialog **Kelola Wawasan CloudWatch Kontributor**, alihkan **Aktifkan** tabel `Music` dasar dan indeks sekunder global. `AlbumTitle-index`
1. **Biarkan **mode Only throttled keys** toggle di posisi off untuk keduanya dan kemudian pilih Simpan perubahan.**
![\[Tangkapan layar konsol yang menampilkan opsi daftar status Wawasan Kontributor.\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/images/CI_Enable.png)
Ini memungkinkan mode *kunci yang diakses dan dibatasi* default untuk tabel dan GSI, yang menyediakan pemantauan item yang diakses dan dibatasi. *Mengalihkan sakelar **mode Only throttled keys** ke posisi on akan mengaktifkan mode tombol throttled.*
Jika operasi gagal, lihat [DescribeContributorInsights FailureException](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DescribeContributorInsights.html#DDB-DescribeContributorInsights-response-FailureException)di Referensi *Amazon DynamoDB API* untuk alasan yang mungkin.
1. Grafik CloudWatch Contributor Insights sekarang terlihat di tab **Monitor** untuk tabel. `Music` Karena Anda mengaktifkan mode *kunci yang diakses dan dibatasi*, Anda melihat grafik item yang diakses dan dibatasi.
![\[Tangkapan layar konsol yang menampilkan tab Wawasan Kontributor dengan beberapa grafik untuk tabel musik.\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/images/CI_Graphs.png)
### Beralih antar mode
Anda dapat beralih antar mode kapan saja tanpa menonaktifkan Contributor Insights.
**Untuk mengganti mode Contributor Insights**
1. Pada tab **Monitor** tabel Anda, pilih **Kelola Wawasan CloudWatch Kontributor**.
1. Di kotak dialog **Kelola Wawasan Kontributor**, untuk setiap tabel dasar atau: GSIs
+ *Alihkan **Only throttled keys mode** on atau off untuk mengaktifkan mode tombol *throttled atau kembali ke mode tombol* yang diakses dan dibatasi default.*
+ Alihkan **Nonaktifkan** untuk menonaktifkan CloudWatch Contributor Insight untuk tabel atau GSI.
1. Pilih **Simpan perubahan**.
Setelah selesai, grafik akan mencerminkan mode baru.
### Membuat CloudWatch alarm
Ikuti langkah-langkah ini untuk membuat CloudWatch alarm dan diberi tahu ketika kunci partisi apa pun menghabiskan lebih dari 50.000 [ConsumedThroughputUnits](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/contributorinsights_HowItWorks.html#contributorinsights_HowItWorks.Graphs.most-accessed)atau mengalami pelambatan.
1. Masuk ke Konsol Manajemen AWS dan buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)
1. Di panel navigasi di sisi kiri konsol, pilih **Wawasan Kontributor**.
1. Pilih aturan yang sesuai berdasarkan mode Anda dan apa yang ingin Anda pantau:
+ **Untuk pemantauan item yang diakses (hanya mode tombol yang diakses dan dibatasi): Pilih Dynamo Insights-PKC-Music DBContributor**
+ **Untuk pemantauan item terbatas (kedua mode): Pilih Dynamo Insights-PKT-Musik DBContributor**
1. Pilih drop down **Tindakan**.
1. Pilih **Lihat dalam metrik**.
1. Pilih **Nilai Kontributor Maks**.
**catatan**
Hanya `Max Contributor Value` dan `Maximum` yang mengembalikan statistik yang berguna. Statistik lain dalam daftar ini tidak mengembalikan nilai yang berarti.
![\[Tangkapan layar konsol yang menampilkan tab dan tombol Wawasan Kontributor.\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/images/CI_AlarmsViewinMetrics.png)
1. Di kolom **Tindakan**, Pilih **Buat Alarm**.
![\[Tangkapan layar konsol yang menampilkan opsi daftar status Wawasan Kontributor.\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/images/CI_AlarmsSetAlarm.png)
1. Masukkan nilai ambang batas yang sesuai dan pilih **Berikutnya**:
+ Untuk item yang diakses (aturan PKC): Masukkan 50000 untuk `ConsumedThroughputUnits`
+ Untuk item yang dibatasi (aturan PKT): Masukkan 1 `ThrottleCount` untuk diperingatkan pada pelambatan apa pun
![\[Tangkapan layar konsol yang menampilkan tab dan tombol Wawasan Kontributor.\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/images/CI_AlarmsSetAlarmThreashold.png)
1. Lihat [Menggunakan CloudWatch alarm Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) untuk detail tentang cara mengonfigurasi notifikasi untuk alarm.
## Menggunakan Wawasan Kontributor (AWS CLI)
AWS CLI Ini menyediakan akses terprogram ke Contributor Insights dengan dukungan penuh untuk kedua mode. Anda dapat menentukan mode saat mengaktifkan Contributor Insights atau beralih mode nanti.
### Operasi dasar dengan mode default
**Untuk menggunakan Contributor Insights dengan setelan default**
1. *Aktifkan CloudWatch Contributor Insights untuk DynamoDB pada tabel `Music` dasar dengan mode kunci yang diakses dan dibatasi.* Karena `ACCESSED_AND_THROTTLED_KEYS` adalah mode default, Anda dapat menghilangkan `--contributor-insights-mode=ACCESSED_AND_THROTTLED_KEYS` parameter.
```
aws dynamodb update-contributor-insights \
--table-name Music \
--contributor-insights-action=ENABLE
```
1. Aktifkan Wawasan Kontributor untuk DynamoDB di indeks sekunder global `AlbumTitle-index`.
```
aws dynamodb update-contributor-insights \
--table-name Music \
--index-name AlbumTitle-index \
--contributor-insights-action=ENABLE
```
1. Dapatkan status dan aturan untuk tabel `Music` dan semua indeksnya.
```
aws dynamodb describe-contributor-insights
--table-name Music
```
Tanggapan akan mencakup `ContributorInsightsMode` bidang yang ditampilkan`ACCESSED_AND_THROTTLED_KEYS`.
1. Buat daftar status `Music` tabel dan semua indeksnya.
```
aws dynamodb list-contributor-insights --table-name Music
```
### Mengaktifkan mode tombol terhambat
**Untuk mengaktifkan Contributor Insights dalam mode tombol terbatas**
1. *Aktifkan CloudWatch Contributor Insights untuk DynamoDB pada tabel `Music` dasar dengan mode tombol terbatas.*
```
aws dynamodb update-contributor-insights \
--table-name Music \
--contributor-insights-action=ENABLE \
--contributor-insights-mode=THROTTLED_KEYS
```
1. Aktifkan Wawasan Kontributor *dalam mode kunci terbatas* untuk indeks sekunder global. `AlbumTitle-index`
```
aws dynamodb update-contributor-insights \
--table-name Music \
--index-name AlbumTitle-index \
--contributor-insights-action=ENABLE \
--contributor-insights-mode=THROTTLED_KEYS
```
1. Verifikasi mode dengan menjelaskan konfigurasi Contributor Insights.
```
aws dynamodb describe-contributor-insights --table-name Music
```
Respons akan menunjukkan aturan `ContributorInsightsMode` sebagai `THROTTLED_KEYS` dan lebih sedikit dibandingkan dengan mode default.
### Beralih antar mode
**Untuk mengganti mode Contributor Insights**
1. Beralih dari mode *tombol dibatasi ke mode tombol* yang *diakses dan dibatasi*.
```
aws dynamodb update-contributor-insights \
--table-name Music \
--contributor-insights-action=ENABLE \
--contributor-insights-mode=ACCESSED_AND_THROTTLED_KEYS
```
1. Beralih dari mode tombol yang *diakses dan dibatasi ke mode tombol* *dibatasi*.
```
aws dynamodb update-contributor-insights \
--table-name Music \
--contributor-insights-action=ENABLE \
--contributor-insights-mode=THROTTLED_KEYS
```
1. Periksa status selama transisi.
```
aws dynamodb describe-contributor-insights --table-name Music
```
Selama sakelar mode, `ContributorInsightsStatus` akan ditampilkan sebagai`ENABLING`. Setelah selesai, itu akan ditampilkan seperti `ENABLED` mode baru.
### Mengelola Wawasan Kontributor
**Untuk mengelola setelan Contributor Insights**
1. Nonaktifkan CloudWatch Contributor Insights untuk DynamoDB pada indeks sekunder global. `AlbumTitle-index`
```
aws dynamodb update-contributor-insights \
--table-name Music --index-name AlbumTitle-index \
--contributor-insights-action=DISABLE
```
1. Cantumkan semua konfigurasi Contributor Insights di akun Anda.
```
aws dynamodb list-contributor-insights
```
Ini menunjukkan semua tabel dan indeks dengan Contributor Insights diaktifkan, bersama dengan modenya.
1. Dapatkan informasi terperinci tentang konfigurasi tertentu.
```
aws dynamodb describe-contributor-insights \
--table-name Music \
--index-name AlbumTitle-index
```
### Contoh tanggapan
Berikut adalah contoh tanggapan yang menunjukkan perbedaan antara mode:
#### Respons mode tombol yang diakses dan dibatasi
```
{
"TableName": "Music",
"ContributorInsightsRuleList": [
"DynamoDBContributorInsights-PKC-Music-1234567890123",
"DynamoDBContributorInsights-PKT-Music-1234567890123",
"DynamoDBContributorInsights-SKC-Music-1234567890123",
"DynamoDBContributorInsights-SKT-Music-1234567890123"
],
"ContributorInsightsStatus": "ENABLED",
"ContributorInsightsMode": "ACCESSED_AND_THROTTLED_KEYS",
"LastUpdateDateTime": "2024-01-15T10:30:00.000Z"
}
```
#### Respons mode tombol terhambat
```
{
"TableName": "Music",
"ContributorInsightsRuleList": [
"DynamoDBContributorInsights-PKT-Music-1234567890123",
"DynamoDBContributorInsights-SKT-Music-1234567890123"
],
"ContributorInsightsStatus": "ENABLED",
"ContributorInsightsMode": "THROTTLED_KEYS",
"LastUpdateDateTime": "2024-01-15T10:35:00.000Z"
}
```
Perhatikan bahwa mode tombol dibatasi memiliki aturan yang lebih sedikit (hanya PKT dan SKT), yang sesuai dengan pemantauan yang lebih terfokus.