ARMS Java SDK - Application Real-Time Monitoring Service - Alibaba Cloud Dokümantasyon Merkezi

Kullanım

Agent sürümleri 4.x ve üzeri için özel enstrümantasyon ve iz bağlamını elde etmek amacıyla OpenTelemetry Java SDK'yı kullanmanızı öneririz:

4.x agent sürümüne yükseltme yapamadığınız durumlar haricinde, özel enstrümantasyon veya iz bağlamını elde etmek için ARMS SDK kullanılması önerilmez.

Ön koşullar

ARMS konsolunda uygulamanız için Uygulama İzleme özelliğini etkinleştirmiş ve Java uygulamanızda agent'ı başlatmış olmanız gerekir. Daha fazla bilgi için bkz. Agent'ı manuel olarak yükleme.
Uygulamanız arms-sdk-1.7.3.jar bağımlılığını içermelidir.
```
<dependency>
    <groupId>com.alibaba.arms.apm</groupId>
    <artifactId>arms-sdk</artifactId>
    <version>1.7.3</version>
</dependency>
```
Not
Bağımlılığı pom.xml dosyasından elde edemiyorsanız arms-sdk-1.7.3.jar dosyasını indirin.

İz Kimliği ve RPC Kimliğini Elde Etme

İz kimliğini (trace ID) ve RPC kimliğini elde etmek için aşağıdaki kodu kullanın.

Span span = Tracer.builder().getSpan();   // This does not create a new span.
String traceId = span.getTraceId();
String rpcId = span.getRpcId();

Özel baggage Yayma

Not

Spring Cloud Gateway filtresi ile baggage eklerken, agent'ı 4,2.x sürümüne yükseltip özel yapılandırmada spring-bean eklentisini etkinleştirirseniz yayma işlemi başarısız olur. Bu sorunu çözmek için spring-bean eklentisini devre dışı bırakın veya agent'ı 4,1.x ya da daha önceki bir sürüme düşürün.

Özel baggage öğelerini yaymak için aşağıdaki gibi ayarlama ve getirme kodlarını ekleyin:

Uygulama kodunuza özel baggage ekleyin.

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);

Uygulama kodunuzdan özel baggage öğelerini alın.

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

Agent sürümleri 4.x ve üzeri için baggage yalnızca yayılır. Agent bu içeriği her span'in etiketlerine otomatik olarak eklemez. Bu verilere etiketlerde ihtiyacınız varsa, bir span için özel etiket ayarlamanız gerekir.

Bir span İçin Özel Etiketler Ayarlama

Etiketler yalnızca ayarlandıkları belirli span için geçerlidir ve diğer span'lere yayılmaz. Özel etiketleri ayarlamak ve almak için aşağıdaki adımları izleyin:

Uygulama kodunuzda bir span'e özel tags ekleyin. Birden fazla etiket ekleyebilirsiniz.

Span span = Tracer.builder().getSpan();
// Add a tag to the Span.
span.setTag("tag-key1", "tag-value1");
span.setTag("tag-key2", "tag-value2");

Bir span'in özel tags değerlerini alın.

Span span = Tracer.builder().getSpan();
// Inspect the Span's tags.
Map<String, String> tags = span.tags();

Özel baggage ve tags Kullanarak İzleri Sorgulama

Bir span üzerinde ayarlanan özel baggage ve tags kullanarak izleri sorgulayın.

Baggage aşağı akış hizmetlerine yayılır ve genellikle iş bağlamının yayılması için kullanılır. Aşırı sayıda baggage öğesi ayarlamaktan kaçının.
Bir tag yalnızca mevcut span için geçerlidir. İş verileri için birden fazla etiket ayarlayabilirsiniz.

ARMS konsoluna giriş yapın. Sol gezinme bölmesinde seçeneğini belirleyin.
Sayfasında üst kısımdan hedef bölgeyi seçin. Ardından bir seçin, alanına özel etiket değerini girin ve tıklayın.
İzler listesinde hedef izin Trace ID değerine tıklayın.
Traces ayrıntıları sayfasında, mevcut span'in etiketlerini görüntülemek için sütunun üzerine gelin.

Örneğin, span'in etiketlerine tag-userid (değeri 123456789) ve tag-bu (değeri taobao) özel etiketleri eklenmiştir.
Agent sürümleri 4.x ve üzeri için baggage içeriğini bir span'e yazmak üzere öncelikle Özel baggage yayma bölümünde açıklandığı gibi tüm baggage öğelerini alın. Ardından, Bir span için özel etiketler ayarlama bölümünde açıklanan yöntemi kullanarak bunları span'e yazın.