Application Real-Time Monitoring Service:Günlük analizi

XML değişikliklerinden sonra günlük ilişkilendirmesi neden başarısız olur?

SLS'de günlükleri sorgularken bu sorunla karşılaşırsanız öncelikle günlüklerin SLS'ye raporlandığını ve ARMS konsolunda doğru proje ile Logstore'u bağladığınızı doğrulayın.

SLS'de verilerin bulunduğunu onayladıktan sonra sorunu aşağıdaki iki senaryoya göre giderin:

• Hiçbir günlük bir iz kimliği ile ilişkilendirilmemiş. Bu sorunun birkaç olası nedeni vardır:

  • Aracı başarıyla eklenmemiş.

    ARMS konsolunda tüm ölçümlerin doğru şekilde görüntülenip görüntülenmediğini kontrol ederek bunu doğrulayabilirsiniz.

  • Aracının ana anahtarı devre dışı bırakılmış veya Tomcat eklentisi gibi belirli eklentiler kapatılmış.

    Bunu Custom configurations sayfasındaki Agent switch settings bölümünden kontrol edebilirsiniz.

  • Sunucu tarafı çerçeve desteklenmiyor. Örneğin desteklenmeyen bir web kapsayıcısı, RPC çerçevesi, zamanlanmış görev çerçevesi veya mesajlaşma çerçevesi kullanıyor olabilirsiniz. Desteklenen çerçevelerin listesi için bkz. Uygulama izleme tarafından desteklenen Java bileşenleri ve çerçeveleri.

  • Log4j, Log4j2 veya Logback dışındaki günlük kayıt çerçevelerini kullanıyor veya bu çerçevelerde yoğun değişiklikler yapmış olabilirsiniz.

  • Günlük XML yapılandırması hatalı.

    Sorunu araştırmak için aşağıdaki adımları uygulayın:

    • Aracı sürüm 4.1.6 veya üstünü kullanıyorsanız otomatik iz kimliği ekleme özelliğini etkinleştirin. İz kimlikleri ilişkilendirilebiliyorsa bu durum günlük XML yapılandırmasında bir hata olduğunu doğrular.

    • Java için ARMS SDK'sını içe aktarın ve günlükleri yazdırırken iz kimliğini manuel olarak alın. Aşağıda örnek kod verilmiştir:

      Span span = Tracer.builder().getSpan();   // This does not create a new span.
      String traceId = span.getTraceId();
      logger.warn("traceId={} this is your log message", traceId)

      İz kimliğini alabiliyorsanız bu durum günlük XML yapılandırmasında bir hata olduğunu doğrular.

    • Her iki yöntem de başarısız olursa destek talebi oluşturun.

• Bazı günlükler bir iz kimliği ile ilişkilendirilmemiş. Bunun nedeni günlüklerde bir iz bağlamının eksik olması olabilir.

  Genellikle günlükler yazılırken bir iz bağlamı bulunmaz. İz bağlamı genellikle yalnızca HTTP arabirimleri, RPC arabirimleri, zamanlanmış görevler veya mesaj tüketimi gibi istek giriş noktalarında işlenen kodlarda yazdırılan günlüklerde mevcuttur.

  Örnek senaryolar:

  • Bir uygulama HTTP isteği aldıktan sonra bir veritabanı sorgusu yürütür ve ardından bir günlük yazdırır. Bu durumda bir iz bağlamı vardır ve günlük başarıyla bir iz kimliği ile ilişkilendirilebilir.

  • Bir uygulama HTTP isteği alır, bir veritabanı sorgusunu yürütmek üzere eşzamansız bir görevi bir iş parçacığı havuzuna gönderir ve ardından bir günlük yazdırır.

    • Aracı v3.x için günlükler bir iz kimliği ile ilişkilendirilemez çünkü aracı iz bağlamının otomatik eşzamansız yayılmasını desteklemez. Eşzamansız iş parçacığında iz bağlamı yoktur.

    • Aracı v4.x için günlükler bir iz kimliği ile ilişkilendirilebilir çünkü aracı iz bağlamının otomatik eşzamansız yayılmasını destekler. Eşzamansız iş parçacığında iz bağlamı vardır.

  • Başlatıldıktan sonra bir uygulama veritabanı sorgularını döngüsel olarak yürütmek ve her sorgudan sonra bir günlük yazdırmak için bir JDK iş parçacığı havuzu kullanır. Bu durumda iz bağlamı yoktur ve günlükler bir iz kimliği ile ilişkilendirilemez.

  Günlüğü yazan iş parçacığının adını kontrol ederek belirli senaryoyu belirleyebilirsiniz.

  Örneğin:

  • Web kapsayıcısı olarak Tomcat kullandığınızda http-nio- ile başlayan iş parçacığı adları genellikle HTTP isteklerini işleyen iş parçacıklarını temsil eder. Bu iş parçacıkları tarafından yazdırılan günlükler bir iz kimliği ile ilişkilendirilebilir.

  • RPC çerçevesi olarak Dubbo kullandığınızda DubboServerHandler- ile başlayan iş parçacığı adları genellikle Dubbo isteklerini işleyen iş parçacıklarını temsil eder. Bu iş parçacıkları tarafından yazdırılan günlükler bir iz kimliği ile ilişkilendirilebilir.

  Diğer çerçeveler de benzer şekilde davranır. Sorunun bu senaryolardan hiçbiri nedeniyle kaynaklanmadığını belirlerseniz destek talebi oluşturun.

