Memecahkan masalah

Halaman ini berisi informasi pemecahan masalah untuk Trace.

Masalah umum

Bagian ini mencantumkan masalah umum:

Rentang yang ditulis ke project Google Cloud Anda 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 Log Analytics

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

Pesan error yang menyatakan bahwa tampilan tidak ada

Anda memasukkan kueri SQL di panel kueri halaman Log 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 tepat:

Pastikan nama lengkap tampilan mengikuti sintaksis yang diperlukan oleh skema penamaan Log Analytics. Anda dapat menemukan sintaksis yang diperlukan untuk tampilan dengan menampilkan kueri defaultnya.
Jika Google Cloud project ID, lokasi, bucket ID, dataset ID, atau view ID berisi karakter titik, (.), maka verifikasi bahwa kolom tersebut diapit oleh tanda petik terbalik tunggal, (`).

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

Tidak ada data di halaman Trace Explorer

Anda memiliki aplikasi yang mengirimkan data rekaman aktivitas ke project Google Cloud Anda. 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.

Pastikan Anda memiliki izin untuk melihat data rekaman aktivitas

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

Memverifikasi bahwa rentang rekaman aktivitas dikirim ke project Anda

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

Enable the Cloud Trace and Telemetry APIs.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.
Enable the APIs

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

Catatan: Mungkin ada kebijakan org yang telah 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 Permintaan untuk kedua API ini adalah nol, berarti tidak ada data rekaman aktivitas yang dikirim ke project Anda.

Pastikan 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 Error 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, dan lihat Errors by API method:

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

Pastikan data rekaman aktivitas Anda disimpan

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

Untuk menentukan apakah bucket kemampuan observasi ada untuk data trace Anda, Anda dapat [mencantumkan bucket kemampuan observasi][trace-storage-list-buckets] atau membuka halaman Trace Explorer. Misalnya, Anda dapat melakukan hal berikut:

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

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

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

Jika inisialisasi berhasil, banner notifikasi akan ditampilkan dan Cloud Trace akan menyerap data 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 pengaktifan gagal, maka 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 Kirim tiket.

Penelusuran untuk rekaman aktivitas tertentu gagal

Anda memasukkan ID rekaman aktivitas ke halaman Trace Explorer. Rekaman aktivitas tidak ditemukan dan pesan yang mirip dengan berikut ini akan 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 konsol Google Cloud memilih project ini. Secara default, halaman Trace Explorer hanya memiliki akses ke data rekaman aktivitas yang disimpan dalam project yang dipilih.

Data lama tidak ada di halaman Trace Explorer

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

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

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

Trace yang tidak lengkap ditampilkan

Anda membuka halaman Trace Explorer dan memilih rentang untuk dilihat. Flyout Detail 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 project Google Cloud 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 ke project Google Cloud Anda.

Untuk mengatasi masalah ini, lakukan langkah berikut:

Di halaman Trace Explorer, pastikan untuk menyetel elemen Cakupan ke cakupan rekaman aktivitas yang mencantumkan project yang menyimpan span untuk rekaman aktivitas yang dipilih.

Jika tidak ada cakupan rekaman aktivitas yang mencakup 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 sedang 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 Cakupan dan identifikasi cakupan rekaman aktivitas yang dipilih.
Di panel Persempit cakupan, pilih Kelola cakupan.
Temukan cakupan rekaman aktivitas yang Anda identifikasi pada langkah pertama, lalu luaskan detailnya untuk melihat daftar Google Cloud project.
Untuk setiap project Google Cloud dalam cakupan rekaman aktivitas, pastikan Anda memiliki peran Pengguna Cloud Trace (roles/cloudtrace.user). Jika Anda tidak memiliki peran tersebut di suatu project, minta administrator atau pemilik project untuk memberi Anda peran tersebut.

Pesan ID rentang tidak ada dalam rekaman aktivitas

Rekaman aktivitas Anda berisi pesan "ID rentang tidak ada".

Dalam sistem pelacakan terdistribusi, trace 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 belum terselesaikan dapat terjadi karena alasan berikut:

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

Saat Anda melihat trace yang tidak lengkap, Cloud Trace akan menampilkan pesan "ID span tidak ada" di panel detail trace.

Jika Anda terus-menerus melihat pesan "ID rentang tidak ada", coba lakukan langkah-langkah berikut:

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

LayananGoogle Cloud biasanya mematuhi petunjuk ini. Namun, opsi ini juga membatasi kecepatan penulisan data rekaman aktivitas.
Jika Anda menggunakan Cloud Service Mesh, verifikasi bahwa Anda mengikuti panduan untuk menyebarkan konteks rekaman aktivitas untuk konfigurasi tersebut. Untuk panduan Cloud Service Mesh, lihat Penerusan konteks rekaman aktivitas.

Tidak dapat mengorelasikan data log dan rekaman aktivitas

Anda melakukan salah satu tindakan berikut:

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

Untuk mengatasi kegagalan ini, konfigurasi cakupan kemampuan pengamatan. Cakupan ini menentukan cakupan rekaman aktivitas dan cakupan log mana yang akan digunakan saat halaman penjelajah yang sesuai terbuka. Untuk mempelajari lebih lanjut, lihat Mengonfigurasi cakupan kemampuan pengamatan untuk kueri multi-project.

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

Aplikasi Anda bergantung pada library klien untuk merekam 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 jembatan, lihat OpenCensus Bridge.

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