Dokumen ini menjelaskan cara menambahkan kode kemampuan observasi ke aplikasi Anda menggunakan OpenTelemetry. OpenTelemetry menyediakan library instrumentasi yang menghasilkan telemetri untuk framework populer. Anda dapat meningkatkan telemetri yang dihasilkan library dengan menambahkan instrumentasi kustom yang mengukur perilaku spesifik per aplikasi.
Prinsip dan konsep yang dijelaskan dalam dokumen ini dapat diterapkan ke aplikasi yang ditulis dalam semua bahasa yang didukung oleh OpenTelemetry. Untuk mempelajari instrumentasi lebih lanjut, lihat dokumen berikut:
Kode contoh, yang merupakan aplikasi Go yang sama seperti yang dijelaskan di Membuat rekaman aktivitas dan metrik dengan Go, tersedia di GitHub. Untuk melihat contoh lengkap, klik more_vert More, lalu pilih View on GitHub.
Sebelum memulai
Enable the Cloud Logging, Cloud Monitoring, and Cloud Trace APIs.
Membuat rekaman aktivitas kustom
Untuk membuat rekaman aktivitas kustom dari aplikasi, Anda menambahkan kode instrumentasi yang membuat span OpenTelemetry. Dalam OpenTelemetry, span adalah elemen penyusun untuk trace.
Untuk membuat span, lakukan langkah berikut:
Memodifikasi aplikasi untuk memperoleh OpenTelemetry
Tracer
. Di OpenTelemetry, pelacak adalah pembuat span. Anda dapat memperoleh tracer seperti yang ditunjukkan dalam kode berikut:Nama tracer, yang direpresentasikan oleh
scopeName
, mengidentifikasi cakupan instrumentasi rekaman aktivitas yang dibuat.Gunakan instance
tracer
untuk membuat span. Dalam contoh kode berikut, fungsicomputeSubrequests
menghasilkan span setiap kali dipanggil:Pada contoh kode sebelumnya, span yang dihasilkan dari fungsi
computeSubrequests
mewakili pekerjaan yang dilakukan oleh seluruh fungsi. Hal ini karena langkah pertama fungsi ini adalah memulai span baru menggunakantracer.Start
dan kata kuncidefer
sebelumspan.End()
memastikan bahwa span berakhir tepat sebelum fungsi keluar.
Membuat metrik kustom
Untuk membuat metrics dari aplikasi, tambahkan kode instrumentasi yang mencatat pengukuran yang dilakukan selama eksekusi aplikasi Anda.
Untuk membuat metrik, lakukan tindakan berikut:
Memodifikasi aplikasi untuk memperoleh OpenTelemetry
Meter
. Dalam OpenTelemetry, meter menyediakan akses ke instrumen metrik untuk merekam metrik. Anda bisa mendapatkan pengukur seperti yang ditunjukkan dalam kode berikut:Nama pengukur, yang diwakili oleh
scopeName
, mengidentifikasi cakupan instrumentasi metrik yang dihasilkan.Gunakan instance
meter
untuk membuat instrumen yang dapat merekam metrik. Misalnya, dalam kode berikut, kita menggunakanmeter
untuk membuat OpenTelemetry Histogram:Kode sebelumnya ini menghasilkan histogram bernama
sleepHistogram
.Gunakan instance
sleepHistogram
untuk mencatat waktu tidur, yang ditentukan saat fungsirandomSleep
dipanggil:Metrik yang direkam dari instrumen ini diekspor dari aplikasi Anda berdasarkan konfigurasi pengekspor OpenTelemetry.
Langkah selanjutnya
- Menghubungkan metrik dan rekaman aktivitas dengan menggunakan contoh
- OpenTelemetry
- Instrumentasi OpenTelemetry
- Model Data Metrik OpenTelemetry