Memecahkan masalah

Halaman ini berisi informasi pemecahan masalah untuk Trace.

Masalah umum

Bagian ini mencantumkan masalah umum:

Rentang yang ditulis keyour Google Cloud project menggunakan Telemetry API tidak dapat diakses oleh Cloud Trace API. Misalnya, jika Anda mencoba mencantumkan rekaman aktivitas ini, perintah akan gagal dengan error 404 Not Found.

Memecahkan masalah Observability Analytics

Bagian ini menjelaskan cara mengatasi kegagalan yang mungkin Anda lihat saat menggunakan Observability Analytics untuk membuat kueri data rekaman aktivitas.

Pesan error yang menyatakan bahwa tampilan tidak ada

Anda memasukkan kueri SQL di panel kueri halaman Observability Analytics , tetapi parser SQL menampilkan error berikut:

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/views/OBS_VIEW_ID does not exist

Error sebelumnya dilaporkan saat tampilan yang ditentukan dalam pernyataan FROM tidak dapat ditemukan.

Untuk mengatasi error ini, pastikan tampilan Anda memiliki sintaksis yang benar:

Pastikan nama tampilan yang sepenuhnya memenuhi syarat mengikuti sintaksis yang diperlukan oleh skema penamaan Observability Analytics. Anda dapat menemukan sintaksis yang diperlukan untuk a tampilan dengan menampilkan kueri default-nya.
Jikaproject ID, location, bucket ID, dataset ID, atau view ID berisi karakter titik, (.), pastikan kolom tersebut diapit oleh tanda kutip terbalik tunggal, (`). Google Cloud

Misalnya, jika ID your Google Cloud project adalah example.com:bluebird, pernyataan FROM adalah sebagai berikut:
```
FROM `example.com:bluebird`.`us`.`_Trace`.`Spans`.`_AllSpans`
```

Pesan Memulai Observability Analytics ditampilkan

Anda membuka halaman Observability Analytics dan halaman tersebut menampilkan jendela dengan pesan yang mirip dengan berikut ini:

Get started with Observability Analytics

Untuk menggunakan Observability Analytics, di jendela, klik Tutup.

Pesan sebelumnya ditampilkan jika Anda tidak memiliki bucket log yang diupgrade untuk menggunakan Observability Analytics. Namun, data rekaman aktivitas Anda tidak disimpan di bucket log.

Penggabungan beberapa tampilan gagal

Anda menulis kueri yang menggabungkan beberapa tampilan, tetapi kueri tersebut ditandai sebagai tidak valid.

Tidak semua tampilan dapat digabungkan.

Untuk menggabungkan tampilan, batasan berikut berlaku:

Lokasi tampilan memenuhi salah satu hal berikut:
- Semua tampilan memiliki lokasi yang sama.
- Semua tampilan berada di lokasi global atau us.
Saat resource penyimpanan menggunakan kunci enkripsi yang dikelola pelanggan (CMEK), salah satu hal berikut harus benar:
- Resource penyimpanan yang menggunakan CMEK menggunakan kunci Cloud KMS yang sama.
- Resource penyimpanan yang menggunakan CMEK memiliki ancestor umum, dan ancestor tersebut menentukan kunci Cloud KMS default Cloud KMS yang berada di lokasi yang sama dengan resource penyimpanan.
Jika satu atau beberapa resource penyimpanan menggunakan CMEK, sistem akan mengenkripsi data sementara yang dihasilkan oleh penggabungan dengan kunci Cloud KMS umum atau kunci Cloud KMS default ancestor.

Misalnya, Anda memiliki dua tampilan yang berada di lokasi yang sama. Kemudian, Anda dapat menggabungkan tampilan ini jika salah satu hal berikut berlaku:

Resource penyimpanan tidak menggunakan CMEK.
Satu resource penyimpanan menggunakan CMEK dan yang lainnya tidak.
Kedua resource penyimpanan menggunakan CMEK dan keduanya menggunakan kunci Cloud KMS yang sama.
Kedua resource penyimpanan menggunakan CMEK, tetapi menggunakan kunci yang berbeda. Namun, resource tersebut berbagi an ancestor yang menentukan kunci Cloud KMS default yang berada di lokasi yang sama dengan the resource penyimpanan.

Misalnya, hierarki resource untuk bucket log dan bucket observability mencakup organisasi yang sama. Anda dapat menggabungkan tampilan di bucket tersebut jika, untuk organisasi tersebut, Anda telah mengonfigurasi setelan resource default untuk Cloud Logging dan untuk bucket observability dengan kunci Cloud KMS default yang sama untuk lokasi penyimpanan.

Tidak ada data di halaman Trace Explorer

Anda memiliki aplikasi yang mengirim data rekaman aktivitas keyour Google Cloud project. Namun, saat Anda membuka halaman Trace Explorer, tidak ada data yang ditampilkan.

Ada beberapa kemungkinan alasan mengapa Anda tidak dapat melihat data rekaman aktivitas:

Anda tidak diberi izin yang diperlukan untuk melihat data.
Rentang rekaman aktivitas tidak dikirim ke project Anda.
Aplikasi Anda tidak memiliki izin yang diperlukan untuk menulis data rekaman aktivitas.
Rentang rekaman aktivitas Anda tidak disimpan.

Subbagian berikut memberikan informasi tentang cara memecahkan masalah skenario kegagalan yang tercantum.

Memastikan bahwa Anda memiliki izin untuk melihat data rekaman aktivitas

Untuk melihat data rekaman aktivitas, pastikan Anda telah diberi peran Pengguna Cloud Trace (roles/cloudtrace.user).

Memastikan bahwa rentang rekaman aktivitas dikirim ke project Anda

Untuk memastikan bahwa rentang dikirim ke project Anda, lakukan hal berikut:

Aktifkan Cloud Trace dan Telemetry API.
Peran yang diperlukan untuk mengaktifkan API
Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran.
Aktifkan API

Kedua API dapat menyerap rentang rekaman aktivitas. Namun, Telemetry API direkomendasikan karena kompatibel dengan ekosistem OpenTelemetry dan karena memiliki batas yang lebih besar daripada Cloud Trace API.

Catatan: Mungkin ada kebijakan organisasi yang menonaktifkan Cloud Trace API. Kebijakan ini mencegah Anda mengaktifkan API.
Buka halaman Enabled APIs and Services, temukan baris untuk Cloud Trace API dan Telemetry API.

Jika jumlah Requests untuk kedua API ini adalah nol, berarti tidak ada data rekaman aktivitas yang dikirim ke project Anda.

Memastikan bahwa aplikasi Anda memiliki izin yang diperlukan untuk menulis rentang rekaman aktivitas

Untuk menentukan apakah aplikasi Anda memiliki izin untuk menulis data rekaman aktivitas ke project Anda, lakukan hal berikut:

Buka halaman Enabled APIs and Services, temukan baris untuk Cloud Trace API dan Telemetry API, lalu periksa kolom Errors.
Jika Anda melihat nilai bukan nol di kolom Errors untuk salah satu API, berarti ada error saat membaca atau menulis data rekaman aktivitas melalui API tersebut. Untuk mengidentifikasi jenis error, pilih API, pilih tab Metrics, lalu lihat Errors by API method:

Jika penulisan gagal, berikan peran berikut kepada akun layanan yang memberikan kredensial:
- Cloud Trace API: Peran Cloud Trace Agent (roles/cloudtrace.agent).
- Telemetry API: Cloud Telemetry Trace Writer (roles/telemetry.tracesWriter).

Memastikan bahwa data rekaman aktivitas Anda disimpan

Rentang rekaman aktivitas disimpan di bucket observability bernama _Trace. Bucket tersebut disediakan secara otomatis saat your Google Cloud project menerima rentang rekaman aktivitas. Namun, ada beberapa skenario saat penyediaan gagal.

Untuk menentukan apakah bucket observability ada untuk data rekaman aktivitas Anda, Anda dapat mencantumkan bucket observability atau Anda dapat membuka halaman Trace Explorer. Misalnya, Anda dapat melakukan hal berikut:

Di Google Cloud konsol, buka halaman Trace explorer:
Buka Trace explorer

Anda juga dapat menemukan halaman ini menggunakan kotak penelusuran.
Jika Anda melihat banner yang mirip dengan berikut ini, berarti penyimpanan untuk data rekaman aktivitas Anda tidak disediakan.
```
Trace storage is not initialized for this project. Enable trace storage to begin collecting trace data.
```
Untuk menyediakan bucket observability untuk data rekaman aktivitas Anda, buka banner dan klik Enable.

Saat Anda mengklik Enable, tindakan tersebut akan menyebabkan rentang dikirim ke project Anda. Saat menerima rentang, sistem akan mengeluarkan perintah untuk membuat bucket observability bernama _Trace. Proses ini dapat memerlukan waktu beberapa menit hingga selesai.

Jika inisialisasi berhasil, banner notifikasi akan ditampilkan dan Cloud Trace akan menyerap data rekaman aktivitas yang dikirim dalam satu jam terakhir. Data ini disimpan dalam buffer sementara. Mungkin perlu waktu beberapa menit sebelum data muncul di Trace Explorer. Jika Anda tidak melihat data apa pun, muat ulang jendela Anda.
Jika perintah aktifkan gagal, pesan berikut akan ditampilkan:
```
Initializing trace storage has failed for an unexpected reason. Please file a support ticket for assistance.
```
Untuk mengatasi kegagalan, hubungi Google Cloud dukungan dengan mengklik File a ticket.

Penelusuran rekaman aktivitas tertentu gagal

Anda memasukkan ID rekaman aktivitas ke halaman Trace Explorer. Rekaman aktivitas tidak ditemukan dan pesan yang mirip dengan berikut ini ditampilkan:

The select trace with ID abcde does not exist or is older than 30 days and has been deleted per our retention policy.

Untuk mengatasi kegagalan ini, coba langkah-langkah berikut:

Pastikan stempel waktu yang terkait dengan ID rekaman aktivitas berada dalam periode retensi.
Identifikasi Google Cloud project yang menyimpan rekaman aktivitas, dan pastikan pemilih resource di Google Cloud konsol memilih project ini. Secara default, halaman Trace Explorer hanya memiliki akses ke data rekaman aktivitas yang disimpan di project yang dipilih.

Data lama tidak ada di halaman Trace Explorer

Anda menggunakan halaman Trace Explorer dan dapat melihat data terbaru, tetapi saat Anda menetapkan pemilih rentang waktu ke 30 hari atau ke nilai yang lebih besar, data lama tidak ditampilkan.

Halaman Trace Explorer tidak menampilkan data untuk periode waktu yang lebih besar dari periode retensi data Cloud Trace, yaitu 30 hari.

Jika pemilih rentang waktu adalah 30 hari atau kurang, data yang tidak ada menunjukkan bahwa database yang dikueri oleh kueri halaman Trace Explorer dibuat lebih baru daripada setelan rentang waktu Anda. Misalnya, jika Anda menetapkan nilai ini ke 20 hari dan hanya dapat melihat data 10 hari terakhir, database dibuat 10 hari yang lalu. Selain itu, database ini hanya berisi rekaman aktivitas yang dikirim ke your Google Cloud project setelah database dibuat.

Rekaman aktivitas tidak lengkap ditampilkan

Anda membuka halaman Trace Explorer dan memilih rentang untuk dilihat. Flyout Details menampilkan rekaman aktivitas, tetapi rekaman aktivitas tidak lengkap. Beberapa rentang tidak ditampilkan.

Rentang mungkin tidak ada karena alasan berikut:

Halaman Trace Explorer tidak menelusuri semua Google Cloud project yang menyimpan data rentang untuk rekaman aktivitas.
Peran IAM Anda di a Google Cloud project yang menyimpan data rentang untuk rekaman aktivitas tidak berisi izin yang diperlukan untuk melihat data rekaman aktivitas.
Ada masalah instrumentasi. Misalnya, hanya beberapa rentang dalam rekaman aktivitas yang dikirim keyour Google Cloud project.

Untuk mengatasi masalah ini, lakukan hal berikut:

Di halaman Trace Explorer, pastikan untuk menetapkan elemen Scope ke cakupan rekaman aktivitas yang mencantumkan project yang menyimpan rentang untuk rekaman aktivitas yang dipilih.

Jika tidak ada cakupan rekaman aktivitas yang menyertakan project yang Anda identifikasi pada langkah sebelumnya, buat atau ubah cakupan rekaman aktivitas yang ada. Untuk mengetahui informasi selengkapnya, lihat Membuat dan mengelola cakupan rekaman aktivitas.
Pastikan Anda memiliki peran Pengguna Cloud Trace (roles/cloudtrace.user) di project yang menyimpan data rentang.

Anda tidak memiliki izin yang diperlukan untuk melihat data rekaman aktivitas

Anda melihat halaman Trace Explorer dan melihat notifikasi berikut:

You don't have the required permissions to view trace data for one or more projects listed in the trace scope.

Untuk mengatasi pesan ini, di toolbar, lakukan hal berikut:

Luaskan elemen Scope dan identifikasi cakupan rekaman aktivitas yang dipilih.
Di flyout Refine scope, pilih Manage scopes.
Temukan cakupan rekaman aktivitas yang Anda identifikasi pada langkah pertama, lalu luaskan detailnya untuk melihat daftarproject. Google Cloud
Untuk setiapproject dalam cakupan rekaman aktivitas, pastikan Anda memiliki peran Pengguna Cloud Trace (roles/cloudtrace.user). Jika Anda tidak memiliki peran tersebut di project, minta administrator atau pemilik project untuk memberi Anda peran tersebut. Google Cloud

Kueri lintas region tidak didukung

Anda membuka halaman Trace Explorer dan halaman tersebut menampilkan pesan yang mirip dengan berikut ini:

Error loading chart data. Cross-regional queries are not supported. The selected scope comprises buckets residing in multiple locations: list of locations.

Pesan error menunjukkan bahwa halaman Trace Explorer perlu mengeluarkan kueri untuk data yang disimpan di lokasi yang berbeda.

Untuk mengatasi kegagalan ini, lakukan salah satu hal berikut:

Batasi data rekaman aktivitas ke data yang disimpan oleh project yang Anda pilih:
- Buka toolbar halaman Trace Explorer dan luaskan menu Scope.
- Di flyout Refine scope, pilih Current project.
Pilih cakupan rekaman aktivitas yang mencantumkan project yang datanya disimpan di lokasi yang sama. Untuk melakukan perubahan ini, gunakan opsi di menu Scope.
Hapus project yang datanya disimpan di lokasi yang berbeda dari project yang Anda pilih dari cakupan rekaman aktivitas yang dipilih:
- Buka toolbar halaman Trace Explorer dan luaskan menu Scope.
- Di flyout Refine scope, pilih Manage scopes.
- Dari halaman Trace scopes, Anda dapat mengedit cakupan rekaman aktivitas.
Untuk menemukan lokasi penyimpanan data rekaman aktivitas Anda, jalankan perintah List observability buckets. Di parameter jalur, tentukan project Anda, dan untuk LOCATION, tetapkan kolom ke tanda hubung, (-), yang bertindak sebagai karakter pengganti.

Pesan ID rentang tidak ada dalam rekaman aktivitas

Rekaman aktivitas Anda berisi pesan "Missing span ID".

Dalam sistem pelacakan terdistribusi, rekaman aktivitas yang tidak lengkap adalah hal yang wajar. Rekaman aktivitas tidak lengkap jika rentang yang diambil sampelnya berisi referensi ke rentang lain yang belum diterima. Referensi yang tidak terselesaikan dapat terjadi karena alasan berikut:

Rentang yang direferensikan tidak diambil sampelnya.
Rentang yang direferensikan diambil sampelnya, tetapi belum diterima oleh Cloud Trace atau rentang diterima, tetapi tidak disimpan.

Saat Anda melihat rekaman aktivitas yang tidak lengkap, Cloud Trace akan menampilkan pesan "Missing span ID" di panel detail rekaman aktivitas.

Jika Anda terus melihat pesan "Missing span ID", coba langkah-langkah berikut:

Untuk komponen yang Anda kelola, pastikan komponen tersebut mematuhi dan menyebarkan flag sampled header, jika kolom ini ada. Setelan ini adalah petunjuk untuk komponen turunan agar mengambil sampel permintaan. Untuk mengetahui informasi selengkapnya tentang header rekaman aktivitas, lihat Protokol untuk propagasi konteks.

Google Cloud layanan biasanya mematuhi petunjuk ini. Namun, layanan ini juga membatasi kecepatan penulisan data rekaman aktivitas.
Jika Anda menggunakan Cloud Service Mesh, pastikan Anda mengikuti panduan untuk menyebarkan konteks rekaman aktivitas untuk konfigurasi tersebut. Untuk panduan Cloud Service Mesh, lihat Propagasi konteks rekaman aktivitas.

Tidak dapat mengorelasikan data log dan rekaman aktivitas

Anda melakukan salah satu hal berikut:

Anda melihat rentang rekaman aktivitas dan ingin melihat entri log terkait. Namun, tidak ada data log yang tercantum atau, saat Anda membuka halaman Logs Explorer, halaman tersebut tidak menampilkan entri log apa pun.
Anda melihat entri log dan ingin melihat rentang rekaman aktivitas terkait. Namun, saat Anda menggunakan opsi di entri log untuk membuka halaman Trace Explorer, halaman tersebut tidak menampilkan data rekaman aktivitas apa pun.

Untuk mengatasi kegagalan ini, konfigurasikan cakupan observability. Cakupan ini menentukan cakupan rekaman aktivitas dan cakupan log mana yang akan digunakan saat halaman explorer yang sesuai dibuka. Untuk mempelajari lebih lanjut, lihat Mengonfigurasi cakupan observability untuk kueri multi-project.

Tidak ada data rekaman aktivitas setelah mengupdate aplikasi Go untuk menggunakan OpenTelemetry

Aplikasi Anda bergantung pada library klien untuk mengambil rekaman aktivitas, dan setelah mengupdate aplikasi untuk menggunakan OpenTelemetry, Anda tidak lagi melihat data Cloud Trace.

Karena beberapa Library Klien Cloud untuk Go terintegrasi dengan OpenCensus, Anda harus menggunakan OpenCensus Bridge. Untuk mengetahui informasi selengkapnya tentang masalah yang diselesaikan oleh bridge, lihat OpenCensus Bridge.

Untuk mengetahui informasi tentang update Library Klien Cloud untuk Go, lihat Masalah #4237.