Ringkasan penyimpanan rekaman aktivitas

Data Cloud Trace Anda disimpan dalam set data kemampuan observasi yang dikelola oleh bucket kemampuan observasi. Memahami model penyimpanan membantu Anda mengontrol tempat data trace disimpan, menerapkan kebijakan enkripsi, dan menghubungkan telemetri ke layanan analisis yang disediakan oleh Observability Analytics dan BigQuery.

Untuk mengetahui informasi tentang cara menggunakan BigQuery untuk menganalisis data trace, lihat Membuat set data BigQuery tertaut.

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 Google Cloud 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. 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.

Google Cloud Observability menggunakan setelan default dan kebijakan organisasi untuk menentukan lokasi dan model enkripsi untuk bucket kemampuan observasi baru. Jika bucket observabilitas yang ada tidak memenuhi persyaratan peraturan organisasi, Anda mungkin dapat menyediakan ulang bucket observabilitas.

Set data

Set data menyimpan data. Sistem akan otomatis membuat satu set data saat membuat bucket kemampuan observasi, yang mengelola set data tersebut. Misalnya, saat sistem membuat bucket _Trace, sistem juga membuat set data bernama Spans, yang menyimpan data trace 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 akan 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 mengkueri data dalam set data menggunakan BigQuery atau layanan lain yang menggunakan BigQuery API. Untuk mempelajari struktur link, lihat Link.

Sistem tidak otomatis membuat link di set data.

Konfigurasi penyimpanan untuk data trace

Data trace disimpan dalam set data yang dikelola oleh bucket kemampuan observasi bernama _Trace. Untuk menyimpan set data, bucket _Trace harus ada. Bucket _Trace dapat dibuat secara otomatis atau manual:

  • Pembuatan otomatis: Sistem akan otomatis membuat bucket sebagai respons terhadap penerimaan data trace dari aplikasi atau layanan Google Cloud . Sistem menggunakan setelan default yang berlaku untuk bucket kemampuan observasi guna menentukan lokasi dan kunci enkripsi bucket. Jika Anda belum menentukan setelan default, sistem akan memilih lokasi yang didukung dan bucket akan menggunakan enkripsi berstandar Google.

    Data trace yang dihasilkan oleh Cloud Run Functions, Cloud Run, dan App Engine tidak menyebabkan sistem membuat bucket kemampuan observasi. Span dari layanan ini hanya disimpan jika bucket kemampuan observasi ada.

  • Pembuatan manual: Anda dapat menggunakan Observability API untuk membuat bucket _Trace sebelum project Google Cloud Anda menerima data trace. Anda harus memberikan lokasi bucket. Anda dapat memberikan kunci Cloud Key Management Service:

    • Jika Anda memberikan kunci, sistem akan menggunakan kunci tersebut untuk mengenkripsi data yang disimpan.
    • Jika Anda tidak memberikan kunci Cloud KMS, setelan default yang berlaku untuk resource induk bucket akan menentukan kunci enkripsi. Jika setelan default menentukan kunci Cloud KMS, kunci tersebut akan mengenkripsi data yang disimpan. Jika tidak, enkripsi berstandar Google akan digunakan.

Saat bucket _Trace dibuat, sistem juga akan membuat set data bernama Spans untuk bucket, dan tampilan bernama _AllSpans di set data. Tampilan tersebut mencakup semua data dalam set data.

Untuk informasi selengkapnya, lihat referensi berikut:

Jika data trace muncul di halaman Trace Explorer, berarti bucket kemampuan observasi Anda yang bernama _Trace ada. Jika Anda tidak melihat data apa pun atau jika Anda melihat banner yang menyatakan bahwa penyimpanan tidak 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 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.

Ada dua cara berbeda yang digunakan sistem untuk menerapkan setelan default:

  • Saat sistem otomatis membuat bucket kemampuan observasi, sistem akan menggunakan setelan default untuk menentukan lokasi dan kunci enkripsi bucket. Jika Anda belum menentukan setelan default, sistem akan memilih lokasi dan bucket akan menggunakan enkripsi berstandar Google.

  • Saat memulai pembuatan bucket kemampuan observasi dengan mengeluarkan permintaan API, Anda memberikan lokasi. Namun, sistem akan otomatis menggunakan kunci Cloud KMS yang ditentukan oleh setelan default untuk mengenkripsi data, kecuali jika argumen untuk permintaan API menentukan kunci tersebut.

Karena induk bucket kemampuan observasi selalu berupa project, saat Anda membuat bucket, sistem akan terlebih dahulu menelusuri setelan default level project. Jika tidak ada, sistem akan menelusuri ancestor induk untuk menemukan setelan default. Misalnya, jika Anda menentukan setelan default untuk folder, setelan tersebut akan berlaku untuk turunan folder, kecuali turunan yang telah dikonfigurasi setelan defaultnya.

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

Untuk informasi selengkapnya, baca dokumen berikut:

Batasan

Anda tidak dapat melakukan hal berikut:

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

Langkah berikutnya