Ringkasan Cloud Trace

Cloud Trace adalah sistem pelacakan terdistribusi untuk Google Cloud yang melacak latensi permintaan dan membantu Anda memecahkan masalah bottleneck performa di seluruh layanan dan aplikasi AI generatif. Dengan mengumpulkan data latensi dari Google Cloud layanan dan aplikasi yang diinstrumentasikan, Trace membantu Anda memahami cara permintaan diproses dalam arsitektur microservice dan mengidentifikasi log yang relevan.

Trace membantu Anda menjawab pertanyaan seperti berikut:

  • Berapa lama waktu yang dibutuhkan aplikasi Anda untuk menangani permintaan tertentu?
  • Mengapa permintaan memerlukan waktu lama untuk diselesaikan?
  • Mengapa beberapa permintaan memerlukan waktu lebih lama daripada yang lain?
  • Berapa latensi keseluruhan permintaan ke aplikasi Anda?
  • Apakah latensi aplikasi meningkat atau menurun dari waktu ke waktu?
  • Bagaimana cara mengurangi latensi aplikasi?
  • Apa dependensi aplikasi Anda?

Untuk mengetahui informasi tentang cara menggunakan trace dan log bersama-sama untuk analisis penyebab utama, lihat postingan blog Memecahkan masalah aplikasi terdistribusi: Menggunakan trace dan log bersama-sama untuk analisis penyebab utama.

Untuk mengetahui informasi tentang pembuatan profil aplikasi, lihat Cloud Profiler.

Dukungan lingkungan

Trace berjalan di Linux di lingkungan berikut:

Komponen

Trace terdiri dari klien pelacakan, yang mengumpulkan trace dan mengirimkannya ke Google Cloud project Anda. Anda kemudian dapat menggunakan Google Cloud konsol untuk melihat dan menganalisis data yang dikumpulkan oleh klien pelacakan. Untuk mengetahui informasi tentang model data, lihat Trace dan span.

Klien pelacakan

Klien pelacakan mengumpulkan data latensi dan span dari aplikasi Anda dan mengekspornya ke your Google Cloud project. Bergantung pada lingkungan dan persyaratan Anda, Anda dapat mengumpulkan data trace secara otomatis atau manual dengan menginstrumentasikan kode aplikasi Anda.

Antarmuka pelacakan

Untuk melihat dan menganalisis data span, Anda dapat menggunakan halaman Trace Explorer dan Observability Analytics di Google Cloud konsol:

  • Trace Explorer: Menampilkan informasi gabungan tentang data trace Anda dan memungkinkan Anda memeriksa setiap trace secara mendetail. Data latensi gabungan ditampilkan pada peta panas, yang dapat Anda jelajahi dengan pointer. Untuk membatasi data yang ditampilkan, Anda dapat menambahkan filter. Anda juga dapat melihat dan menjelajahi setiap span dan trace:

  • Observability Analytics: Menyediakan antarmuka kueri SQL. Kueri Anda dapat menggabungkan data trace dan log, dan Anda dapat melihat hasil kueri sebagai tabel atau diagram. Anda dapat menggunakan BigQuery untuk menganalisis data trace jika membuat set data BigQuery tertaut. Untuk mengetahui informasi selengkapnya, lihat Mengkueri dan menganalisis trace.

Konfigurasi dengan pelacakan otomatis

Konfigurasi berikut otomatis menangkap data trace:

  • Lingkungan standar App Engine

    • Runtime generasi pertama otomatis mencegat dan mengirim span trace ke Cloud Trace. Untuk mengetahui informasi selengkapnya, lihat Ringkasan layanan gabungan lama.

    • Runtime generasi kedua otomatis menangkap latensi permintaan keseluruhan dan menambahkan header HTTP X-Cloud-Trace-Context ke permintaan. Untuk mengetahui informasi selengkapnya, lihat Jadwal dukungan runtime.

  • Cloud Run Functions dan Cloud Run

    Untuk permintaan HTTP masuk dan keluar, data latensi otomatis dikirim ke Trace.

Menginstrumentasikan aplikasi Anda

Instrumentasikan aplikasi Anda untuk mengumpulkan informasi spesifik yang membantu Anda memahami performanya dan memecahkan masalah kegagalan. Beberapa framework instrumentasi open source mengumpulkan data log, metrik, dan trace data, serta dapat mengirimkan data tersebut ke vendor mana pun, termasuk Google Cloud. Untuk aplikasi agentik Anda, beberapa framework dapat mengumpulkan perintah dan respons Anda atau meneruskan konteks yang memungkinkan pelacakan beberapa panggilan server MCP Google Cloud jarak jauh.

Untuk menginstrumentasikan aplikasi Anda, sebaiknya gunakan framework instrumentasi open source yang netral vendor, seperti OpenTelemetry, bukan API atau library klien khusus vendor dan produk. Untuk mengetahui informasi tentang framework ini, lihat Instrumentasi dan kemampuan observasi dan Memilih pendekatan instrumentasi.

