Arama alanları ekleme ve mesaj arama

Bir sipariş numarası, bayi kodu veya dış sistem referansını Business field olarak kaydederek mesajları gövde okumadan bulabilirsiniz. Alanı akışta üretirsiniz; ayrıca bir arama şeması veya veritabanı sütunu oluşturmanız gerekmez.

Akışa bir iş alanı ekleyin

Önkoşul: Proje düzenleme yetkisi, kaydedilecek değerin akışta hazır olması ve Info, Debug veya Trace kayıt seviyesi. Error seviyesi özel iş alanlarını saklamaz.

Source içinden akış dosyasını açın.
Değeri elde ettiğiniz noktaya Bean adımı ekleyin.
Bean referansını lunexMonitor, method değerini appendBusinessValue('Order','ORD-2026-0042') yapın.
Akışı kaydedin ve gerçek bir örnek mesaj çalıştırın.
Message Monitor → Open filters → More filters içinde Business field değerini Order, Business value değerini ORD-2026-0042 yapın. Zaman aralığı ve projeyi seçip Apply kullanın.

Code görünümünde kullanılacak adım:

- bean:
    ref: lunexMonitor
    method: "appendBusinessValue('Order','ORD-2026-0042')"

Header’dan almak için Camel Simple ifadesini method argümanında kullanabilirsiniz:

- bean:
    ref: lunexMonitor
    method: "appendBusinessValue('Order',${header.OrderId})"

Header’ı önce doğrulayın. Alan ekleme çağrısı mesaj gövdesini veya taşıma header’larını değiştirmez. Aynı isimle birden fazla çağrı yapabilirsiniz; tekrarlanan değerler de korunur. Örneğin bir toplu mesaj içindeki her sipariş için Order alanı eklenebilir.

Beklenen sonuç, filtredeki ad/değer çiftiyle eşleşen mesajdır. Mesajı açtığınızda Business fields altında Name ve Value satırları görünür.

Dış sisteme gitmeden tam örnek

Boş bir deneme projesindeki monitor-demo.camel.yaml dosyasına aşağıdaki akışı kaydedip Run kullanabilirsiniz. Her runtime başlangıcında bir örnek çalışma üretir:

- route:
    id: monitor-demo
    description: Order monitoring example
    from:
      uri: timer:monitor-demo
      parameters:
        repeatCount: 1
      steps:
        - setBody:
            constant: '{"orderId":"ORD-2026-0042","region":"TR"}'
        - setProperty:
            name: lunex.monitor.applicationId
            constant: ORD-2026-0042
        - bean:
            ref: lunexMonitor
            method: "appendBusinessValue('Order','ORD-2026-0042')"
        - bean:
            ref: lunexMonitor
            method: "appendBusinessValue('Region','TR')"

Log level = Info iken tamamlanan mesajı hem Application ID aramasıyla hem Order iş alanıyla bulabilmelisiniz. Bu işlemi Simulate ile yapmak, gerçek Message Monitor kaydı ürettiğini doğrulamak yerine örnek akış mantığını denemek içindir.

Filtre ve kimlik aramasını seçin

Arama biçimi	Kullanım
Search by identifier	Türü Message ID, Correlation ID veya Application ID seçin; tam değeri girip Enter basın. Normal filtre ve zaman aralığı bu aramanın koşulu değildir.
Open filters	Başlangıç aralığı, proje, rota ve durumu birlikte uygulayın. Kayıt seviyesi, iş alanı/değer çifti ve ek metadata alanlarını More filters altında açın.
Ayrıntıdaki Search fields	Açık mesajın zaten yüklenmiş Business fields tablosunu daraltır; bütün mesajlarda yeni arama yapmaz.

Filtre penceresindeki değişiklikler Apply ile birlikte uygulanır. Cancel veya pencere dışına tıklama uygulanmamış değişiklikleri bırakır. Uygulanmış etiketleri kaldırabilir ya da Clear filters ile temizleyebilirsiniz.

Zaman, durum ve kapsam

Started mesajın saklanan en erken çalışma başlangıcını filtreler. Last update start date / Last update end date, daha sonra yeni deneme veya gözlem gelmiş mesajları bulmanıza yardımcı olur. Özel tarih aralığı tarayıcınızın yerel saat diliminde bütün günleri kapsar.

Hazır bir aralık seçtiğinizde sorgunun saati sabitlenir; sayfa değiştirirken kaymaz. Refresh hazır aralığı bugüne ilerletir; özel aralığın tarihlerini korur.

Status, mesajın son saklanan run’ının sonucunu esas alır. Bir iş alanının eski başarısız run’da eşleşmesi, sonradan başarılı olan mesajı Failed yapmaz. Level, mesajın saklanan run’larından herhangi birinin kayıt seviyesiyle eşleşebilir.

Projects sabit proje kodlarını gösterir; proje adıyla da arayabilirsiniz. Route rota adını ve proje kodunu gösterir, seçim proje ve rota koduyla eşleşir. Seçenekler seçtiğiniz tarih aralığındaki kayıtlardan gelir; aynı kimliğin adı değiştiyse en son kaydedilmiş ad kullanılır.

More filters içindeki Recorded project, yalnız proje kodundan farklı kaydedilmiş proje metadata’sı varsa görünür. Bu alan veya Project type değişirse uyumsuz proje seçimleri temizlenir. Sender, Receiver, Application type ve Custom status seçenekleri ancak kaydedilmiş değerler olduğunda görünür. Bu değerleri kimlik metadata’sı olarak açıkça atayın.

İzleme kapsamının ortamı kurulum ayarından gelir; filtrede ayrı bir Environment seçimi yoktur.

Eşleşme ve sınırlar

İş alanı adı ve değeri tam ve büyük/küçük harfe duyarlı eşleşir. Order ile order farklıdır.
*, tırnaklar veya benzeri karakterler sorgu dili değildir; doğrudan değerin parçasıdır.
Aynı anda bir Business field / Business value çifti uygulanır. Boş değer aramak için alan adını yazıp değeri boş bırakın.
Bir çalışma içinde en fazla 100 farklı alan adı ve toplam 1.000 değer tutulur. Alan adı 128, değer 1.024 UTF-8 byte sınırındadır.
Sınırı aşan veya geçersiz metin kayda alınmaz; kesilmiş başka bir değer aratılmaz. Business values omitted uyarısı kaydedilmeyen değerleri bildirir.
İş alanı çağrısından sonra run’ın terminal gözlemi gelmelidir. Çağrıdan önce hata oluştuysa alan yoktur; geçmiş veriye sonradan alan eklenmez.

Aranabilir alanlara parola, erişim token’ı veya gereksiz kişisel veri koymayın. Bunlar normal izleme metadata’sıdır; gövde içeriklerinden farklı bir erişim yolu vardır.

Yavaş veya eksik sonuçlar

Results unavailable görünürse tarih aralığını ve Projects kapsamını daraltıp Retry kullanın. Çok geniş toplam ve rapor sorguları, ilk sonuç sayfası kullanılabilirken ayrı zaman aşımına uğrayabilir. Count cancelled veya Counts unavailable sıfır mesaj demek değildir.

Kaydı açıp Business fields satırında tam yazımı kontrol edin. Ardından kayıt seviyesi, atama sırası, saklama süresi ve ortamı kontrol edin. Sonuçları dosyaya almak için raporu kullanın.