Ringkasan ekspor data rekaman aktivitas

Halaman ini memberikan ringkasan konseptual tentang cara mengekspor data trace menggunakan Cloud Trace. Anda mungkin ingin mengekspor data trace karena alasan berikut:

• Untuk menyimpan data trace selama periode yang lebih lama dari periode retensi default selama 30 hari.

• Untuk memungkinkan Anda menggunakan alat BigQuery guna menganalisis data trace. Misalnya, menggunakan BigQuery, Anda dapat mengidentifikasi jumlah dan kuantil span. Untuk mengetahui informasi tentang kueri yang digunakan untuk membuat tabel berikut, lihat Kueri HipsterShop.

  

Cara kerja ekspor

Ekspor melibatkan pembuatan sink untuk sebuah Google Cloud project. Sink menentukan set data BigQuery sebagai tujuannya.

Anda dapat membuat sink menggunakan Cloud Trace API atau menggunakan Google Cloud CLI.

Properti dan terminologi sink

Sink ditentukan untuk sebuah Google Cloud project dan memiliki properti berikut:

• Nama: Nama untuk sink. Misalnya, nama dapat berupa:

  "projects/PROJECT_NUMBER/traceSinks/my-sink"
  

  dengan PROJECT_NUMBER adalah nomor Google Cloud project sink dan my-sink adalah ID sink.

• Induk: Resource tempat Anda membuat sink. Induk harus berupa sebuah Google Cloud project:

  "projects/PROJECT_ID"
  

  PROJECT_ID dapat berupa Google Cloud ID atau nomorproject.

• Tujuan: Satu tempat untuk mengirim span trace. Trace mendukung ekspor trace ke BigQuery. Tujuannya dapat berupaproject Google Cloud sink atauproject lain Google Cloud yang berada dalam organisasi yang sama.

  Misalnya, tujuan yang valid adalah:

  bigquery.googleapis.com/projects/DESTINATION_PROJECT_NUMBER/datasets/DATASET_ID
  

  dengan DESTINATION_PROJECT_NUMBER adalah Google Cloud nomor project tujuan, dan DATASET_ID adalah ID set data BigQuery.

• Identitas Penulis: Nama akun layanan. Pemilik tujuan ekspor harus memberikan izin kepada akun layanan ini untuk menulis ke tujuan ekspor. Saat mengekspor trace, Trace mengadopsi identitas ini untuk otorisasi. Untuk meningkatkan keamanan, sink baru akan mendapatkan akun layanan unik:

  export-PROJECT_NUMBER-GENERATED_VALUE@gcp-sa-cloud-trace.iam.gserviceaccount.com
  

  dengan PROJECT_NUMBER adalah nomor Google Cloud project Anda, dalam Hex, dan GENERATED_VALUE adalah nilai yang dibuat secara acak.

  Anda tidak membuat, memiliki, atau mengelola akun layanan yang diidentifikasi oleh identitas penulis sink. Saat Anda membuat sink, Trace akan membuat akun layanan yang diperlukan sink. Akun layanan ini tidak disertakan dalam daftar akun layanan untuk project Anda hingga memiliki setidaknya satu binding Identity and Access Management. Anda menambahkan binding ini saat mengonfigurasi tujuan sink.

  Untuk mengetahui informasi tentang cara menggunakan identitas penulis, lihat izin tujuan.

Cara kerja sink

Setiap kali span trace tiba di sebuah project, Trace akan mengekspor salinan span.

Trace yang diterima Trace sebelum sink dibuat tidak dapat diekspor.

Kontrol akses

Untuk membuat atau mengubah sink, Anda harus memiliki salah satu peran Identity and Access Management berikut:

• Admin Trace
• Pengguna Trace
• Pemilik Project
• Editor Project

Untuk mengetahui informasi selengkapnya, lihat Kontrol akses.

Untuk mengekspor trace ke tujuan, akun layanan penulis sink harus diizinkan untuk menulis ke tujuan. Untuk mengetahui informasi selengkapnya tentang identitas penulis, lihat Properti sink di halaman ini.

Kuota dan batas

Cloud Trace menggunakan BigQuery Streaming API untuk mengirim span trace ke tujuan. Cloud Trace melakukan batch pada panggilan API. Cloud Trace tidak menerapkan mekanisme percobaan ulang atau throttling. Span trace mungkin tidak berhasil diekspor jika jumlah data melebihi kuota tujuan.

Untuk mengetahui detail kuota dan batas BigQuery, lihat Kuota dan batas.

Harga

Mengekspor trace tidak dikenai biaya Cloud Trace. Namun, Anda mungkin dikenai biaya BigQuery. Lihat Harga BigQuery untuk mengetahui informasi selengkapnya.

Memperkirakan biaya