Contoh instrumentasi yang kami berikan menggunakan OpenTelemetry:

Meskipun Anda dapat menggunakan library klien Cloud Trace untuk menginstrumentasikan aplikasi, sebaiknya gunakan OpenTelemetry. Library OpenTelemetry lebih disukai daripada library klien Trace karena lebih sederhana dan mengekspor data trace dalam format OTLP, yang ditentukan oleh OpenTelemetry. Untuk mengetahui informasi selengkapnya, lihat Instrumentasi untuk Trace dan Library klien untuk Cloud Trace.

Cloud Trace dan aplikasi agentik

Untuk memahami perilaku aplikasi agentik, konfigurasikan aplikasi tersebut untuk mengumpulkan perintah dan respons atau membuat span saat memanggil server MCP Google Cloud jarak jauh Google Cloud. Perintah dan respons membantu Anda memahami penalaran yang digunakan aplikasi agentic. Span yang merekam panggilan alat membantu Anda mengonfirmasi pemanggilan alat, status panggilan, dan latensi permintaan.

Beberapa contoh instrumentasi menunjukkan cara mengonfigurasi aplikasi untuk mengumpulkan perintah dan respons. Contoh ini mengandalkan OpenTelemetry. Untuk mengetahui informasi selengkapnya, lihat Cara menginstrumentasikan aplikasi AI generatif Anda.

Server MCP Google Cloud dapat membuat span trace. Untuk mengetahui informasi selengkapnya, lihat Menyelidiki panggilan MCP menggunakan Trace.

API yang menerima data trace

Anda dapat mengirim data trace ke project menggunakan Telemetry API atau Cloud Trace API. Sebaiknya gunakan Telemetry API karena alasan berikut:

  • API ini menyediakan kompatibilitas dengan ekosistem OpenTelemetry open source, dan batasnya sering kali lebih besar daripada batas Cloud Trace API, yang merupakan API eksklusif Google Cloud .

  • Data trace Anda disimpan dalam format yang umumnya konsisten dengan file proto yang ditentukan oleh OTLP. Beberapa kolom mungkin dikonversi dari jenis data khusus OpenTelemetry ke jenis data JSON sebelum penyimpanan. Untuk mengetahui informasi tentang format penyimpanan, lihat Skema untuk data trace.

  • Untuk ekspor data trace berbasis pengumpul, instrumentasi Anda tidak bergantung pada exporter Google Cloud-khusus.

  • Beberapa fitur, seperti Application Monitoring, mengandalkan informasi yang hanya tersedia saat Anda mengirim data trace ke Telemetry API.

Untuk mencegah your Google Cloud project menyimpan data trace, nonaktifkan the Cloud Trace API. Menonaktifkan Cloud Trace API akan memiliki efek berikut:

  • Google Cloud layanan tidak mengirim data trace ke project Anda.
  • Google Cloud membalas permintaan yang dikirim ke endpoint Cloud Trace API dengan kode error.
  • Google Cloud Observability akan menghapus data trace yang dikirim ke endpoint API khusus trace. Jangan nonaktifkan Telemetry API, karena API tersebut dapat menerima data log, metrik, dan trace.

Jika Anda mengelola organisasi dan ingin mencegah penggunaan Cloud Trace, maka buat batasan kebijakan organisasi.

Dukungan Kontrol Layanan VPC

Trace adalah layanan yang didukung Kontrol Layanan VPC. Nama layanan Trace adalah cloudtrace.googleapis.com. Batasan Kontrol Layanan VPC yang Anda buat untuk layanan Trace hanya berlaku untuk layanan tersebut. Batasan tersebut tidak berlaku untuk layanan lain, termasuk layanan seperti telemetry.googleapis.com layanan, yang juga dapat menerima data trace.

Untuk informasi selengkapnya, lihat referensi berikut:

Cloud Trace dan residensi data

Jika Anda menggunakan Assured Workloads karena memiliki persyaratan residensi data atau Tingkat Dampak 4 (IL4) persyaratan, jangan gunakan Cloud Trace API untuk mengirim span trace.

Untuk mencegah your Google Cloud project menyimpan data trace, nonaktifkan the Cloud Trace API. Jangan nonaktifkan Telemetry API, karena API tersebut dapat menerima data log, metrik, dan trace.

Retensi trace

Kategori Periode retensi data
Span yang disimpan di _Trace bucket 30 hari

Peran IAM

Cloud Trace menggunakan Identity and Access Management (IAM) untuk mengontrol akses ke resource. Untuk mengetahui daftar peran Cloud Trace API dan Telemetry API, lihat Mengontrol akses dengan IAM.

Karena Telemetry API adalah API konsumen, pengiriman data ke Telemetry API mengharuskan Anda menentukan project kuota dan memberikan izin akun layanan aplikasi untuk menggunakan kuota tersebut. Untuk mengetahui informasi selengkapnya, lihat Telemetry API: Autentikasi.

Langkah berikutnya