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 layanan Google Cloud menggunakan Observability API untuk menyimpan datanya, sistem akan membuat bucket observasi berdasarkan nama layanan. Misalnya, untuk layanan Cloud Trace, bucket yang dibuat sistem diberi nama _Trace. Untuk mempelajari struktur bucket kemampuan observasi, lihat Bucket.
Set data
Set data adalah entitas penyimpanan. Setiap dataset adalah turunan dari bucket kemampuan pengamatan. Saat membuat bucket pengamatan untuk layanan Google Cloud , sistem juga membuat satu set data. Misalnya, setelah sistem membuat bucket _Trace, sistem akan membuat set data bernama Spans. Set data tersebut menyimpan data rekaman aktivitas Anda. Untuk mempelajari struktur kumpulan 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. Saat set data dibuat, sistem akan otomatis membuat satu tampilan. 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 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 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 melakukan satu upaya untuk membuat bucket bernama _Trace jika bucket tersebut tidak ada dan salah satu kondisi berikut terpenuhi:

  • Aplikasi mengirimkan data rekaman aktivitas 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.

Untuk menentukan apakah bucket pengamatan bernama _Trace ada atau untuk memicu alur yang membuat bucket ini, lakukan hal berikut:

  1. Di konsol Google Cloud , buka halaman Trace explorer:

    Buka Trace explorer

    Anda juga dapat menemukan halaman ini dengan menggunakan kotak penelusuran.

  2. Lakukan salah satu hal berikut:

    • Jika halaman menampilkan data rekaman aktivitas, Anda tidak perlu melakukan apa pun. Project Google Cloud Anda berisi bucket pengamatan bernama _Trace.

    • Jika halaman menampilkan banner berikut, maka aplikasi Anda tidak memiliki data rekaman aktivitas, atau hanya memiliki data dari Cloud Run Functions, Cloud Run, dan App Engine.

      Trace storage is not initialized for this project. Enable trace storage to begin collecting trace data.

      Jika Anda ingin memicu alur yang membuat bucket pengamatan bernama _Trace, buka banner dan klik Aktifkan.

    • Jika halaman menampilkan banner berikut, inisialisasi bucket observasi bernama _Trace gagal. Jika Anda melihat pesan ini, buka banner dan klik Ajukan tiket.

      Initializing trace storage has failed for an unexpected reason. Please file a support ticket for assistance.

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 mencantumkan bucket, set data, tampilan, atau link.
  • Buat bucket kemampuan pengamatan di lokasi selain us; bucket kemampuan pengamatan harus berada di lokasi us.

Langkah berikutnya