Trace Explorer'da günlükler neden boş?

Sorun giderme adımlarını izleyin:

1. Uygulamanın günlüklerinin hiçbirinin bir iz kimliği ile ilişkilendirilip ilişkilendirilmediğini kontrol edin. Durum böyleyse Günlük XML yapılandırmasını değiştirdikten sonra günlükler neden iz kimlikleriyle ilişkilendirilmiyor? bölümündeki sorun giderme adımlarına bakın. Durum böyle değilse sonraki adıma geçin.

2. Bir veya daha fazla belirli arabirim için bir iz kimliğine ait günlükleri bulamıyorsanız bu durum genellikle arabirimlerin herhangi bir günlük çıkarmadığı anlamına gelir.

3. Yukarıdaki senaryoların hiçbiri geçerli değilse destek talebi oluşturun.

Bağlamadan sonra Logstore neden boş?

SLS belgelerine göre Logstore için günlük toplamayı yapılandırmanız gerekir. ARMS günlükleri otomatik olarak Logstore'a toplamaz.

Ağ geçidi günlüklerinde iz kimliği ilişkilendirmesi neden başarısız olur?

v3.x aracısının Spring Cloud Gateway instrumentasyonunda bilinen bir hata vardır. v4.x aracısına yükseltmek bu sorunu çözer.

TraceCallable.wrap() kullanıldığında iz kimliği ilişkilendirmesi neden başarısız olur?

Bu durum yöntemin yanlış kullanıldığını gösterir. Eşzamansız senaryoları kod değişikliği gerektirmeden işleyen v4.x aracısına yükseltmenizi öneririz.

Otomatik ekleme sırasında iz kimliği ilişkilendirmesi neden başarısız olur?

Bu sorun genellikle iki durumda ortaya çıkar:

• Hiçbir günlük bir iz kimliği ile ilişkilendirilmemiş: Bu durum genellikle yapılandırmanın aracıya başarıyla uygulanmadığını gösterir. Java uygulama izleme için ağ yapılandırması belgesine başvurarak Application Configuration Management (ACM) sunucusuna bağlantıyı kontrol edin.

• Bazı günlükler bir iz kimliği ile ilişkilendirilmemiş: Günlük XML yapılandırmasını değiştirdikten sonra günlükler neden iz kimlikleriyle ilişkilendirilmiyor? bölümündeki sorun giderme adımlarına bakın.

ARMS, Simple Log Service (SLS) yerine kullanılabilir mi?

Hayır. Application Real-Time Monitoring Service (ARMS) ve Simple Log Service (SLS) farklı amaçlara hizmet eder ve birbirlerinin yerine geçmek yerine birbirlerini tamamlar.

• ARMS; iz analizi, API izleme ve uygulama performans analizi üzerine odaklanan bir Uygulama Performansı İzleme (APM) ürünüdür. ARMS'in Günlük analizi özelliği bağladığınız SLS projesi ve Logstore'dan günlükleri sorgular; bu nedenle SLS'i günlük depolama arka ucu olarak kullanır. ARMS sizin adınıza günlükleri Logstore'a toplamaz.

• SLS; günlük toplama, depolama ve analiz için genel amaçlı bir hizmettir ve birden çok veri kaynağından veri alımını destekler.

ARMS'in Günlük analizi özelliğini kullanmak için bu konudaki 1. Adım: İş günlüklerini ilişkilendirme bölümünde açıklandığı gibi bir SLS projesi ve Logstore bağlayın. Ardından üst gezinme çubuğunda Scenario-based Analysis > Log Analysis seçeneklerini belirleyerek günlükleri sorgulayın ve analiz edin.