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.

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+Item 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 AWS Management Console dan buka konsol DynamoDB di. https://console.aws.amazon.com/dynamodb/

2. Di panel navigasi di sisi kiri konsol, pilih Tabel.

3. Pilih tabel Music.

4. Pilih tab Pantau.

5. Pilih Aktifkan Wawasan CloudWatch Kontributor.

   

6. Di kotak dialog Kelola Wawasan CloudWatch Kontributor, alihkan Aktifkan tabel Music dasar dan indeks sekunder global. AlbumTitle-index

7. Biarkan mode Only throttled keys toggle di posisi off untuk keduanya dan kemudian pilih Simpan perubahan.

   

   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 FailureExceptiondi Referensi Amazon DynamoDB API untuk alasan yang mungkin.

8. 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.

   

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.

2. 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.

3. 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 ConsumedThroughputUnitsatau mengalami pelambatan.

1. Masuk ke AWS Management Console dan buka CloudWatch konsol di https://console.aws.amazon.com/cloudwatch/

2. Di panel navigasi di sisi kiri konsol, pilih Wawasan Kontributor.

3. 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

4. Pilih drop down Tindakan.

5. Pilih Lihat dalam metrik.

6. 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.

   

7. Di kolom Tindakan, Pilih Buat Alarm.

   

8. 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

   

9. Lihat Menggunakan CloudWatch alarm Amazon 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

2. 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

3. Dapatkan status dan aturan untuk tabel Music dan semua indeksnya.

   aws dynamodb describe-contributor-insights 
                       --table-name Music

   Tanggapan akan mencakup ContributorInsightsMode bidang yang ditampilkanACCESSED_AND_THROTTLED_KEYS.

4. 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

2. 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

3. 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

2. 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

3. Periksa status selama transisi.

   aws dynamodb describe-contributor-insights --table-name Music

   Selama sakelar mode, ContributorInsightsStatus akan ditampilkan sebagaiENABLING. 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

2. 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.

3. 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.