Ringkasan penyimpanan rekaman aktivitas

Dokumen ini menjelaskan model penyimpanan untuk data Cloud Trace. Fitur ini memperkenalkan bucket kemampuan observasi, tampilan kemampuan observasi, dan link. Jika Anda membuat penautan, Anda dapat membuat kueri data rekaman aktivitas dari BigQuery.

Dokumen ini tidak menjelaskan skema, yang menentukan cara penyimpanan setiap rentang. Untuk mempelajari lebih lanjut, lihat Skema rekaman aktivitas.

Model penyimpanan kemampuan observasi

Model penyimpanan Observability API mengandalkan arsitektur berikut:

Bucket kemampuan observasi
Bucket keobservasian adalah entitas pengelolaan untuk set data, yang menyimpan data. Bucket observasi berada di lokasi tertentu dan memiliki kebijakan retensi data. Saat Google Cloud layanan menggunakan Observability API untuk menyimpan datanya, sistem akan membuat bucket observasi berdasarkan nama layanan, set data untuk menyimpan data, dan tampilan untuk memberikan akses baca ke data yang disimpan. Misalnya, untuk layanan Cloud Trace, sistem akan memberi nama bucket yang dibuat sistem _Trace, set data Spans, dan tampilan _AllSpans. Untuk mempelajari struktur bucket kemampuan observasi, lihat Bucket.
Set data
Set data menyimpan data. Sistem akan otomatis membuat satu set data saat membuat bucket observabilitas, yang mengelola set data. Misalnya, saat membuat bucket _Trace, sistem juga membuat set data bernama Spans, yang menyimpan data rekaman aktivitas Anda. Untuk mempelajari struktur set data, lihat Dataset.
Tampilan pada set data
Setiap set data menghosting satu atau beberapa tampilan. Tampilan memberikan akses baca ke subset entri dalam set data. Sistem membuat satu tampilan saat membuat set data. Tampilan tersebut mencakup semua data dalam set data. Nama tampilan bergantung pada layanan. Misalnya, untuk layanan Cloud Trace, sistem membuat tampilan bernama _AllSpans di set data Spans. Untuk mempelajari struktur tampilan, lihat View.
Link di set data

Setiap set data dapat berisi maksimal satu link. Saat Anda membuat link untuk set data, sistem akan membuat set data BigQuery tertaut. Kemudian, Anda dapat membuat kueri data di set data menggunakan BigQuery atau layanan lain yang menggunakan BigQuery API. Untuk mempelajari struktur link, lihat Link.

Sistem tidak otomatis membuat link pada set data.

Konfigurasi penyimpanan untuk data rekaman aktivitas

Data rekaman aktivitas Anda disimpan dalam bucket observabilitas bernama _Trace. Sistem membuat set data bernama Spans di bucket ini. Pada set data tersebut, sistem membuat tampilan bernama _AllSpans. Tampilan ini mencakup semua data dalam set data.

Sistem mencoba membuat bucket pengamatan bernama _Trace jika bucket tidak ada dan salah satu hal berikut terpenuhi:

  • Aplikasi mengirimkan data trace ke project Google Cloud Anda menggunakan Cloud Trace API atau Telemetry API.

  • Anda mengaktifkan Cloud Trace untuk Google Cloud layanan, lalu layanan tersebut mengirimkan data rekaman aktivitas ke project Google Cloud Anda. Misalnya, Cloud Service Mesh mendukung pengumpulan rekaman aktivitas; namun, pengumpulan rekaman aktivitas dinonaktifkan secara default. Jika Anda mengaktifkan pelacakan untuk Cloud Service Mesh, maka data yang dikirim oleh layanan tersebut akan menyebabkan sistem membuat bucket.

    Data rekaman aktivitas yang dihasilkan oleh Cloud Run Functions, Cloud Run, dan App Engine tidak menyebabkan sistem membuat bucket kemampuan pengamatan. Rentang dari layanan ini hanya disimpan jika bucket pengamatan ada.

Jika Anda dapat melihat data rekaman aktivitas menggunakan halaman Trace Explorer, berarti bucket pengamatan Anda yang bernama _Trace ada. Jika Anda tidak melihat data apa pun atau jika Anda melihat banner yang menyatakan bahwa penyimpanan belum diinisialisasi, coba salah satu langkah berikut:

Residensi data untuk bucket kemampuan observasi

Jika Anda memiliki persyaratan kepatuhan atau peraturan untuk menyimpan data di lokasi tertentu atau menggunakan CMEK, sebaiknya konfigurasi setelan default untuk bucket kemampuan pengamatan:

  • Untuk organisasi, folder, dan project, setelan default untuk bucket kemampuan pengamatan memungkinkan Anda mengonfigurasi hal berikut:

    • Lokasi penyimpanan default.
    • Untuk setiap lokasi, kunci Cloud Key Management Service default.

    Turunan dalam hierarki resource akan otomatis menggunakan setelan ini, kecuali untuk turunan yang telah Anda konfigurasi setelan defaultnya.

    Setelan default untuk bucket kemampuan pengamatan hanya berlaku untuk resource baru, bukan resource yang sudah ada. Untuk mempelajari lebih lanjut, lihat Menetapkan default untuk bucket kemampuan observasi.

Setelan default untuk setelan bucket observabilitas tidak berlaku untuk bucket log, yang menyimpan data log. Untuk mempelajari cara menetapkan lokasi default atau mewajibkan CMEK untuk bucket log, lihat Mengonfigurasi setelan resource default untuk Cloud Logging.

Batasan

Anda tidak dapat melakukan hal berikut:

  • Ubah atau hapus bucket pengamatan.
  • Membuat, menghapus, atau mengubah set data.
  • Membuat, menghapus, atau mengubah tampilan.
  • Gunakan konsol Google Cloud untuk membuat daftar bucket, set data, tampilan, atau link.

Langkah berikutnya