Managed Service for OpenTelemetry：Gunakan SkyWalking untuk melaporkan data aplikasi Java

Kode contoh

Untuk informasi lebih lanjut tentang repositori kode contoh, lihat SkyWalking Demo.

Gunakan SkyWalking untuk menginstrumentasi aplikasi Java secara otomatis

1. Unduh SkyWalking Java Agent.

2. Ubah file konfigurasi SkyWalking Java Agent untuk mengatur informasi akses dan informasi aplikasi.

   collector.backend_service=<endpoint> // Ganti dengan informasi titik akhir yang diperoleh dari kondisi lain.
   agent.authentication=<token> // Ganti dengan token otentikasi yang diperoleh dari prasyarat.
   agent.service_name=<Service Name> // Ganti dengan nama aplikasi aktual Anda.

3. Gunakan salah satu metode berikut untuk menentukan jalur ke SkyWalking Agent berdasarkan lingkungan runtime aplikasi:

   Catatan

   Ganti <skywalking-agent-path> dalam kode contoh berikut dengan jalur mutlak ke file skywalking-agent.jar di folder agent.

   Linux Tomcat 7 / Tomcat 8

   Tambahkan konten berikut sebagai baris pertama dalam file tomcat/bin/catalina.sh:

   CATALINA_OPTS="$CATALINA_OPTS -javaagent:<skywalking-agent-path>"; export CATALINA_OPTS

   Windows Tomcat 7 / Tomcat 8

   Tambahkan konten berikut sebagai baris pertama dalam file tomcat/bin/catalina.bat:

   set "CATALINA_OPTS=-javaagent:<skywalking-agent-path>"

   File JAR atau Spring Boot

   Tambahkan parameter -javaagent ke perintah startup aplikasi.

   Penting

   Parameter -javaagent harus ditulis sebelum parameter -jar.

   java -javaagent:<skywalking-agent-path> -jar yourApp.jar

   Jetty

   Tambahkan konten berikut ke file konfigurasi {JETTY_HOME}/start.ini:

   --exec
   -javaagent:<skywalking-agent-path>

4. Mulai ulang aplikasi.

Atribut yang dapat dikonfigurasi pada Agen Java SkyWalking

Agen Java SkyWalking mendukung berbagai atribut yang dapat dikonfigurasi. Untuk informasi lebih lanjut, lihat file config/agent.config dalam kode contoh.

Sebagian atribut Agen Java SkyWalking

Tabel berikut menjelaskan sebagian atribut Agen Java SkyWalking versi 8.16.0.

Metode konfigurasi

Atribut sistem

Gunakan -Dskywalking. diikuti kunci dari file konfigurasi agent.config. Contoh kode:

# Konfigurasikan atribut agent.service_name menggunakan atribut sistem.
java -javaagent:/path/to/skywalking-agent.jar -Dskywalking.agent.service_name=<your_service_name> -jar your-project.jar

Opsi proxy

Tambahkan atribut setelah jalur proxy dalam parameter JVM.

# Template
-javaagent:/path/to/skywalking-agent.jar=[key1]=[value1],[key2]=[value2]

# Contoh
java -javaagent:/path/to/skywalking-agent.jar=agent.service_name=<your-service-name>,agent.authentication=<your-token> -jar your-project.jar

Variabel lingkungan sistem

Konfigurasikan atribut sebagai variabel lingkungan sistem. Agen SkyWalking secara otomatis membaca variabel lingkungan sistem tersebut. Anda dapat menemukan variabel lingkungan sistem yang sesuai dengan atribut tertentu di file config/agent.config. Misalnya, atribut agent.service_name sesuai dengan variabel lingkungan sistem SW_AGENT_NAME.

agent.service_name=${SW_AGENT_NAME:default_name}

# Konfigurasikan variabel lingkungan.
export SW_AGENT_NAME=<your_service_name>

Preseden

Prioritas metode konfigurasi di atas dari yang tertinggi ke terendah adalah opsi proxy, properti sistem, variabel lingkungan sistem, dan file konfigurasi.

Plugin Agen Java SkyWalking

Agen Java SkyWalking mendukung berbagai middleware, framework, dan repositori. Untuk informasi lebih lanjut tentang plugin yang didukung, lihat folder /plugins dalam kode contoh.

Aktifkan plugin

Semua plugin di folder /plugins diaktifkan secara default. Jika paket JAR plugin dihapus dari folder tersebut, plugin tersebut tidak lagi tersedia.

Plugin resmi yang didukung

Plugin resmi yang didukung tersedia di folder /plugins.

Plugin opsional

Plugin Agen Java SkyWalking bersifat plug-and-play. Plugin opsional tersedia di folder optional-plugins pada repositori pihak ketiga atau agen. Untuk menggunakan plugin opsional, pindahkan plugin tersebut ke folder /plugins.

Plugin Bootstrap

Semua plugin Bootstrap bersifat opsional karena risiko tak terduga. Plugin Bootstrap tersedia di folder bootstrap-plugins. Jika ingin menggunakannya, tambahkan paket JAR plugin tersebut ke folder /plugins.

Plugin yang didukung

Tim resmi SkyWalking berpendapat bahwa plugin berikut dapat memengaruhi kinerja SkyWalking dan membatasi penggunaannya. Oleh karena itu, plugin tersebut hanya dirilis di repositori pihak ketiga. Untuk informasi lebih lanjut, lihat java-plugin-extensions di GitHub.

Kembangkan plugin

Untuk membuat plugin kustom Agen Java SkyWalking, rujuk ke dokumentasi resmi SkyWalking.

Managed Service for OpenTelemetry mendukung pelaporan jejak. Untuk membuat plugin jejak kustom, rujuk ke dokumentasi resmi SkyWalking.

FAQ

T: Mengapa saya tidak dapat membuat aplikasi setelah SkyWalking terhubung ke server?

Data mungkin tidak dilaporkan karena alasan berikut: pengambilan sampel diaktifkan, data difilter, atau permintaan untuk menggunakan Managed Service for OpenTelemetry belum dipicu.