Kuota dan batas

Untuk mengirim data rekaman aktivitas ke project Google Cloud, Anda dapat menggunakan Telemetry (OTLP) API atau Cloud Trace API. Telemetry API mengimplementasikan OpenTelemetry OTLP API, dan menyediakan kompatibilitas serta dukungan yang lebih baik untuk ekosistem OpenTelemetry open source. Trace API adalah API Google Cloud eksklusif yang sudah ada sebelum dukungan untuk Telemetry API. Batas untuk Telemetry API sering kali lebih longgar 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 tarif untuk permintaan Cloud Trace API dan kuota penyerapan untuk durasi yang Anda kirim ke Trace.

Kuota

Tabel berikut meringkas 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 ListTraces per 60 detik.
  • Buat 10 panggilan API ListTraces dan 50 panggilan API GetTrace per 60 detik.
Kategori Total unit kuota
Operasi baca1 300 per 60 detik
Operasi tulis2 4.800 per 60 detik
Durasi yang diserap3 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 penyerapan durasi Trace harian ditentukan oleh histori akun penagihan dan permintaan peningkatan kuota yang Anda buat.

Batas

Deskripsi Nilai
Jumlah maksimum durasi per panggilan GetTrace 1.000
Jumlah maksimum durasi per panggilan PatchTraces 25.000
Jumlah maksimum Trace per panggilan ListTraces 1.000 di tampilan ROOTSPAN dan MINIMAL
100 di tampilan COMPLETE
Jumlah maksimum durasi per Trace 1.000
Ukuran rekaman aktivitas maksimum 50 MB
Panjang maksimum nama span 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 maksimum sebelumnya untuk span yang akan diserap 14 hari
Stempel waktu maksimum di masa mendatang untuk span yang akan diserap 3 hari
Stempel waktu maksimum sebelumnya untuk peristiwa yang relatif terhadap stempel waktu span 365 hari

Anda dapat menganotasi span dengan membuat objek attributes dan melampirkannya ke objek Span saat menggunakan Trace API v2 batchWrite. Demikian pula, Anda dapat menganotasi span dengan membuat objek labels dan melampirkan ke objek TraceSpan saat menggunakan metode patchTraces Trace API v1.

Batas Telemetry API

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

Deskripsi Nilai
Ukuran maksimum kunci atribut 512 byte
Ukuran maksimum nilai atribut 64 KiB
Ukuran maksimum nama objek Span* 1.024 byte
Jumlah maksimum atribut yang dilampirkan ke objek Span* 1024
Jumlah maksimum atribut resource per objek ResourceSpans* 1024
Jumlah maksimum atribut per objek ResourceSpan*
Menyertakan atribut yang dilampirkan ke objek turunan dari jenis berikut:
Resource, Span, ScopeSpans, Event, dan Link.		 8192
Jumlah maksimum objek Event* per objek Span* 256
Jumlah maksimum objek Link* per objek Span* 128
Ukuran maksimum nama objek Event* 1.024 byte
Jumlah maksimum atribut per objek Event* 1024
Atribut maksimum per objek Link* 1024
Ukuran maksimum URL skema 8.192 byte
*  Untuk definisi struktur ini, lihat trace.proto OpenTelemetry.

Batasan pada cakupan rekaman aktivitas

Batasan pada cakupan rekaman aktivitas Nilai
Jumlah maksimum cakupan rekaman aktivitas per project 100
Jumlah maksimum project per cakupan rekaman aktivitas 20

Periode retensi Trace

Kategori Periode retensi data
Data span yang disimpan oleh Cloud Trace 30 hari
Laporan analisis 30 hari

Mengelola kuota

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

Meminta perubahan pada kuota Cloud Trace API

Anda dapat meminta batas Cloud Trace API yang lebih tinggi atau lebih rendah menggunakan Konsol Google Cloud. Untuk informasi selengkapnya, lihat Melihat dan mengelola kuota.

Jika mendapatkan error Edit is not allowed for this quota, Anda dapat menghubungi Dukungan untuk meminta perubahan pada kuota. Perhatikan juga bahwa penagihan harus diaktifkan di project Google Cloud untuk mengklik kotak centang.

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.