Bir hatayı araştırırken önce doğru mesajı, sonra doğru çalışma denemesini seçin. En son run başarılı olsa bile önceki başarısız denemeler inceleme için kalabilir.
Hatanın olduğu run’ı açın
Önkoşul: Kaydı okuyabilmeniz ve saklama süresinin dolmamış olması gerekir. Gövde ve ek dosya görüntüleme ayrıca içerik erişim denetiminden geçer.
- Message Monitor içinde mesajı kimlikle veya filtreyle bulun.
- Ayrıntıdaki Processing failure veya Handled error bilgisini okuyun.
- Runs tablosunda hata anına karşılık gelen çalışmayı açın. Recording bağlantısı da run incelemesine gider.
- Recorded steps listesinden adımı seçin. Aynı adıma birden fazla ziyaret varsa her ziyaret ayrı kayıttır.
- Step events bölümünde Model step, Observed time, Elapsed (ms), Evidence, Local attempt ve Error alanlarını inceleyin.
- Text view içindeki Processing log ile çalışma özetini okuyun; gerekirse metni indirin.
Beklenen sonuç, kaydedilmiş hata ve onu çevreleyen adımlardır. Info ile normal başarılı çalışmada adım listesi bulunmaması olağandır. Yeni bir deneme için daha ayrıntılı bilgi gerekiyorsa Debug veya Trace açın.
Model: o sırada çalışan akış
Model, seçili run’ın başladığı sırada kaydedilen akış modelini gösterir. Daha sonra projeyi değiştirmeniz eski run’ın modelini değiştirmez. Görünüm salt okunurdur; yakınlaştırabilir ve kaydedilmiş adımla ilişkilendirebilirsiniz.
Model bulunamıyorsa güncel proje kodu tarihsel model yerine gösterilmez. Text view ve mevcut Step events ile devam edin. Model, Java sınıflarının bütün kaynak kodunu veya dış sistemin o andaki durumunu içermez.
Content ve Attachments
| Bölüm | Ne içerir? |
|---|---|
| Content | Trace sırasında tutulabilen adım öncesi gövde ile desteklenen HTTP/SOAP protokol gözlemleri. |
| Attachments | Akış yazarının bilerek eklediği adlandırılmış teşhis dosyaları. |
| Text view | Kimlikler, durum, hata, adımlar ve kapsamın metinsel özeti; gövde dosyalarının yerine geçmez. |
Content veya Attachments içinde kaydı seçip Inspect kullanın. İçerik mevcutsa indirebilirsiniz. İnceleme ve indirme denetlenir; erişim veya denetim kaydı başarısızsa içerik açılmaz.
| İçerik durumu | Yorum |
|---|---|
| Stored | İçerik saklandı. |
| Empty | Geçerli ama boş içerik saklandı. |
| Truncated | Yalnız sınır içindeki başlangıç bölümü saklandı. İndirdiğiniz dosya tam mesaj değildir. |
| Pending | Metadata var; içerik yazımı henüz doğrulanmadı. |
| Failed | İçeriğin saklanması başarısız oldu. İşlemin sonucu ayrıca değerlendirilir. |
| Omitted / Unsupported | İçerik politika, sınır veya desteklenmeyen gövde türü nedeniyle alınmadı. |
| Expired | İçeriğin saklama süresi doldu. Sayfayı yenilemek onu geri getirmez. |
Otomatik bir içerik kaydı en fazla 64 KiB, adlandırılmış bir ek en fazla 1 MiB ve bir run’ın toplam içeriği en fazla 10 MiB olabilir. Bir run’a en fazla 100 adlandırılmış ek eklenir. Stream türündeki gövdeler teşhis için kendiliğinden tüketilmez.
Adlandırılmış teşhis eki ekleyin
Gövdeden bağımsız bir doğrulama özeti saklamak için akışa şu adımı ekleyin:
- bean:
ref: lunexMonitor
method: "appendAttachment('validation.txt','text/plain','Order validation accepted')"Bu çağrı iş gövdesini değiştirmez. Info, Debug veya Trace ile yeni bir mesaj işleyin; ilgili run’ın Attachments bölümünde validation.txt görünmelidir. Aynı isimle iki ek yazarsanız iki ayrı içerik kaydı oluşur.
Gövdeyi bilerek saklayacaksanız veri kapsamını önce daraltın. Bu ekler yazarın sağladığı içeriktir; otomatik bir gizli bilgi temizleme garantisi yoktur.
HTTP veya SOAP çağrısını araştırma
Trace, desteklenen çağrılarda istek/yanıt/fault aşaması, çağrı kimliği, yön, bileşen ve gözlemlenen adım ilişkisini tutar. Bir HTTP yönlendirmesi veya yeniden deneme aynı run içinde birden fazla çağrı kaydı oluşturabilir. İstek gözlemi tek başına alıcının işi tamamladığını göstermez; bağlantı kurulamadıysa yanıt kaydı hiç bulunmayabilir.
HTTP yanıtı Unsupported ise çoğunlukla o noktadaki gövde tekrar okunabilir bir metin değildir. İşleminizin gövde ve bellek gereksinimleri uygunsa HTTP adımının hemen sonrasında açıkça metne dönüştürüp ek yazabilirsiniz:
- convertBodyTo:
type: java.lang.String
- bean:
ref: lunexMonitor
method: "appendAttachment('response.xml','application/xml',${body})"Sonraki gerçek çalışmada ekten okursunuz. Bu kayıt, dönüşümden sonraki uygulama gövdesidir; daha önce saklanmamış ağ yanıtını geri getirmez. Trace açıksa dönüşümü izleyen adımın Before step içeriği de bu noktayı gösterebilir.
SOAP gözlemi desteklenen CXF POJO akışına bağlıdır. Özel binding, mevcut farklı logging feature, MTOM veya başka veri biçiminde içerik Unsupported olabilir. İşlem sonucunu ve mevcut hata kaydını kullanın; her SOAP zarfı veya binary ek kaydedilir varsaymayın.
İlişkili işlemler ve yeniden deneme
Related processing, kaydedilmiş alt işlem ve çağrı ilişkilerini gösterir. Çağıran ve çağrılan akışın sonuçları farklı olabilir: çağrılan akış Failed, hatayı işleyen çağıran Completed olabilir. Süresi dolan veya kaydedilmeyen hedefler için görünür kayıt bulunmayabilir.
LocalRedelivery, aynı run içindeki yerel yeniden denemeyi işaretler. Motorun bildirmediği adım kimliği tahmin edilmez. Broker’ın mesajı yeniden teslim etmesi ise yeni run oluşturabilir. Artemis/JMS provider kimliği doğrulanabildiğinde eski başarısız run’lar aynı mesaj altında toplanabilir; mesaj gövdesini yeni bir mesaj olarak tekrar yayınlamak aynı ilişkiyi garanti etmez.
Message Monitor inceleme ekranıdır; saklanan gövdeyi yeniden çalıştıran genel bir Replay işlemi yoktur. Hata giderildikten sonra giriş sisteminden yeni istek gönderin veya dead letter’ı ajanınızla yeniden deneyin. Önceki denemenin hedef sistemde iş etkisi oluşturup oluşturmadığını iş kimliğiyle kontrol edin.
Log, sağlık ve sayaçlarla tamamlayın
Projenin Log sekmesinde doğru container’ı seçin. Arama için en az dört karakter girin; Enter veya Next match ile ilerleyin. Autoscroll, Wrap text ve Jump to bottom uzun çıktıda gezinmeyi kolaylaştırır. Clear log ekrandaki tamponu temizler; Message Monitor geçmişini silmez.
Deployment ve Log rehberi, imaj/sürüm kontrolünü, pod olaylarını ve console loguyla Message Monitor kaydının farkını ayrıntılı açıklar.
Architecture → Statistics, route’un anlık Total, Inflight ve Failed sayaçlarını gösterir. Container veya route ayakta olsa da iş mesajı başarısız olabilir. Tersine izleme veritabanı erişilemezken entegrasyon işlemeye devam edebilir. Runtime kayıt sağlığı yönetici tarafından /ui/monitoring/v1/health?environment=… üzerinden okunabilir; ayrı bir sağlık paneli yoktur.
Dağıtık izleme yapılandırılmışsa OpenTelemetry izleri ayrıca işletilir. Message Monitor’deki Trace kayıt seviyesi, tek başına harici bir izleme sunucusu kurmaz veya ona veri göndermeyi yapılandırmaz.