Memecahkan masalah

Halaman ini berisi informasi pemecahan masalah untuk Trace.

Dokumen ini menjelaskan cara memecahkan masalah saat Anda menggunakan halaman Trace Explorer atau halaman Trace Explorer lama:

Masalah umum

Bagian ini mencantumkan masalah umum:

  • Rentang yang ditulis ke project Google Cloud Anda menggunakan Telemetry API tidak tersedia melalui halaman Trace Explorer lama. Untuk melihat rentang ini, gunakan halaman Trace Explorer default.

  • 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 trace 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, berarti 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 menemukan data rekaman aktivitas. Di toolbar, buka elemen Scope, luaskan menu Refine scope, pilih Current project, lalu pilih Apply.

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 Anda setelah database dibuat. Google Cloud

Untuk melihat dan menganalisis data rekaman aktivitas yang lebih lama, beralihlah ke halaman Trace Explorer lama. Halaman ini membaca data rekaman aktivitas dan rentang dari database yang berbeda dengan halaman Trace Explorer.

Buka Legacy Trace explorer

Rentang 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. Tentukan apakah perekaman aktivitas selesai di halaman Trace Explorer lama:

    1. Dari flyout Detail untuk rekaman aktivitas, salin ID rekaman aktivitas ke papan klip Anda.

    2. Buka halaman Trace Explorer lama:

      Buka Legacy Trace explorer

    3. Tempelkan ID rekaman aktivitas ke kolom Trace ID.

      Halaman Detail rekaman aktivitas diperbarui dan mencantumkan project yang menyimpan rentang untuk rekaman aktivitas.

  2. Jika perekaman aktivitas selesai di halaman Trace Explorer lama, kemudian kembali ke halaman Trace Explorer dan tetapkan elemen Cakupan ke cakupan rekaman aktivitas yang mencantumkan semua project yang Anda identifikasi pada langkah sebelumnya. Ini adalah project yang menyimpan rentang 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.

  3. Jika rekaman aktivitas tidak selesai di halaman Trace Explorer lama, maka rentang tidak direkam atau Anda tidak 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 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.

Inisialisasi penyimpanan rekaman aktivitas gagal

Anda mencoba menginisialisasi penyimpanan rekaman aktivitas dengan mengklik Aktifkan di 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.

Memecahkan masalah halaman Trace Explorer lama

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

Tidak ada data di antarmuka lama

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

Untuk mengatasi kegagalan ini, coba langkah-langkah berikut:

  1. Enable the Cloud Trace API.

    Enable the API

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

    Buka APIs & Services

    Setelah menemukan baris berlabel Cloud Trace API, coba lakukan hal berikut:

    • Jika kolom berlabel Permintaan tidak mencantumkan informasi numerik apa pun, berarti tidak ada data rekaman aktivitas yang dikirim ke project Google Cloud Anda.

      Untuk menyelesaikan kasus ini, periksa aplikasi dan proxy Anda untuk memastikan aplikasi dan proxy tersebut dikonfigurasi untuk mengirimkan rekaman aktivitas ke project yang benar.

    • Pilih Cloud Trace API, pilih tab Metrics, lalu temukan diagram berlabel Errors by API method:

      • Jika penulisan gagal, berikan peran Cloud Trace Agent (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 Cloud Trace User (roles/cloutrace.user). Untuk mengetahui daftar izin untuk peran ini, lihat Peran IAM Cloud Trace.

Tidak ada data rekaman aktivitas untuk aplikasi yang di-deploy di antarmuka lama

Anda telah men-deploy aplikasi yang mengirim data ke project Google Cloud Anda menggunakan Cloud Trace API, tetapi data rekaman aktivitas tidak dikumpulkan.

Coba langkah berikut untuk mengatasinya:

  • Jika Anda tidak melihat data apa pun di halaman Trace Explorer lama di konsol Google Cloud , ikuti langkah-langkah di bagian berjudul Tidak ada data di antarmuka Trace lama.

  • Jika aplikasi tidak di-deploy di Google Cloud atau jika aplikasi menggunakan akun layanan untuk memberikan kredensial autentikasi, pastikan akun layanan telah diberi peran Cloud Trace Agent (roles/cloudtrace.agent).

    Peran ini mencakup izin cloudtrace.traces.patch, yang memungkinkan aplikasi menulis data rentang ke project Google Cloud .

  • Jika aplikasi mengandalkan OpenTelemetry, lakukan hal berikut:

    • Untuk layanan root, coba perbarui variabel lingkungan Anda agar OpenTelemetry menggunakan sampler traceidratio dengan frekuensi pengambilan sampel 0.5:

      export OTEL_TRACES_SAMPLER="traceidratio"
export OTEL_TRACES_SAMPLER_ARG="0.5"

    • Untuk semua layanan lainnya, biarkan variabel lingkungan OTEL_TRACES_SAMPLER tidak ditetapkan untuk menggunakan sampler default, yaitu parentbased_always_on. Setelan default berarti keputusan pengambilan sampel untuk rentang diwarisi dari rentang induknya, jika rentang tersebut ada. Jika rentang induk tidak ada, rentang akan diambil sampelnya.

    Kecuali jika aplikasi Anda selalu mengambil sampel setiap rentang, secara umum, permintaan tidak dapat dipaksa untuk dilacak secara menyeluruh karena setiap komponen dalam permintaan menyeluruh membuat keputusan pengambilan sampel sendiri. Namun, Anda dapat memengaruhi keputusan dengan menambahkan tanda sampled ke header rekaman aktivitas, dengan tanda ini disetel ke true. Setelan ini adalah petunjuk untuk komponen turunan guna mengambil sampel permintaan. Untuk mengetahui informasi selengkapnya tentang header pelacakan, lihat Protokol untuk propagasi konteks.

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 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 pelacakan, 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 Penerusan konteks rekaman aktivitas.

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.