Application Real-Time Monitoring Service:ARMS SDK for Java (tidak digunakan lagi)

Catatan penggunaan

Untuk agen versi 4.x atau lebih baru, gunakan OpenTelemetry Java SDK untuk instrumentasi kustom dan mengambil konteks jejak:

• Gunakan OpenTelemetry Java SDK untuk instrumentasi kustom

• Gunakan OpenTelemetry Java SDK untuk menyebarkan konteks dalam skenario asinkron intra-proses

• Gunakan OpenTelemetry Java SDK untuk menyebarkan konteks lintas proses

Gunakan ARMS SDK hanya jika Anda tidak dapat melakukan upgrade ke agen versi 4.x. Untuk semua skenario lainnya, gunakan OpenTelemetry Java SDK untuk instrumentasi kustom dan mengambil konteks jejak.

Prasyarat

• Di Konsol ARMS, aktifkan Pemantauan Aplikasi untuk aplikasi Anda, lalu instal dan jalankan agen di aplikasi Java Anda. Untuk informasi selengkapnya, lihat Instal agen secara manual.

• Sertakan dependensi arms-sdk-1.7.3.jar dalam aplikasi Anda.

  <dependency>
      <groupId>com.alibaba.arms.apm</groupId>
      <artifactId>arms-sdk</artifactId>
      <version>1.7.3</version>
  </dependency>

  Catatan

  Jika Anda tidak dapat memperoleh dependensi dari pom.xml, unduh arms-sdk-1.7.3.jar.

Ambil ID jejak dan ID RPC

Gunakan kode berikut untuk mengambil ID jejak dan ID RPC.

Span span = Tracer.builder().getSpan();   // Ini tidak membuat Span baru.
String traceId = span.getTraceId();
String rpcId = span.getRpcId();

Sebarkan baggage kustom

Untuk menyebarkan baggage kustom, tambahkan kode untuk mengatur dan mengambilnya seperti pada langkah-langkah berikut:

1. Atur baggage kustom.

   Map<String, String> baggage = new HashMap<String, String>();
   baggage.put("key-01", "value-01");
   baggage.put("key-02", "value-02");
   baggage.put("key-03", "value-03");
   Span span = Tracer.builder().getSpan();
   span.withBaggage(baggage);

2. Ambil baggage kustom.

   Span span = Tracer.builder().getSpan();
   Map<String, String> baggage = span.baggageItems();

3. Pada agen versi 4.x dan lebih baru, baggage hanya digunakan untuk penyebaran. Isinya tidak ditambahkan secara otomatis ke tag setiap Span. Jika diperlukan, Anda harus secara manual mengatur tag kustom untuk sebuah Span.

Atur tag rentang kustom

Tag kustom hanya berlaku untuk Span tempat tag tersebut diatur dan tidak disebarkan. Tambahkan dan ambil tag kustom sebagai berikut:

1. Dalam kode aplikasi Anda, tambahkan satu atau beberapa tag kustom ke sebuah Span.

   Span span = Tracer.builder().getSpan();
   // Tambahkan tag ke Span.
   span.setTag("tag-key1", "tag-value1");
   span.setTag("tag-key2", "tag-value2");

2. Dalam kode aplikasi Anda, ambil tag kustom dari sebuah Span.

   Span span = Tracer.builder().getSpan();
   // Periksa tag milik Span.
   Map<String, String> tags = span.tags();

Kueri berdasarkan baggage dan tag kustom

Anda dapat melakukan kueri jejak menggunakan baggage dan tag kustom yang diatur pada sebuah Span.

• Baggage disebarkan ke layanan downstream dan biasanya digunakan untuk penyebaran konteks bisnis. Hindari menambahkan terlalu banyak item baggage.

• Tag hanya berlaku dalam Span saat ini. Anda dapat menambahkan beberapa item terkait bisnis sebagai tag.

1. Login ke Konsol ARMS. Di panel navigasi sebelah kiri, pilih Application Monitoring > Trace Query.

2. Di halaman Trace Query, pilih Wilayah di bagian atas halaman. Lalu, pilih Parameter type, masukkan tag kustom di bidang Parameter value, dan klik Add to query criteria.

3. Dalam daftar jejak, klik trace ID dari jejak yang diinginkan.

4. Di halaman detail Trace, arahkan kursor ke service name untuk melihat tag untuk Span tersebut.

   

5. Untuk agen versi 4.x dan lebih baru, agar baggage termasuk dalam sebuah Span, ambil baggage tersebut lalu atur sebagai tag kustom. Lihat Sebarkan baggage kustom dan Atur tag kustom untuk sebuah Span.