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.
Masuk ke Konsol ARMS. Di panel navigasi sebelah kiri, klik Integration Center.
Di halaman Pusat Integrasi, klik kartu OpenTelemetry di bagian Server-side Applications.
Di panel OpenTelemetry, klik tab Mulai Integrasi, 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.
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 OpenTelemetryKonsol ARMS 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 ARMS. Di panel navigasi sebelah kiri, pilih . Di halaman Applications, klik nama aplikasi. Di halaman yang muncul, lihat data jejak.
CatatanJika ikon
ditampilkan di kolom Language, aplikasi tersebut terhubung ke Pemantauan Aplikasi. Jika tanda hubung (-) ditampilkan, aplikasi tersebut terhubung ke Managed Service for OpenTelemetry.
Apa yang harus dilakukan selanjutnya
Setelah data aplikasi dilaporkan ke konsol Managed Service for OpenTelemetry, Anda dapat melakukan operasi berikut di konsol ARMS:
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.