Untuk mengirim data trace ke your Google Cloud project, Anda dapat menggunakan Telemetry (OTLP) API atau Cloud Trace API. Telemetry API mengimplementasikan OpenTelemetry OTLP API, dan memberikan kompatibilitas serta dukungan yang lebih besar untuk ekosistem OpenTelemetry open source. Trace API adalah API berpemilik Google Cloud yang ada sebelum dukungan untuk Telemetry API. Batas untuk Telemetry API sering kali lebih besar daripada untuk Trace API.
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 memberlakukan dua jenis kuota berbeda: kuota kapasitas untuk permintaan Cloud Trace API dan kuota penyerapan untuk span yang Anda kirim ke Trace.
Kuota
Tabel berikut merangkum unit kuota yang tersedia untuk operasi baca dan tulis, serta kuota harian untuk menyerap durasi 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:
- Buat 12 panggilan API
ListTracesper 60 detik. - Buat 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 |
| Durasi yang diserap3,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 trace
menggunakan Trace Explorer di Google Cloud konsol 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 durasi yang diserap menggunakan Cloud Trace API.
Penyerapan melalui Telemetry API tidak dibatasi.
4 Kuota penyerapan durasi trace harian untuk Cloud Trace API
ditentukan oleh histori akun penagihan dan permintaan peningkatan kuota yang Anda buat.
Batas
Tabel ini mencantumkan batas untuk Cloud Trace API.
| Deskripsi | Nilai |
|---|---|
Jumlah maksimum durasi per panggilan GetTrace |
10.000 |
Jumlah maksimum durasi 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 durasi | 1.024 byte |
| Jumlah maksimum label atau atribut per durasi | 1024 |
| Ukuran maksimum kunci untuk label atau atribut | 512 byte |
| Ukuran maksimum nilai untuk label atau atribut | 65.532 byte |
| Jumlah maksimum peristiwa per durasi | 256 |
| Stempel waktu masa lalu maksimum agar durasi dapat diserap | 14 hari |
| Stempel waktu masa depan maksimum agar durasi dapat diserap | 3 hari |
| Stempel waktu masa lalu maksimum untuk peristiwa relatif terhadap stempel waktu durasi | 365 hari |
Melampaui batas mungkin tidak akan menyebabkan panggilan API gagal dengan error. Misalnya, error tidak dilaporkan saat jumlah atribut yang dilampirkan ke durasi melebihi 1.024. Sebagai gantinya, dalam skenario ini, Cloud Trace API menggunakan algoritma non-deterministik untuk memilih 1.024 atribut yang akan diserap. Atribut yang tersisa akan dihapus.
Cloud Trace API memberikan detail tentang endpoint
GetTrace, PatchTraces, dan
ListTraces.
Cara Anda menganotasi durasi 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.
Kuota dan batas Telemetry API
Bagian ini mencantumkan batas yang hanya berlaku saat Telemetry API digunakan untuk menyerap data trace. Telemetry API, yang mengimplementasikan OpenTelemetry OTLP API, di rancang untuk digunakan dengan aplikasi yang diinstrumentasi 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* |
1.024 byte | Batas. |
Jumlah maksimum atribut yang dilampirkan ke objek Span* |
1024 | Batas. |
Jumlah maksimum atribut resource per ResourceSpans* objek |
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* |
1.024 byte | Batas. |
Jumlah maksimum atribut per Event* objek |
1024 | Batas. |
Atribut maksimum per Link* objek |
1024 | Batas. |
| Ukuran maksimum URL skema | 8.192 byte | Batas. |
| Jumlah maksimum byte penyerapan trace per menit | 2,4 GB untuk wilayah berikut: 300 MB untuk semua wilayah lainnya. |
Kuota. |
trace.proto.
Batas cakupan trace
| Batas cakupan trace | Nilai |
|---|---|
| Jumlah maksimum cakupan trace per project | 100 |
| Jumlah maksimum tampilan per cakupan trace | 20 |
Periode retensi Trace
| Kategori | Periode retensi data |
|---|---|
Durasi yang disimpan di
_Trace bucket |
30 hari |
Mengelola kuota
Bagian ini menjelaskan cara meminta perubahan kuota dan cara memantau penggunaan kuota.
Meminta perubahan kuota Cloud Trace API
Untuk menentukan apakah Anda dapat meminta batas Cloud Trace API yang lebih tinggi atau lebih rendah untuk kuota menggunakan Google Cloud konsol, buka halaman Kuota & Batas Sistem dan telusuri kuota yang diinginkan.
- Jika kuota tercantum, Anda dapat menggunakan halaman tersebut untuk meminta perubahan 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 kuota. Penagihan harus diaktifkan pada Google Cloud project untuk mengedit kuota di Google Cloud konsol.
Memantau penggunaan kuota
Untuk memastikan bahwa Anda tidak kehabisan kuota dan kehilangan visibilitas ke performa aplikasi, pastikan Anda mengelompokkan pembaruan 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 durasi harian, lihat Melihat dan mengelola kuota.
Untuk mempelajari cara mengurangi unit kuota API dan unit kuota penyerapan durasi harian, lihat Membatasi penggunaan.
Untuk meminta peningkatan unit kuota API atau kuota penyerapan durasi 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 trace bervolume tinggi, buat set data BigQuery tertaut, lalu gunakan BigQuery API.
Jangan gunakan Cloud Trace API untuk pembuatan kueri bervolume tinggi karena panggilan ke Trace API dibatasi kapasitasnya.