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 memberikan kompatibilitas dan dukungan yang lebih besar untuk ekosistem OpenTelemetry open source. Trace API adalah API Google Cloud berpemilik 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 tarif untuk permintaan Cloud Trace API dan kuota penyerapan untuk 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 waktu 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 rekaman aktivitas harian Anda 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 rentang per panggilan GetTrace 1.000
Jumlah maksimum rentang per panggilan PatchTraces 25.000
Jumlah maksimum rekaman aktivitas per panggilan ListTraces 1.000 dalam tampilan ROOTSPAN dan MINIMAL
100 dalam tampilan COMPLETE
Jumlah maksimum durasi per Trace 1.000
Ukuran rekaman aktivitas maksimum 50 MB
Panjang maksimum nama rentang 128 byte
Jumlah maksimum label atau atribut per rentang 32
Ukuran maksimum kunci untuk label atau atribut 128 byte
Ukuran maksimum nilai untuk label atau atribut 256 byte
Jumlah maksimum peristiwa per rentang 128
Stempel waktu lalu maksimum untuk rentang yang akan diproses 14 hari
Stempel waktu masa depan 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 karena error. Misalnya, error tidak dilaporkan saat jumlah atribut yang dilampirkan rentang melebihi 32. Sebagai gantinya, dalam skenario ini, Cloud Trace API menggunakan algoritma non-deterministik untuk memilih 32 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 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
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*
Mencakup 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 8192 byte
*  Untuk mengetahui definisi struktur ini, lihat OpenTelemetry trace.proto.

Batas cakupan rekaman aktivitas

Batas 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 rentang yang disimpan oleh Cloud 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

Anda dapat meminta batas Cloud Trace API yang lebih tinggi atau lebih rendah menggunakan konsolGoogle Cloud . 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 pada kuota. Perhatikan juga bahwa penagihan harus diaktifkan di Google Cloud project agar kotak centang dapat diklik.

Memantau penggunaan kuota

Untuk memastikan bahwa Anda tidak kehabisan kuota dan kehilangan kemampuan untuk mengamati performa aplikasi, pastikan 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.