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 Google Cloud eksklusif yang mendahului 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.
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 | 128 byte |
| Jumlah maksimum label atau atribut per durasi | 32 |
| Ukuran maksimum kunci untuk label atau atribut | 128 byte |
| Ukuran maksimum nilai untuk label atau atribut | 256 byte |
| Jumlah maksimum peristiwa per durasi | 128 |
| 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 32. Sebagai gantinya, dalam skenario ini, Cloud Trace API menggunakan algoritma non-deterministik untuk memilih 32 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* |
1024 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* |
1024 byte | Batas. |
Jumlah maksimum atribut per Event* objek |
1024 | Batas. |
Atribut maksimum per Link* objek |
1024 | Batas. |
| Ukuran maksimum URL skema | 8192 byte | Batas. |
| Jumlah maksimum byte penyerapan trace per menit | 2,4 GB untuk region berikut: 300 MB untuk semua region 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 |
|---|---|
| Data durasi yang disimpan oleh Cloud Trace | 30 hari |
Bucket _Trace |
30 hari |
Mengelola kuota
Bagian ini menjelaskan cara meminta perubahan kuota dan cara memantau penggunaan kuota.
Meminta perubahan kuota Cloud Trace API
Anda dapat meminta batas Cloud Trace API yang lebih tinggi atau lebih rendah menggunakan Google Cloud konsol. Untuk mengetahui informasi selengkapnya, lihat Melihat dan mengelola kuota.
Jika Anda mendapatkan error Edit is not allowed for this quota, Anda dapat
menghubungi Dukungan untuk meminta perubahan
kuota. Perhatikan juga bahwa penagihan harus diaktifkan pada
Google Cloud project agar kotak centang dapat diklik.
Memantau penggunaan kuota
Untuk memastikan bahwa Anda tidak kehabisan kuota yang menyebabkan Anda tidak dapat mengamati performa aplikasi, pastikan Anda mengelompokkan update 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 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.