Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Kuota dan batas

Cloud Trace menerapkan kuota kapasitas, batas penyerapan span, dan periode retensi data yang bergantung pada apakah Anda mengirim data trace menggunakan Telemetry (OTLP) API atau Cloud Trace API. Memahami batas ini akan membantu Anda memantau penggunaan sehingga Anda tidak kehilangan kemampuan observasi ke dalam aplikasi.

Kuota dan batas Trace API

Bagian ini memberikan informasi tentang kuota dan batas yang hanya berlaku untuk Trace API. Kuota dan batas yang tercantum di bagian ini tidak berlaku untuk Telemetry API.

Cloud Trace menerapkan dua jenis kuota yang berbeda: kuota kapasitas pada permintaan Cloud Trace API Anda dan kuota penyerapan pada span yang Anda kirim ke Trace.

Kuota

Tabel berikut merangkum unit kuota yang tersedia untuk operasi baca dan tulis, serta kuota harian untuk menyerap span untuk Trace API. Misalnya, Anda memiliki total 300 per 60 detik untuk tiga perintah API GetTrace, ListTraces, dan ListSpan. Berikut adalah dua contoh berbeda tentang cara menggunakan semua unit kuota yang tersedia:

Melakukan 12 panggilan API ListTraces per 60 detik.
Melakukan 10 panggilan API ListTraces dan 50 panggilan API GetTrace per 60 detik.

Kategori	Total unit kuota
Operasi baca¹	300 per 60 detik
Operasi tulis²	4.800 per 60 detik
Span yang diserap^3,4	3.000.000 per hari - 5.000.000.000 per hari

¹ Operasi baca mencakup GetTrace, ListTraces, ListSpan. Panggilan ke ListTraces menggunakan 25 unit kuota. Panggilan ke GetTrace menggunakan ListSpan 1 unit kuota. Membuat kueri dan melihat trace menggunakan Trace Explorer di konsol Google Cloud tidak menggunakan kuota ini.
² Operasi tulis mencakup PatchTraces, BatchWrite, dan CreateSpan. Setiap operasi tulis menggunakan 1 unit kuota.
³ Kuota ini hanya berlaku untuk span yang diserap menggunakan Cloud Trace API. Penyerapan melalui Telemetry API tidak dibatasi. ⁴ Kuota penyerapan span trace harian Anda untuk Cloud Trace API ditentukan oleh histori akun penagihan dan permintaan yang telah Anda buat untuk penambahan kuota.

Batas

Tabel ini mencantumkan batas untuk Cloud Trace API.

Deskripsi	Nilai
Jumlah maksimum span per panggilan `GetTrace`	10.000
Jumlah maksimum span per panggilan `PatchTraces`	25.000
Jumlah maksimum trace per panggilan `ListTraces`	1.000 dalam tampilan `ROOTSPAN` dan `MINIMAL` 100 dalam tampilan `COMPLETE`
Panjang maksimum nama span	1.024 byte
Jumlah maksimum label atau atribut per span	1024
Ukuran maksimum kunci untuk label atau atribut	512 byte
Ukuran maksimum nilai untuk label atau atribut	65.532 byte
Jumlah maksimum peristiwa per span	256
Stempel waktu lampau maksimum untuk span yang akan diserap	14 hari
Stempel waktu mendatang maksimum untuk rentang yang akan diserap	3 hari
Stempel waktu lampau maksimum untuk peristiwa yang terkait dengan stempel waktu span	365 hari

Melebihi batas mungkin tidak menyebabkan panggilan API gagal dengan error. Misalnya, error tidak dilaporkan saat jumlah atribut yang dilampirkan ke span melebihi 1024. Sebagai gantinya, dalam skenario ini, Cloud Trace API menggunakan algoritma non-deterministik untuk memilih 1024 atribut yang akan diserap. Atribut yang tersisa akan dihapus.

Cloud Trace API memberikan detail tentang endpoint GetTrace, PatchTraces, dan ListTraces.

Cara Anda menganotasi span bergantung pada endpoint Cloud Trace API. Jika Anda menggunakan endpoint batchWrite, tambahkan atribut ke objek Span. Jika Anda menggunakan endpoint patchTraces, tambahkan label ke objek TraceSpan.

Batas dan kuota Telemetry API

