Kuota dan batas

Cloud Trace memberlakukan dua jenis kuota berbeda: kuota tarif untuk permintaan API dan kuota penyerapan untuk durasi yang Anda kirim ke Trace.

Melacak kuota

Tabel berikut merangkum unit kuota yang tersedia untuk operasi baca dan tulis, serta kuota harian untuk menyerap span. 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 rekaman aktivitas

Bagian ini mencantumkan batas yang berlaku saat menggunakan Cloud Trace API.

Batas untuk metode API

Batas untuk metode API 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

Batas span

Batas span Nilai
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 melampirkan ke objek Span saat menggunakan batchWrite Cloud Trace API v2. Demikian pula, Anda dapat menganotasi span dengan membuat objek labels dan melampirkan ke objek TraceSpan saat menggunakan metode patchTraces Cloud Trace API v1.

Batasan pada rekaman aktivitas

Batasan pada rekaman aktivitas Nilai
Jumlah maksimum durasi per Trace 1.000
Ukuran rekaman aktivitas maksimum 50 MB

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 Anda 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.