Memecahkan masalah

Halaman ini berisi informasi pemecahan masalah untuk Trace.

Tidak ada data di antarmuka Trace

Jika Anda tidak dapat melihat trace apa pun di project Google Cloud saat Anda mengharapkan data trace ada, coba langkah-langkah berikut:

  1. Enable the Cloud Trace API.

    Enable the API

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

    Buka API & Layanan

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

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

      Untuk mengatasi kasus ini, periksa aplikasi dan proxy Anda untuk memastikannya dikonfigurasi untuk mengirim rekaman aktivitas ke project yang benar.

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

      • Jika operasi tulis 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 span ke project Google Cloud.

        Untuk mengetahui informasi selengkapnya, lihat Peran IAM Cloud Trace.

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

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

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

Karena beberapa library klien Google untuk Go terintegrasi dengan OpenCensus, Anda harus menggunakan OpenCensus Bridge. Untuk informasi selengkapnya tentang masalah yang dipecahkan oleh jembatan, lihat OpenCensus Bridge.

Untuk informasi tentang update library klien Google untuk Go, lihat Masalah #4237.

Tidak ada data rekaman aktivitas untuk aplikasi yang di-deploy

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

Coba langkah berikut untuk mengatasinya:

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

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

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

  • Jika aplikasi mengandalkan OpenTelemetry, lakukan hal berikut:

    • Untuk layanan root, coba perbarui variabel lingkungan Anda sehingga OpenTelemetry menggunakan sampler traceidratio dengan frekuensi sampling 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 span diwarisi dari span induknya, jika span tersebut ada. Jika span induk tidak ada, span akan diambil sampelnya.

    Kecuali jika aplikasi Anda selalu mengambil sampel setiap span, secara umum, Anda tidak dapat memaksa permintaan untuk dilacak secara menyeluruh karena setiap komponen dalam permintaan menyeluruh membuat keputusan sampling-nya sendiri. Namun, Anda dapat memengaruhi keputusan dengan menambahkan tanda sampled ke header rekaman aktivitas, dengan tanda ini ditetapkan ke true. Setelan ini adalah petunjuk untuk komponen turunan guna mengambil sampel permintaan. Untuk informasi selengkapnya tentang header rekaman aktivitas, lihat Protokol untuk penyebaran konteks.

Pesan ID span tidak ada dalam rekaman aktivitas

Pelacakan Anda berisi pesan "ID span tidak ada".

Dalam sistem pelacakan terdistribusi, trace yang tidak lengkap dapat terjadi. Rekaman aktivitas tidak lengkap jika span sampel berisi referensi ke span lain yang belum diterima. Referensi yang tidak terselesaikan dapat terjadi karena alasan berikut:

  • Rentang yang direferensikan tidak diambil sampelnya.
  • Span yang dirujuk diambil sampelnya, tetapi belum diterima oleh Cloud Trace atau span 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 span tidak ada", coba 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 informasi selengkapnya tentang header rekaman aktivitas, lihat Protokol untuk penyebaran konteks.

    Layanan Google Cloud biasanya mengikuti petunjuk ini. Namun, keduanya 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 Penyebaran konteks rekaman aktivitas.