Halaman ini diterjemahkan oleh Cloud Translation API.

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:

Memecahkan masalah halaman Trace Explorer
Memecahkan masalah halaman Trace Explorer lama

Masalah umum

Ada dua masalah umum pada halaman Trace Explorer:

Span yang ditulis ke project Google Cloud Anda sebelum 11 Januari 2025 mungkin tidak tersedia. Rentang ini tersedia di halaman Trace Explorer lama.
Panel detail peristiwa untuk span yang ditulis ke project Google Cloud Anda sebelum 11 Januari 2025 mungkin ditampilkan secara berbeda dibandingkan dengan span yang ditulis setelah tanggal tersebut.

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 trace ada.

Coba langkah-langkah berikut:

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.
  
  Catatan: Mungkin ada kebijakan organisasi yang telah menonaktifkan Cloud Trace API. Kebijakan ini mencegah Anda mengaktifkan API.
Di halaman Enable APIs and Services, temukan baris berlabel Cloud Trace API.
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.
Jika kolom berlabel Error mencantumkan nilai non-nol, berarti ada error saat membaca atau menulis data rekaman aktivitas. Untuk mendapatkan informasi selengkapnya tentang sumber error, pilih Cloud Trace API, pilih tab Metrics, lalu temukan diagram berlabel Errors by API method:
- Jika operasi tulis gagal, berikan akun layanan yang menyediakan kredensial autentikasi peran Agen Cloud Trace (roles/cloudtrace.agent). 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 Pengguna Cloud Trace (roles/cloutrace.user). Untuk daftar izin peran ini, lihat Peran IAM Cloud Trace.
Pastikan halaman Trace Explorer menelusuri project saat ini untuk mencari data rekaman aktivitas:
1. Di konsol Google Cloud, buka halaman Trace Explorer:
  Buka Trace Explorer
  
  Anda juga dapat menemukan halaman ini menggunakan kotak penelusuran.
2. Di toolbar, buka elemen Cakupan, luaskan menu Pertajam cakupan, pilih Project saat ini, lalu pilih Terapkan.
Coba salah satu dari berikut ini:
- Beralih ke halaman Trace Explorer lama. Halaman ini membaca data rekaman aktivitas dan span dari database yang berbeda dengan halaman Trace Explorer.
  
  Buka Legacy Trace Explorer
- Gunakan Cloud Trace API untuk mengirim span ke project Google Cloud Anda. Untuk informasi selengkapnya, lihat Memaksa pembuatan database untuk halaman Trace Explorer.

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 yang lebih lama tidak akan ditampilkan.

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

Jika pemilih rentang waktu adalah 30 hari atau kurang, data yang hilang 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, 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.

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

Buka Legacy Trace Explorer

Tidak ada span dalam rekaman aktivitas

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

Span mungkin tidak ada karena alasan berikut:

Halaman Trace Explorer tidak menelusuri semua project Google Cloud yang menyimpan data span untuk trace.
Peran IAM Anda di project Google Cloud yang menyimpan data span untuk rekaman aktivitas tidak berisi izin yang diperlukan untuk melihat data rekaman aktivitas.
Ada masalah instrumentasi. Misalnya, hanya beberapa span dalam trace yang dikirim ke project Google Cloud Anda.
Data tersebut ditulis ke project Google Cloud Anda sebelum 11 Januari 2025.

Untuk mengatasi masalah ini, lakukan langkah berikut:

Tentukan apakah rekaman aktivitas sudah selesai di halaman Trace Explorer lama:
1. Dari flyout Details untuk rekaman aktivitas, salin ID rekaman aktivitas ke papan klip.
2. Buka halaman Trace Explorer lama:
  
  Buka Legacy Trace Explorer
3. Tempel ID rekaman aktivitas ke kolom Trace ID.
  
  Halaman Detail trace diperbarui dan mencantumkan project yang menyimpan span untuk rekaman aktivitas.
Jika rekaman aktivitas selesai di halaman Trace Explorer lama, kembali ke halaman Trace Explorer dan tetapkan elemen Scope ke cakupan rekaman aktivitas yang mencantumkan semua project yang Anda identifikasi pada langkah sebelumnya. Ini adalah project yang menyimpan span 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 informasi selengkapnya, lihat Membuat dan mengelola cakupan rekaman aktivitas.
Jika rekaman aktivitas tidak selesai di halaman Trace Explorer lama, maknanya span tidak dicatat atau Anda tidak memiliki peran Pengguna Cloud Trace (roles/cloudtrace.user) di project yang menyimpan data span.

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 flyout Pertajam cakupan, pilih Kelola cakupan.
Temukan cakupan rekaman aktivitas yang Anda identifikasi pada langkah pertama, lalu luaskan detailnya untuk melihat daftar project Google Cloud.
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 project, minta administrator atau pemilik project untuk memberi Anda peran tersebut.

Memaksa pembuatan database untuk halaman Trace Explorer

Jika satu-satunya data trace dalam project Anda berasal dari Google Cloud layanan yang telah dikonfigurasi sebelumnya untuk Cloud Trace, database yang dibaca halaman Trace Explorer untuk data trace dan span Anda mungkin tidak dibuat. Namun, Anda dapat memaksa pembuatan database ini dengan mengirim trace ke project Google Cloud menggunakan Cloud Trace API.

Misalnya, Anda dapat melakukan hal berikut:

Buka halaman dokumentasi patchTraces.
Di panel Coba metode ini, lakukan hal berikut:
1. Di kolom projectId, masukkan PROJECT_ID Anda.
2. Salin JSON, yang menentukan rekaman aktivitas dengan satu span, ke papan klip, lalu tempelkan ke kolom Isi permintaan.
  
  Sebelum menyalin JSON, lakukan hal berikut:
  - Ganti PROJECT_ID dengan ID project Anda.
  - Ganti END_TIME dengan waktu saat ini, dan ganti START_TIME dengan nilai yang lebih awal dari waktu berakhir. Jika Anda menggunakan Linux, jalankan date -Isec untuk mendapatkan waktu saat ini dalam format yang benar. Misalnya, Anda dapat menetapkan kolom ini sebagai berikut:
```
"startTime": "2024-05-31T15:10:35.398448Z",
"endTime": "2024-05-31T15:10:35.574999047Z",
```
  - Perbarui kolom traceId dan spanId setiap kali Anda menjalankan perintah.
```
"traces": [
  {
    "projectId": "PROJECT_ID",
    "traceId": "33fc0d8c45bb4e5cebb29f047931270d",
    "spans": [
      {
        "spanId": "17941747227541407973",
        "name": "/",
        "startTime": "START_TIME",
        "endTime": "END_TIME",
      }
    ]
  }
]
```
3. Tekan Execute.
  
  Jika perintah berhasil diselesaikan, isi respons akan kosong. Jika membuka Trace Explorer, Anda dapat melihat rekaman aktivitas. Mungkin ada sedikit keterlambatan sebelum rekaman aktivitas tersedia di konsol Google Cloud.

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 trace apa pun di project Google Cloud saat Anda mengharapkan data trace ada.

Untuk mengatasi kegagalan ini, coba langkah-langkah berikut:

Enable the Cloud Trace API.
Enable the API

Catatan: Mungkin ada kebijakan organisasi yang telah menonaktifkan Cloud Trace API. Kebijakan ini mencegah Anda mengaktifkan API.
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 untuk aplikasi yang di-deploy di antarmuka lama

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 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 menggunakan akun layanan untuk memberikan kredensial autentikasi, pastikan bahwa 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 adalah hal yang wajar. 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.

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

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 Cloud 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 Cloud untuk Go, lihat Masalah #4237.