Ringkasan ekspor data trace

Halaman ini menyediakan ringkasan konseptual tentang mengekspor data trace menggunakan Cloud Trace. Anda mungkin ingin mengekspor data rekaman aktivitas karena alasan berikut:

Untuk menyimpan data rekaman aktivitas selama periode yang lebih lama dari periode retensi data default 30 hari.
Agar Anda dapat menggunakan alat BigQuery untuk menganalisis data trace. Misalnya, dengan menggunakan BigQuery, Anda dapat mengidentifikasi jumlah dan kuantil span. Untuk informasi tentang kueri yang digunakan untuk membuat tabel berikut, lihat kueri HipsterShop.

Cara kerja ekspor

Pengeksporan melibatkan pembuatan sink untuk project Google Cloud. Sink menentukan set data BigQuery sebagai tujuan.

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

Properti dan terminologi sink

Sink ditentukan untuk project Google Cloud dan memiliki properti berikut:

Nama: Nama untuk sink. Sebagai contoh, sebuah nama mungkin:
```
"projects/PROJECT_NUMBER/traceSinks/my-sink"
```
dengan PROJECT_NUMBER sebagai nomor project Google Cloud sink, dan my-sink adalah ID sink.
Induk: Resource tempat Anda membuat sink. Induk harus merupakan project Google Cloud:
```
"projects/PROJECT_ID"
```
PROJECT_ID dapat berupa ID atau nomor project Google Cloud.
Tujuan: Satu tempat untuk mengirim span trace. Trace mendukung ekspor trace ke BigQuery. Tujuannya dapat berupa project Google Cloud sink atau project Google Cloud lainnya yang berada di organisasi yang sama.

Misalnya, tujuan yang valid adalah:
```
bigquery.googleapis.com/projects/DESTINATION_PROJECT_NUMBER/datasets/DATASET_ID
```
dengan DESTINATION_PROJECT_NUMBER sebagai nomor tujuan project Google Cloud, dan DATASET_ID sebagai ID set data BigQuery.
Writer Identity: Nama akun layanan. Pemilik tujuan ekspor harus memberi akun layanan ini izin untuk menulis ke tujuan ekspor. Saat mengekspor trace, Trace menggunakan identitas ini untuk otorisasi. Untuk meningkatkan keamanan, sink baru mendapatkan akun layanan yang unik:
```
export-PROJECT_NUMBER-GENERATED_VALUE@gcp-sa-cloud-trace.iam.gserviceaccount.com
```
dengan PROJECT_NUMBER adalah nomor project Google Cloud Anda, dalam Hex, dan GENERATED_VALUE adalah nilai yang dibuat secara acak.

Anda tidak boleh membuat, memiliki, atau mengelola akun layanan yang diidentifikasi oleh identitas penulis sink. Saat Anda membuat sink, Trace membuat akun layanan yang diperlukan oleh 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 informasi tentang penggunaan identitas penulis, lihat izin tujuan.

Cara kerja sink

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

Rekaman aktivitas 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 rekaman aktivitas ke tujuan, akun layanan penulis sink harus diizinkan menulis ke tujuan. Untuk 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 mengelompokkan 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 tentang kuota dan batas BigQuery, lihat Kuota dan batas.

Harga

Mengekspor rekaman aktivitas tidak dikenai biaya Cloud Trace. Namun, Anda dapat dikenai biaya BigQuery. Lihat harga BigQuery untuk mengetahui informasi selengkapnya.

Memperkirakan biaya Anda

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

Memperkirakan jumlah total span trace yang diserap dalam sebulan.

Untuk informasi cara melihat penggunaan, lihat Melihat penggunaan menurut akun penagihan.
Memperkirakan persyaratan streaming berdasarkan jumlah span rekaman aktivitas yang diserap.

Setiap span ditulis ke baris tabel. Setiap baris di BigQuery memerlukan setidaknya 1.024 byte. Oleh karena itu, batas bawah pada persyaratan streaming BigQuery Anda adalah menetapkan 1.024 byte untuk setiap span. Misalnya, jika project Google Cloud Anda menyerap 200 span, maka span tersebut memerlukan setidaknya 20.400 byte untuk streaming insert.
Gunakan Kalkulator Harga untuk memperkirakan biaya BigQuery Anda karena penyimpanan, streaming insert, dan kueri.

Melihat dan mengelola penggunaan BigQuery Anda

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 di 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 membuat kebijakan pemberitahuan.

Untuk membuat kebijakan pemberitahuan, lakukan langkah berikut:

Pada panel navigasi Konsol Google Cloud, pilih Monitoring, lalu pilih Alerting:
Buka Alerting
ika Anda belum membuat saluran notifikasi dan ingin menerima notifikasi, klik Edit Notification Channels dan tambahkan saluran notifikasi Anda. Kembali ke halaman Alerting setelah menambahkan saluran.
Dari halaman Alerting, pilih Create policy.
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.
Klik Next, lalu konfigurasi pemicu kebijakan pemberitahuan. Untuk melengkapi kolom ini, gunakan nilai dalam tabel Mengonfigurasi pemicu pemberitahuan.
Klik Next.
Opsional: Untuk menambahkan notifikasi ke kebijakan pemberitahuan, klik Notification channels. 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.
Opsional: Perbarui Incident autoclose duration. Kolom ini menentukan kapan Monitoring akan menutup insiden jika data metrik tidak ada.
Opsional: Klik Documentation, lalu tambahkan informasi apa pun yang ingin Anda sertakan dalam pesan notifikasi.
Klik Alert name dan masukkan nama untuk kebijakan pemberitahuan itu.
Klik Create Policy.

Kolom New condition	Nilai
Resource and Metric	Di menu Resources, pilih Set Data BigQuery. Di menu Kategori metrik, pilih Penyimpanan. 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: ID project Google Cloud Anda. 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 selanjutnya

Untuk mengonfigurasi sink, lihat Mengekspor rekaman aktivitas.