Sebelum menggunakan Managed Service for OpenTelemetry, Anda perlu membuat akun Alibaba Cloud, mengaktifkan Managed Service for OpenTelemetry, dan mendapatkan informasi titik akhir. Topik ini menjelaskan cara menggunakan agen Java OpenTelemetry untuk melakukan instrumentasi otomatis pada aplikasi Java serta melaporkan data aplikasi tersebut, membantu Anda memulai dengan Managed Service for OpenTelemetry.
Prasyarat
Akun Alibaba Cloud telah dibuat.
Managed Service for OpenTelemetry telah diaktifkan.
Konsol baru
Masuk ke Konsol Managed Service for OpenTelemetry. Di panel navigasi sebelah kiri, klik Integration Center.
Di halaman Pusat Integrasi, klik kartu OpenTelemetry di bagian Open Source Frameworks.
Di panel OpenTelemetry, klik tab Start Integration, lalu pilih wilayah tempat Anda ingin melaporkan data.
CatatanSaat mengakses wilayah untuk pertama kalinya, sumber daya akan diinisialisasi secara otomatis di sana.
Konfigurasikan parameter Tipe Koneksi dan Protokol Ekspor, lalu salin titik akhir.
Tipe Koneksi: Jika layanan Anda diterapkan di Alibaba Cloud dan berada di wilayah yang dipilih, kami sarankan menyetel parameter ini ke Jaringan VPC Alibaba Cloud. Jika tidak, atur ke Jaringan Publik.
Protokol Ekspor: Atur parameter ini ke HTTP (disarankan) atau gRPC berdasarkan protokol yang didukung oleh klien.
Konsol lama
Masuk ke Konsol Managed Service for OpenTelemetry.
Di panel navigasi sebelah kiri, klik Cluster Configurations. Di halaman yang muncul, klik tab Access point information.
Di bilah navigasi atas, pilih wilayah tempat Anda ingin melaporkan data. Di bagian Cluster Information, aktifkan Show Token.
Atur parameter Client ke OpenTelemetry.
Di kolom Related Information tabel, salin titik akhir.
CatatanJika aplikasi Anda diterapkan di lingkungan produksi Alibaba Cloud, gunakan titik akhir VPC. Jika tidak, gunakan titik akhir publik.
Ikhtisar
Dalam contoh ini, agen Java OpenTelemetry digunakan untuk melakukan instrumentasi otomatis pada aplikasi Java dan melaporkan data aplikasi. Langkah-langkah berikut dilakukan:
Unduh demo: Anda dapat mengunduh demo agen Java OpenTelemetry dan mencoba Managed Service for OpenTelemetry. Anda juga dapat menggunakan agen Java OpenTelemetry untuk melakukan instrumentasi otomatis pada aplikasi bisnis Anda dan melihat data pemantauan.
Gunakan agen Java OpenTelemetry untuk melakukan instrumentasi otomatis pada aplikasi: Unduh agen Java OpenTelemetry. Agen ini memungkinkan pelaporan data aplikasi ke Managed Service for OpenTelemetry secara non-intrusif dan dapat digunakan untuk mengunggah data jejak secara otomatis dalam ratusan framework Java. Modifikasi parameter JVM di konfigurasi startup Java untuk melaporkan data jejak.
Lihat data pemantauan: Masuk ke Konsol Managed Service for OpenTelemetry untuk melihat data pemantauan yang dihasilkan menggunakan OpenTelemetry.
Langkah 1: Unduh demo
Anda dapat menggunakan demo agen Java OpenTelemetry atau kode bisnis Java Anda sendiri.
Unduh demo agen Java OpenTelemetry.
Paket demo berisi folder berikut:
java-agent-usage: menggunakan agen Java OpenTelemetry untuk melakukan instrumentasi otomatis pada aplikasi. Dalam contoh ini, metode ini digunakan.
otel-sdk-usage: menggunakan SDK OpenTelemetry untuk Java untuk melakukan instrumentasi manual pada aplikasi.
agent-sdk-usage: menggunakan agen Java OpenTelemetry dan SDK OpenTelemetry untuk Java untuk melakukan instrumentasi pada aplikasi.
Langkah 2: Gunakan agen Java OpenTelemetry untuk melakukan instrumentasi otomatis pada aplikasi
Dalam contoh ini, agen Java OpenTelemetry digunakan untuk melakukan instrumentasi otomatis pada aplikasi Java dan melaporkan data aplikasi. Untuk informasi lebih lanjut tentang framework Java yang didukung, lihat Library, framework, server aplikasi, dan JVM yang didukung.
Unduh agen Java OpenTelemetry.
Di halaman unduhan, temukan versi terbaru dan klik Assets. Temukan paket opentelemetry-javaagent.jar dan unduh paket tersebut.
Modifikasi parameter JVM di konfigurasi startup Java untuk melaporkan data jejak.
-javaagent:/{user.workspace}/opentelemetry-javaagent.jar // Ganti {user.workspace} dengan direktori tempat paket opentelemetry-javaagent.jar diunduh. -Dotel.resource.attributes=service.name=<appName> // Ganti <appName> dengan nama aplikasi yang datanya ingin Anda laporkan ke Managed Service for OpenTelemetry. -Dotel.exporter.otlp.headers=Authentication=<token> // Informasi titik akhir yang diperoleh di Prasyarat. -Dotel.exporter.otlp.endpoint=<endpoint> // Informasi titik akhir yang diperoleh di Prasyarat.Sebagai contoh, gunakan perintah berikut untuk memulai aplikasi Anda:
java -jar /{user.workspace}/java-agent-usage-0.0.1-SNAPSHOT.jarUntuk melaporkan data ke Managed Service for OpenTelemetry, gunakan perintah berikut untuk memulai aplikasi Anda:
java -Dotel.resource.attributes=service.name=java-agent-usage-0.0.1-SNAPSHOT -Dotel.exporter.otlp.headers=Authentication=ggxw4l****@7323a5caae30263_ggxw4l****@53df7ad2afe**** -Dotel.exporter.otlp.endpoint=http://tracing-analysis-dc-hz.aliyuncs.com:8090 -javaagent:/{user.workspace}/opentelemetry-javaagent.jar -jar /{user.workspace}/java-agent-usage-0.0.1-SNAPSHOT.jar
Langkah 3: Lihat data pemantauan
Akses aplikasi demo menggunakan URL berikut:
localhost:8081/user/async. Agen Java OpenTelemetry mengumpulkan data dari aplikasi demo dan melaporkannya ke Managed Service for OpenTelemetry.Masuk ke Konsol Managed Service for OpenTelemetry. Di halaman Applications, klik nama aplikasi demo. Di halaman yang muncul, lihat data jejak.
Apa yang harus dilakukan selanjutnya
Setelah data aplikasi dilaporkan ke konsol Managed Service for OpenTelemetry, Anda dapat melakukan operasi berikut di konsol Managed Service for OpenTelemetry:
Anda dapat melaporkan data aplikasi yang dikembangkan menggunakan berbagai bahasa pemrograman ke konsol Managed Service for OpenTelemetry, seperti Java, Go, Python, JavaScript, .NET, dan C++. Klien yang dapat Anda gunakan untuk melaporkan data termasuk OpenTelemetry, Jaeger, Zipkin, dan SkyWalking.