Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Ringkasan Cloud Trace

Cloud Trace, sistem pelacakan terdistribusi untuk Google Cloud, membantu Anda memahami waktu yang diperlukan aplikasi untuk menangani permintaan masuk dari pengguna atau aplikasi lain, dan berapa lama waktu yang diperlukan untuk menyelesaikan operasi seperti panggilan RPC yang dilakukan saat menangani permintaan. Trace juga dapat membantu Anda saat mengembangkan layanan, mengembangkan aplikasi agentik, atau memecahkan masalah kegagalan. Misalnya, Trace dapat membantu Anda memahami cara permintaan diproses dalam arsitektur microservice yang rumit, dan dapat membantu Anda mengidentifikasi log mana yang harus diperiksa.

Karena Trace menerima data latensi dari Google Cloud layanan seperti App Engine, dan dari aplikasi yang Anda instrumentasikan, Trace dapat membantu Anda menjawab pertanyaan berikut:

Berapa lama waktu yang diperlukan aplikasi saya untuk menangani permintaan tertentu?
Mengapa aplikasi saya memerlukan waktu yang lama untuk menangani permintaan?
Mengapa beberapa permintaan saya memerlukan waktu lebih lama daripada yang lain?
Berapa latensi keseluruhan permintaan ke aplikasi saya?
Apakah latensi untuk aplikasi saya meningkat atau menurun dari waktu ke waktu?
Apa yang dapat saya lakukan untuk mengurangi latensi aplikasi?
Apa saja dependensi aplikasi saya?

Jika Anda ingin tahu cara menggunakan Trace untuk membantu mengelola aplikasi, baca blog Memecahkan masalah aplikasi terdistribusi: Menggunakan trace dan log bersama-sama untuk analisis akar masalah.

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

Dukungan lingkungan

Trace berjalan di Linux di lingkungan berikut:

Trace menyediakan library klien untuk menginstrumentasikan aplikasi Anda guna menangkap informasi trace. Untuk petunjuk penyiapan per bahasa, lihat Menginstrumentasikan untuk Trace.

Konfigurasi dengan pelacakan otomatis

Beberapa konfigurasi menghasilkan pengambilan data trace otomatis:

Lingkungan standar App Engine

Aplikasi Java 8, Python 2, dan PHP 5 tidak perlu menggunakan library klien Trace. Runtime ini otomatis mengirimkan data latensi ke Trace untuk permintaan ke URI aplikasi. Permintaan ini mencakup data latensi untuk panggilan RPC pulang pergi ke layanan App Engine. Trace berfungsi dengan semua App Engine Admin API, kecuali Cloud SQL.
Cloud Run Functions dan Cloud Run

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

API yang menyerap 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 OpenTelemetry Line Protocol. Beberapa kolom mungkin dikonversi dari jenis data khusus OpenTelemetry ke jenis data JSON sebelum penyimpanan. Untuk mempelajari format penyimpanan lebih lanjut, lihat Skema untuk data trace.
Untuk ekspor data trace berbasis pengumpul, instrumentasi Anda tidak bergantung pada pengekspor Google Cloud-tertentu.
Beberapa fitur, seperti Application Monitoring, bergantung pada informasi yang hanya tersedia saat Anda mengirim data trace ke Telemetry API.

Jika Anda ingin mencegah Google Cloud project menyimpan data trace, nonaktifkan Cloud Trace API. Menonaktifkan Cloud Trace API akan menghasilkan hal 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.

Cloud Trace dan aplikasi agentik

Untuk memahami perilaku aplikasi agentik, konfigurasikan aplikasi tersebut untuk mengumpulkan perintah dan respons atau membuat rentang saat memanggil server MCP Google Cloud jarak jauh Google Cloud. Prompt dan respons membantu Anda memahami penalaran yang digunakan aplikasi agentic Anda. Rentang 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 bergantung pada OpenTelemetry. Untuk mengetahui informasi selengkapnya, lihat Cara menginstrumentasikan aplikasi AI generatif.

Untuk mempelajari server MCP Google Cloud jarak jauh mana yang mendukung pembuatan trace, dan untuk mempelajari cara mengonfigurasi aplikasi untuk menginstruksikan server ini membuat rentang, lihat Menyelidiki panggilan MCP menggunakan Trace.

Cara menginstrumentasikan aplikasi

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 mengirim 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, 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:

Untuk contoh yang menggunakan ekspor berbasis pengumpul, lihat contoh berikut:
- Go
- Java
- Node.js
- Python
Contoh ini mengirim data trace ke Telemetry API.
Untuk mengetahui informasi tentang cara menggunakan ekspor langsung data trace dan mengirim data tersebut ke Telemetry API, lihat Bermigrasi dari pengekspor Trace ke endpoint OTLP.
Untuk contoh yang menunjukkan cara mengonfigurasi aplikasi agentik untuk mengumpulkan perintah dan respons, lihat Cara menginstrumentasikan aplikasi AI generatif.

Untuk mempelajari server MCP Google Cloud jarak jauh mana yang mendukung pembuatan trace, dan untuk mempelajari cara mengonfigurasi aplikasi untuk menginstruksikan server ini membuat rentang, lihat Menyelidiki panggilan MCP menggunakan Trace.

Anda juga dapat menggunakan library klien Cloud Trace untuk menginstrumentasikan aplikasi. Namun, 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 mempelajari lebih lanjut, lihat Library klien untuk Cloud Trace.

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 agen. Untuk mengetahui informasi tentang model data, lihat Trace dan rentang.

Klien pelacakan

Jika library OpenTelemetry tersedia untuk bahasa pemrograman Anda, Anda dapat menyederhanakan proses pembuatan dan pengiriman data trace menggunakan OpenTelemetry. Selain lebih mudah digunakan, OpenTelemetry menerapkan pengelompokan yang dapat meningkatkan performa.

Jika library OpenTelemetry tidak ada, instrumentasikan kode Anda dengan mengimpor library Trace SDK dan menggunakan Cloud Trace API. Cloud Trace API mengirim data trace ke project Anda. Google Cloud

Antarmuka pelacakan

Anda dapat melihat dan menganalisis data trace secara hampir real-time di antarmuka Trace.

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

Trace Explorer: Menampilkan informasi gabungan tentang data trace 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. Halaman ini juga memungkinkan Anda melihat dan menjelajahi setiap rentang dan trace:
- Untuk mengetahui informasi tentang cara melihat data trace yang disimpan di beberapa project, lihat Membuat dan mengelola cakupan trace.
- Untuk mengetahui informasi tentang cara memfilter dan melihat data trace, lihat Menemukan dan menjelajahi trace.
Observability Analytics: Halaman ini memungkinkan Anda menjalankan kueri yang melakukan analisis gabungan rentang menggunakan SQL. Kueri SQL juga dapat menggabungkan data trace dan log. Anda dapat melihat hasil kueri dalam bentuk tabel atau dengan diagram. Jika membuat set data BigQuery tertaut, Anda dapat menggunakan BigQuery untuk menganalisis rentang. Untuk mengetahui informasi selengkapnya, lihat Membuat kueri dan menganalisis trace.

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 service, yang juga dapat menyerap 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 rentang trace.