Bagian ini mencantumkan batas yang hanya berlaku saat Telemetry API digunakan untuk menyerap data trace. Telemetry API, yang mengimplementasikan OpenTelemetry OTLP API, dirancang untuk digunakan dengan aplikasi yang diinstrumentasikan menggunakan salah satu OpenTelemetry SDK. Batas yang tercantum di bagian ini tidak berlaku untuk Cloud Trace API.

Deskripsi	Nilai	Catatan
Ukuran maksimum kunci atribut	512 byte	Batas.
Ukuran maksimum nilai atribut	64 KiB	Batas.
Ukuran maksimum nama objek `Span`^*	1024 byte	Batas.
Jumlah maksimum atribut yang dilampirkan ke objek `Span`^*	1024	Batas.
Jumlah maksimum atribut resource per objek `ResourceSpans`^*	1024	Batas.
Jumlah maksimum atribut per objek `ResourceSpan`^* Mencakup atribut yang dilampirkan ke objek turunan dari jenis berikut: `Resource`, `Span`, `ScopeSpans`, `Event`, dan `Link.`	8192	Batas.
Jumlah maksimum objek `Event`^* per objek `Span`^*	256	Batas.
Jumlah maksimum objek `Link`^* per objek `Span`^*	128	Batas.
Ukuran maksimum nama objek `Event`^*	1024 byte	Batas.
Jumlah maksimum atribut per objek `Event`^*	1024	Batas.
Atribut maksimum per objek `Link`^*	1024	Batas.
Ukuran maksimum URL skema	8.192 byte	Batas.
Jumlah maksimum byte penyerapan trace per menit	2,4 GB untuk wilayah berikut: `asia-east1, asia-northeast1, asia-southeast1, asia-south1, europe-west1, europe-west2, europe-west3, europe-west4, us-central1, us-east4, us-west1`. 300 MB untuk semua region lainnya.	Kuota.

^* Untuk definisi struktur ini, lihat file trace.proto.

Batasan pada cakupan trace

Batasan pada cakupan trace	Nilai
Jumlah maksimum cakupan trace per project	100
Jumlah maksimum tampilan per cakupan trace	20

Periode retensi Trace

Kategori	Periode retensi data
Span yang disimpan di bucket `_Trace`	30 hari

Mengelola kuota Anda

Bagian ini menjelaskan cara meminta perubahan kuota dan cara memantau penggunaan kuota Anda.

Meminta perubahan pada kuota Cloud Trace API

Untuk menentukan apakah Anda dapat meminta batas Cloud Trace API yang lebih tinggi atau lebih rendah untuk kuota menggunakan konsol Google Cloud , 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 Cloud Customer Care dan minta perubahan kuota. Penagihan harus diaktifkan pada projectGoogle Cloud untuk mengedit kuota di konsol Google Cloud .

Memantau penggunaan kuota Anda

Untuk memastikan Anda tidak kehabisan kuota dan kehilangan kemampuan observasi terhadap performa aplikasi, pastikan Anda mengelompokkan update dan memantau penggunaan kuota. Misalnya, Anda dapat membuat kebijakan pemberitahuan yang memberi tahu Anda saat penggunaan melebihi batas. Untuk informasi selengkapnya tentang pemantauan permintaan API dan memahami masing-masing respons, lihat Memantau penggunaan API.

Untuk melihat Cloud Trace API dan kuota penyerapan span harian Anda, lihat Melihat dan mengelola kuota.
Untuk mempelajari cara mengurangi unit kuota API dan unit kuota penyerapan span harian, lihat Membatasi penggunaan.
Untuk meminta peningkatan unit kuota API atau kuota penyerapan span harian, lihat Meminta kuota lebih banyak.
Lihat Membuat pemberitahuan kelebihan kuota untuk mengetahui informasi selengkapnya tentang pembuatan kebijakan pemberitahuan untuk memantau kuota Trace API dan penyerapan durasi pelacakan tarif.

Membuat kueri bervolume tinggi

Untuk membuat kueri data trace dalam volume tinggi, buat set data BigQuery tertaut, lalu gunakan BigQuery API.

Jangan gunakan Cloud Trace API untuk kueri bervolume tinggi karena panggilan ke Trace API dibatasi kapasitasnya.

Kuota dan batas Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.