Memecahkan masalah

Halaman ini berisi informasi pemecahan masalah untuk Trace.

Masalah umum

Bagian ini mencantumkan masalah umum:

  • Rentang yang ditulis ke Google Cloud project 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 halaman Trace Explorer

Bagian ini menjelaskan cara memecahkan masalah saat Anda menggunakan halaman Trace Explorer.

Tidak ada data di halaman Trace Explorer

Anda menggunakan halaman Trace Explorer dan tidak dapat melihat rekaman aktivitas apa pun di project Google Cloud saat Anda mengharapkan data rekaman aktivitas ada.

Coba langkah-langkah berikut:

  1. Pastikan Cloud Trace API diaktifkan dan data sedang ditulis ke project Anda:

    1. Di konsol Google Cloud , buka halaman Enabled APIs & Services:

      Buka Enabled APIs & Services

    2. Jika Cloud Trace API tercantum, lanjutkan ke langkah berikutnya. Jika tidak, aktifkan API.

      Untuk mengaktifkan API, klik Enable APIs and Services, telusuri "Cloud Trace API", pilih opsi, lalu klik Enable.

  2. Di halaman Enabled APIs and Services, temukan baris berlabel Cloud Trace API.

  3. Jika kolom berlabel Error mencantumkan nilai selain nol, berarti ada error saat membaca atau menulis data rekaman aktivitas melalui Cloud Trace API. Untuk mendapatkan informasi selengkapnya tentang sumber error, pilih Cloud Trace API, pilih tab Metrics, lalu temukan diagram berlabel Errors by API method:

    • Jika penulisan gagal, berikan peran Agen Cloud Trace (roles/cloudtrace.agent) kepada akun layanan yang menyediakan kredensial autentikasi. Peran ini mencakup izin cloudtrace.traces.patch, yang memungkinkan aplikasi menulis data rentang ke project Google Cloud .

      Untuk mengetahui informasi selengkapnya, lihat Peran IAM Cloud Trace.

    • Jika pembacaan gagal, pastikan peran IAM Anda di project Google Cloud menyertakan izin dalam peran Pengguna Cloud Trace (roles/cloutrace.user). Untuk mengetahui daftar izin untuk peran ini, lihat Peran IAM Cloud Trace.

  4. Kolom Requests mencantumkan jumlah permintaan yang dikirim ke Cloud Trace API. Jika kolom ini nol, tidak ada data rekaman aktivitas yang dikirim melalui API tersebut.

    App Engine, Cloud Run, dan Cloud Run Functions mengirimkan data trace tanpa menggunakan Cloud Trace API. Jika Anda hanya menggunakan layanan ini, lanjutkan ke langkah berikutnya.

    Jika Anda memiliki aplikasi yang mengirim data rekaman aktivitas melalui Cloud Trace API dan kolom permintaan bernilai nol, periksa aplikasi dan proxy Anda untuk memverifikasi bahwa aplikasi dan proxy tersebut dikonfigurasi untuk mengirim rekaman aktivitas ke project yang benar.

  5. Di halaman Trace Explorer, pastikan penyimpanan Trace diinisialisasi:

    1. Di konsol Google Cloud , buka halaman Trace explorer:

      Buka Trace explorer

      Anda juga dapat menemukan halaman ini dengan menggunakan kotak penelusuran.

    2. Jika Penyimpanan rekaman aktivitas tidak diinisialisasi, halaman Trace Explorer akan menampilkan banner yang berisi teks berikut:

      Trace storage is not initialized in this project. Enable trace storage to begin collecting trace data.

      Untuk menginisialisasi penyimpanan Trace, di banner, klik Aktifkan. Inisialisasi biasanya selesai dalam beberapa menit.

      Jika inisialisasi berhasil, banner notifikasi akan ditampilkan. Trace menyerap data rekaman aktivitas yang dikirim dalam satu jam terakhir, yang sebelumnya disimpan dalam buffer. Anda dapat memuat ulang dalam beberapa menit saat data mulai muncul di Trace Explorer.

      Jika Anda melihat pesan error yang menunjukkan bahwa inisialisasi gagal, maka anggota tim dukungan Google Cloud perlu menyelesaikan masalah secara manual. Klik Ajukan tiket untuk memulai proses ini.

  6. Pastikan halaman Trace Explorer menelusuri project saat ini untuk mendapatkan data rekaman aktivitas. Di toolbar, buka elemen Cakupan, luaskan menu Persempit cakupan, pilih Project saat ini, lalu pilih Terapkan.

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:

  1. Pastikan stempel waktu yang terkait dengan ID rekaman aktivitas berada dalam periode retensi.

  2. Identifikasi project Google Cloud yang menyimpan rekaman aktivitas, dan pastikan pemilih resource di konsol Google Cloud memilih project ini. Google Cloud 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 lama 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.

Rentang yang tidak ada dalam rekaman aktivitas

Anda membuka halaman Trace Explorer dan memilih rentang untuk dilihat. Flyout Detail menampilkan rekaman aktivitas, tetapi beberapa rentang tidak ada.

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-langkah berikut:

  1. 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.

  2. 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:

  1. Perluas elemen Cakupan dan identifikasi cakupan rekaman aktivitas yang dipilih.
  2. Di panel Persempit cakupan, pilih Kelola cakupan.
  3. Temukan cakupan rekaman aktivitas yang Anda identifikasi pada langkah pertama, lalu luaskan detailnya untuk melihat daftar project. Google Cloud
  4. Untuk setiap project Google Cloud dalam cakupan rekaman aktivitas, pastikan Anda memiliki peran Cloud Trace User (roles/cloudtrace.user). Jika Anda tidak memiliki peran tersebut di suatu project, minta administrator atau pemilik project untuk memberi Anda peran tersebut.

Inisialisasi penyimpanan rekaman aktivitas gagal

Anda mencoba menginisialisasi penyimpanan rekaman aktivitas dengan mengklik Aktifkan pada banner yang ditampilkan di Trace Explorer, dan Anda melihat error berikut:

Initializing trace storage has failed for an unexpected reason. Please file a support ticket for assistance.

Jika inisialisasi penyimpanan gagal, maka Google Cloud anggota tim dukungan harus menyelesaikan masalah secara manual. Untuk menghubungi dukungan, klik Ajukan tiket.

Pesan ID rentang tidak ada dalam rekaman aktivitas

Rekaman aktivitas Anda berisi pesan "Missing span ID".

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.
  • Span yang dirujuk telah diambil sampelnya, tetapi belum diterima oleh Cloud Trace atau span 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 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, pastikan Anda mengikuti panduan untuk menyebarkan konteks rekaman aktivitas untuk konfigurasi tersebut. Untuk panduan Cloud Service Mesh, lihat Penerapan konteks pelacakan.

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 Masalah #4237.