Untuk membantu Anda merencanakan kapasitas dan menghindari gangguan layanan, Cloud Logging menerapkan kuota dan batas sistem pada permintaan API, penyimpanan, dan konfigurasi resource. Anda dapat meminta penambahan untuk sebagian besar kuota, tetapi batas sistem bersifat tetap dan tidak dapat diubah.
Kuota logging dan batas penggunaan
Tabel berikut mencantumkan kuota dan batas yang berlaku untuk penggunaan Cloud Logging. Secara umum, Anda dapat meminta penambahan kuota. Namun, batas tidak dapat diubah.
Beberapa entri tercantum sebagai per project, tetapi catatan menunjukkan bahwa entri tersebut juga berlaku untuk akun penagihan, folder, dan organisasi, serta tidak bersifat hierarkis. Misalnya, jika Anda memiliki beberapa project Cloud de Confiance dalam sebuah organisasi, Anda dapat mengonfigurasi hingga 200 sink untuk setiap project Cloud de Confiance ; untuk organisasi yang sama, Anda juga dapat mengonfigurasi hingga 200 sink di level organisasi.
| Kategori | Nilai maksimum batas atau nilai kuota awal |
Catatan |
|---|---|---|
Ukuran
LogEntry |
256 KiB | Batas ini merupakan perkiraan dan didasarkan pada ukuran data internal, bukan ukuran permintaan REST API yang sebenarnya. Tidak dapat ditingkatkan. |
| Ukuran entri log audit | 512 KiB | Tidak dapat ditingkatkan. |
| Jumlah label | 64 per LogEntry |
Tidak dapat ditingkatkan. |
Panjang kunci label LogEntry |
512 B | Cloud Logging memotong kunci label yang terlalu besar saat entri log terkait ditulis. Tidak dapat ditingkatkan. |
Panjang nilai label LogEntry |
64 KiB | Cloud Logging memotong nilai label yang terlalu besar saat entri log terkait ditulis. Tidak dapat ditingkatkan. |
| Panjang kueri bahasa kueri Logging | 20.000 karakter | Tidak dapat ditingkatkan. |
| Pemecahan kueri | 200 bucket | Batas ini adalah jumlah maksimum bucket yang mungkin berisi entri log untuk suatu resource. Untuk mengetahui informasi selengkapnya, lihat Kueri menampilkan error. Tidak dapat ditingkatkan. Untuk alasan performa, minimalkan jumlah bucket log dan buat bucket log Anda di satu region. Jika Anda sering perlu mengkueri entri log yang berasal dari berbagai resource, pertimbangkan untuk merutekan entri log ke beberapa bucket log terpusat. |
| Jumlah sink | 200 per Cloud de Confiance project | Dapat ditingkatkan hingga 4.000. Kuota ini juga berlaku untuk akun penagihan, folder, dan organisasi serta tidak bersifat hierarkis. |
| Panjang filter penyertaan sink | 20.000 karakter | Tidak dapat ditingkatkan. |
| Panjang filter pengecualian sink | 20.000 karakter | Tidak dapat ditingkatkan. |
| Jumlah filter pengecualian | 50 per sink | Tidak dapat ditingkatkan. Jika Anda memerlukan lebih dari 50 filter pengecualian, pertajam filter penyertaan. |
| Jumlah bucket log | 100 per Cloud de Confiance project | Dapat ditingkatkan hingga 2.500. Kuota ini adalah jumlah maksimum bucket yang mungkin berisi entri log untuk resource dan mencakup bucket yang menunggu penghapusan. Kuota ini juga berlaku untuk akun penagihan, folder, dan organisasi serta tidak bersifat hierarkis. Jika Anda meningkatkan jumlah maksimum bucket log, pengalaman pengguna mungkin akan menurun karena cakupan log default tidak dapat menyertakan semua bucket log dalam project. |
| Jumlah kolom kustom yang diindeks | 20 per bucket log | Tidak dapat ditingkatkan. Cloud Logging mendukung pengindeksan teks lengkap. Oleh karena itu, sebaiknya Anda tidak menentukan pengindeksan kustom. |
| Jumlah tampilan log | 30 per bucket log | Dapat ditingkatkan menjadi 1.000 tampilan log di satu bucket log. Jika Anda meningkatkan jumlah maksimum tampilan log, pengalaman pengguna mungkin akan menurun karena cakupan log default tidak dapat menyertakan semua tampilan log dalam project. |
| Stempel waktu terlama yang dapat disimpan di bucket log | Ditentukan oleh periode retensi bucket log. | Untuk bucket log kustom dengan periode retensi default, nilai ini adalah 30 hari yang lalu. Logging API menerima entri log dengan stempel waktu yang lebih lama, dan entri log tersebut dirutekan ke tujuan sink. Namun, jika entri log dengan stempel waktu yang lebih lama dirutekan ke bucket log, entri log tersebut tidak akan disimpan. |
| Stempel waktu mendatang yang dapat disimpan di bucket log | Hingga 1 hari ke depan | Logging API menolak entri dengan stempel waktu lebih dari 1 hari di masa mendatang dan menampilkan error INVALID_ARGUMENT. Tidak dapat ditingkatkan. |
| Jumlah cakupan log per resource | 100 | Dapat ditingkatkan hingga 10.000. |
| Jumlah tampilan log dan project yang disertakan dalam cakupan log | 100 | Sebaiknya cakupan log mencantumkan tampilan log, bukan project, jika memungkinkan. Mencantumkan tampilan log akan mengurangi waktu kueri dan meningkatkan kejelasan tentang entri log mana yang sedang dikueri. |
| Jumlah project yang disertakan dalam cakupan log | 5 | Sebaiknya cakupan log mencantumkan tampilan log, bukan project, jika memungkinkan. Tampilan log dapat berada di project yang berbeda. |
Kuota dan batas Logging API
Batas berikut berlaku untuk penggunaan Logging API Anda. Anda dapat meminta perubahan pada kuota dan batas Logging API; untuk mengetahui petunjuknya, lihat Meminta perubahan pada kuota Cloud Logging API di halaman ini.
Untuk melihat kuota API, buka dasbor API, pilih API, lalu pilih Kuota.
| Kategori | Nilai maksimum batas atau nilai kuota awal |
Catatan |
|---|---|---|
| Masa pakai token halaman API | 24 jam | Tidak dapat ditingkatkan. |
Ukuran permintaan entries.write |
10 MB | Tidak dapat ditingkatkan. |
Tingkat permintaan entries.write,
menurut region |
4,8 GB per menit, per Cloud de Confiance project di region
asia-east1,
asia-northeast1,
asia-southeast1,
asia-south1,
europe-west1,
europe-west2,
europe-west3,
europe-west4,
us-central1,
us-east4,
us-west1
300 MB per menit, per Cloud de Confiance project di semua region lainnya |
Anda dapat meminta penambahan kuota. Kuota ini juga berlaku untuk akun penagihan, folder, dan organisasi, serta tidak bersifat hierarkis. Untuk mengetahui informasi selengkapnya tentang kuota ini, lihat Kuota penyerapan per region. Menggunakan filter pengecualian
tidak mengurangi rasio permintaan tulis karena entri log
dikecualikan setelah permintaan |
Jumlah permintaan entries.list |
60 per menit, per Cloud de Confiance project | Tidak dapat ditingkatkan. Batas ini juga berlaku untuk akun penagihan, folder, dan organisasi serta tidak bersifat hierarkis. Untuk mengkueri log dalam jumlah besar, pertimbangkan untuk menggunakan BigQuery API. Untuk mentransfer log dalam jumlah besar, pertimbangkan untuk menggunakan sink log atau menyalin entri log. |
Jumlah nama resource yang berbeda dalam satu perintah entries.write |
1000 | Tidak dapat ditingkatkan. Kolom |
| Permintaan kontrol per menit | 600 | Tidak dapat ditingkatkan. Kuota ini berlaku untuk permintaan API administratif dan konfigurasi. Kuota ini mencakup semua permintaan dalam kuota permintaan kontrol harian, serta permintaan yang menghapus log atau mengelola resource seperti bucket log, tampilan log, kebijakan IAM pada tampilan log, cakupan log, dan metrik berbasis log. |
| Mengontrol permintaan per hari | 1.000 per Cloud de Confiance project | Tidak dapat ditingkatkan. Kuota ini berlaku untuk permintaan API untuk membuat dan memperbarui pengecualian dan sink. |
| Jumlah Cloud de Confiance project atau nama resource lainnya dalam satu permintaan entries.list |
100 | Tidak dapat ditingkatkan. |
| Tingkat ekspor ke topik Pub/Sub | 60 GB/mnt per Cloud de Confiance project, folder, atau organisasi tempat sink ditentukan | Anda dapat mengajukan permintaan dukungan untuk menambah kuota. Peningkatan kuota diberikan berdasarkan ketersediaan Pub/Sub. Jika rasio ekspor melebihi kuota, error akan dicatat dalam entri log. Kolom ringkasan menunjukkan error konfigurasi sink, dan kode error dicantumkan sebagai Untuk mengetahui informasi pemecahan masalah, lihat Masalah kuota dengan sink. |
Kuota penyerapan per region
Untuk meningkatkan isolasi dan melindungi resource regional dari kelebihan beban penyerapan, kuota Cloud Logging membatasi volume data yang ditulis ke region penyerapan per projectCloud de Confiance .
Tabel berikut menunjukkan kuota default untuk setiap region:
| Region penyerapan | Nilai default |
|---|---|
asia-east1,
asia-northeast1,
asia-southeast1,
asia-south1,
europe-west1,
europe-west2,
europe-west3,
europe-west4,
us-central1,
us-east4,
us-west1
|
4,8 GB per menit, per Cloud de Confiance project |
| Semua wilayah yang tersisa | 300 MB per menit, per project Cloud de Confiance |
Nilai default untuk kuota regional melebihi volume penyerapan sebagian besar pengguna. Namun, jika volume penyerapan project Anda dari suatu region mendekati atau lebih tinggi dari kuota default dalam enam bulan atau lebih sebelum kuota diberlakukan, kuota awal Anda akan mencakup peningkatan otomatis satu kali. Oleh karena itu, kuota Anda mungkin lebih tinggi daripada kuota default dalam tabel sebelumnya. Untuk mengetahui informasi tentang cara meninjau kuota, lihat Meninjau kuota Cloud Logging API.
Jika Anda melebihi kuota regional, permintaan tulis Anda ke Cloud Logging API mungkin akan ditolak dengan pesan error "resource exhausted". Untuk rekomendasi yang membantu Anda menghindari kelebihan kuota, lihat Mengelola dan memantau kuota Logging Anda.
Meninjau kuota Cloud Logging API Anda
Untuk meninjau kuota Cloud Logging API, lakukan hal berikut:
-
Di konsol Cloud de Confiance , buka halaman Quotas & System Limits:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah IAM & Admin.
- Filter daftar kuota untuk layanan Cloud Logging API.
Meminta perubahan pada kuota Cloud Logging API
Untuk menentukan apakah Anda dapat meminta batas Logging API yang lebih tinggi atau lebih rendah untuk kuota menggunakan konsol Cloud de Confiance , buka halaman Quotas & System Limits dan telusuri kuota yang diinginkan.
- Jika kuota tercantum, Anda dapat menggunakan halaman tersebut untuk meminta perubahan pada batas. Untuk mengetahui informasi tentang langkah-langkah tersebut, lihat Melihat dan mengelola kuota.
- Jika kuota tidak tercantum atau jika Anda meminta pembaruan kuota dan mendapatkan error
Edit is not allowed for this quota, hubungi Dukungan dan minta perubahan kuota. Penagihan harus diaktifkan pada projectCloud de Confiance untuk mengedit kuota di konsol Cloud de Confiance .
Mengelola dan memantau kuota Cloud Logging API Anda
Untuk mencegah gangguan layanan yang disebabkan oleh kuota yang terlampaui, Anda dapat melakukan hal berikut:
- Gunakan penyesuaian kuota otomatis untuk memantau penggunaan kuota dan meminta peningkatan untuk Anda. Untuk mengetahui informasi selengkapnya, lihat Pengatur kuota.
- Buat pemberitahuan tentang kuota untuk memberi tahu Anda tentang penggunaan. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan pemberitahuan kuota.
Mengoptimalkan penggunaan entries.list
Penggunaan entries.list yang diharapkan adalah untuk menelusuri log yang cocok. Metode ini tidak dimaksudkan untuk pengambilan entri log dalam volume tinggi. Jika
Anda sering menghabiskan kuota entries.list, pertimbangkan
opsi berikut:
Pastikan Anda menggunakan Cloud Logging API secara efektif. Untuk mengetahui informasi selengkapnya, lihat Mengoptimalkan penggunaan API.
Jika Anda sudah tahu bahwa entri log yang ingin Anda analisis melebihi kuota
entries.list, konfigurasikan sink log untuk mengekspor log Anda ke tujuan yang didukung.
Logging audit
Ukuran maksimum log audit ditampilkan dalam tabel berikut. Nilai ini dapat membantu Anda memperkirakan ruang yang Anda butuhkan di tujuan sink.
| Jenis log audit | Ukuran maksimum |
|---|---|
| Aktivitas Admin | 512 KiB |
| Akses Data | 512 KiB |
| Peristiwa Sistem | 512 KiB |
| Kebijakan Ditolak | 512 KiB |
Periode retensi log
Periode retensi Cloud Logging berikut berlaku untuk bucket log, terlepas dari jenis log yang disertakan dalam bucket atau apakah log tersebut disalin dari lokasi lain:
| Bucket | Resource | Periode retensi data default | Retensi kustom |
|---|---|---|---|
_Required |
project, folder, organisasi | 400 hari | Tidak dapat dikonfigurasi |
_Default |
folder, organisasi | 30 hari | Tidak dapat dikonfigurasi |
_Default |
project | 30 hari | Dapat dikonfigurasi |
| Ditentukan pengguna | project | 30 hari | Dapat Dikonfigurasi |
Untuk _Default dan bucket log yang ditentukan pengguna yang ada dalam project, Anda dapat mengonfigurasi Cloud Logging untuk mempertahankan log Anda antara 1 hari dan400 days. Untuk mengetahui informasi tentang cara menetapkan aturan retensi, lihat Mengonfigurasi retensi kustom.
Untuk menyimpan entri log dari folder atau organisasi selama lebih dari 30 hari, buat sink log dan rutekan entri log tersebut ke bucket log dalam project.