BigQuery mengenakan biaya untuk penyerapan dan penyimpanan data. Untuk memperkirakan biaya BigQuery bulanan, lakukan hal berikut:

1. Perkirakan jumlah total span trace yang diserap dalam sebulan.

   Untuk mengetahui informasi tentang cara melihat penggunaan, lihat Melihat penggunaan menurut akun penagihan.

2. Perkirakan persyaratan streaming berdasarkan jumlah span trace yang diserap.

   Setiap span ditulis ke baris tabel. Setiap baris di BigQuery memerlukan minimal 1.024 byte. Oleh karena itu, batas bawah pada persyaratan streaming BigQuery Anda adalah menetapkan 1.024 byte ke setiap span. Misalnya, jika Google Cloud project Anda menyerap 200 span, span tersebut memerlukan setidaknya 20.400 byte untuk streaming insert.

3. Gunakan Kalkulator harga untuk memperkirakan biaya BigQuery Anda karena penyimpanan, streaming insert, dan kueri.

Melihat dan mengelola penggunaan BigQuery

Anda dapat menggunakan Metrics Explorer untuk melihat penggunaan BigQuery. Anda juga dapat membuat kebijakan pemberitahuan yang memberi tahu Anda jika penggunaan BigQuery melebihi batas yang telah ditentukan. Tabel berikut berisi setelan untuk membuat kebijakan pemberitahuan. Anda dapat menggunakan setelan dalam tabel panel target saat membuat diagram atau saat menggunakan Metrics Explorer.

Untuk membuat kebijakan pemberitahuan yang terpicu saat metrik BigQuery yang diserap melebihi tingkat yang ditentukan pengguna, gunakan setelan berikut.

Langkah-langkah untuk membuat kebijakan pemberitahuan.

Untuk membuat kebijakan pemberitahuan, lakukan langkah berikut:

1. Di Google Cloud konsol, buka halaman notifications Pemberitahuan:

   Buka Pemberitahuan

   Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

2. Jika Anda belum membuat saluran notifikasi dan ingin menerima notifikasi, klik Edit Saluran Notifikasi dan tambahkan saluran notifikasi Anda. Kembali ke halaman Pemberitahuan setelah menambahkan saluran.
3. Dari halaman Alerting, pilih Create policy.
4. Untuk memilih resource, metrik, dan filter, luaskan menu Select a metric dan gunakan nilai dalam tabel New condition:
   1. Opsional: Agar menu hanya menampilkan entri yang relevan, masukkan nama resource atau metrik di kolom filter.
   2. Pilih salah satu Resource type. Misalnya, pilih VM instance.
   3. Pilih salah satu Metric category. Misalnya, pilih instance.
   4. Pilih salah satu Metric. Misalnya, pilih CPU Utilization.
   5. Pilih Apply.
5. Klik Next, lalu konfigurasi pemicu kebijakan pemberitahuan. Untuk melengkapi kolom ini, gunakan nilai dalam tabel Mengonfigurasi pemicu pemberitahuan.
6. Klik Next.

7. Opsional: Untuk menambahkan notifikasi ke kebijakan pemberitahuan, klik Saluran notifikasi. Dalam dialog ini, pilih satu atau beberapa saluran notifikasi dari menu, lalu klik OK.

   Untuk menerima notifikasi saat insiden dibuka dan ditutup, centang Notify on incident closure. Secara default, notifikasi hanya dikirim saat insiden dibuka.

8. Opsional: Perbarui Incident autoclose duration. Kolom ini menentukan kapan Monitoring akan menutup insiden jika data metrik tidak ada.
9. Opsional: Klik Documentation, lalu tambahkan informasi apa pun yang ingin Anda sertakan dalam pesan notifikasi.
10. Klik Nama pemberitahuan dan masukkan nama untuk kebijakan pemberitahuan itu.
11. Klik Create Policy.

Kolom New condition	Nilai
Resource and Metric	Di menu Resources, pilih BigQuery Dataset. Di menu Metric categories, pilih Storage. Pilih metrik dari menu Metrics. Metrik khusus untuk penggunaan mencakup Stored bytes, Uploaded bytes, dan Uploaded bytes billed. Untuk mengetahui daftar lengkap metrik yang tersedia, lihat Metrik BigQuery.
Filter	project_id: Project ID Anda Google Cloud . dataset_id: ID set data Anda.
Di seluruh deret waktu Mengelompokkan deret waktu menurut	dataset_id: ID set data Anda.
Di seluruh deret waktu Agregasi deret waktu	sum
Rolling window	1 m
Rolling window function	mean

Kolom Configure alert trigger	Nilai
Condition type	Threshold
Alert trigger	Any time series violates
Threshold position	Above threshold
Threshold value	Anda menentukan nilai yang dapat diterima.
Retest window	1 minute

Langkah berikutnya

Untuk mengonfigurasi sink, lihat Mengekspor trace.