Cloud Trace menerapkan kuota kecepatan, batas penyerapan rentang, dan periode retensi data yang bergantung pada API yang Anda gunakan untuk mengirim data rekaman aktivitas ke project Google Cloud Anda: Telemetry (OTLP) API atau Cloud Trace API. Telemetry API menerapkan spesifikasi OTLP OpenTelemetry dan memberikan kompatibilitas yang lebih baik dengan ekosistem OpenTelemetry open source.
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 kecepatan pada permintaan Cloud Trace API Anda dan kuota penyerapan pada rentang yang Anda kirim ke Trace.
Kuota
Tabel berikut merangkum unit kuota yang tersedia untuk operasi baca dan tulis, serta kuota harian untuk menyerap rentang 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:
- Lakukan 12 panggilan API
ListTracesper 60 detik. - Lakukan 10 panggilan API
ListTracesdan 50 panggilan APIGetTraceper 60 detik.
| Kategori | Total unit kuota |
|---|---|
| Operasi baca1 | 300 per 60 detik |
| Operasi tulis2 | 4.800 per 60 detik |
| Rentang yang diproses3,4 | 3.000.000 per hari - 5.000.000.000 per hari |
1 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 rekaman aktivitas
menggunakan Trace Explorer di konsol Google Cloud tidak menggunakan
kuota ini.
2 Operasi tulis mencakup PatchTraces, BatchWrite,
dan CreateSpan. Setiap operasi tulis menggunakan 1 unit kuota.
3 Kuota ini hanya berlaku untuk rentang yang dimasukkan menggunakan Cloud Trace API.
Penyerapan melalui Telemetry API tidak dibatasi.
4 Kuota penyerapan rentang rekaman aktivitas harian Anda untuk Cloud Trace API ditentukan oleh histori akun penagihan dan permintaan yang telah Anda buat untuk peningkatan kuota.
Batas
Tabel ini mencantumkan batas untuk Cloud Trace API.
| Deskripsi | Nilai |
|---|---|
Jumlah rentang maksimum per panggilan GetTrace |
10.000 |
Jumlah rentang maksimum per panggilan PatchTraces |
25.000 |
Jumlah maksimum rekaman aktivitas per panggilan ListTraces |
1.000 di tampilan ROOTSPAN dan MINIMAL100 di tampilan COMPLETE |
| Panjang maksimum nama rentang | 1.024 byte |
| Jumlah maksimum label atau atribut per rentang | 1024 |
| Ukuran maksimum kunci untuk label atau atribut | 512 byte |
| Ukuran maksimum nilai untuk label atau atribut | 65.532 byte |
| Jumlah maksimum peristiwa per rentang | 256 |
| Stempel waktu lalu maksimum untuk rentang yang akan diproses | 14 hari |
| Stempel waktu mendatang maksimum untuk rentang yang akan diproses | 3 hari |
| Stempel waktu lalu maksimum untuk peristiwa relatif terhadap stempel waktu rentang | 365 hari |
Melebihi batas mungkin tidak menyebabkan panggilan API gagal dengan error. Misalnya, error tidak dilaporkan saat jumlah atribut yang dilampirkan rentang melebihi 1.024. Sebagai gantinya, dalam skenario ini, Cloud Trace API menggunakan algoritma non-deterministik untuk memilih 1024 atribut yang akan diproses. Atribut yang tersisa akan dihapus.
Cloud Trace API memberikan detail tentang endpoint
GetTrace, PatchTraces, dan
ListTraces.
Cara Anda membuat anotasi rentang 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 memproses data rekaman aktivitas. Telemetry API, yang mengimplementasikan OpenTelemetry OTLP API, dirancang untuk digunakan dengan aplikasi yang diinstrumentasi menggunakan salah satu SDK OpenTelemetry. 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 rekaman aktivitas per menit | 2,4 GB untuk wilayah berikut: 300 MB untuk semua region lainnya. |
Kuota. |
trace.proto.
Batasan pada cakupan rekaman aktivitas
| Batasan pada cakupan rekaman aktivitas | Nilai |
|---|---|
| Jumlah maksimum cakupan rekaman aktivitas per project | 100 |
| Jumlah maksimum tampilan per cakupan rekaman aktivitas | 20 |
Periode retensi Trace
| Kategori | Periode retensi data |
|---|---|
Rentang yang disimpan di
bucket _Trace |
30 hari |
Mengelola kuota Anda
Bagian ini menjelaskan cara meminta perubahan kuota dan cara memantau penggunaan kuota.
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 cari 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, maka hubungi Cloud Customer Care dan minta perubahan pada kuota. Penagihan harus diaktifkan di projectGoogle Cloud untuk mengedit kuota di konsol Google Cloud .
Memantau penggunaan kuota Anda
Untuk memastikan Anda tidak kehabisan kuota dan kehilangan kemampuan memantau performa aplikasi, verifikasi bahwa Anda mengelompokkan pembaruan dan memantau penggunaan kuota. Misalnya, Anda dapat membuat kebijakan pemberitahuan yang memberi tahu Anda saat penggunaan Anda 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 rentang harian, lihat Membatasi penggunaan.
Untuk meminta peningkatan unit kuota API atau kuota penyerapan rentang harian, lihat Meminta lebih banyak kuota.
Lihat Membuat pemberitahuan kelebihan kuota untuk mengetahui informasi selengkapnya tentang pembuatan kebijakan pemberitahuan untuk memantau kuota Trace API dan penyerapan durasi pelacakan tarif.
Kueri bervolume tinggi
Untuk kueri data rekaman aktivitas bervolume 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 lajunya.