Ringkasan penyimpanan rekaman aktivitas

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

Dokumen ini tidak menjelaskan skema, yang menentukan cara penyimpanan rentang individual. Untuk mengetahui informasi tentang format penyimpanan, lihat Skema rekaman aktivitas.

Model penyimpanan kemampuan observasi

Model penyimpanan Observability API mengandalkan arsitektur berikut:

Bucket kemampuan observasi
Bucket kemampuan observasi adalah entity pengelolaan untuk set data, yang menyimpan data. Bucket kemampuan observasi berada di lokasi tertentu dan memiliki kebijakan retensi data. Saat layanan menggunakan Observability API untuk menyimpan datanya, sistem akan membuat bucket kemampuan observasi berdasarkan nama layanan, set data untuk menyimpan data, dan tampilan untuk memberikan akses baca ke data yang disimpan. Google Cloud 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 kemampuan observasi, yang mengelola set data. Misalnya, saat sistem membuat bucket _Trace, sistem juga akan 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 akan 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 akan membuat tampilan bernama _AllSpans pada set data Spans. Untuk mempelajari struktur tampilan, lihat View.
Link pada 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 dalam 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 kemampuan observasi bernama _Trace. Sistem akan membuat set data bernama Spans di bucket ini. Pada set data tersebut, sistem akan membuat tampilan bernama _AllSpans. Tampilan ini mencakup semua data dalam set data.

Sistem akan mencoba membuat bucket kemampuan observasi bernama _Trace jika bucket tidak ada dan salah satu hal berikut benar:

  • Aplikasi mengirimkan data rekaman aktivitas ke your Google Cloud project menggunakan the Cloud Trace API atau Telemetry API.

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

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

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

Residensi data untuk bucket kemampuan observasi

Jika Anda memiliki persyaratan kepatuhan atau peraturan untuk menyimpan data di lokasi tertentu atau menggunakan kunci enkripsi yang dikelola pelanggan (CMEK), sebaiknya konfigurasikan kebijakan organisasi dan setelan default untuk bucket kemampuan observasi.

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

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

Jika dikonfigurasi untuk project, setelan ini hanya berlaku untuk bucket kemampuan observasi baru yang dibuat dalam project tersebut. Jika dikonfigurasi untuk folder atau organisasi, setelan ini berlaku untuk bucket kemampuan observasi baru yang dibuat dalam project yang merupakan turunan dari folder atau organisasi, kecuali untuk project yang telah Anda konfigurasi setelan default.

Anda juga dapat menggunakan kebijakan organisasi untuk membatasi lokasi bucket kemampuan observasi baru, mewajibkan penggunaan CMEK, atau membatasi kunci Cloud KMS yang dapat digunakan untuk enkripsi. Jika Anda mengonfigurasi kebijakan organisasi yang mewajibkan penggunaan CMEK, Anda harus mengonfigurasi setelan default untuk bucket kemampuan observasi. Jika tidak, penyediaan untuk bucket kemampuan observasi yang dibuat sistem akan gagal.

Untuk mempelajari lebih lanjut, lihat Menetapkan default untuk bucket kemampuan observasi.

Batasan

Anda tidak dapat melakukan hal berikut:

  • Mengubah atau menghapus bucket kemampuan observasi.
  • Membuat, menghapus, atau mengubah set data.
  • Membuat, menghapus, atau mengubah tampilan.
  • Menggunakankonsol untuk mencantumkan bucket, set data, tampilan, atau link. Google Cloud

Langkah berikutnya