All Products
Search
Document Center

SchedulerX:Integrasikan analisis tracing

Last Updated:Mar 12, 2026

Pekerjaan terjadwal terdistribusi umumnya melibatkan beberapa layanan dan berlangsung lebih lama dibandingkan permintaan real-time biasa. Analisis tracing SchedulerX memberikan visibilitas end-to-end terhadap jalur eksekusi pekerjaan, sehingga membantu Anda mengukur durasi eksekusi dan mengidentifikasi kegagalan lintas layanan.

Prasyarat

Sebelum memulai, pastikan Anda telah:

  • Menggunakan Agent versi 1.7.0 atau yang lebih baru.

  • Meningkatkan aplikasi ke Edisi Profesional.

Tambahkan dependensi plug-in trace

Tambahkan dependensi berikut ke file pom.xml aplikasi Spring Boot Anda:

<dependency>
  <groupId>com.aliyun.schedulerx</groupId>
  <artifactId>schedulerx2-spring-boot-starter</artifactId>
  <version>{Latest version}</version>
  <!-- Jika Anda menggunakan Logback, exclude Log4J dan Log4J2. -->
  <exclusions>
    <exclusion>
      <groupId>org.apache.logging.log4j</groupId>
      <artifactId>log4j-api</artifactId>
    </exclusion>
    <exclusion>
      <groupId>org.apache.logging.log4j</groupId>
      <artifactId>log4j-core</artifactId>
    </exclusion>
    <exclusion>
      <groupId>log4j</groupId>
      <artifactId>log4j</artifactId>
    </exclusion>
  </exclusions>
</dependency>

<!-- OpenTelemetry trace plug-in -->
<dependency>
  <groupId>com.aliyun.schedulerx</groupId>
  <artifactId>schedulerx-plugin-trace-opentelemetry</artifactId>
  <version>{Latest version}</version>
</dependency>

<!-- Alternatif: SkyWalking trace plug-in -->
<!--
<dependency>
  <groupId>com.aliyun.schedulerx</groupId>
  <artifactId>schedulerx-plugin-trace-skywalking</artifactId>
  <version>{Latest version}</version>
</dependency>
-->

Deploy aplikasi

Pilih salah satu metode deployment berikut.

Deploy di Enterprise Distributed Application Service (EDAS) (disarankan)

Jika aplikasi Anda sudah di-deploy di EDAS, analisis tracing akan berfungsi secara otomatis tanpa perlu konfigurasi tambahan.

Jika Anda baru menggunakan EDAS, aktifkan layanan tersebut dan deploy aplikasi Anda dari Konsol EDAS. Analisis tracing diaktifkan secara default. Untuk informasi selengkapnya, lihat Memulai dengan EDAS.

Integrasikan Application Real-Time Monitoring Service (ARMS)

  1. Unduh paket JAR agent ARMS.

  2. Konfigurasikan informasi aplikasi Anda.

  3. Tambahkan javaagent ARMS ke skrip startup Anda.

Untuk petunjuk langkah demi langkah, lihat Menginstal agent ARMS secara manual untuk aplikasi Java.

Integrasikan platform tracing yang dikelola sendiri

Jika Anda menggunakan platform tracing yang dikelola sendiri seperti Apache SkyWalking, ikuti langkah-langkah berikut:

  1. Unduh paket agent SkyWalking dan selesaikan konfigurasi agent-nya.

  2. Tambahkan parameter JVM berikut ke skrip startup aplikasi Java Anda:

       -javaagent:{agent.path}/skywalking-agent.jar
  3. Ganti dependensi plug-in Trace SchedulerX ke tipe SkyWalking:

       <dependency>
           <groupId>com.aliyun.schedulerx</groupId>
           <artifactId>schedulerx-plugin-trace-skywalking</artifactId>
           <version>{Latest version}</version>
       </dependency>

Lihat hasil analisis tracing

Setelah integrasi dan deployment selesai, SchedulerX melakukan tracing eksekusi pekerjaan terjadwal secara end-to-end. Tabel berikut mencantumkan jenis pekerjaan yang didukung dan cara mengakses data jejak untuk masing-masing jenis.

Job type

Supported

How to access traces

Standalone (termasuk HTTP)

Yes

Klik tracing di kolom Operation. Atau, klik Details, lalu klik ID di samping TraceId untuk membuka halaman Traces.

Broadcast

Yes

Klik Details > tab Current execution details > klik ID worker di kolom TraceId.

Visual MapReduce

Yes

Klik Details > tab Subtask list > klik ID subtask di kolom TraceId.

Untuk melihat hasil tracing:

  1. Masuk ke Distributed Task Scheduling Platform.

  2. Di bilah navigasi atas, pilih wilayah.

  3. Di panel navigasi kiri, klik Execution List. Di tab Task instance List, temukan instans pekerjaan target.

  4. Di kolom Operation, akses data jejak sesuai dengan jenis pekerjaan yang dijelaskan dalam tabel di atas.

Catatan

Laju pengambilan sampel default mengontrol volume data jejak yang dikumpulkan. Tidak semua jalur eksekusi diambil sampelnya. Sesuaikan laju pengambilan sampel berdasarkan kebutuhan workload Anda.