OpenTelemetry Tracing demom iki Spring Boot bileşeni içeriyor. Biri Java aracısını kullanıyor ve yakın zamanda v1.x'ten v2.x'e yükselttiğimde farklı bir davranış fark ettim. Diğerinde, GraalVM yereline derlediğim için Micrometer Tracing kullanıyorum ve Java aracılarını işleyemiyor.   OpenTelemetry Demom  Bu yazımda bu üç yaklaşımı karşılaştırmak istiyorum: Java Agent v1, Java Agent v2 ve Micrometer Tracing.  Temel uygulama ve altyapısı  Aynı temel uygulamayı kullanacağım: Kotlin'de kodlanmış basit bir Spring Boot uygulaması. Tek bir uç nokta sunuyor.  Uç noktanın ötesindeki fonksiyon   olarak adlandırılır entry()    adında başka bir fonksiyonu çağırır intermediate()  İkincisi, yukarıdaki uç noktaya bir çağrı yapmak için   yerine geçen bir   örneği kullanır RestTemplate WebClient  Sonsuz döngüden kaçınmak için özel bir istek başlığı geçiriyorum:   fonksiyonu bunu bulursa, daha fazla ilerlemez  entry()  Aşağıdaki koda çevrilir:   @SpringBootApplication class Agent1xApplication @RestController class MicrometerController { private val logger = LoggerFactory.getLogger(MicrometerController::class.java) @GetMapping("/{message}") fun entry(@PathVariable message: String, @RequestHeader("X-done") done: String?) { logger.info("entry: $message") if (done == null) intermediate() } fun intermediate() { logger.info("intermediate") RestClient.builder() .baseUrl("http://localhost:8080/done") .build() .get() .header("X-done", "true") .retrieve() .toBodilessEntity() } }  Her kurulum için iki aşamayı kontrol edeceğim: OpenTelemetry'nin etkinleştirildiği birincil aşama ve ek dahili aralıklar oluşturmak için bir özelleştirme aşaması.  Mikrometre İzleme  Mikrometre İzleme, "tedarikçiden bağımsız bir uygulama gözlemlenebilirlik cephesi" olan   kaynaklanmaktadır. Mikrometre'den  Micrometer Tracing, en popüler izleyici kütüphaneleri için basit bir cephe sunar ve JVM tabanlı uygulama kodunuzu satıcıya bağlı kalmadan enstrümanlamanıza olanak tanır. İzleme toplama etkinliğinize çok az veya hiç ek yük eklemeden izleme çabanızın taşınabilirliğini en üst düzeye çıkarmak için tasarlanmıştır.  --  Mikrometre İzleme sitesi  Mikrometre İzlemeye başlamak için birkaç bağımlılığın eklenmesi gerekir:  Spring Boot Aktüatörü,  org.springframework.boot:spring-boot-starter-actuator  Mikrometre İzlemenin kendisi,  io.micrometer:micrometer-tracing  Hedef izleme arka uç API'sine bir "köprü". Benim durumumda, bu OpenTelemetry'dir, dolayısıyla  io.micrometer:micrometer-tracing-bridge-otel  Arka uç için somut bir ihracatçı,  io.opentelemetry:opentelemetry-exporter-otlp  Spring Boot ebeveyninde sürümler zaten tanımlı olduğundan bir BOM'a ihtiyacımız yok.  Yine de, iki çalışma zamanı yapılandırma parametresine ihtiyacımız var: İzler nereye gönderilmeli ve bileşenin adı nedir. Bunlar   ve   değişkenleri tarafından yönetilir. MANAGEMENT_OTLP_TRACING_ENDPOINT SPRING_APPLICATION_NAME   services: jaeger: image: jaegertracing/all-in-one:1.55 environment: - COLLECTOR_OTLP_ENABLED=true #1 ports: - "16686:16686" micrometer-tracing: build: dockerfile: Dockerfile-micrometer environment: MANAGEMENT_OTLP_TRACING_ENDPOINT: http://jaeger:4318/v1/traces #2 SPRING_APPLICATION_NAME: micrometer-tracing #3  Jaeger için OpenTelemetry toplayıcısını etkinleştirin  Jaeger OpenTelemetry gRPC uç noktasına tam URL  OpenTelemetry'nin hizmet adını ayarlayın  İşte sonuç:   Micrometer, herhangi bir özelleştirmeye gerek kalmadan HTTP isteklerini alırken ve gönderirken aralıklar oluşturur.  Çerçevenin   gönderim için sihir enjekte etmesi gerekir. Bunun için birincisinin ikincisini örneklendirmesine izin vermeliyiz: RestClient   @SpringBootApplication class MicrometerTracingApplication { @Bean fun restClient(builder: RestClient.Builder) = builder.baseUrl("http://localhost:8080/done").build() }  Manuel aralıkları birkaç şekilde oluşturabiliriz, bunlardan biri OpenTelemetry API'sinin kendisidir. Ancak kurulum çok sayıda hazır kod gerektirir. En basit yol Micrometer'ın   . Başlıca faydası hem   hem de   yöneten tek bir API kullanmaktır.  Observation API'sidir ölçümleri izleri  İşte güncellenmiş kod:   class MicrometerController( private val restClient: RestClient, private val registry: ObservationRegistry ) { @GetMapping("/{message}") fun entry(@PathVariable message: String, @RequestHeader("X-done") done: String?) { logger.info("entry: $message") val observation = Observation.start("entry", registry) if (done == null) intermediate(observation) observation.stop() } fun intermediate(parent: Observation) { logger.info("intermediate") val observation = Observation.createNotStarted("intermediate", registry) .parentObservation(parent) .start() restClient.get() .header("X-done", "true") .retrieve() .toBodilessEntity() observation.stop() } }  Eklenen gözlem çağrıları oluşturulan izlere yansır:   OpenTelemetry Aracısı v1  Micrometer Tracing'e bir alternatif, genel   . Başlıca faydası, ne kodu ne de geliştiricileri etkilememesidir; ajan, saf bir çalışma zamanı kapsamlı endişedir. OpenTelemetry Java Agent'tır   java -javaagent:opentelemetry-javaagent.jar agent-one-1.0-SNAPSHOT.jar  Ajan, ortam değişkenleriyle OpenTelemetry'nin yapılandırmasına uyar:   services: agent-1x: build: dockerfile: Dockerfile-agent1 environment: OTEL_EXPORTER_OTLP_ENDPOINT: http://jaeger:4317 #1 OTEL_RESOURCE_ATTRIBUTES: service.name=agent-1x #2 OTEL_METRICS_EXPORTER: none #3 OTEL_LOGS_EXPORTER: none #4 ports: - "8081:8080"  Protokolü, etki alanını ve portu ayarlayın. Kütüphane   ekler /v1/traces  OpenTelemetry'nin hizmet adını ayarlayın  Ne ölçümleri ne de günlükleri dışa aktarın  Herhangi bir yapılandırma yapmadan aşağıdaki izleri elde ederiz:   Aracı, alınan ve gönderilen istekleri   otomatik olarak izler. İzler, çağrı yığınına göre birbirlerinin içine doğru şekilde yerleştirilmiştir. Ek işlevleri izlemek için kod tabanımıza bir bağımlılık eklememiz gerekir,   . Artık daha önce izlenmeyen işlevleri   açıklamasıyla açıklayabiliriz.  ve Spring ile ilgili açıklamalarla işaretlenmiş işlevleri io.opentelemetry.instrumentation:opentelemetry-instrumentation-annotations @WithSpan    kısmı, trace'in etiketini yönetirken,   bir   niteliği olarak çevrilir. Değer, varsayılan olan boş bir dizeye ayarlanırsa, işlevin adını çıktı olarak verir. Benim amaçlarım için, varsayılan değerler yeterince iyidir. value() kind span.kind   @WithSpan fun intermediate() { logger.info("intermediate") RestClient.builder() .baseUrl("http://localhost:8080/done") .build() .get() .header("X-done", "true") .retrieve() .toBodilessEntity() }  Beklenen yeni   izini verir:  intermediate()  OpenTelemetry Aracısı v2  OpenTelemetry bu yılın Ocak ayında ajanın yeni bir ana sürümünü yayınladı. Demomu bununla güncelledim; izler artık yalnızca uygulama istek aldığında ve gönderdiğinde oluşturuluyor.   Önceki versiyonda olduğu gibi,   anotasyonuyla izleri ekleyebiliriz. Tek fark,   fonksiyonunu da anotlamamız gerektiğidir. Varsayılan olarak izlenmemektedir.  @WithSpan entry()  Tartışma  Spring iki nedenden ötürü başarılı oldu: karmaşık çözümleri basitleştirdi,   EJBs 2 ve rakip kütüphaneler üzerinde bir soyutlama katmanı sağladı. Micrometer Tracing, Zipkin ve Jaeger üzerinde bir soyutlama katmanı olarak başladı ve tamamen mantıklıydı. OpenTelemetry'nin programlama dilleri ve iz toplayıcıları genelindeki çoğu kütüphane tarafından desteklenmesiyle bu argüman tartışmalı hale geldi. Observation API, Metrics ve Traces üzerinde tek bir API kullandığı için Micrometer Tracing'in hala önemli bir faydasıdır. yani  Java Agent tarafında, OpenTelemetry yapılandırması tüm teknoloji yığınları ve kütüphaneler arasında benzerdir - ortam değişkenleri. v1'den v2'ye yükselttiğimde biraz hayal kırıklığına uğradım, çünkü yeni ajan Spring'i algılamıyor: Spring açıklamalı işlevler varsayılan olarak izlenmiyor.  Sonuç olarak, bu akıllıca bir karardır. Görmek istemediğiniz bazı bölümleri kaldırmaktansa, istediğiniz bölümleri açıkça belirtmek çok daha iyidir.    . Yardımı ve yorumu için   teşekkürler Jonatan Ivanov'a  Bu yazının tam kaynak koduna GitHub'dan ulaşabilirsiniz:   https://github.com/ajavageek/boot-tracing?embedable=true   Daha ileri gitmek gerekirse:   OpenTelemetry Tracing'in Demosu   Mikrometre İzleme   OpenTelemetry İzleri   OpenTelemetry Java entegrasyonu OpenTelemetry Java örnekleri   Spring Boot 3 ile Dağıtık İzleme — Mikrometre ve OpenTelemetri   Spring Boot 3 ile Gözlemlenebilirlik   İlk olarak 3 Ağustos 2024'te   yayınlandı A Java Geek'te

