Halaman ini akan memandu Anda melakukan langkah-langkah berikut:
- Instal paket OpenTelemetry.
- Konfigurasi aplikasi Anda untuk mengekspor span ke Cloud Trace.
- Konfigurasi platform Anda.
Untuk informasi rilis, lihat referensi berikut:
Untuk konten referensi OpenTelemetry, lihat hal berikut:
Untuk detail terbaru tentang OpenTelemetry untuk C++, beserta dokumentasi dan contoh tambahan, lihat OpenTelemetry.
Sebelum memulai
-
Di panel navigasi Konsol Google Cloud, pilih APIs & Services, klik Enable APIs and Services, lalu aktifkan Cloud Trace API:
Jika API enabled ditampilkan, berarti API sudah diaktifkan. Jika belum, klik tombol Enable.
Menginstal paket OpenTelemetry
- Menyiapkan lingkungan pengembangan C++.
- Instal library pengekspor OpenTelemetry Google Cloud C++. Untuk mengetahui informasi penginstalan, lihat Panduan memulai OpenTelemetry.
Mengonfigurasi ekspor span ke Cloud Trace
Untuk mengonfigurasi ekspor data rekaman aktivitas, panggil metode google::cloud::otel::ConfigureBasicTracing(...)
di metode main()
Anda:
Kolom project_id
adalah project Google Cloud tempat Anda ingin menyimpan
rekaman aktivitas.
Metode ConfigureBasicTracing(...)
membuat instance objek TracerProvider
yang menerapkan pengekspor Cloud Trace. Jika objek yang ditampilkan oleh panggilan ke
ConfigureBasicTracing(...)
berada di luar cakupan, objek TracerProvider
sebelumnya akan diaktifkan kembali, jika ada.
Mengonfigurasi frekuensi sampel
Aplikasi dapat menghasilkan data rekaman aktivitas dalam jumlah besar. Contoh berikut menunjukkan cara mengonfigurasi frekuensi sampling:
Ekspor ke Cloud Trace dengan TracerProvider
kustom
Anda mungkin memiliki kasus penggunaan yang memerlukan objek TracerProvider
kustom. Misalnya, jika ingin menggunakan beberapa pengekspor sekaligus, Anda harus membuat objek TracerProvider
kustom. Dalam hal ini, Anda dapat langsung menggunakan pengekspor Cloud Trace:
Menginstrumentasikan aplikasi Anda sendiri
Untuk mengetahui informasi tentang cara mengonfigurasi aplikasi Anda guna merekam durasi rekaman aktivitas, lihat Pelacakan OpenTelemetry. Halaman ini menjelaskan cara melakukan semua tindakan berikut:
- Membuat span
- Membuat span bertingkat
- Menetapkan atribut span
- Membuat span dengan peristiwa
- Membuat span dengan link
Contoh aplikasi
Untuk aplikasi contoh, lihat quickstart.
Konfigurasi platform Anda
Anda dapat menggunakan Cloud Trace di Google Cloud dan platform lainnya.
Berjalan di Google Cloud
Saat aplikasi Anda berjalan di Google Cloud, Anda tidak perlu memberikan kredensial autentikasi dalam bentuk akun layanan ke library klien. Namun, Anda harus memastikan bahwa platform Google Cloud Anda telah mengaktifkan cakupan akses Cloud Trace API.
Untuk mengetahui daftar lingkungan Google Cloud yang didukung, lihat Dukungan lingkungan.
Untuk konfigurasi berikut, setelan cakupan akses default akan mengaktifkan Cloud Trace API:
- Lingkungan fleksibel App Engine
Lingkungan standar App Engine
Google Kubernetes Engine (GKE)
Compute Engine
Cloud Run
Jika menggunakan cakupan akses kustom, Anda harus memastikan cakupan akses API Cloud Trace diaktifkan:
Untuk mengetahui informasi cara mengonfigurasi cakupan akses untuk lingkungan Anda menggunakan Konsol Google Cloud, lihat Mengonfigurasi project Google Cloud.
Untuk pengguna
gcloud
, tentukan cakupan akses menggunakan flag--scopes
dan sertakan cakupan akses Cloud Trace APItrace.append
. Misalnya, untuk membuat cluster GKE dengan hanya Cloud Trace API yang diaktifkan, lakukan hal berikut:gcloud container clusters create example-cluster-name --scopes=https://www.googleapis.com/auth/trace.append
Berjalan secara lokal dan di tempat lain
Jika aplikasi Anda berjalan di luar Google Cloud, Anda harus memberikan kredensial autentikasi dalam bentuk akun layanan ke library klien. Akun layanan harus berisi peran agen Cloud Trace. Untuk mengetahui petunjuknya, lihat Membuat akun layanan.
Library klien Google Cloud menggunakan Kredensial Default Aplikasi (ADC) untuk menemukan kredensial aplikasi Anda.
Anda dapat memberikan kredensial ini dengan salah satu dari tiga cara:
Jalankan
gcloud auth application-default login
Tempatkan akun layanan di jalur default untuk sistem operasi Anda. Berikut ini daftar jalur default untuk Windows dan Linux:
Windows:
%APPDATA%/gcloud/application_default_credentials.json
Linux:
$HOME/.config/gcloud/application_default_credentials.json
Tetapkan variabel lingkungan
GOOGLE_APPLICATION_CREDENTIALS
ke jalur ke akun layanan Anda:
Linux/macOS
export GOOGLE_APPLICATION_CREDENTIALS=path-to-your-service-accounts-private-key
Windows
set GOOGLE_APPLICATION_CREDENTIALS=path-to-your-service-accounts-private-key
PowerShell:
$env:GOOGLE_APPLICATION_CREDENTIALS="path-to-your-service-accounts-private-key"
Lihat pelacakan
Di panel navigasi konsol Google Cloud, pilih Trace, lalu pilih Trace explorer:
Pemecahan masalah
Untuk mengetahui informasi tentang cara memecahkan masalah terkait Cloud Trace, buka halaman Pemecahan masalah.
Untuk men-debug pengekspor Cloud Trace C++, lihat bagian Pemecahan masalah dalam dokumentasi referensi.
Referensi
- https://opentelemetry.io/
- repositori GitHub open-telemetry/opentelemetry-cpp
- Repositori GitHub Google-cloud-cpp OpenTelemetry Exporters Library.