

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

# Menggunakan Amazon DocumentDB tanpa server
<a name="docdb-serverless"></a>

Amazon DocumentDB tanpa server adalah konfigurasi penskalaan otomatis sesuai permintaan yang mengotomatiskan proses penyesuaian kapasitas database Amazon DocumentDB Anda secara dinamis berdasarkan permintaan aplikasi. Anda hanya dikenakan biaya untuk sumber daya yang dikonsumsi cluster Anda. Dengan demikian, DocumentDB tanpa server dapat membantu Anda tetap dalam anggaran dan menghindari membayar sumber daya komputer yang tidak Anda gunakan.

Jenis otomatisasi ini sangat berharga untuk lingkungan dengan beban kerja yang sangat bervariasi dan tidak dapat diprediksi, seperti database multitenant, database terdistribusi, dan sistem pengembangan dan pengujian.

**Topics**
+ [Kasus penggunaan tanpa server](#docdb-serverless-use-cases)
+ [Keuntungan dari Amazon DocumentDB tanpa server](#docdb-serverless-advantages)
+ [Cara kerja tanpa server](docdb-serverless-how-it-works.md)
+ [Persyaratan dan batasan tanpa server](docdb-serverless-limitations.md)
+ [Membuat cluster yang menggunakan tanpa server](docdb-serverless-create-cluster.md)
+ [Migrasi ke tanpa server](docdb-serverless-migrating.md)
+ [Mengelola tanpa server](docdb-serverless-managing.md)
+ [Batas instance tanpa server](docdb-serverless-instance-limits.md)
+ [Konfigurasi penskalaan tanpa server](docdb-serverless-scaling-config.md)
+ [Pemantauan tanpa server](docdb-serverless-monitoring.md)

## Kasus penggunaan tanpa server DocumentDB
<a name="docdb-serverless-use-cases"></a>

Cluster yang disediakan Amazon DocumentDB dan DocumentDB tanpa server mendukung banyak jenis beban kerja basis data, mulai dari lingkungan pengembangan dan pengujian hingga aplikasi yang paling menuntut dan kritis bisnis yang memerlukan skala dan ketersediaan tinggi. Namun DocumentDB serverless menambahkan dimensi lain pada beban kerja pelanggan, yaitu kemampuan untuk mendukung situs web dan aplikasi yang memiliki beban kerja yang tidak terduga.

DocumentDB tanpa server sangat berguna untuk kasus penggunaan berikut:
+ **Beban kerja variabel** — Anda menjalankan beban kerja yang memiliki peningkatan aktivitas yang tiba-tiba dan tidak dapat diprediksi. Contohnya adalah situs info lalu lintas yang mengalami lonjakan aktivitas saat hujan mulai turun. Contoh yang lain adalah situs e-commerce yang mengalami peningkatan lalu lintas ketika Anda menawarkan obral atau promosi khusus. Dengan DocumentDB tanpa server, database Anda secara otomatis menskalakan kapasitas untuk memenuhi kebutuhan beban puncak aplikasi dan menurunkan skala saat lonjakan aktivitas selesai. Dengan DocumentDB tanpa server, Anda tidak perlu lagi menyediakan kapasitas puncak atau rata-rata. Anda dapat menentukan batas kapasitas atas untuk menangani situasi terburuk, dan kapasitas tersebut tidak akan digunakan kecuali jika diperlukan.
  + Perincian penskalaan di DocumentDB tanpa server membantu Anda mencocokkan kapasitas dengan kebutuhan database Anda. Untuk klaster yang disediakan, penskalaan membutuhkan penambahan instance yang sama sekali baru. DocumentDB tanpa server dapat menambahkan setengah DCU ketika hanya sedikit lebih banyak kapasitas yang dibutuhkan. Ini dapat menambahkan 0,5, 1, 1,5, 2, atau setengah tambahan DCUs berdasarkan kapasitas tambahan yang diperlukan untuk menangani peningkatan beban kerja. Dan itu dapat menghapus 0,5, 1, 1,5, 2, atau tambahan setengah- DCUs ketika beban kerja menurun dan kapasitas itu tidak lagi diperlukan.
+ **Aplikasi multi-tenant** - Dengan DocumentDB tanpa server, Anda tidak perlu mengelola kapasitas database secara individual untuk setiap aplikasi di armada Anda. DocumentDB tanpa server mengelola kapasitas database individual untuk Anda.
  + Anda dapat membuat klaster untuk setiap penghuni. Dengan begitu, Anda dapat menggunakan fitur seperti kloning dan pemulihan snapshot untuk meningkatkan ketersediaan tinggi dan pemulihan bencana yang sesuai untuk setiap penyewa.
  + Setiap penghuni mungkin memiliki periode sibuk dan idle tertentu tergantung waktu dalam sehari, periode dalam setahun, acara promosi, dan sebagainya. Setiap klaster dapat memiliki rentang kapasitas yang luas. Dengan begitu, cluster dengan aktivitas rendah dikenakan biaya instans minimal. Setiap klaster dapat dengan cepat menaikkan skala untuk menangani periode aktivitas tinggi.
+ **Aplikasi baru** — Anda menerapkan aplikasi baru dan Anda tidak yakin tentang ukuran instans yang Anda butuhkan. Dengan menggunakan DocumentDB tanpa server, Anda dapat menyiapkan klaster dengan satu atau banyak instance dan memiliki skala otomatis database untuk persyaratan kapasitas aplikasi Anda.
+ Aplikasi **mixed-use — Misalkan Anda memiliki aplikasi** pemrosesan transaksi online (OLTP), tetapi Anda secara berkala mengalami lonjakan lalu lintas kueri. Dengan menentukan tingkatan promosi untuk instance tanpa server DocumentDB dalam klaster, Anda dapat mengonfigurasi klaster Anda sehingga instance pembaca dapat menskalakan secara independen dari instance penulis untuk menangani beban tambahan. Ketika lonjakan penggunaan mereda, instance pembaca menskalakan kembali agar sesuai dengan kapasitas instance penulis.
+ **Perencanaan kapasitas** - Misalkan Anda biasanya menyesuaikan kapasitas database Anda, atau memverifikasi kapasitas database optimal untuk beban kerja Anda, dengan memodifikasi kelas instance dari semua instance dalam sebuah cluster. Dengan DocumentDB tanpa server, Anda dapat menghindari overhead administratif ini. Anda dapat menentukan kapasitas minimum dan maksimum yang sesuai dengan menjalankan beban kerja dan memeriksa seberapa besar skala instans sebenarnya.
  + Anda dapat memodifikasi instance yang ada dari yang disediakan ke DocumentDB tanpa server atau dari DocumentDB tanpa server ke yang disediakan. Anda tidak perlu membuat cluster baru atau instance baru dalam kasus seperti itu.
+ **Pengembangan dan pengujian** — Selain menjalankan aplikasi yang paling menuntut, Anda juga dapat menggunakan DocumentDB tanpa server untuk lingkungan pengembangan dan pengujian. Dengan DocumentDB tanpa server, Anda dapat membuat instance dengan kapasitas minimum rendah alih-alih menggunakan kelas instans db.t\$1 yang dapat diburstable. Anda dapat mengatur kapasitas maksimum yang cukup tinggi sehingga instans tersebut masih dapat menjalankan beban kerja yang besar tanpa kehabisan memori. Ketika database tidak digunakan, semua instance diturunkan untuk menghindari biaya yang tidak perlu.

### Menggunakan Amazon DocumentDB tanpa server untuk beban kerja yang sudah tersedia
<a name="docdb-serverles-provisioned-workloads"></a>

Misalkan Anda sudah memiliki aplikasi DocumentDB yang berjalan pada cluster yang disediakan. Anda dapat memeriksa bagaimana aplikasi akan bekerja dengan DocumentDB tanpa server dengan menambahkan satu atau lebih instance tanpa server DocumentDB ke cluster yang ada sebagai instance pembaca. Anda dapat memeriksa seberapa sering instance pembaca naik dan turun. Anda dapat menggunakan mekanisme failover DocumentDB untuk mempromosikan instance tanpa server DocumentDB menjadi penulis dan memeriksa bagaimana menangani beban kerja. read/write Dengan demikian, Anda dapat beralih dengan waktu henti minimal dan tanpa mengubah titik akhir yang digunakan aplikasi klien Anda. Untuk detail tentang prosedur mengonversi cluster yang ada ke DocumentDB tanpa server, lihat. [Bermigrasi ke Amazon DocumentDB tanpa server](docdb-serverless-migrating.md)

## Keuntungan dari Amazon DocumentDB tanpa server
<a name="docdb-serverless-advantages"></a>

DocumentDB tanpa server ditujukan untuk beban kerja variabel atau “runcing”. Dengan beban kerja yang tidak dapat diprediksi seperti itu, Anda mungkin mengalami kesulitan dalam merencanakan kapan harus mengubah kapasitas basis data Anda. Anda mungkin juga mengalami kesulitan dalam membuat perubahan kapasitas dengan cukup cepat menggunakan mekanisme yang sudah dikenal seperti menambahkan instance atau mengubah kelas instance. DocumentDB tanpa server memberikan keuntungan berikut untuk membantu kasus penggunaan seperti:
+ **Manajemen kapasitas yang lebih sederhana daripada yang disediakan** - DocumentDB tanpa server mengurangi upaya untuk merencanakan ukuran instans dan mengubah ukuran instance saat beban kerja berubah. Ini juga mengurangi upaya untuk mempertahankan kapasitas yang konsisten untuk semua instance dalam sebuah cluster.
+ **Penskalaan yang lebih cepat dan lebih mudah selama periode aktivitas tinggi** — DocumentDB tanpa server menskalakan kapasitas komputasi dan memori sesuai kebutuhan, tanpa gangguan pada transaksi klien atau beban kerja Anda secara keseluruhan. Kemampuan untuk menggunakan instance pembaca dengan DocumentDB tanpa server membantu Anda memanfaatkan penskalaan horizontal selain penskalaan vertikal. Kemampuan untuk menggunakan cluster global DocumentDB berarti Anda dapat menyebarkan beban kerja baca tanpa server DocumentDB Anda di beberapa. Wilayah AWS Kemampuan ini lebih praktis daripada mekanisme penskalaan untuk klaster terprovisi.
+ **Hemat biaya selama periode aktivitas rendah** — DocumentDB tanpa server membantu Anda menghindari penyediaan instans yang berlebihan. DocumentDB tanpa server menambahkan sumber daya secara bertahap saat instance meningkat. Anda hanya membayar untuk sumber daya database yang Anda konsumsi. Penggunaan sumber daya tanpa server DocumentDB diukur berdasarkan per detik. Dengan begitu, ketika sebuah instance menurunkan skala, pengurangan penggunaan sumber daya segera didaftarkan.
+ **Paritas fitur dengan disediakan - Anda dapat menggunakan semua fitur DocumentDB** dengan DocumentDB tanpa server. Misalnya, dengan DocumentDB tanpa server, Anda dapat menggunakan instance pembaca, otentikasi database (IAM) AWS Identity and Access Management , dan Performance Insights.

  Secara khusus, dengan DocumentDB tanpa server Anda dapat memanfaatkan fitur-fitur berikut dari cluster yang disediakan:
  + **Instance pembaca** - DocumentDB tanpa server dapat memanfaatkan instance pembaca untuk menskalakan secara horizontal. Ketika sebuah cluster berisi satu atau lebih instance pembaca, cluster dapat segera gagal jika terjadi masalah dengan instance penulis.
  + **Cluster multi-AZ** — Anda dapat mendistribusikan instance tanpa server DocumentDB dari sebuah cluster di beberapa Availability Zones (). AZs Menyiapkan klaster Multi-AZ akan membantu memastikan kelangsungan bisnis bahkan dalam kasus masalah yang jarang terjadi yang memengaruhi seluruh AZ.
  + **Kluster global** - Anda dapat menggunakan DocumentDB tanpa server dalam kombinasi dengan cluster global DocumentDB untuk membuat salinan read-only tambahan dari cluster Anda di tempat lain untuk tujuan pemulihan bencana. Wilayah AWS 

# Cara kerja tanpa server Amazon DocumentDB
<a name="docdb-serverless-how-it-works"></a>

**Topics**
+ [Ikhtisar](#docdb-serverlerss-overviewn)
+ [Konfigurasi untuk cluster Amazon DocumentDB](#docdb-serverlerss-configuration)
+ [Kapasitas penskalaan tanpa server Amazon DocumentDB](#docdb-serverless-scaling-capacity)
+ [Penskalaan tanpa server Amazon DocumentDB](#docdb-serverless-scaling)
+ [Keadaan menganggur (0,5 DCUs)](#docdb-serverlerss-idle-state)

## Ikhtisar
<a name="docdb-serverlerss-overviewn"></a>

Amazon DocumentDB tanpa server cocok untuk beban kerja yang paling menuntut dan sangat bervariasi. Misalnya, penggunaan basis data Anda mungkin berat untuk waktu yang singkat, diikuti dengan aktivitas ringan dalam waktu lama atau tidak ada aktivitas sama sekali. Beberapa contohnya adalah situs web retail, game, atau olahraga dengan peristiwa promosi berkala, dan basis data yang menghasilkan laporan jika diperlukan. Contoh lainnya adalah lingkungan pengembangan dan pengujian, serta aplikasi baru yang penggunaannya dapat meningkat dengan cepat. Untuk kasus seperti ini dan banyak kasus lainnya, mengonfigurasi kapasitas dengan benar sebelumnya tidak selalu dapat dilakukan dengan model terprovisi. Hal ini juga dapat mengakibatkan biaya yang lebih tinggi jika Anda menetapkan penyediaan yang berlebih dan memiliki kapasitas yang tidak Anda gunakan.

Sebaliknya, cluster yang disediakan DocumentDB cocok untuk beban kerja yang stabil. Dengan cluster yang disediakan, Anda memilih kelas instance yang memiliki jumlah memori, daya CPU, I/O bandwidth, dan sebagainya yang telah ditentukan sebelumnya. Jika beban kerja Anda berubah, Anda secara manual memodifikasi kelas instans penulis dan pembaca Anda. Model terprovisi berfungsi dengan baik saat Anda dapat menyesuaikan kapasitas sebelum pola konsumsi yang diharapkan dan Anda sanggup mengalami pemadaman singkat saat mengubah kelas instans penulis dan pembaca di klaster Anda.

DocumentDB tanpa server dirancang dari bawah ke atas untuk mendukung cluster tanpa server yang dapat diskalakan secara instan. DocumentDB tanpa server direkayasa untuk memberikan tingkat keamanan dan isolasi yang sama seperti penulis dan pembaca yang disediakan. Aspek-aspek ini sangat penting dalam lingkungan cloud nirserver multi-penghuni. Mekanisme penskalaan dinamis memiliki overhead yang sangat sedikit sehingga dapat merespons dengan cepat perubahan beban kerja basis data. Mekanisme ini juga cukup kuat untuk memenuhi permintaan memproses permintaan yang meningkat secara drastis.

Dengan menggunakan DocumentDB tanpa server, Anda dapat membuat cluster DocumentDB tanpa dikunci ke dalam kapasitas database tertentu untuk setiap penulis dan pembaca. Anda menentukan rentang kapasitas minimum dan maksimum. DocumentDB menskalakan setiap penulis atau pembaca tanpa server DocumentDB di cluster dalam rentang kapasitas tersebut. Dengan menggunakan klaster Multi-AZ yang memungkinkan setiap penulis atau pembaca diskalakan secara dinamis, Anda dapat memanfaatkan penskalaan dinamis dan ketersediaan tinggi.

DocumentDB tanpa server menskalakan sumber daya database secara otomatis berdasarkan spesifikasi kapasitas minimum dan maksimum Anda. Penskalaan dilakukan dengan cepat karena sebagian besar operasi peristiwa penskalaan mempertahankan penulis atau pembaca di host yang sama. Dalam kasus yang jarang terjadi ketika penulis atau pembaca tanpa server DocumentDB dipindahkan dari satu host ke host lainnya, DocumentDB tanpa server mengelola koneksi secara otomatis. Anda tidak perlu mengubah kode aplikasi klien basis data Anda atau string koneksi basis data Anda.

Dengan DocumentDB tanpa server, seperti halnya cluster yang disediakan, kapasitas penyimpanan dan kapasitas komputasi terpisah. Ketika kita mengacu pada kapasitas dan penskalaan tanpa server DocumentDB, selalu kapasitas komputasi yang meningkat atau menurun. Dengan demikian, klaster Anda dapat berisi banyak terabyte data bahkan ketika kapasitas CPU dan memori diturunkan skalanya ke tingkat rendah.

Alih-alih menyediakan dan mengelola server basis data, Anda menentukan kapasitas basis data. Kapasitas sebenarnya dari setiap penulis atau pembaca tanpa server DocumentDB bervariasi dari waktu ke waktu, tergantung pada beban kerja Anda. Untuk detail tentang mekanisme tersebut, lihat [Penskalaan tanpa server Amazon DocumentDB](#docdb-serverless-scaling).

## Konfigurasi untuk cluster Amazon DocumentDB
<a name="docdb-serverlerss-configuration"></a>

Untuk setiap cluster Amazon DocumentDB Anda, Anda dapat memilih kombinasi kapasitas tanpa server DocumentDB, kapasitas yang disediakan, atau keduanya.

Anda dapat mengatur cluster yang berisi DocumentDB tanpa server dan kapasitas yang disediakan, yang disebut cluster konfigurasi campuran. Misalnya, anggaplah Anda membutuhkan read/write kapasitas lebih dari yang tersedia untuk penulis tanpa server DocumentDB. Dalam hal ini, Anda dapat mengatur klaster dengan penulis terprovisi yang sangat besar. Kemudian Anda masih dapat menggunakan DocumentDB tanpa server untuk pembaca. Atau anggaplah beban kerja tulis untuk klaster Anda bervariasi, tetapi beban kerja baca stabil. Dalam hal ini, Anda dapat mengatur cluster Anda dengan penulis tanpa server DocumentDB dan satu atau lebih pembaca yang disediakan.

Anda juga dapat mengatur cluster di mana semua kapasitas dikelola oleh DocumentDB tanpa server. Untuk melakukan ini, Anda dapat membuat cluster baru dan menggunakan DocumentDB tanpa server dari awal. Atau Anda dapat mengganti semua kapasitas yang disediakan di cluster yang ada dengan DocumentDB tanpa server. Untuk prosedur untuk membuat cluster baru dengan DocumentDB serverless atau untuk mengalihkan cluster yang ada ke DocumentDB serverless, lihat dan. [Membuat cluster yang menggunakan Amazon DocumentDB tanpa server](docdb-serverless-create-cluster.md) [Bermigrasi ke Amazon DocumentDB tanpa server](docdb-serverless-migrating.md)

Jika Anda tidak menggunakan DocumentDB tanpa server sama sekali dalam sebuah cluster, semua penulis dan pembaca di cluster disediakan. Ini adalah jenis cluster yang paling umum yang sebagian besar pengguna akrab dengan. Kapasitas terprovisi bersifat konstan. Biayanya relatif mudah untuk diperkirakan. Namun, Anda harus memprediksi sebelumnya berapa banyak kapasitas yang Anda butuhkan. Dalam beberapa kasus, prediksi Anda mungkin tidak akurat atau kebutuhan kapasitas Anda mungkin berubah. Dalam kasus ini, klaster Anda dapat menjadi underprovisioned (lebih lambat dari yang Anda inginkan) atau overprovisioned (lebih mahal dari yang Anda inginkan).

## Kapasitas penskalaan tanpa server Amazon DocumentDB
<a name="docdb-serverless-scaling-capacity"></a>

Satuan ukuran untuk Amazon DocumentDB serverless adalah DocumentDB Capacity Unit (DCU). Kapasitas penskalaan tanpa server DocumentDB tidak terkait dengan kelas instans yang Anda gunakan untuk klaster yang disediakan.

Setiap DCU adalah kombinasi dari sekitar 2 gibibytes (GiB) memori, CPU yang sesuai, dan jaringan. Anda menentukan rentang kapasitas basis data menggunakan unit ukur ini. Metrik `DCUUtilization` CloudWatch dan `ServerlessDatabaseCapacity` membantu Anda menentukan berapa banyak kapasitas yang sebenarnya digunakan basis data Anda dan di mana kapasitas tersebut berada dalam rentang yang ditentukan.

Setiap saat, setiap penulis atau pembaca tanpa server DocumentDB memiliki kapasitas. Kapasitas adalah angka floating-point yang mewakili. DCUs Kapasitas ini meningkat atau menurun setiap kali penulis atau pembaca diskalakan. Nilai ini diukur setiap detik. Untuk setiap cluster tempat Anda ingin menggunakan DocumentDB tanpa server, Anda menentukan rentang kapasitas: nilai kapasitas minimum dan maksimum yang dapat diskalakan oleh setiap penulis atau pembaca tanpa server DocumentDB. Rentang kapasitasnya sama untuk setiap penulis atau pembaca tanpa server DocumentDB dalam sebuah cluster. Setiap penulis atau pembaca tanpa server DocumentDB memiliki kapasitasnya sendiri, berada di suatu tempat dalam kisaran itu.

DocumentDB serverless didukung pada DocumentDB 5.0.0 saja (tidak didukung pada 8.0) dengan rentang kapasitas 0.5 - 256. DCUs

Kapasitas tanpa server DocumentDB terkecil yang dapat Anda tentukan adalah 0,5. DCUs Anda dapat menentukan angka yang lebih tinggi jika kurang dari atau sama dengan nilai kapasitas maksimum yang didukung. Menyetel kapasitas minimum ke jumlah kecil memungkinkan cluster yang dimuat ringan mengkonsumsi sumber daya komputasi minimal. Pada saat yang sama, klaster tersebut tetap siap untuk menerima koneksi dengan segera dan menaikkan skalanya ketika menjadi sibuk.

Kami merekomendasikan pengaturan minimum ke nilai yang memungkinkan setiap penulis atau pembaca untuk memegang set kerja aplikasi di kolam buffer. Dengan begitu, konten pool buffer tidak dibuang selama periode idle. Untuk semua pertimbangan saat memilih rentang kapasitas penskalaan, lihat. [Memilih rentang kapasitas penskalaan untuk cluster tanpa server DocumentDB](docdb-serverless-scaling-config.md#docdb-serverless-scaling-capacity-choosing)

Bergantung pada bagaimana Anda mengkonfigurasi pembaca dalam penyebaran multi-AZ, kapasitas mereka dapat dikaitkan dengan kapasitas penulis atau secara mandiri. Untuk detail tentang cara melakukannya, lihat [Melihat dan memodifikasi tingkat promosi pembaca tanpa server](docdb-serverless-managing.md#docdb-serverless-promo-tier).

Pemantauan DocumentDB tanpa server melibatkan pengukuran nilai kapasitas untuk penulis dan pembaca di cluster Anda dari waktu ke waktu. Jika basis data Anda tidak menurunkan skalanya ke kapasitas minimum, Anda dapat mengambil tindakan seperti menyesuaikan kapasitas minimum dan mengoptimalkan aplikasi basis data Anda. Jika basis data Anda secara konsisten mencapai kapasitas maksimumnya, Anda dapat mengambil tindakan seperti meningkatkan kapasitas maksimum. Anda juga dapat mengoptimalkan aplikasi basis data Anda dan menyebarkan beban kueri ke lebih banyak pembaca.

Biaya untuk kapasitas tanpa server DocumentDB diukur dalam hal jam DCU. [Untuk informasi tentang cara menghitung biaya tanpa server DocumentDB, lihat harga Amazon DocumentDB.](https://aws.amazon.com//documentdb/pricing) Misalkan jumlah total penulis dan pembaca di cluster Anda adalah n. Dalam hal ini, cluster mengkonsumsi sekitar n x minimum DCUs ketika Anda tidak menjalankan operasi database apa pun. Amazon DocumentDB sendiri mungkin menjalankan operasi pemantauan atau pemeliharaan yang menyebabkan sejumlah kecil beban. Cluster itu mengkonsumsi tidak lebih dari n x maksimum DCUs ketika database berjalan pada kapasitas penuh.

Untuk detail selengkapnya tentang memilih nilai DCU minimum dan maksimum yang sesuai, lihat[Memilih rentang kapasitas penskalaan untuk cluster tanpa server DocumentDB](docdb-serverless-scaling-config.md#docdb-serverless-scaling-capacity-choosing). Nilai DCU minimum dan maksimum yang Anda tentukan juga memengaruhi beberapa batas instans Amazon DocumentDB. Untuk detail tentang interaksi antara rentang kapasitas dan batas instans, lihat[Batas instans tanpa server Amazon DocumentDB](docdb-serverless-instance-limits.md).

## Penskalaan tanpa server Amazon DocumentDB
<a name="docdb-serverless-scaling"></a>

Untuk setiap penulis atau pembaca tanpa server DocumentDB, Amazon DocumentDB terus melacak pemanfaatan sumber daya seperti CPU, memori, dan jaringan. Pengukuran ini secara kolektif disebut beban. Beban mencakup operasi basis data yang dilakukan oleh aplikasi Anda. Ini juga mencakup pemrosesan latar belakang untuk server database dan tugas administratif Amazon DocumentDB. Ketika kapasitas dibatasi oleh salah satu dari ini, DocumentDB tanpa server meningkat. DocumentDB tanpa server juga meningkat ketika mendeteksi masalah kinerja yang dapat diselesaikan dengan melakukannya. Anda dapat memantau pemanfaatan sumber daya dan bagaimana pengaruhnya terhadap penskalaan tanpa server DocumentDB dengan menggunakan prosedur di. [Pemantauan Amazon DocumentDB tanpa server](docdb-serverless-monitoring.md)

Beban dapat bervariasi di seluruh penulis dan pembaca di cluster Anda. Penulis menangani operasi menulis, dan melakukan semua modifikasi data pada volume cluster. Pembaca dapat memproses permintaan hanya-baca.

Scaling adalah operasi yang meningkatkan atau mengurangi kapasitas tanpa server DocumentDB untuk database Anda. Dengan DocumentDB tanpa server, setiap penulis dan pembaca memiliki nilai kapasitasnya sendiri saat ini, diukur dalam. DCUs DocumentDB tanpa server menskalakan penulis atau pembaca hingga kapasitas yang lebih tinggi ketika kapasitas saat ini terlalu rendah untuk menangani beban. Operasi ini menurunkan skala penulis atau pembaca ke kapasitas yang lebih rendah ketika kapasitas saat ini lebih tinggi dari yang dibutuhkan.

DocumentDB tanpa server dapat meningkatkan kapasitas secara bertahap. Ketika permintaan beban kerja Anda mulai mencapai kapasitas database penulis atau pembaca saat ini, DocumentDB tanpa server meningkatkan jumlah DCUs untuk penulis atau pembaca itu. DocumentDB tanpa server menskalakan kapasitas dalam peningkatan yang diperlukan untuk memberikan kinerja terbaik bagi sumber daya yang dikonsumsi. Penskalaan terjadi secara bertahap sekecil 0,5. DCUs Semakin besar kapasitas saat ini, semakin besar inkremen penskalaan dan akibatnya semakin cepat penskalaan dapat terjadi.

Karena penskalaan tanpa server DocumentDB sangat sering, terperinci, dan tidak mengganggu, itu tidak menyebabkan peristiwa diskrit di file. Konsol Manajemen AWS Sebagai gantinya, Anda dapat mengukur CloudWatch metrik Amazon seperti `serverlessDatabaseCapacity` dan`DCUUtilization`, dan melacak nilai minimum, maksimum, dan rata-ratanya dari waktu ke waktu. Untuk mempelajari selengkapnya tentang pemantauan DocumentDB tanpa server, lihat. [Pemantauan Amazon DocumentDB tanpa server](docdb-serverless-monitoring.md)

Penskalaan naik atau turun dapat disebabkan oleh hal-hal berikut:
+ Pemanfaatan memori
+ Penggunaan CPU
+ Penggunaan jaringan
+ Pemanfaatan penyimpanan

Anda dapat memantau penyebab penskalaan ini up/down pada instance tanpa server DocumentDB. Untuk informasi selengkapnya, lihat [Pemantauan Amazon DocumentDB tanpa server](docdb-serverless-monitoring.md).

Anda dapat memilih untuk membuat pembaca diskalakan pada saat yang sama dengan penulis terkait, atau secara independen dari penulis. Anda dapat melakukannya dengan menentukan tingkat promosi untuk pembaca tersebut.
+ Pembaca tanpa server DocumentDB, dalam tingkatan promosi 0 dan 1, skala pada saat yang sama dengan penulis. Perilaku penskalaan tersebut membuat pembaca di tingkat prioritas 0 dan 1 cocok untuk mendukung ketersediaan. Hal ini karena pembaca tersebut selalu diatur ukurannya sesuai dengan kapasitas yang tepat untuk mengambil alih beban kerja dari penulis jika terjadi failover.
+ Pembaca di tingkat promosi 2–15 akan diskalakan secara independen dari penulis. Setiap pembaca tetap berada dalam nilai DCU minimum dan maksimum yang Anda tentukan untuk cluster Anda. Ketika pembaca diskalakan secara independen dari DB penulis terkait, pembaca tersebut bisa menjadi idle dan menurunkan skalanya sementara penulis terus memproses volume transaksi yang tinggi. Pembaca tersebut masih tersedia sebagai target failover jika tidak ada pembaca lain yang tersedia di tingkat promosi yang lebih rendah. Namun, jika dipromosikan menjadi penulis, pembaca tersebut mungkin perlu dinaikkan skalanya untuk menangani beban kerja penuh dari penulis.

Untuk detail tentang melihat dan mengubah tingkatan promosi instans tanpa server, lihat. [Melihat dan memodifikasi tingkat promosi pembaca tanpa server](docdb-serverless-managing.md#docdb-serverless-promo-tier)

Penskalaan tanpa server DocumentDB dapat terjadi saat koneksi database terbuka, saat transaksi sedang dalam proses, dll. DocumentDB tanpa server tidak menunggu titik tenang untuk memulai penskalaan. Penskalaan tidak mengganggu operasi basis data apa pun yang sedang berlangsung.

Jika beban kerja Anda membutuhkan lebih banyak kapasitas baca daripada yang tersedia dengan satu penulis dan satu pembaca, Anda dapat menambahkan beberapa pembaca tanpa server DocumentDB ke cluster. Setiap pembaca tanpa server DocumentDB dapat menskalakan dalam kisaran nilai kapasitas minimum dan maksimum yang Anda tentukan untuk klaster Anda. Anda dapat menggunakan titik akhir pembaca klaster untuk mengarahkan sesi hanya baca ke pembaca dan mengurangi beban pada penulis.

Apakah DocumentDB tanpa server melakukan penskalaan, dan seberapa cepat penskalaan terjadi begitu dimulai, juga tergantung pada pengaturan DCU minimum dan maksimum untuk cluster. Selain itu, hal tersebut bergantung pada apakah pembaca dikonfigurasi untuk diskalakan bersama dengan penulis atau secara independen. Untuk detail tentang konfigurasi penskalaan, lihat[Konfigurasi penskalaan tanpa server Amazon DocumentDB](docdb-serverless-scaling-config.md).

## Keadaan menganggur (0,5 DCUs)
<a name="docdb-serverlerss-idle-state"></a>

Saat Amazon DocumentDB penulis atau pembaca tanpa server menganggur, instance tanpa server DocumentDB mendukung penskalaan ke status idle 0,5 jika cluster dikonfigurasi menjadi 0,5. DCUs MinCapacity 

Dalam keadaan idle, instance tanpa server DocumentDB tidak memiliki kapasitas komputasi CPU yang memadai untuk mendukung sebagian besar beban kerja produksi, tetapi siap untuk ditingkatkan dengan cepat untuk mendukung beban kerja baru. Dalam keadaan non-idle, instance tanpa server DocumentDB biasanya memerlukan setidaknya 1,0 - 2,5. DCUs Oleh karena itu, ketika instance tanpa server DocumentDB meningkat dari status idle ke status non-idle, mereka akan menskalakan langsung ke 1,0 - DCUs 2,5 (atau nilai jika lebih rendah). MaxCapacity 

Untuk mendukung penskalaan ke 0,5 DCUs saat idle, batas instance dibatasi jika MinCapacity dikonfigurasi menjadi kurang dari atau sama dengan 1,0. DCUs Untuk informasi selengkapnya tentang bagaimana batas dipengaruhi oleh MinCapacity konfigurasi, lihat[Batas instans tanpa server Amazon DocumentDB](docdb-serverless-instance-limits.md).

# Persyaratan dan batasan untuk DocumentDB tanpa server
<a name="docdb-serverless-limitations"></a>

## Persyaratan fitur
<a name="w2aac41c15b3"></a>

### Ketersediaan wilayah
<a name="w2aac41c15b3b3"></a>

Jenis instans tanpa server Amazon DocumentDB tersedia di wilayah berikut:

 AWS CLI Perintah berikut dapat digunakan untuk memverifikasi opsi instance tanpa server DocumentDB yang ditawarkan di wilayah tertentu:

```
aws docdb describe-orderable-db-instance-options \
        --region my_region \
        --db-instance-class db.serverless \
        --engine docdb
```

### Ketersediaan versi mesin
<a name="w2aac41c15b3b5"></a>

DocumentDB tanpa server hanya didukung oleh versi mesin Amazon DocumentDB 5.0.0. Ini tidak tersedia pada versi mesin 3.6, 4.0, atau 8.0.

**catatan**  
DocumentDB tanpa server hanya didukung pada versi patch 5.0.0 yang lebih baru. Pastikan klaster Anda diperbarui ke versi patch mesin terbaru. Untuk informasi selengkapnya tentang memelihara klaster Amazon DocumentDB, lihat [Memelihara Amazon DocumentDB](db-instance-maintain.md)

### Konfigurasi klaster
<a name="w2aac41c15b3b7"></a>

Sebelum menambahkan instance tanpa server Amazon DocumentDB ke cluster Amazon DocumentDB, cluster juga harus memiliki parameter yang ditetapkan. `ServerlessV2ScalingConfiguration` Ini mendefinisikan rentang kapasitas instance tanpa server DocumentDB di cluster. Untuk informasi selengkapnya tentang konfigurasi penskalaan, lihat[Konfigurasi penskalaan tanpa server Amazon DocumentDB](docdb-serverless-scaling-config.md).

### Pengaturan rentang kapasitas penskalaan minimum untuk fitur Amazon DocumentDB tertentu
<a name="w2aac41c15b3b9"></a>

Beberapa fitur Amazon DocumentDB bekerja dengan DocumentDB tanpa server, tetapi dapat menyebabkan masalah jika rentang kapasitas Anda lebih rendah dari yang dibutuhkan untuk persyaratan memori untuk fitur tersebut dengan beban kerja spesifik Anda. Dalam hal ini, database Anda mungkin tidak berfungsi sebaik biasanya, atau mungkin mengalami out-of-memory kesalahan.

Fitur-fitur berikut memerlukan konfigurasi `MinCapacity` and/or `MaxCapacity` nilai yang lebih tinggi untuk operasi terbaik:
+ Wawasan Performa
+ Cluster global (hanya berlaku untuk primer Wilayah AWS)
+ Pembuatan instance tanpa server pada cluster dengan volume data yang besar

  Ini termasuk pembuatan instance tanpa server sebagai bagian dari pemulihan cluster.

Untuk rekomendasi tentang pengaturan rentang kapasitas yang sesuai (jika Anda menggunakan fitur ini), lihat[Memilih rentang kapasitas penskalaan untuk cluster tanpa server DocumentDB](docdb-serverless-scaling-config.md#docdb-serverless-scaling-capacity-choosing). Untuk informasi pemecahan masalah jika database Anda menemukan out-of-memory kesalahan karena rentang kapasitas yang salah dikonfigurasi, lihat. [Menghindari out-of-memory kesalahan](docdb-serverless-scaling-config.md#docdb-serverless-scaling-mem-errors)

# Membuat cluster yang menggunakan Amazon DocumentDB tanpa server
<a name="docdb-serverless-create-cluster"></a>



## Membuat cluster tanpa server Amazon DocumentDB
<a name="w2aac41c17b5"></a>

Dengan Amazon DocumentDB tanpa server, cluster Anda dapat dipertukarkan dengan cluster yang disediakan. Anda dapat memiliki cluster di mana beberapa instance menggunakan tanpa server dan beberapa instance disediakan.

Verifikasi bahwa wilayah dan versi engine yang Anda inginkan mendukung DocumentDB tanpa server. Lihat [Persyaratan dan batasan untuk DocumentDB tanpa server](docdb-serverless-limitations.md).

Untuk membuat klaster Amazon DocumentDB tempat Anda dapat menambahkan instance tanpa server, ikuti prosedur yang sama seperti di. [Membuat cluster Amazon DocumentDB](db-cluster-create.md) Satu-satunya perbedaan adalah bahwa `ServerlessV2ScalingConfiguration` argumen juga harus disediakan.

`ServerlessV2ScalingConfiguration`Argumen menentukan rentang kapasitas penskalaan instance tanpa server DocumentDB Anda. Ini terdiri dari nilai unit kapasitas DocumentDB (DCU) minimum dan maksimum yang berlaku untuk semua instance tanpa server DocumentDB di cluster:
+ `MinCapacity`Nilai menentukan kapasitas penskalaan minimum.
+ `MaxCapacity`Nilai menentukan kapasitas penskalaan maksimum.

Untuk informasi selengkapnya tentang penskalaan, lihat [Konfigurasi penskalaan tanpa server Amazon DocumentDB](docdb-serverless-scaling-config.md).

------
#### [ Using the Konsol Manajemen AWS ]

Contoh Konsol Manajemen AWS konfigurasi berikut menunjukkan cara membuat cluster tanpa server DocumentDB.

1. Masuk ke [Konsol Manajemen AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)dan buka konsol Amazon DocumentDB.

1. Di panel navigasi, pilih **Klaster**.
**Tip**  
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di pojok kiri atas halaman.

   Tabel **Clusters** muncul.

1. Pilih **Buat**.

   Halaman cluster **Create Amazon DocumentDB muncul**.

1. Pada halaman cluster Create Amazon DocumentDB, di bagian tipe **Cluster, pilih cluster** **berbasis Instance** (ini adalah opsi default).

1. Di bagian **konfigurasi Cluster**:

   1. Untuk **pengidentifikasi Cluster**, masukkan nama unik, seperti**myserverlesscluster**. Perhatikan bahwa konsol akan mengubah semua nama cluster menjadi huruf kecil terlepas dari bagaimana mereka dimasukkan.

   1. Untuk **versi Engine**, pilih **5.0.0** (ini adalah opsi default).

1. Di bagian **konfigurasi penyimpanan Cluster**, pilih **Amazon DocumentDB** Standard (ini adalah opsi default).
**catatan**  
Opsi lain dalam kategori ini adalah **Amazon DocumentDB I/O-Optimized**. Untuk mempelajari lebih lanjut tentang salah satu opsi, lihat [Konfigurasi penyimpanan klaster Amazon DocumentDB](db-cluster-storage-configs.md)

1. Di bagian **konfigurasi Instans**:

   1. Untuk **Kelas instans DB**, pilih **Nirserver**.

   1. Untuk **Jumlah contoh replika biasa**, pilih **3** (ini adalah opsi default).

   1. Di bagian **Rentang kapasitas**, biarkan nilai default untuk **Minimum DCUs** dan **Maksimum DCUs**. Untuk informasi tentang pengaturan parameter ini, lihat[Batas instans tanpa server Amazon DocumentDB](docdb-serverless-instance-limits.md).  
![\[Formulir konfigurasi untuk cluster database tanpa server dengan bidang untuk kelas contoh, instance replika, dan rentang kapasitas.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/instance-config-serverless.png)

1. Di bagian **Konektivitas**, biarkan pengaturan default **Jangan sambungkan ke sumber daya komputasi EC2**.

1. Di bagian **Autentikasi**, masukkan nama pengguna untuk pengguna utama, lalu pilih **Self managed**. Masukkan kata sandi, lalu konfirmasikan.

   Jika Anda memilih **Managed in AWS Secrets Manager**, lihat [Manajemen kata sandi dengan Amazon DocumentDB dan AWS Secrets Manager](docdb-secrets-manager.md) untuk informasi selengkapnya.

1. Biarkan semua opsi lain sebagai default dan pilih **Buat cluster**.

------
#### [ Using the AWS CLI ]

Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi atau parameter konfigurasi Anda sendiri.

Untuk membuat cluster yang kompatibel dengan instance tanpa server DocumentDB menggunakan, lihat. AWS CLI[Membuat cluster menggunakan AWS CLI](db-cluster-create.md#db-cluster-create-cli)

Sertakan parameter tambahan berikut dalam `create-db-cluster` perintah Anda:

```
--serverless-v2-scaling-configuration 
     MinCapacity=minimum_capacity,MaxCapacity=maximum_capacity
```

Contoh:

```
aws docdb create-db-cluster \
      --db-cluster-identifier sample-cluster \
      --engine docdb \
      --engine-version 5.0.0 \
      --serverless-v2-scaling-configuration MinCapacity=0.5,MaxCapacity=16 \
      --master-username user-name \
      --master-user-password password
```

------

## Menambahkan instance tanpa server Amazon DocumentDB
<a name="docdb-serverless-adding-instance"></a>

Untuk menambahkan instance tanpa server DocumentDB, ikuti prosedur yang sama [Menambahkan instance Amazon DocumentDB ke klaster](db-instance-add.md) di, pastikan untuk menentukan db.serverless sebagai kelas instance.

### Menambahkan instance tanpa server menggunakan file. Konsol Manajemen AWS
<a name="w2aac41c17b7b5"></a>

**Untuk menambahkan instance tanpa server DocumentDB menggunakan konsol, [Menambahkan instance Amazon DocumentDB ke klaster](db-instance-add.md) lihat dan pilih Menggunakan tab. Konsol Manajemen AWS**

### Menambahkan instance tanpa server menggunakan AWS CLI
<a name="w2aac41c17b7b7"></a>

**Untuk menambahkan instance tanpa server DocumentDB menggunakan, [Menambahkan instance Amazon DocumentDB ke klaster](db-instance-add.md) lihat dan pilih Menggunakan AWS CLI tab. AWS CLI**

Gunakan argumen CLI kelas contoh berikut:

```
--db-instance-class db.serverless
```

Contoh:

```
aws docdb create-db-instance \
      --db-cluster-identifier sample-cluster \
      --db-instance-identifier sample-instance \
      --db-instance-class db.serverless \
      --engine docdb
```

# Bermigrasi ke Amazon DocumentDB tanpa server
<a name="docdb-serverless-migrating"></a>

**Topics**
+ [Migrasi cluster DocumentDB yang ada ke tanpa server](#w2aac41c19b5)
+ [Migrasi dari MongoDB ke DocumentDB tanpa server](#w2aac41c19b7)

## Migrasi cluster DocumentDB yang ada ke tanpa server
<a name="w2aac41c19b5"></a>

### Memutakhirkan versi mesin cluster
<a name="w2aac41c19b5b3"></a>

Jika klaster yang disediakan menjalankan versi engine yang lebih rendah yang tidak mendukung DocumentDB tanpa server, Anda harus terlebih dahulu memutakhirkan klaster ke versi engine yang didukung. Untuk informasi selengkapnya, lihat [Peningkatan versi utama Amazon DocumentDB di tempat](docdb-mvu.md).

### Migrasi cluster yang disediakan ke DocumentDB tanpa server
<a name="docdb-serverless-migrate-cluster"></a>

Untuk mengganti klaster yang disediakan agar menggunakan DocumentDB tanpa server, ikuti langkah-langkah berikut:

1. Periksa apakah versi engine cluster yang disediakan perlu ditingkatkan untuk digunakan dengan DocumentDB tanpa server. Lihat [Persyaratan dan batasan untuk DocumentDB tanpa server](docdb-serverless-limitations.md).
**catatan**  
Jika klaster yang disediakan menjalankan versi engine yang tidak tersedia untuk DocumentDB tanpa server, tingkatkan versi mesin cluster. Lihat [Peningkatan versi utama Amazon DocumentDB di tempat](docdb-mvu.md).

1. Konfigurasikan konfigurasi penskalaan untuk klaster. Untuk detail tentang memilih konfigurasi penskalaan, lihat[Memilih rentang kapasitas penskalaan untuk cluster tanpa server DocumentDB](docdb-serverless-scaling-config.md#docdb-serverless-scaling-capacity-choosing). Untuk memodifikasi konfigurasi penskalaan klaster, lihat[Melihat dan memodifikasi konfigurasi rentang kapasitas penskalaan klaster](docdb-serverless-managing.md#docdb-serverless-range-config).

1. Konfigurasikan properti cluster lainnya untuk memperhitungkan persyaratan dan batasan tanpa server DocumentDB. [Persyaratan dan batasan untuk DocumentDB tanpa server](docdb-serverless-limitations.md)

1. Tambahkan satu atau beberapa instance tanpa server DocumentDB ke cluster. Ikuti prosedur di [Menambahkan instance tanpa server Amazon DocumentDB](docdb-serverless-create-cluster.md#docdb-serverless-adding-instance).
**catatan**  
Dalam beberapa kasus, Anda mungkin sudah memiliki satu atau lebih instance pembaca yang disediakan di cluster. Jika demikian, Anda dapat memilih untuk mengonversi salah satu pembaca ke instance tanpa server DocumentDB alih-alih membuat instance baru. Untuk melakukannya, ikuti prosedurnya di [Mengubah kelas instance](db-instance-classes.md#db-instance-class-changing).

1. (Opsional) Lakukan operasi failover untuk menjadikan instance tanpa server DocumentDB sebagai penulis cluster. Lihat [Failover Amazon DocumentDB](failover.md).

1. (Opsional) Konversi instans Amazon DocumentDB yang tersisa yang disediakan ke instance [Mengubah kelas instance](db-instance-classes.md#db-instance-class-changing) tanpa server DocumentDB (lihat) atau hapus dari cluster (lihat). [Menghapus instans Amazon DocumentDB](db-instance-delete.md)

------
#### [ Using the Konsol Manajemen AWS ]

Contoh Konsol Manajemen AWS konfigurasi berikut menunjukkan proses migrasi menggunakan kluster yang disediakan Amazon DocumentDB yang menjalankan Amazon DocumentDB 5.0.0, yang tidak memerlukan upgrade versi engine untuk mulai menggunakan DocumentDB tanpa server. Cluster diberi nama`sample`, dan dimulai dengan tiga instance yang disediakan bernama`sample`,, `sample2` dan. `sample3` Dalam contoh ini, ketiga instance ini akan digantikan oleh tiga instance tanpa server.

1. Masuk ke [Konsol Manajemen AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)dan buka konsol Amazon DocumentDB.

1. Di panel navigasi, pilih **Klaster**.
**Tip**  
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di pojok kiri atas halaman.

   Tabel **Clusters** muncul.

1. Dalam tabel **Clusters**, pilih kotak centang cluster yang ingin Anda tambahkan instance tanpa server.

1. Pilih **Tindakan**, dan kemudian pilih **Tambahkan instans**.

1. Dalam kotak dialog **Add instance**, pilih **Tanpa Server** di bagian **kelas instans DB untuk setiap instance** tanpa server baru yang ingin Anda buat.

1. Untuk **pengaturan kapasitas tanpa server**, atur konfigurasi penskalaan berdasarkan deskripsi kapasitas di kotak dialog.

1. (Opsional) Untuk menambahkan contoh lain, pilih **Tambahkan instance**. Lanjutkan menambahkan instance hingga Anda mencapai jumlah instans baru yang diinginkan.

   Dalam contoh ini, tiga instance tanpa server baru dibuat.

1. Pilih **Buat**.

   Dibutuhkan beberapa menit untuk membuat sebuah instans. Anda dapat menggunakan konsol atau AWS CLI untuk melihat status instans. Untuk informasi selengkapnya, lihat [Memantau Status Cluster Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/monitoring_docdb-cluster_status.html).

1. Kembali ke tabel **Clusters**, pilih kotak centang dari ketiga instance asli yang disediakan.

1. Pilih **Tindakan**, lalu pilih **Hapus**.

Selama penghapusan, failover secara otomatis dilakukan untuk mempromosikan salah satu contoh yang tersisa untuk menjadi penulis. Setelah beberapa menit, proses penghapusan selesai. **Cluster yang ada sekarang berisi tiga instance tanpa server DocumentDB (seperti yang didefinisikan dalam kolom Ukuran).**

------
#### [ Using the AWS CLI ]

Contoh AWS CLI konfigurasi berikut menunjukkan proses migrasi menggunakan kluster yang disediakan Amazon DocumentDB yang menjalankan Amazon DocumentDB 5.0.0, yang tidak memerlukan upgrade versi engine untuk mulai menggunakan DocumentDB tanpa server. Cluster diberi nama`sample`, dan dimulai dengan tiga instance yang disediakan bernama`sample`,, `sample2` dan. `sample3` Dalam contoh ini, ketiga instance ini akan digantikan oleh tiga instance tanpa server. Cluster diberi nama`sample-cluster`, dan dimulai dengan dua instance yang disediakan bernama `sample-provisioned-instance-1` dan`sample-provisioned-instance-2`, instance penulis dan instance pembaca.

Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi atau parameter konfigurasi Anda sendiri.

Gunakan `aws docdb describe-db-clusters` operasi untuk menentukan status cluster. Kode berikut menemukan status cluster `sample-cluster` dan output hasil dalam tabel:

```
aws docdb describe-db-clusters \
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[*].DBClusterMembers' \
    --output table
```

```
--------------------------------------------------------------------------------------------------------
|                                          DescribeDBClusters                                          |
+--------------------------------+---------------------------------+------------------+----------------+
|  DBClusterParameterGroupStatus |      DBInstanceIdentifier       | IsClusterWriter  | PromotionTier  |
+--------------------------------+---------------------------------+------------------+----------------+
|  in-sync                       |  sample-provisioned-instance-2  |  False           |  1             |
|  in-sync                       |  sample-provisioned-instance-1  |  True            |  1             |
+--------------------------------+---------------------------------+------------------+----------------+
```

Tambahkan konfigurasi penskalaan untuk cluster:

```
aws docdb modify-db-cluster \
    --db-cluster-identifier sample-cluster \
    --serverless-v2-scaling-configuration MinCapacity=0.5,MaxCapacity=16
```

Tambahkan instance tanpa server. Dalam contoh ini, instance tanpa server baru bernama `sample-serverless-instance-1` dan `sample-serverless-instance-2` ditambahkan:

```
aws docdb create-db-instance \
    --db-cluster-identifier sample-cluster \
    --db-instance-identifier sample-serverless-instance-1 \
    --db-instance-class db.serverless \
    --engine docdb

aws docdb create-db-instance \
    --db-cluster-identifier sample-cluster \
    --db-instance-identifier sample-serverless-instance-2 \
    --db-instance-class db.serverless \
    --engine docdb
```

Masukkan yang berikut ini untuk menunggu instans tanpa server tersedia sebelum melanjutkan:

```
aws docdb wait db-instance-available \
    --db-instance-identifier sample-serverless-instance-1

aws docdb wait db-instance-available \
    --db-instance-identifier sample-serverless-instance-2
```

Lakukan failover untuk menjadikan `sample-serverless-instance-1` instance baru sebagai penulis cluster:

```
aws docdb failover-db-cluster \
    --db-cluster-identifier sample-cluster \
    --target-db-instance-identifier sample-serverless-instance-1
```

Failover membutuhkan beberapa detik untuk menyelesaikannya, setelah itu sample-serverless-instance -1 menjadi penulis cluster. Verifikasi ini dengan masukan berikut:

```
aws docdb describe-db-clusters \
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[*].DBClusterMembers' \
    --output table
```

```
--------------------------------------------------------------------------------------------------------
|                                          DescribeDBClusters                                          |
+--------------------------------+---------------------------------+------------------+----------------+
|  DBClusterParameterGroupStatus |      DBInstanceIdentifier       | IsClusterWriter  | PromotionTier  |
+--------------------------------+---------------------------------+------------------+----------------+
|  in-sync                       |  sample-provisioned-instance-2  |  False           |  1             |
|  in-sync                       |  sample-provisioned-instance-1  |  False           |  1             |
|  in-sync                       |  sample-serverless-instance-2   |  False           |  1             |
|  in-sync                       |  sample-serverless-instance-1   |  True            |  1             |
+--------------------------------+---------------------------------+------------------+----------------+
```

Terakhir, hapus instance asli yang disediakan:

```
aws docdb delete-db-instance \
    --db-instance-identifier sample-provisioned-instance-1

aws docdb delete-db-instance \
    --db-instance-identifier sample-provisioned-instance-2
```

------

## Migrasi dari MongoDB ke DocumentDB tanpa server
<a name="w2aac41c19b7"></a>

Anda dapat memigrasikan database MongoDB Anda ke DocumentDB tanpa server, seperti halnya Amazon DocumentDB yang disediakan. Untuk informasi selengkapnya, lihat [Migrasi ke Amazon DocumentDB](docdb-migration.md).

# Mengelola Amazon DocumentDB tanpa server
<a name="docdb-serverless-managing"></a>

## Melihat dan memodifikasi konfigurasi rentang kapasitas penskalaan klaster
<a name="docdb-serverless-range-config"></a>

`ServerlessV2ScalingConfiguration`Argumen menentukan rentang kapasitas penskalaan instance tanpa server DocumentDB Anda. Ini terdiri dari nilai unit kapasitas DocumentDB minimum dan maksimum (DCU) yang berlaku untuk semua instance tanpa server DocumentDB di cluster.
+ **`MinCapacity`**- Kapasitas penskalaan minimum dari setiap instance tanpa server DocumentDB di cluster.
+ **`MaxCapacity`**- Kapasitas penskalaan maksimum dari setiap instance tanpa server DocumentDB di cluster.

**catatan**  
Modifikasi konfigurasi penskalaan berikut memerlukan instans restart untuk mencerminkan `MaxCapacity` nilai baru `MinCapacity` dan:  
Setiap perubahan pada `MaxCapacity` nilai
Mengubah `MinCapacity` nilai menjadi 1,0 atau lebih rendah dari nilai yang lebih tinggi
Mengubah `MinCapacity` nilai menjadi lebih besar dari 1,0 dari nilai yang lebih rendah

Untuk informasi selengkapnya tentang konfigurasi penskalaan dan cara memilih batas kapasitas penskalaan yang sesuai, lihat. [Konfigurasi penskalaan tanpa server Amazon DocumentDB](docdb-serverless-scaling-config.md)

------
#### [ Using the Konsol Manajemen AWS ]

Contoh Konsol Manajemen AWS konfigurasi berikut menunjukkan cara melihat dan mengedit pengaturan konfigurasi penskalaan cluster tanpa server DocumentDB.

1. Masuk ke [Konsol Manajemen AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)dan buka konsol Amazon DocumentDB.

1. Di panel navigasi, pilih **Klaster**.
**Tip**  
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di pojok kiri atas halaman.

   Tabel **Clusters** muncul.

1. Dalam tabel **Clusters**, pilih kotak centang cluster yang ingin Anda ubah kapasitas penskalaan.

1. Pilih **Tindakan**, dan kemudian pilih **Modifikasi**.

   Kotak dialog **Modify cluster** muncul.

1. Temukan bagian **pengaturan kapasitas tanpa server** dan atur konfigurasi penskalaan (**Rentang kapasitas**) berdasarkan deskripsi kapasitas di kotak dialog.

   Untuk informasi selengkapnya tentang penskalaan dan rentang kapasitas, lihat[Konfigurasi penskalaan tanpa server Amazon DocumentDB](docdb-serverless-scaling-config.md).

1. Pilih **Lanjutkan**.

1. Untuk **Penjadwalan perubahan**, pilih **Terapkan langsung**.

1. Pilih **Ubah klaster**.

1. Setelah modifikasi selesai, setiap instance tanpa server harus di-boot ulang. Untuk meminimalkan ketidaktersediaan penulis, lakukan urutan operasi berikut:

   1. Reboot setiap instance pembaca tanpa server.

      1. Pilih instance pembaca, pilih **Actions**, dan kemudian **Reboot**.

      1. Tunggu status instance kembali ke **Tersedia**.

   1. Lakukan failover ke instance tanpa server yang di-boot ulang.

      1. Pilih cluster, pilih **Tindakan**, dan kemudian **Failover**.

      1. Tunggu hingga operasi failover selesai.

   1. Reboot instance tanpa server yang tersisa.

      1. Pilih instance yang tersisa, pilih **Actions**, dan kemudian **Reboot**.

      1. Tunggu status instance kembali ke **Tersedia**.

------
#### [ Using the AWS CLI ]

Contoh AWS CLI konfigurasi berikut menunjukkan konfigurasi penskalaan saat ini.

Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi atau parameter konfigurasi Anda sendiri.

Konfigurasi penskalaan cluster saat ini dapat dilihat menggunakan `describe-db-clusters` AWS CLI perintah:

```
aws docdb describe-db-clusters \
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[0].ServerlessV2ScalingConfiguration'
```

Berikut ini adalah output dari perintah ini:

```
{
    "MinCapacity": 0.5,
    "MaxCapacity": 16.0
}
```

Konfigurasi penskalaan cluster dapat dimodifikasi menggunakan `modify-db-cluster` perintah:

```
aws docdb modify-db-cluster \
    --db-cluster-identifier sample-cluster \
    --serverless-v2-scaling-configuration MinCapacity=0.5,MaxCapacity=32
```

Setelah selesai, setiap instance tanpa server harus di-boot ulang. Untuk meminimalkan ketidaktersediaan penulis, kami dapat melakukan urutan operasi berikut:

```
aws docdb reboot-db-instance \
    --db-instance-identifier sample-serverless-instance-reader

aws docdb wait db-instance-available \
    --db-instance-identifier sample-serverless-instance-reader

aws docdb failover-db-cluster \
   --db-cluster-identifier sample-cluster \
   --target-db-instance-identifier sample-serverless-instance-reader

aws docdb reboot-db-instance \
    --db-instance-identifier sample-serverless-instance-writer

aws docdb wait db-instance-available \
    --db-instance-identifier sample-serverless-instance-writer

aws docdb failover-db-cluster \
   --db-cluster-identifier sample-cluster \
   --target-db-instance-identifier sample-serverless-instance-writer
```

------

## Melihat dan memodifikasi tingkat promosi pembaca tanpa server
<a name="docdb-serverless-promo-tier"></a>

Untuk cluster yang berisi beberapa instance tanpa server DocumentDB atau campuran instance yang disediakan dan tanpa server, perhatikan pengaturan tingkat promosi untuk setiap instans tanpa server. Setelan ini mengontrol lebih banyak perilaku untuk instance tanpa server daripada instance yang disediakan.

Untuk instance yang disediakan, pilihan tier 0—15 hanya menentukan urutan Amazon DocumentDB memilih instance pembaca mana yang akan dipromosikan kepada penulis selama operasi failover. Namun, untuk instance tanpa server, nomor tingkatan juga menentukan apakah instans menskalakan agar sesuai dengan kapasitas instance penulis atau menskalakan secara independen berdasarkan beban kerjanya sendiri. Instans pembaca tanpa server di tingkat 0 atau 1 disimpan pada kapasitas minimum setidaknya setinggi instance penulis. Dengan begitu, mereka siap untuk mengambil alih dari contoh penulis jika terjadi kegagalan. Jika instance writer adalah instance yang disediakan, Amazon DocumentDB memperkirakan kapasitas tanpa server DocumentDB yang setara. Ini menggunakan estimasi itu sebagai kapasitas minimum untuk instance pembaca tanpa server.

Instance pembaca tanpa server DocumentDB di tingkatan 2-15 tidak memiliki batasan yang sama pada kapasitas minimumnya. Ketika mereka menganggur, mereka dapat menurunkan ke nilai unit kapasitas DocumentDB minimum (DCU) yang ditentukan dalam rentang kapasitas cluster.

------
#### [ Using the Konsol Manajemen AWS ]

Contoh Konsol Manajemen AWS konfigurasi berikut menunjukkan cara melihat dan memodifikasi setelan tingkat promosi pembaca instans tanpa server DocumentDB.

1. Masuk ke [Konsol Manajemen AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)dan buka konsol Amazon DocumentDB.

   Tingkatan promosi setiap instans ditampilkan di kolom **Tingkat Promosi** di. Konsol Manajemen AWS

1. Di panel navigasi, pilih **Klaster**.
**Tip**  
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di pojok kiri atas halaman.

   Tabel **Clusters** muncul.

1. Di tabel **Clusters**, pilih kotak centang instance yang ingin Anda ubah tingkatan promosi.

1. Pilih **Tindakan**, dan kemudian pilih **Modifikasi**.

   Kotak dialog **Modify instance** muncul.

1. Temukan bagian **Failover** dan atur **tingkat Promosi** ke level yang diinginkan.

1. Pilih **Lanjutkan**.

1. Untuk **Penjadwalan perubahan**, pilih **Terapkan langsung**.

1. Pilih **Ubah instans**.

------
#### [ Using the AWS CLI ]

Contoh AWS CLI konfigurasi berikut menunjukkan konfigurasi penskalaan saat ini.

Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi atau parameter konfigurasi Anda sendiri.

Tingkatan promosi dari semua instance dalam sebuah cluster dapat dilihat menggunakan perintah: `describe-db-clusters` AWS CLI 

```
aws docdb describe-db-clusters \
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[0].DBClusterMembers' \
    --output table
```

Berikut ini adalah output dari perintah ini:

```
--------------------------------------------------------------------------------------------------------
|                                          DescribeDBClusters                                          |
+--------------------------------+---------------------------------+------------------+----------------+
|  DBClusterParameterGroupStatus |      DBInstanceIdentifier       | IsClusterWriter  | PromotionTier  |
+--------------------------------+---------------------------------+------------------+----------------+
|  in-sync                       |  sample-serverless-instance-2   |  False           |  1             |
|  in-sync                       |  sample-serverless-instance-1   |  True            |  1             |
+--------------------------------+---------------------------------+------------------+----------------+
```

Tingkat promosi dari instance tertentu dapat dimodifikasi menggunakan `modify-db-instance` perintah:

```
aws docdb modify-db-instance \
    --db-instance-identifier sample-serverless-instance-2 \
    --promotion-tier 3
```

------

# Batas instans tanpa server Amazon DocumentDB
<a name="docdb-serverless-instance-limits"></a>

Untuk instance tanpa server DocumentDB, batas berikut per instance bergantung pada kapasitas penskalaan instans saat ini:
+ Memori Instans (GiB)
+ Koneksi (semua)
+ Batas Kursor
+ Buka Transaksi
+ Koneksi (aktif)

Tabel berikut menjelaskan bagaimana skala batas per instance tanpa server dalam kaitannya dengan kapasitas penskalaan instans saat ini.

Perhatikan bahwa nilai batas berbeda tergantung pada apakah konfigurasi `MinCapacity` penskalaan cluster telah disetel ke lebih besar dari dua (2). Jika `MinCapacity` diatur ke kurang dari atau sama dengan 2, maka nilai batas untuk batas kursor, transaksi terbuka, dan koneksi (aktif) dibatasi ke nilai maksimum yang lebih rendah. (Alasan teknis untuk cap adalah untuk mendukung penskalaan ke status “idle”. Untuk informasi selengkapnya, lihat [Keadaan menganggur (0,5 DCUs)](docdb-serverless-how-it-works.md#docdb-serverlerss-idle-state).

**db.serverless instance membatasi jika ≤1 MinCapacity **


| Kapasitas Saat Ini (DCU) | Memori Instans (GiB) | Koneksi (semua) | Batas Kursor | Buka Transaksi | Koneksi (aktif) | 
| --- | --- | --- | --- | --- | --- | 
|  0,5  |  1  |  250  |  6  |  12  |  39  | 
|  1  |  2  |  500  |  12  |  24  |  79  | 
|  2  |  4  |  1000  |  24  |  48  |  173  | 
|  4  |  8  |  2000  |  48  |  96  |  416  | 
|  8  |  16  |  4000  |  96  |  192  |  1071  | 
|  16  |  32  |  8000  |  132  |  264  |  1550  | 
|  32  |  64  |  16000  |  132  |  264  |  1550  | 
|  64  |  128  |  32000  |  132  |  264  |  1550  | 
|  128  |  256  |  60000  |  132  |  264  |  1550  | 
|  256  |  512  |  60000  |  132  |  264  |  1550  | 

**db.serverless instance membatasi jika >1 MinCapacity **


| Kapasitas Saat Ini (DCU) | Memori Instans (GiB) | Koneksi (semua) | Batas Kursor | Buka Transaksi | Koneksi (aktif) | 
| --- | --- | --- | --- | --- | --- | 
|  1.5  |  3  |  7250  |  18  |  36  |  124  | 
|  2  |  4  |  1000  |  24  |  48  |  173  | 
|  4  |  8  |  2000  |  48  |  96  |  416  | 
|  8  |  16  |  4000  |  96  |  192  |  1071  | 
|  16  |  32  |  8000  |  192  |  384  |  2709  | 
|  32  |  64  |  16000  |  384  |  768  |  4500  | 
|  64  |  128  |  32000  |  768  |  1536  |  4500  | 
|  128  |  256  |  60000  |  1536  |  3072  |  4500  | 
|  256  |  512  |  60000  |  3072  |  6144  |  4500  | 

Anda dapat memantau dan alarm pada batas per instans menggunakan CloudWatch metrik berikut. Untuk selengkapnya tentang metrik Amazon CloudWatch DocumentDB, lihat. [Memantau Amazon DocumentDB dengan CloudWatch](cloud_watch.md)


| Sumber daya | CloudWatch batas metrik | CloudWatch metrik penggunaan (maks 1 menit) | CloudWatch metrik penggunaan | 
| --- | --- | --- | --- | 
| Memori Instans | - | - | FreeableMemory | 
| Koneksi (semua) | DatabaseConnectionsLimit | DatabaseConnectionsMax | DatabaseConnections | 
| Cursors | DatabaseCursorsLimit | DatabaseCursorsMax | DatabaseCursors | 
| Transaksi | TransactionsOpenLimit | TransactionsOpenMax | TransactionsOpen | 

# Konfigurasi penskalaan tanpa server Amazon DocumentDB
<a name="docdb-serverless-scaling-config"></a>



**Topics**
+ [Memilih rentang kapasitas penskalaan untuk cluster tanpa server DocumentDB](#docdb-serverless-scaling-capacity-choosing)
+ [Memilih `MinCapacity` pengaturan untuk cluster tanpa server DocumentDB](#docdb-serverless-scaling-mincapacity-choosing)
+ [Memilih `MaxCapacity` pengaturan untuk cluster tanpa server DocumentDB](#docdb-serverless-scaling-maxcapacity-choosing)
+ [Menghindari out-of-memory kesalahan](#docdb-serverless-scaling-mem-errors)
+ [Mengapa instance tanpa server saya tidak diperkecil?](#docdb-serverless-scaling-down)

## Memilih rentang kapasitas penskalaan untuk cluster tanpa server DocumentDB
<a name="docdb-serverless-scaling-capacity-choosing"></a>

Sebelum menambahkan instance tanpa server DocumentDB apa pun ke cluster Amazon DocumentDB, cluster juga harus memiliki set parameter. `ServerlessV2ScalingConfiguration`

`ServerlessV2ScalingConfiguration`Parameter terdiri dari dua nilai yang menentukan rentang kapasitas penskalaan tanpa server dari setiap instance tanpa server di cluster:
+ **`MinCapacity`**- Kapasitas penskalaan minimum dari setiap instance tanpa server DocumentDB di cluster.
+ **`MaxCapacity`**- Kapasitas penskalaan maksimum dari setiap instance tanpa server DocumentDB di cluster.

## Memilih `MinCapacity` pengaturan untuk cluster tanpa server DocumentDB
<a name="docdb-serverless-scaling-mincapacity-choosing"></a>

Sangat menggoda untuk selalu memilih 0,5 untuk`MinCapacity`. Nilai itu memungkinkan instance untuk menurunkan kapasitas terkecil saat benar-benar menganggur, sambil tetap aktif. Namun, tergantung pada bagaimana Anda menggunakan cluster itu dan pengaturan lain yang Anda konfigurasikan, kapasitas minimum yang berbeda mungkin yang paling efektif. Pertimbangkan faktor-faktor berikut saat memilih pengaturan kapasitas minimum:
+ Tingkat penskalaan untuk instance tanpa server DocumentDB bergantung pada kapasitasnya saat ini. Semakin tinggi kapasitas saat ini, semakin cepat instans DB dapat dinaikkan skalanya. Jika Anda memerlukan instans untuk dengan cepat meningkatkan kapasitas yang sangat tinggi, pertimbangkan untuk mengatur kapasitas minimum ke nilai di mana tingkat penskalaan memenuhi kebutuhan Anda.
+ Jika Anda biasanya memodifikasi kelas instans instans Anda untuk mengantisipasi beban kerja yang sangat tinggi atau rendah, Anda dapat menggunakan pengalaman itu untuk membuat perkiraan kasar rentang kapasitas tanpa server DocumentDB yang setara. Untuk menentukan ukuran memori dari jenis instans Amazon DocumentDB yang disediakan, lihat. [Batas instans](limits.md#limits.instance)

  Misalnya, anggaplah Anda menggunakan kelas `db.r6g.xlarge` instance ketika cluster Anda memiliki beban kerja yang rendah. Kelas instance itu memiliki 32 GiB memori. Dengan demikian, Anda dapat menentukan 16 untuk menyiapkan instance tanpa server yang dapat menurunkan skala hingga kira-kira kapasitas yang sama. `MinCapacity` Itu karena setiap DCU sesuai dengan sekitar 2 GiB memori. Anda dapat menentukan nilai yang agak lebih rendah untuk membiarkan skala instance lebih rendah jika `db.r6g.xlarge` instance Anda terkadang kurang dimanfaatkan.
+ Jika aplikasi Anda bekerja paling efisien ketika instance memiliki sejumlah data dalam cache buffer, pertimbangkan untuk menentukan pengaturan DCU minimum di mana memori cukup besar untuk menampung data yang sering diakses. Jika tidak, beberapa data dikeluarkan dari cache buffer saat instance tanpa server diturunkan ke ukuran memori yang lebih rendah. Kemudian ketika instance diskalakan kembali, informasi dibaca kembali ke cache buffer dari waktu ke waktu. Jika jumlah I/O untuk membawa data kembali ke cache buffer cukup besar, mungkin lebih efektif untuk memilih nilai DCU minimum yang lebih tinggi. Untuk informasi selengkapnya, lihat [Ukuran instans](best_practices.md#best_practices-instance_sizing).
+ Jika instance tanpa server DocumentDB Anda berjalan sebagian besar waktu pada kapasitas tertentu, pertimbangkan untuk menentukan pengaturan kapasitas minimum yang lebih rendah dari baseline tersebut, tetapi tidak terlalu rendah. Instans tanpa server dapat memperkirakan secara efektif berapa banyak dan seberapa cepat untuk ditingkatkan ketika kapasitas saat ini tidak jauh lebih rendah dari kapasitas yang dibutuhkan.
+ Jika beban kerja Anda yang disediakan memiliki persyaratan memori yang terlalu tinggi untuk kelas instans kecil seperti T3 atau T4G, pilih pengaturan DCU minimum yang menyediakan memori yang sebanding dengan instans R5 atau R6g.
+ Secara khusus, kami merekomendasikan minimum berikut `MinCapacity` untuk digunakan dengan fitur yang ditentukan (rekomendasi ini dapat berubah):
  + Performance Insights - 2 DCUs
  + Cluster global - 8 DCUs (hanya berlaku untuk primer Wilayah AWS)
+ Di Amazon DocumentDB, replikasi terjadi pada lapisan penyimpanan, sehingga kapasitas pembaca tidak secara langsung memengaruhi replikasi. Namun, untuk instance pembaca tanpa server DocumentDB yang menskalakan secara independen, pastikan kapasitas minimum cukup untuk menangani beban kerja selama periode intensif penulisan untuk menghindari latensi kueri. Jika instance pembaca dalam tingkatan promosi 2—15 mengalami masalah kinerja, pertimbangkan untuk meningkatkan kapasitas minimum klaster. Untuk detail tentang perubahan apakah skala instance pembaca bersama dengan penulis atau secara independen, lihat[Melihat dan memodifikasi tingkat promosi pembaca tanpa server](docdb-serverless-managing.md#docdb-serverless-promo-tier).

  Jika Anda memiliki cluster dengan instance pembaca tanpa server DocumentDB, pembaca tidak menskalakan bersama dengan instance penulis ketika tingkat promosi pembaca bukan 0 atau 1. Dalam hal ini, pengaturan kapasitas minimum yang rendah dapat mengakibatkan lag replikasi yang berlebihan. Hal ini karena pembaca mungkin tidak memiliki kapasitas yang cukup untuk menerapkan perubahan dari penulis ketika basis data sibuk. Kami menyarankan Anda mengatur kapasitas minimum ke nilai yang mewakili jumlah memori dan CPU yang sebanding dengan instance penulis.
+ Waktu yang dibutuhkan untuk instance tanpa server DocumentDB untuk menskalakan dari kapasitas minimumnya ke kapasitas maksimumnya tergantung pada perbedaan antara nilai DCU minimum dan maksimumnya. Ketika kapasitas instans saat ini besar, DocumentDB tanpa server meningkat dalam peningkatan yang lebih besar daripada saat instance dimulai dari kapasitas kecil. Jadi, jika Anda menentukan kapasitas maksimum yang relatif besar dan instans menghabiskan sebagian besar waktunya di dekat kapasitas itu, pertimbangkan untuk meningkatkan pengaturan DCU minimum. Dengan begitu, instans idle dapat menskalakan kembali ke kapasitas maksimum dengan lebih cepat.
+ Batas instans tertentu ditentukan oleh kapasitas instans tanpa server saat ini, seperti batas koneksi, batas kursor, dan batas transaksi terbuka. Jika kapasitas instans saat ini kecil, maka batasnya juga akan kecil. Jika batasan ini menjadi masalah saat instance tanpa server Anda diperkecil ke `MinCapacity` nilainya, pertimbangkan untuk meningkatkan `MinCapacity` ke nilai yang lebih tinggi. Untuk informasi selengkapnya, lihat [Batas instans tanpa server Amazon DocumentDB](docdb-serverless-instance-limits.md).
+ Selanjutnya, batas instance tertentu dibatasi pada nilai maksimum yang lebih rendah jika `MinCapacity` disetel ke kurang dari atau sama dengan 1,0 DCUs, seperti batas koneksi aktif, batas kursor, dan batas transaksi terbuka. Jika batas yang dibatasi ini tidak mencukupi untuk beban kerja Anda, gunakan `MinCapacity` nilai minimal 1,5. DCUs Untuk informasi selengkapnya, lihat [Batas instans tanpa server Amazon DocumentDB](docdb-serverless-instance-limits.md).

Untuk petunjuk tentang cara memodifikasi konfigurasi penskalaan klaster, lihat[Mengelola Amazon DocumentDB tanpa server](docdb-serverless-managing.md).

## Memilih `MaxCapacity` pengaturan untuk cluster tanpa server DocumentDB
<a name="docdb-serverless-scaling-maxcapacity-choosing"></a>

Sangat menggoda untuk selalu memilih beberapa nilai tinggi untuk pengaturan kapasitas tanpa server DocumentDB maksimum. Kapasitas maksimum yang besar memungkinkan instans untuk meningkatkan skala paling banyak saat menjalankan beban kerja intensif. Nilai rendah menghindari kemungkinan biaya tak terduga. Bergantung pada cara Anda menggunakan klaster tersebut dan pengaturan lain yang Anda konfigurasikan, nilai yang paling efektif mungkin lebih tinggi atau lebih rendah dari yang Anda kira. Pertimbangkan faktor-faktor berikut saat memilih pengaturan kapasitas maksimum:
+ Kapasitas maksimum harus minimal setinggi kapasitas minimum. Anda dapat mengatur kapasitas minimum dan maksimum agar identik. Namun, dalam hal ini kapasitas tidak pernah naik atau turun. Dengan demikian, menggunakan nilai yang identik untuk kapasitas minimum dan maksimum tidak tepat untuk situasi di luar pengujian.
+ Kapasitas maksimum harus minimal 1,0 DCUs dan harus paling banyak 256 DCUs.
+ Sebaiknya Anda memantau penskalaan dan penggunaan sumber daya instans tanpa server Anda. Jika instans tanpa server Anda sering menskalakan ke kapasitas maksimum dan mencapai batasan sumber daya (misalnya saat `DCUUtilization` metrik berada di 100,0), sebaiknya pilih nilai yang lebih tinggi. `MaxCapacity` Untuk informasi selengkapnya, lihat [Pemantauan Amazon DocumentDB tanpa server](docdb-serverless-monitoring.md).
+ Jika Anda biasanya memodifikasi kelas instans dari instans yang disediakan untuk mengantisipasi beban kerja yang sangat tinggi atau rendah, Anda dapat menggunakan pengalaman tersebut untuk memperkirakan rentang kapasitas tanpa server DocumentDB yang setara. Untuk menentukan ukuran memori instans Amazon DocumentDB yang disediakan, lihat. [Batas instans](limits.md#limits.instance)

  Misalnya, misalkan Anda menggunakan kelas `db.r6g.4xlarge` instance ketika cluster Anda memiliki beban kerja yang tinggi. Kelas instance itu memiliki 128 GiB memori. Dengan demikian, Anda dapat menentukan pengaturan DCU maksimum 64 untuk menyiapkan instance tanpa server yang dapat menskalakan hingga kira-kira kapasitas yang sama. Itu karena setiap DCU sesuai dengan sekitar 2 GiB memori. Anda dapat menentukan nilai yang sedikit lebih tinggi untuk membiarkan instance meningkat lebih jauh jika `db.r6g.4xlarge` instans Anda terkadang tidak memiliki kapasitas yang cukup untuk menangani beban kerja secara efektif.
+ Jika Anda memiliki batasan anggaran pada penggunaan database Anda, pilih nilai yang tetap dalam batas itu meskipun semua instance tanpa server Anda berjalan pada kapasitas maksimum sepanjang waktu. Ingatlah bahwa ketika Anda memiliki n instance tanpa server di cluster Anda, kapasitas tanpa server maksimum teoritis yang dapat dikonsumsi klaster kapan saja adalah n kali pengaturan DCU maksimum untuk cluster. (Jumlah sebenarnya yang dikonsumsi mungkin lebih sedikit, misalnya jika beberapa pembaca diskalakan secara terpisah dari penulis.)
+ Jika Anda menggunakan instance pembaca tanpa server untuk menurunkan beberapa beban kerja hanya-baca dari instance penulis, Anda mungkin dapat memilih pengaturan kapasitas maksimum yang lebih rendah. Anda melakukan ini untuk mencerminkan bahwa setiap instance pembaca tidak perlu menskalakan setinggi jika cluster hanya berisi satu instance.
+ Misalkan Anda ingin mencegah penggunaan yang berlebihan karena parameter basis data yang salah dikonfigurasi atau kueri yang tidak efisien dalam aplikasi Anda. Dalam hal ini, Anda dapat menghindari penggunaan berlebihan yang tidak disengaja dengan memilih pengaturan kapasitas maksimum yang lebih rendah dari pengaturan tertinggi absolut yang dapat Anda tetapkan.
+ Jika lonjakan karena aktivitas pengguna sebenarnya jarang tetapi dapat terjadi, Anda dapat mempertimbangkan situasi tersebut saat memilih pengaturan kapasitas maksimum. Jika prioritasnya adalah agar aplikasi tetap berjalan dengan performa dan skalabilitas penuh, Anda dapat menentukan pengaturan kapasitas maksimum yang lebih tinggi daripada yang Anda amati dalam penggunaan normal. Jika Anda tidak memiliki masalah dengan aplikasi yang berjalan dengan throughput yang berkurang selama lonjakan aktivitas yang sangat ekstrem, Anda dapat memilih pengaturan kapasitas maksimum yang sedikit lebih rendah. Pastikan Anda memilih pengaturan yang masih memiliki cukup memori dan sumber daya CPU untuk menjaga aplikasi tetap berjalan.
+ Jika Anda mengaktifkan pengaturan di klaster yang meningkatkan penggunaan memori untuk setiap instance, pertimbangkan memori tersebut saat memutuskan nilai DCU maksimum. Pengaturan tersebut mencakup pengaturan untuk Performance Insights dan klaster global. Pastikan bahwa nilai DCU maksimum memungkinkan instans tanpa server untuk meningkatkan skala cukup untuk menangani beban kerja saat fitur tersebut digunakan. Untuk informasi tentang pemecahan masalah yang disebabkan oleh kombinasi setelan DCU maksimum rendah dan fitur Amazon DocumentDB yang memaksakan overhead memori, lihat (di bawah). [Menghindari out-of-memory kesalahan](#docdb-serverless-scaling-mem-errors)
+ Secara khusus, kami merekomendasikan minimum berikut `MaxCapacity` untuk digunakan dengan fitur yang ditentukan (rekomendasi ini dapat berubah):
  + Pembuatan instans tanpa server pada klaster dengan volume data yang besar — 2 DCUs (ini termasuk pembuatan instance tanpa server sebagai bagian dari pemulihan klaster.)
+ Batas instans tertentu ditentukan oleh kapasitas instans saat ini, seperti batas koneksi, batas kursor, dan batas transaksi terbuka. Saat memilih `MaxCapacity` nilai untuk beban kerja Anda, pastikan untuk mengingat batasan instance ini agar tidak terhambat oleh salah satu batasan ini. Untuk informasi selengkapnya, lihat [Batas instans tanpa server Amazon DocumentDB](docdb-serverless-instance-limits.md).

Untuk petunjuk tentang cara memodifikasi konfigurasi penskalaan klaster, lihat[Mengelola Amazon DocumentDB tanpa server](docdb-serverless-managing.md).

## Menghindari out-of-memory kesalahan
<a name="docdb-serverless-scaling-mem-errors"></a>

**Jika salah satu instance tanpa server DocumentDB Anda secara konsisten mencapai batas kapasitas maksimumnya, Amazon DocumentDB menunjukkan kondisi ini dengan menyetel instance ke status parameter yang tidak kompatibel.** Sementara instance memiliki status **parameter yang tidak kompatibel,** beberapa operasi diblokir. Misalnya, Anda tidak dapat meningkatkan versi mesin. Untuk informasi selengkapnya tentang status instans Amazon DocumentDB, [lihat Memantau status instans Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/monitoring_docdb-instance_status.html).

Biasanya, instance Anda masuk ke status ini ketika sering restart karena out-of-memory kesalahan. Amazon DocumentDB merekam peristiwa ketika jenis restart ini terjadi. Untuk melihat peristiwa sumber daya, lihat[Melihat acara Amazon DocumentDB](managing-events.md#viewing-events). Penggunaan memori yang luar biasa tinggi dapat terjadi karena overhead dari mengaktifkan pengaturan seperti Performance Insights. Ini juga bisa berasal dari beban kerja yang berat pada instance Anda atau dari mengelola metadata yang terkait dengan sejumlah besar objek skema.

Jika tekanan memori menjadi lebih rendah sehingga instans tidak mencapai kapasitas maksimumnya sangat sering, Amazon DocumentDB secara otomatis mengubah status instans kembali ke tersedia.

Untuk pulih dari kondisi ini, Anda dapat mengambil beberapa atau semua tindakan berikut:
+ Tingkatkan batas bawah kapasitas untuk instans tanpa server dengan mengubah nilai unit kapasitas DocumentDB minimum (DCU) untuk cluster. Tindakan ini menghindari masalah saat basis data idle menurunkan skalanya ke kapasitas dengan memori lebih sedikit daripada yang dibutuhkan untuk fitur yang diaktifkan di klaster Anda. Setelah mengubah pengaturan DCU untuk cluster, reboot instance tanpa server. Melakukan hal itu mengevaluasi apakah Amazon DocumentDB dapat mengatur ulang status kembali ke tersedia.
+ Tingkatkan batas atas kapasitas instans tanpa server dengan mengubah nilai DCU maksimum untuk cluster. Tindakan ini menghindari masalah saat basis data yang sibuk tidak dapat menaikkan skalanya ke kapasitas dengan memori yang cukup untuk fitur yang diaktifkan di klaster Anda dan beban kerja basis data. Setelah mengubah pengaturan DCU untuk cluster, reboot instance tanpa server. Melakukan hal itu mengevaluasi apakah Amazon DocumentDB dapat mengatur ulang status kembali ke tersedia.
+ Nonaktifkan pengaturan konfigurasi yang memerlukan overhead memori. Misalnya, Anda memiliki fitur seperti Performance Insights yang diaktifkan tetapi tidak menggunakannya. Jika demikian, Anda bisa mematikannya. Atau Anda dapat menyesuaikan nilai kapasitas minimum dan maksimum untuk cluster yang lebih tinggi untuk memperhitungkan memori yang digunakan oleh jenis fitur tersebut. Untuk panduan tentang memilih pengaturan kapasitas minimum dan maksimum, lihat [Memilih rentang kapasitas penskalaan untuk cluster tanpa server DocumentDB](#docdb-serverless-scaling-capacity-choosing).
+ Kurangi beban kerja pada instance. Misalnya, Anda dapat menambahkan instance pembaca ke cluster untuk menyebarkan beban dari kueri hanya-baca di lebih banyak instance.

## Mengapa instance tanpa server saya tidak diperkecil?
<a name="docdb-serverless-scaling-down"></a>

Dalam beberapa kasus, DocumentDB tanpa server tidak mengurangi kapasitas minimum, bahkan tanpa beban pada database. Hal ini dapat terjadi karena alasan berikut:
+ Performance Insights dapat meningkatkan penggunaan sumber daya dan mencegah database mengurangi kapasitas minimum. Fitur-fitur ini mencakup hal-hal berikut:
+ Jika instance pembaca tidak mengurangi ke minimum dan tetap pada kapasitas yang sama atau lebih tinggi dari instance penulis, maka periksa tingkat prioritas instance pembaca. Instance pembaca tanpa server DocumentDB di tingkat 0 atau 1 disimpan pada kapasitas minimum setidaknya setinggi instance penulis. Ubah tingkat prioritas pembaca menjadi 2 atau lebih tinggi agar dinaikkan dan diturunkan skalanya secara independen dari penulis. Untuk informasi selengkapnya, lihat [Penskalaan tanpa server Amazon DocumentDB](docdb-serverless-how-it-works.md#docdb-serverless-scaling).
+ Beban kerja basis data yang berat dapat meningkatkan penggunaan sumber daya.
+ Volume basis data yang besar dapat meningkatkan penggunaan sumber daya. Amazon DocumentDB menggunakan memori dan sumber daya CPU untuk manajemen cluster. Amazon DocumentDB membutuhkan lebih banyak CPU dan memori untuk mengelola cluster dengan volume database yang lebih besar. Jika kapasitas minimum klaster Anda kurang dari minimum yang diperlukan untuk pengelolaan klaster, klaster Anda tidak akan menurunkan kapasitas minimum.
+ Kegiatan pemeliharaan latar belakang dapat secara berkala meningkatkan penggunaan sumber daya.

Jika basis data masih tidak menurunkan skalanya ke kapasitas minimum yang dikonfigurasi, hentikan dan aktifkan ulang basis data untuk mengklaim kembali fragmen memori yang mungkin telah terakumulasi dari waktu ke waktu. Menghentikan dan memulai basis data akan menghasilkan waktu henti, jadi sebaiknya lakukan ini seperlunya.

# Pemantauan Amazon DocumentDB tanpa server
<a name="docdb-serverless-monitoring"></a>

Untuk mempelajari lebih lanjut tentang pemantauan di Amazon DocumentDB, lihat. [Memantau Amazon DocumentDB](monitoring_docdb.md)

**Topics**
+ [Kehabisan Memori: status parameter yang tidak kompatibel](#w2aac41c27b7)
+ [CloudWatch Metrik Amazon untuk DocumentDB tanpa server](#w2aac41c27b9)
+ [Memantau kinerja tanpa server DocumentDB dengan Performance Insights](#w2aac41c27c11)

## Kehabisan Memori: status parameter yang tidak kompatibel
<a name="w2aac41c27b7"></a>

Jika salah satu instans tanpa server Anda secara konsisten mencapai batas kapasitas maksimumnya, Amazon DocumentDB menunjukkan kondisi ini dengan menyetel instance ke status parameter yang tidak kompatibel. Untuk informasi selengkapnya, lihat [Menghindari out-of-memory kesalahan](docdb-serverless-scaling-config.md#docdb-serverless-scaling-mem-errors).

## CloudWatch Metrik Amazon untuk DocumentDB tanpa server
<a name="w2aac41c27b9"></a>

Untuk mempelajari lebih lanjut tentang menggunakan CloudWatch Amazon DocumentDB, lihat. [Memantau Amazon DocumentDB dengan CloudWatch](cloud_watch.md)

Anda dapat melihat instans tanpa server CloudWatch untuk memantau kapasitas yang dikonsumsi oleh setiap instance dengan metrik. `ServerlessDatabaseCapacity` Anda juga dapat memantau semua metrik CloudWatch DocumentDB standar, seperti dan Queries. `DatabaseConnections` Untuk daftar lengkap CloudWatch metrik yang dapat Anda pantau untuk Amazon [Memantau Amazon DocumentDB dengan CloudWatch](cloud_watch.md) DocumentDB, lihat. Metrik CloudWatch tingkat instans berikut ini penting untuk dipantau agar Anda memahami bagaimana instans tanpa server DocumentDB Anda naik dan turun. Semua metrik ini dihitung setiap detik. Dengan begitu, Anda dapat memantau status instans tanpa server Anda saat ini. Anda dapat menyetel alarm untuk memberi tahu Anda jika ada instans tanpa server yang mendekati ambang batas untuk metrik yang terkait dengan kapasitas. Anda dapat menentukan apakah pengaturan kapasitas minimum dan maksimum sudah sesuai, atau apakah Anda perlu menyesuaikannya. Anda dapat menentukan di mana upaya Anda harus difokuskan untuk mengoptimalkan efisiensi basis data Anda.
+ **`ServerlessDatabaseCapacity`**— Sebagai metrik tingkat instance, ia melaporkan jumlah yang DCUs diwakili oleh kapasitas instans saat ini. Sebagai metrik tingkat cluster, ini mewakili rata-rata `ServerlessDatabaseCapacity` nilai semua instance tanpa server DocumentDB di cluster.
+ **`DCUUtilization.`**— Metrik ini baru di DocumentDB tanpa server. Nilai ini direpresentasikan sebagai persentase. Ini dihitung sebagai nilai `ServerlessDatabaseCapacity` metrik dibagi dengan nilai DCU maksimum cluster. Pertimbangkan pedoman berikut untuk menafsirkan metrik ini dan mengambil tindakan:
  + Jika metrik ini mendekati nilai`100.0`, instance telah ditingkatkan setinggi mungkin. Pertimbangkan untuk meningkatkan pengaturan DCU maksimum untuk cluster. Dengan begitu, instance penulis dan pembaca dapat menskalakan ke kapasitas yang lebih tinggi.
  + Misalkan beban kerja hanya-baca menyebabkan instance pembaca mendekati a `DCUUtilization` of`100.0`, sedangkan instance penulis tidak mendekati kapasitas maksimumnya. Dalam hal ini, pertimbangkan untuk menambahkan instance pembaca tambahan ke cluster. Dengan begitu, Anda dapat menyebarkan bagian read-only dari beban kerja di lebih banyak instance, mengurangi beban pada setiap instance pembaca.
  + Misalkan Anda menjalankan aplikasi produksi, sehingga performa dan skalabilitas adalah pertimbangan utamanya. Dalam hal ini, Anda dapat mengatur nilai DCU maksimum untuk cluster ke angka tinggi. Tujuan Anda adalah agar `DCUUtilization` metrik selalu di bawah 100,0. Dengan nilai DCU maksimum yang tinggi, Anda dapat yakin bahwa ada cukup ruang jika ada lonjakan tak terduga dalam aktivitas database. Anda hanya dikenai biaya untuk kapasitas basis data yang benar-benar dikonsumsi.
+ **`CPUUtilization`**— Metrik ini ditafsirkan secara berbeda di DocumentDB tanpa server daripada di instance yang disediakan. Untuk DocumentDB tanpa server, nilai ini adalah persentase yang dihitung sebagai jumlah CPU yang saat ini digunakan, dibagi dengan kapasitas CPU yang tersedia di bawah nilai DCU maksimum cluster. Amazon DocumentDB memonitor nilai ini secara otomatis dan meningkatkan skala instans tanpa server Anda ketika instans secara konsisten menggunakan proporsi kapasitas CPU-nya yang tinggi.

  Jika metrik ini mendekati nilai`100.0`, instance telah mencapai kapasitas CPU maksimumnya. Pertimbangkan untuk meningkatkan pengaturan DCU maksimum untuk cluster. Jika metrik ini mendekati nilai `100.0` pada instance pembaca, pertimbangkan untuk menambahkan instance pembaca tambahan ke cluster. Dengan begitu, Anda dapat menyebarkan bagian read-only dari beban kerja yang tersebar di lebih banyak instance, mengurangi beban pada setiap instance pembaca.
+ **`FreeableMemory`**— Nilai ini mewakili jumlah memori yang tidak terpakai yang tersedia ketika instance tanpa server DocumentDB diskalakan ke kapasitas maksimumnya. Untuk setiap DCU yang kapasitas saat ini di bawah kapasitas maksimum, nilai ini meningkat sekitar 2 GiB. Dengan demikian, metrik ini tidak mendekati nol sampai instance ditingkatkan setinggi mungkin.

  Jika metrik ini mendekati nilai nol, instance telah ditingkatkan sebanyak mungkin dan mendekati batas memori yang tersedia. Pertimbangkan untuk meningkatkan pengaturan DCU maksimum untuk cluster. Jika metrik ini mendekati nilai nol pada instance pembaca, pertimbangkan untuk menambahkan instance pembaca tambahan ke cluster. Dengan begitu, bagian read-only dari beban kerja dapat tersebar di lebih banyak instance, mengurangi penggunaan memori pada setiap instance pembaca.
+ **`TempStorageIops`**— Jumlah IOPS dilakukan pada penyimpanan lokal yang melekat pada instance. Ini termasuk IOPS untuk baca dan tulis. Metrik ini merepresentasikan hitungan dan diukur sekali per detik. Ini adalah metrik baru untuk DocumentDB tanpa server. Lihat perinciannya di [Memantau Amazon DocumentDB dengan CloudWatch](cloud_watch.md).
+ **`TempStorageThroughput`**— Jumlah data yang ditransfer ke dan dari penyimpanan lokal yang terkait dengan instance. Metrik ini merepresentasikan byte dan diukur sekali per detik. Ini adalah metrik baru untuk DocumentDB tanpa server. Lihat perinciannya di [Memantau Amazon DocumentDB dengan CloudWatch](cloud_watch.md).

Biasanya, sebagian besar peningkatan skala untuk instance tanpa server DocumentDB disebabkan oleh penggunaan memori dan aktivitas CPU. Metrik `TempStorageIops` dan `TempStorageThroughput` metrik dapat membantu Anda mendiagnosis kasus yang jarang terjadi di mana aktivitas jaringan untuk transfer antara instans Anda dan perangkat penyimpanan lokal bertanggung jawab atas peningkatan kapasitas yang tidak terduga. Untuk memantau aktivitas jaringan lainnya, Anda dapat menggunakan metrik yang ada ini:
+ `NetworkReceiveThroughput`
+ `NetworkThroughput`
+ `NetworkTransmitThroughput`
+ `StorageNetworkReceiveThroughput`
+ `StorageNetworkThroughput`
+ `StorageNetworkTransmitThroughput`

### Bagaimana CloudWatch metrik tanpa server DocumentDB berlaku untuk tagihan Anda AWS
<a name="w2aac41c27b9c13"></a>

Biaya tanpa server DocumentDB pada tagihan AWS Anda dihitung berdasarkan metrik yang `ServerlessDatabaseCapacity` sama yang dapat Anda pantau. Mekanisme penagihan dapat berbeda dari CloudWatch rata-rata yang dihitung untuk metrik ini jika Anda menggunakan kapasitas tanpa server DocumentDB hanya untuk sebagian jam. Ini juga dapat berbeda jika masalah sistem membuat CloudWatch metrik tidak tersedia untuk periode singkat. Dengan demikian, Anda mungkin melihat nilai jam DCU yang sedikit berbeda pada tagihan Anda daripada jika Anda menghitung sendiri angkanya dari nilai rata-rata. `ServerlessDatabaseCapacity`

### Contoh perintah Amazon CloudWatch CLI untuk metrik tanpa server DocumentDB
<a name="w2aac41c27b9c15"></a>

 AWS CLI Contoh berikut menunjukkan bagaimana Anda dapat memantau CloudWatch metrik terpenting yang terkait dengan DocumentDB tanpa server. Dalam setiap kasus, ganti `Value=` string untuk `--dimensions` parameter dengan pengidentifikasi instance tanpa server DocumentDB Anda sendiri.

Contoh Linux berikut menampilkan nilai kapasitas minimum, maksimum, dan rata-rata untuk sebuah instance, diukur setiap 10 menit selama satu jam. Perintah tanggal Linux menentukan waktu mulai dan akhir relatif terhadap tanggal dan waktu saat ini. Fungsi `sort_by` dalam parameter `--query` mengurutkan hasil secara kronologis berdasarkan bidang `Timestamp`.

```
aws cloudwatch get-metric-statistics \
    --metric-name "ServerlessDatabaseCapacity" \
    --start-time "$(date -d '1 hour ago')" \
    --end-time "$(date -d 'now')" \
    --period 600 \
    --namespace "AWS/DocDB" \
    --statistics Minimum Maximum Average \
    --dimensions Name=DBInstanceIdentifier,Value=my_instance \
    --query 'sort_by(Datapoints[*].{min:Minimum,max:Maximum,avg:Average,ts:Timestamp},&ts)' \
    --output table
```

Contoh Linux berikut menunjukkan pemantauan kapasitas instance dalam sebuah cluster. Ini mengukur pemanfaatan kapasitas minimum, maksimum, dan rata-rata suatu instans. Pengukuran dilakukan sekali setiap jam selama periode tiga jam. Contoh-contoh ini menggunakan `DCUUtilization` metrik yang mewakili persentase dari batas atas DCUs, alih-alih `ServerlessDatabaseCapacity` mewakili jumlah tetap DCUs. Dengan begitu, Anda tidak perlu mengetahui angka aktual untuk nilai DCU minimum dan maksimum dalam rentang kapasitas. Anda dapat melihat persentase mulai dari 0 hingga 100.

```
aws cloudwatch get-metric-statistics \
    --metric-name "DCUUtilization" \
    --start-time "$(date -d '3 hours ago')" \
    --end-time "$(date -d 'now')" \
    --period 3600 \
    --namespace "AWS/DocDB" \
    --statistics Minimum Maximum Average \
    --dimensions Name=DBInstanceIdentifier,Value=my_instance \
    --query 'sort_by(Datapoints[*].{min:Minimum,max:Maximum,avg:Average,ts:Timestamp},&ts)' \
    --output table
```

Contoh Linux berikut melakukan pengukuran yang sama seperti yang sebelumnya. Dalam hal ini, pengukuran ditujukan untuk metrik `CPUUtilization`. Pengukuran dilakukan setiap 10 menit selama periode 1 jam. Angka-angka tersebut mewakili persentase CPU yang tersedia yang digunakan, berdasarkan sumber daya CPU yang tersedia untuk pengaturan kapasitas maksimum untuk instance.

```
aws cloudwatch get-metric-statistics \
    --metric-name "CPUUtilization" \
    --start-time "$(date -d '1 hour ago')" \
    --end-time "$(date -d 'now')" \
    --period 600 \
    --namespace "AWS/DocDB" \
    --statistics Minimum Maximum Average \
    --dimensions Name=DBInstanceIdentifier,Value=my_instance \
    --query 'sort_by(Datapoints[*].{min:Minimum,max:Maximum,avg:Average,ts:Timestamp},&ts)' \
    --output table
```

Contoh Linux berikut melakukan pengukuran yang sama seperti yang sebelumnya. Dalam hal ini, pengukuran ditujukan untuk metrik `FreeableMemory`. Pengukuran dilakukan setiap 10 menit selama periode 1 jam.

```
aws cloudwatch get-metric-statistics \
    --metric-name "FreeableMemory" \
    --start-time "$(date -d '1 hour ago')" \
    --end-time "$(date -d 'now')" \
    --period 600 \
    --namespace "AWS/DocDB" \
    --statistics Minimum Maximum Average \
    --dimensions Name=DBInstanceIdentifier,Value=my_instance \
    --query 'sort_by(Datapoints[*].{min:Minimum,max:Maximum,avg:Average,ts:Timestamp},&ts)' \
    --output table
```

## Memantau kinerja tanpa server DocumentDB dengan Performance Insights
<a name="w2aac41c27c11"></a>

Anda dapat menggunakan Performance Insights untuk memantau kinerja instance tanpa server DocumentDB. Untuk prosedur Wawasan Performa, lihat [Memantau dengan Wawasan Kinerja](performance-insights.md).

Penghitung Performance Insights baru berikut ini berlaku untuk instance tanpa server DocumentDB:
+ **`os.general.serverlessDBCapacity`**- Kapasitas saat ini dari instance di DCUs. Nilai sesuai dengan `ServerlessDatabaseCapacity` CloudWatch metrik untuk contoh.
+ **`os.general.dcuUtilization`**— Persentase kapasitas saat ini dari kapasitas maksimum yang dikonfigurasi. Nilai sesuai dengan `DCUUtilization` CloudWatch metrik untuk contoh.
+ **`os.general.maxConfiguredDcu`**— Kapasitas maksimum yang Anda konfigurasikan untuk instance tanpa server DocumentDB ini. Ini diukur dalam DCUs.
+ **`os.general.minConfiguredDcu`**— Kapasitas minimum yang Anda konfigurasikan untuk instance tanpa server DocumentDB ini. Ini diukur dalam DCUs.

Untuk daftar lengkap penghitung Wawasan Performa, lihat [Performance Insights untuk metrik penghitung](performance-insights-counter-metrics.md).

Ketika nilai vCPU ditampilkan untuk instance tanpa server DocumentDB di Performance Insights, nilai tersebut mewakili perkiraan berdasarkan nilai DCU untuk instance tersebut. Pada interval default satu menit, nilai vCPU fraksional apa pun dibulatkan ke bilangan bulat terdekat. Untuk interval yang lebih lama, nilai vCPU yang ditampilkan adalah rata-rata nilai vCPU bilangan bulat untuk setiap menit.