Read all my posts!

Read My Stories

Follow @nicolas_frankel on Twitter

Bu ses hikayenin orijinal dilinde üretilmiştir!

Çok uzun; Okumak

Make resilience your competitive advantage

Spring Boot'ta OpenTelemetry İzleme: Java Agent ve Micrometer Arasında Seçim Yapmak

About Author

YORUMLAR

ETİKETLERİ ASIN

BU YAZI

Related Stories

Claude Sonnet 3.5 Sistem Bilgi Sızıntısı: Adli Analiz

Kazanmak için Dokun: Telegram, Solana'dan Önce Sonraki 10 Milyar Kripto Kullanıcısına Katılabilir

Kullanıcı Odaklı Kripto Ürünleri Oluşturma: Müşteri Geri Bildiriminin Önemi

Forumlardan Feed'lere: Sosyal Medya Algoritmaları Dijital Etkileşimi Nasıl Şekillendiriyor

Claude Sonnet 3.5 Sistem Bilgi Sızıntısı: Adli Analiz

Kazanmak için Dokun: Telegram, Solana'dan Önce Sonraki 10 Milyar Kripto Kullanıcısına Katılabilir

Kullanıcı Odaklı Kripto Ürünleri Oluşturma: Müşteri Geri Bildiriminin Önemi

Forumlardan Feed'lere: Sosyal Medya Algoritmaları Dijital Etkileşimi Nasıl Şekillendiriyor

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps