Halaman ini menjelaskan cara mengaktifkan rekaman aktivitas sisi klien dengan OpenTelemetry saat Anda menggunakan library klien Cloud Storage untuk berinteraksi dengan Cloud Storage. Anda dapat mengumpulkan dan melihat data rekaman aktivitas menggunakan library klien Cloud Storage yang didukung berikut:
Ringkasan
Dengan mengaktifkan rekaman aktivitas di library klien Cloud Storage, Anda dapat memantau performa, menunjukkan masalah latensi, dan melakukan proses debug dengan cepat untuk permintaan Cloud Storage. Dengan rekaman aktivitas, Anda dapat melihat urutan permintaan yang telah selesai, sehingga memberikan tampilan mendetail tentang cara permintaan diterima, dikelola, dan direspons oleh Cloud Storage. Satu rekaman aktivitas terdiri dari beberapa span, yang merupakan catatan mendetail dengan stempel waktu dari setiap fungsi atau operasi yang dilakukan aplikasi Anda selama permintaan Cloud Storage.
Manfaat
Pengumpulan dan propagasi data rekaman aktivitas memberikan manfaat berikut bagi aplikasi Anda:
Peningkatan visibilitas performa: karena data rekaman aktivitas dibuat hampir secara real-time saat Cloud Storage menyelesaikan setiap permintaan yang Anda buat, Anda dapat dengan cepat mengidentifikasi bottleneck dalam performa dan mendeteksi masalah latensi.
Penanganan error: Anda dapat menentukan dengan tepat tempat terjadinya masalah, mempercepat analisis akar masalah, dan mengurangi waktu henti menggunakan informasi tentang setiap permintaan Cloud Storage yang disediakan dalam rekaman aktivitas.
Cara kerja rekaman aktivitas sisi klien
Bagian berikut memberikan gambaran mendetail tentang cara kerja pengumpulan rekaman aktivitas.
Cara kerja pengumpulan rekaman aktivitas dengan OpenTelemetry
Library klien Cloud Storage mendukung pengumpulan data rekaman aktivitas menggunakan OpenTelemetry SDK untuk menyiapkan komponen berikut yang diperlukan untuk mengumpulkan dan menyebarkan data rekaman aktivitas:
Penyedia rekaman aktivitas: digunakan oleh library klien Cloud Storage, penyedia rekaman aktivitas bertanggung jawab untuk membuat dan mengelola sistem rekaman aktivitas, termasuk membuat dan mengelola rekaman aktivitas dan rentang di aplikasi Anda.
Pengekspor trace: digunakan oleh OpenTelemetry SDK, pengekspor trace bertanggung jawab untuk mengirim data trace ke platform kemampuan observasi backend seperti Cloud Trace, tempat Anda dapat menganalisis dan memvisualisasikan data trace. Untuk mempelajari lebih lanjut eksportir rekaman aktivitas, lihat Cara kerja eksportir rekaman aktivitas.
Cara kerja pengekspor rekaman aktivitas
Mengonfigurasi rekaman aktivitas menggunakan OpenTelemetry SDK mencakup memilih backend kemampuan pengamatan untuk mengekspor data Anda ke tempat data tersebut dianalisis, disimpan, dan divisualisasikan. Meskipun Anda dapat mengekspor data rekaman aktivitas ke backend kemampuan pengamatan pilihan Anda, sebaiknya gunakan Cloud Trace, yang dapat diakses menggunakan konsol Google Cloud dan menyediakan integrasi dengan layanan Google Cloud lainnya.
Setelah penyedia rekaman aktivitas dan pengekspor rekaman aktivitas dikonfigurasi dan diaktifkan, Anda dapat melihat data rekaman aktivitas secara hampir real-time saat rekaman aktivitas dan rentang dihasilkan untuk setiap permintaan Cloud Storage.
Dengan menggunakan penjelajah Cloud Trace di konsolGoogle Cloud , Anda dapat melihat setiap rekaman aktivitas yang berisi hal berikut:
Tampilan tingkat tinggi permintaan Cloud Storage secara menyeluruh.
Beberapa rentang, setiap rentang merekam satu operasi yang diberi stempel waktu dalam permintaan Cloud Storage yang dilakukan.
Untuk membaca lebih lanjut rekaman aktivitas dan rentang, lihat dokumentasi OpenTelemetry tentang rekaman aktivitas dan rentang.
Harga
Data rekaman aktivitas dikenai biaya. Biaya dihitung berdasarkan jumlah rentang aktivitas yang diserap dan dipindai oleh Cloud Trace. Untuk mempelajari lebih lanjut rentang aktivitas yang dikenai biaya dan contoh harga, lihat Biaya Cloud Trace.
Sebelum memulai
Sebelum dapat mengumpulkan rekaman aktivitas untuk penggunaan Cloud Storage API, Anda harus menyelesaikan langkah-langkah berikut:
-
Enable the Cloud Trace API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin
), which contains theserviceusage.services.enable
permission. Learn how to grant roles. Aktifkan Cloud Storage API.
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan untuk menulis rekaman aktivitas ke Cloud Trace, minta administrator Anda untuk memberi Anda peran IAM Cloud Trace Agent (roles/coudtrace.agent
) di project yang digunakan oleh klien.
Peran bawaan ini berisi izin
cloudtrace.traces.patch
, yang
diperlukan untuk
menulis rekaman aktivitas ke Cloud Trace.
Anda mungkin juga bisa mendapatkan izin ini dengan peran bawaan, atau Anda dapat membuat peran khusus untuk memberikan izin tertentu. Untuk mengetahui petunjuk cara memberikan peran pada project, lihat Memberikan atau mencabut peran. Untuk mengetahui informasi selengkapnya tentang peran Cloud Trace Agent, lihat dokumentasi Identity and Access Management (IAM).
Mengonfigurasi pelacakan untuk aplikasi Anda
Gunakan petunjuk berikut untuk mengonfigurasi pelacakan dan mulai mengumpulkan data rekaman aktivitas menggunakan library klien Cloud Storage:
C++
Instal versi berikut:
Library klien C++ versi v2.16.0 atau yang lebih baru
C++ versi 14 atau yang lebih baru
Untuk mengaktifkan instrumentasi pelacakan OpenTelemetry di library klien C++, perbarui konfigurasi sistem build untuk CMake atau Bazel.
Buat instance klien Cloud Storage dengan mengaktifkan rekaman aktivitas OpenTelemetry.
Java
Instal versi library klien Java Cloud Storage berikut:
com.google.cloud:google-cloud-storage:2.47.0
atau yang lebih barucom.google.cloud:libraries-bom:26.53.0
atau yang lebih baru
Instal pengekspor Cloud Trace untuk OpenTelemetry. Anda juga dapat menggunakan eksportir pilihan Anda.
Instal propagator Cloud Trace.
Buat instance klien Cloud Storage dengan mengaktifkan rekaman aktivitas OpenTelemetry.
Python
Instal library klien Python Cloud Storage:
pip install google-cloud-storage[tracing]>=2.18.0
Instal pengekspor dan propagator Cloud Trace. Anda juga dapat menggunakan pengekspor pilihan Anda.
pip install opentelemetry-exporter-gcp-trace opentelemetry-propagator-gcp
Instal instrumentasi permintaan OpenTelemetry untuk melacak permintaan HTTP yang mendasarinya.
pip install opentelemetry-instrumentation-requests
Tetapkan variabel lingkungan untuk memilih ikut serta secara selektif dalam pelacakan untuk klien penyimpanan Python:
export ENABLE_GCS_PYTHON_CLIENT_OTEL_TRACES=True
Konfigurasi eksportir rekaman aktivitas dan penyedia rekaman aktivitas.
Melihat trace Anda
Gunakan penjelajah Cloud Trace untuk melihat data rekaman aktivitas di konsol: Google Cloud
-
Di konsol Google Cloud , buka halaman Trace explorer:
Anda juga dapat menemukan halaman ini dengan menggunakan kotak penelusuran.
Di halaman Trace explorer, klik trace tertentu dalam diagram sebar untuk melihat detail trace.
Panel Detail rekaman aktivitas menampilkan tabel rentang rekaman aktivitas.
Opsional: klik baris rentang untuk melihat informasi mendetail tentang rentang tertentu seperti informasi berikut:
Atribut: key-value pair yang memberikan informasi tambahan tentang rentang.
Log & peristiwa: entri log yang terkait dengan rentang.
Stack trace: stack trace yang terkait dengan rentang.
Metadata & Link: link ke layanan Google Cloud lain yang terkait dengan rentang.
Untuk mengetahui informasi selengkapnya tentang cara menggunakan penjelajah Cloud Trace, lihat Menemukan dan menjelajahi rekaman aktivitas.