Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Konfigurasi broker MSK Express khusus (Read/Write akses)
Anda dapat memperbarui konfigurasi read/write broker baik dengan menggunakan fitur konfigurasi pembaruan Amazon MSK atau menggunakan API Apache Kafka AlterConfig . Konfigurasi broker Apache Kafka bersifat statis atau dinamis. Konfigurasi statis memerlukan restart broker agar konfigurasi diterapkan, sementara konfigurasi dinamis tidak memerlukan restart broker. Untuk informasi selengkapnya tentang properti konfigurasi dan mode pembaruan, lihat Memperbarui konfigurasi broker.
Topik
Konfigurasi statis pada broker MSK Express
Anda dapat menggunakan Amazon MSK untuk membuat file konfigurasi MSK khusus untuk mengatur properti statis berikut. Amazon MSK menyetel dan mengelola semua properti lain yang tidak Anda tetapkan. Anda dapat membuat dan memperbarui file konfigurasi statis dari konsol MSK atau menggunakan perintah Buat konfigurasi konfigurasi.
| Properti | Deskripsi | nilai default |
|---|---|---|
|
izinkan semua orang.jika.no.acl.ditemukan |
Jika Anda ingin mengatur properti ini ke false, pertama-tama pastikan Anda mendefinisikan ACL Apache Kafka untuk cluster Anda. Jika Anda menyetel properti ini ke false dan Anda tidak terlebih dahulu mendefinisikan ACL Apache Kafka, Anda kehilangan akses ke cluster. Jika itu terjadi, Anda dapat memperbarui konfigurasi lagi dan mengatur properti ini ke true untuk mendapatkan kembali akses ke cluster. |
true |
|
auto.create.topics.enable |
Memungkinkan pembuatan otomatis topik di server. |
false |
| tipe kompresi |
Tentukan jenis kompresi akhir untuk topik tertentu. Konfigurasi ini menerima codec kompresi standar: gzip, snappy, lz4, zstd. Konfigurasi ini juga menerima |
Apache Kafka Standar |
|
koneksi.max.idle.ms |
Waktu habis koneksi idle dalam milidetik. Utas prosesor soket server menutup koneksi yang tidak aktif selama lebih dari nilai yang Anda tetapkan untuk properti ini. |
Apache Kafka Standar |
|
kustom.diiklan.pendengar |
Mengkonfigurasi nama domain khusus untuk pendengar yang menghadap klien di cluster Amazon MSK Anda. Amazon MSK secara otomatis menerapkan konfigurasi ke setiap broker, termasuk broker baru yang ditambahkan selama penskalaan atau penggantian. Bekerja pada kedua ZooKeeper dan klaster Kraft. Contoh format: Nama pendengar yang diizinkan adalah Untuk informasi selengkapnya, lihat Konfigurasikan nama domain khusus untuk cluster Amazon MSK Anda. |
Tidak ada (dinonaktifkan) |
|
hapus.topic.enable |
Mengaktifkan operasi hapus topik. Jika Anda menonaktifkan pengaturan ini, Anda tidak dapat menghapus topik melalui alat admin. |
Apache Kafka Standar |
|
grup.initial.rebalance.delay.ms |
Jumlah waktu koordinator grup menunggu lebih banyak konsumen data untuk bergabung dengan grup baru sebelum koordinator grup melakukan rebalance pertama. Penundaan yang lebih lama berarti penyeimbangan ulang yang berpotensi lebih sedikit, tetapi ini meningkatkan waktu hingga pemrosesan dimulai. |
Apache Kafka Standar |
|
grup.max.session.timeout.ms |
Waktu tunggu sesi maksimum untuk konsumen terdaftar. Waktu tunggu yang lebih lama memberi konsumen lebih banyak waktu untuk memproses pesan antara detak jantung dengan mengorbankan waktu yang lebih lama untuk mendeteksi kegagalan. |
Apache Kafka Standar |
|
leader.imbalance.per.broker.persen |
Rasio ketidakseimbangan pemimpin diperbolehkan per broker. Pengontrol memicu saldo pemimpin jika melebihi nilai ini per broker. Nilai ini ditentukan dalam persentase. |
Apache Kafka Standar |
| log.cleanup.policy | Kebijakan pembersihan default untuk segmen di luar jendela retensi. Daftar kebijakan yang valid yang dipisahkan koma. Kebijakan yang valid adalah delete dancompact. Untuk cluster berkemampuan penyimpanan berjenjang, kebijakan yang valid hanya berlaku. delete |
Apache Kafka Standar |
| log.message.timestamp.setelah.max.ms |
Perbedaan stempel waktu yang diijinkan antara stempel waktu pesan dan stempel waktu broker. Stempel waktu pesan dapat lebih lambat dari atau sama dengan stempel waktu broker, dengan perbedaan maksimum yang diijinkan ditentukan oleh nilai yang ditetapkan dalam konfigurasi ini. Jika |
86400000 (24 * 60 * 60 * 1000 ms, yaitu, 1 hari) |
| log.pesan.timestamp.sebelum.max.ms |
Perbedaan stempel waktu yang diijinkan antara cap waktu broker dan stempel waktu pesan. Stempel waktu pesan dapat lebih awal dari atau sama dengan stempel waktu broker, dengan perbedaan maksimum yang diijinkan ditentukan oleh nilai yang ditetapkan dalam konfigurasi ini. Jika |
86400000 (24 * 60 * 60 * 1000 ms, yaitu, 1 hari) |
| log.message.timestamp.type | Menentukan apakah stempel waktu dalam pesan adalah waktu pembuatan pesan atau waktu penambahan log. Nilai yang diizinkan adalah CreateTime danLogAppendTime. |
Apache Kafka Standar |
| log.retention.byte | Ukuran maksimum log sebelum menghapusnya. | Apache Kafka Standar |
| log.retention.ms | Jumlah milidetik untuk menyimpan file log sebelum menghapusnya. | Apache Kafka Standar |
| max.connections.per.ip | Jumlah maksimum koneksi yang diizinkan dari setiap alamat IP. Ini dapat diatur ke 0 jika ada penggantian yang dikonfigurasi menggunakan max.connections.per.ip.overrides properti. Koneksi baru dari alamat IP dihapus jika batas tercapai. |
Apache Kafka Standar |
|
maks.incremental.fetch.session.cache.slots |
Jumlah maksimum sesi pengambilan tambahan yang dipertahankan. |
Apache Kafka Standar |
| pesan.max.byte |
Ukuran batch rekaman terbesar yang diizinkan Kafka. Jika Anda meningkatkan nilai ini dan ada konsumen yang lebih tua dari 0.10.2, Anda juga harus meningkatkan ukuran pengambilan konsumen sehingga mereka dapat mengambil batch rekaman sebesar ini. Versi format pesan terbaru selalu mengelompokkan pesan ke dalam batch untuk efisiensi. Versi format pesan sebelumnya tidak mengelompokkan catatan yang tidak terkompresi ke dalam batch, dan dalam kasus seperti itu, batas ini hanya berlaku untuk satu catatan. Anda dapat mengatur nilai ini per topik dengan |
Apache Kafka Standar |
|
nom.partisi |
Jumlah partisi default per topik. |
1 |
|
offset. retensi.menit |
Setelah kelompok konsumen kehilangan semua konsumennya (yaitu, menjadi kosong), pengimbangannya disimpan untuk periode retensi ini sebelum dibuang. Untuk konsumen mandiri (yaitu, mereka yang menggunakan penugasan manual), offset berakhir setelah waktu komit terakhir ditambah periode retensi ini. |
Apache Kafka Standar |
|
replica.fetch.max.byte |
Jumlah byte pesan untuk mencoba mengambil untuk setiap partisi. Ini bukan maksimum mutlak. Jika kumpulan rekaman pertama di partisi pertama yang tidak kosong dari pengambilan lebih besar dari nilai ini, kumpulan rekaman dikembalikan untuk memastikan kemajuan. Message.max.bytes (config broker) atau max.message.bytes (config topik) menentukan ukuran batch record maksimum yang diterima broker. |
Apache Kafka Standar |
|
kelas replika.seleksi |
Nama kelas yang memenuhi syarat yang diimplementasikan ReplicaSelector. Pialang menggunakan nilai ini untuk menemukan replika baca yang disukai. Jika Anda ingin mengizinkan konsumen mengambil dari replika terdekat, setel properti ini ke |
Apache Kafka Standar |
|
socket.receive.buffer.byte |
Buffer SO_RCVBUF dari soket pemutus soket. Jika nilainya -1, default OS digunakan. |
102400 |
|
socket.request.max.byte |
Jumlah maksimum byte dalam permintaan soket. |
104857600 |
|
socket.send.buffer.byte |
Buffer SO_SNDBUF dari soket pemutus soket. Jika nilainya -1, default OS digunakan. |
102400 |
|
transaksi.max.timeout.ms |
Waktu tunggu maksimum untuk transaksi. Jika waktu transaksi yang diminta klien melebihi nilai ini, broker mengembalikan kesalahan dalam InitProducerIdRequest. Ini mencegah klien dari batas waktu yang terlalu besar, dan ini dapat menghambat konsumen yang membaca dari topik yang termasuk dalam transaksi. |
Apache Kafka Standar |
|
transaksial.id.expiration.ms |
Waktu dalam milidetik saat koordinator transaksi menunggu untuk menerima pembaruan status transaksi untuk transaksi saat ini sebelum koordinator mengakhiri ID transaksinya. Pengaturan ini juga memengaruhi kedaluwarsa ID produsen karena menyebabkan ID produsen kedaluwarsa ketika waktu ini berlalu setelah penulisan terakhir dengan ID produsen yang diberikan. Producer ID mungkin kedaluwarsa lebih cepat jika penulisan terakhir dari ID produsen dihapus karena pengaturan retensi untuk topik. Nilai minimum untuk properti ini adalah 1 milidetik. |
Apache Kafka Standar |
Konfigurasi dinamis pada Express Brokers
Anda dapat menggunakan Apache Kafka AlterConfig API atau Kafka-configs.sh alat untuk mengedit konfigurasi dinamis berikut. Amazon MSK menyetel dan mengelola semua properti lain yang tidak Anda tetapkan. Anda dapat secara dinamis mengatur properti konfigurasi tingkat cluster dan tingkat broker yang tidak memerlukan restart broker.
| Properti | Deskripsi | Nilai default |
|---|---|---|
|
diiklankan.pendengar |
Pendengar untuk dipublikasikan untuk digunakan klien, jika berbeda dari properti Juga tidak seperti Properti ini diatur pada tingkat per broker. |
null |
|
tipe kompresi |
Jenis kompresi akhir untuk topik tertentu. Anda dapat mengatur properti ini ke codec kompresi standar ( |
Apache Kafka Standar |
| log.cleaner.menghapus.retention.ms | Jumlah waktu untuk mempertahankan penanda batu nisan hapus untuk topik log yang dipadatkan. Pengaturan ini juga memberikan batas waktu di mana konsumen harus menyelesaikan pembacaan jika mereka mulai dari offset 0 untuk memastikan bahwa mereka mendapatkan snapshot yang valid dari tahap akhir. Jika tidak, batu nisan yang dihapus mungkin dikumpulkan sebelum mereka menyelesaikan pemindaiannya. | 86400000 (24 * 60 * 60 * 1000 ms, yaitu, 1 hari), Apache Kafka Default |
| log.cleaner.min.compaction.lag.ms | Waktu minimum pesan akan tetap tidak dipadatkan di log. Pengaturan ini hanya berlaku untuk log yang sedang dipadatkan. | 0, Apache Kafka Default |
| log.cleaner.max.compaction.lag.ms | Waktu maksimum pesan akan tetap tidak memenuhi syarat untuk pemadatan di log. Pengaturan ini hanya berlaku untuk log yang sedang dipadatkan. Konfigurasi ini akan dibatasi dalam kisaran [7 hari, Long.Max]. | 9223372036854775807, Apache Kafka Standar |
|
log.cleanup.policy |
Kebijakan pembersihan default untuk segmen di luar jendela retensi. Daftar kebijakan yang valid yang dipisahkan koma. Kebijakan yang valid adalah |
Apache Kafka Standar |
|
log.message.timestamp.setelah.max.ms |
Perbedaan stempel waktu yang diijinkan antara stempel waktu pesan dan stempel waktu broker. Stempel waktu pesan dapat lebih lambat dari atau sama dengan stempel waktu broker, dengan perbedaan maksimum yang diijinkan ditentukan oleh nilai yang ditetapkan dalam konfigurasi ini. Jika |
86400000 (24 * 60 * 60 * 1000 ms, yaitu, 1 hari) |
|
log.pesan.timestamp.sebelum.max.ms |
Perbedaan stempel waktu yang diijinkan antara cap waktu broker dan stempel waktu pesan. Stempel waktu pesan dapat lebih awal dari atau sama dengan stempel waktu broker, dengan perbedaan maksimum yang diijinkan ditentukan oleh nilai yang ditetapkan dalam konfigurasi ini. Jika |
86400000 (24 * 60 * 60 * 1000 ms, yaitu, 1 hari) |
|
log.message.timestamp.type |
Menentukan apakah stempel waktu dalam pesan adalah waktu pembuatan pesan atau waktu penambahan log. Nilai yang diizinkan adalah |
Apache Kafka Standar |
|
log.retention.byte |
Ukuran maksimum log sebelum menghapusnya. |
Apache Kafka Standar |
|
log.retention.ms |
Jumlah milidetik untuk menyimpan file log sebelum menghapusnya. |
Apache Kafka Standar |
|
tingkat koneksi maks.penciptaan |
Tingkat pembuatan koneksi maksimum yang diizinkan di broker kapan saja. |
Apache Kafka Standar |
|
koneksi maks |
Jumlah maksimum koneksi yang diizinkan di broker setiap saat. Batas ini diterapkan selain batas per ip yang dikonfigurasi menggunakan |
Apache Kafka Standar |
|
max.connections.per.ip |
Jumlah maksimum koneksi yang diizinkan dari setiap alamat ip. Ini dapat diatur ke |
Apache Kafka Standar |
|
max.connections.per.ip.overrides |
Daftar per-ip atau nama host yang dipisahkan koma menggantikan jumlah koneksi maksimum default. Nilai contoh adalah |
Apache Kafka Standar |
|
pesan.max.byte |
Ukuran batch rekaman terbesar yang diizinkan Kafka. Jika Anda meningkatkan nilai ini dan ada konsumen yang lebih tua dari 0.10.2, Anda juga harus meningkatkan ukuran pengambilan konsumen sehingga mereka dapat mengambil batch rekaman sebesar ini. Versi format pesan terbaru selalu mengelompokkan pesan ke dalam batch untuk efisiensi. Versi format pesan sebelumnya tidak mengelompokkan catatan yang tidak terkompresi ke dalam batch, dan dalam kasus seperti itu, batas ini hanya berlaku untuk satu catatan. Anda dapat mengatur nilai ini per topik dengan |
Apache Kafka Standar |
|
produser.id.expiration.ms |
Waktu dalam ms yang akan menunggu pemimpin partisi topik sebelum ID produser kedaluwarsa. ID Produsen tidak akan kedaluwarsa saat transaksi yang terkait dengannya masih berlangsung. Perhatikan bahwa ID produsen dapat kedaluwarsa lebih cepat jika penulisan terakhir dari ID produsen dihapus karena pengaturan retensi topik. Menyetel nilai ini sama atau lebih tinggi dari |
Apache Kafka Standar |
catatan
Pada KRaft-based cluster (termasuk semua cluster broker Express), penggantian per broker dinam advertised.listeners is tidak didukung. Untuk mengkonfigurasi nama domain kustom pada KRaft-based cluster, gunakan custom.advertised.listeners properti statis. Untuk informasi selengkapnya, lihat Konfigurasikan nama domain khusus untuk cluster Amazon MSK Anda.
Topic-level konfigurasi pada Express Brokers
Anda dapat menggunakan perintah Apache Kafka untuk mengatur atau memodifikasi properti konfigurasi tingkat topik untuk topik baru dan yang sudah ada. Jika Anda tidak dapat memberikan konfigurasi tingkat topik apa pun, Amazon MSK menggunakan default broker. Seperti konfigurasi tingkat broker, Amazon MSK melindungi beberapa properti konfigurasi tingkat topik dari perubahan. Contohnya termasuk faktor replikasi, min.insync.replicas danunclean.leader.election.enable. Jika Anda mencoba membuat topik dengan nilai faktor replikasi selain3, Amazon MSK akan membuat topik dengan faktor replikasi secara 3 default. Untuk informasi selengkapnya tentang properti konfigurasi tingkat topik dan contoh tentang cara mengaturnya, lihat Topic-Level Konfigurasi
| Properti | Deskripsi |
|---|---|
|
pembersihan.kebijakan |
Konfigurasi ini menunjuk kebijakan retensi untuk digunakan pada segmen log. Kebijakan “hapus” (yang merupakan default) akan membuang segmen lama ketika waktu retensi atau batas ukurannya telah tercapai. Kebijakan “ringkas” akan mengaktifkan pemadatan log, yang mempertahankan nilai terbaru untuk setiap kunci. Dimungkinkan juga untuk menentukan kedua kebijakan dalam daftar yang dipisahkan koma (misalnya, “hapus, kompak”). Dalam hal ini, segmen lama akan dibuang sesuai konfigurasi waktu retensi dan ukuran, sementara segmen yang dipertahankan akan dipadatkan. Pemadatan pada broker Express dipicu setelah data dalam partisi mencapai 256 MB. |
|
tipe kompresi |
Tentukan jenis kompresi akhir untuk topik tertentu. Konfigurasi ini menerima codec kompresi standar ( |
| hapus.retention.ms |
Jumlah waktu untuk mempertahankan penanda batu nisan hapus untuk topik log yang dipadatkan. Pengaturan ini juga memberikan batas waktu di mana konsumen harus menyelesaikan pembacaan jika mereka mulai dari offset 0 untuk memastikan bahwa mereka mendapatkan snapshot yang valid dari tahap akhir. Jika tidak, menghapus batu nisan mungkin dikumpulkan sebelum mereka menyelesaikan pemindaiannya. Nilai default untuk pengaturan ini adalah 86400000 (24 * 60 * 60 * 1000 ms, yaitu, 1 hari), Apache Kafka Default |
|
maks.message.byte |
Ukuran batch rekaman terbesar yang diizinkan oleh Kafka (setelah kompresi, jika kompresi diaktifkan). Jika ini meningkat dan ada konsumen yang lebih tua dari |
|
pesan.timestamp.setelah.max.ms |
Konfigurasi ini menetapkan perbedaan stempel waktu yang diijinkan antara stempel waktu pesan dan stempel waktu broker. Stempel waktu pesan dapat lebih lambat dari atau sama dengan stempel waktu broker, dengan perbedaan maksimum yang diijinkan ditentukan oleh nilai yang ditetapkan dalam konfigurasi ini. Jika |
|
pesan.timestamp.before.max.ms |
Konfigurasi ini menetapkan perbedaan stempel waktu yang diijinkan antara stempel waktu broker dan stempel waktu pesan. Stempel waktu pesan dapat lebih awal dari atau sama dengan stempel waktu broker, dengan perbedaan maksimum yang diijinkan ditentukan oleh nilai yang ditetapkan dalam konfigurasi ini. Jika |
|
pesan.timestamp.type |
Tentukan apakah stempel waktu dalam pesan adalah waktu pembuatan pesan atau waktu penambahan log. Nilai harus menjadi salah satu |
| min.compaction.lag.ms |
Waktu minimum pesan akan tetap tidak dipadatkan di log. Pengaturan ini hanya berlaku untuk log yang sedang dipadatkan. Nilai default untuk pengaturan ini adalah 0, Apache Kafka Default |
| max.compaction.lag.ms |
Waktu maksimum pesan akan tetap tidak memenuhi syarat untuk pemadatan di log. Pengaturan ini hanya berlaku untuk log yang sedang dipadatkan. Konfigurasi ini akan dibatasi dalam kisaran [7 hari, Long.Max]. Nilai default untuk pengaturan ini adalah 9223372036854775807, Apache Kafka Default. |
|
retensi.byte |
Konfigurasi ini mengontrol ukuran maksimum partisi (yang terdiri dari segmen log) yang dapat tumbuh sebelum kami akan membuang segmen log lama untuk mengosongkan ruang jika kami menggunakan kebijakan retensi “hapus”. Secara default tidak ada batas ukuran hanya batas waktu. Karena batas ini diberlakukan pada tingkat partisi, kalikan dengan jumlah partisi untuk menghitung retensi topik dalam byte. Selain itu, |
|
retensi.ms |
Konfigurasi ini mengontrol waktu maksimum kami akan menyimpan log sebelum kami akan membuang segmen log lama untuk mengosongkan ruang jika kami menggunakan kebijakan retensi “hapus”. Ini mewakili SLA tentang seberapa cepat konsumen harus membaca data mereka. Jika disetel ke |