Loglar

Platform ve uygulama loglarını tarih, saat ve anahtarla arama; istek, yanıt ve hata ayrıntılarını maskeli gövdeyle inceleme.

Loglar ekranı, uygulamaların ve kanal entegrasyonlarının bıraktığı kayıtları aramanızı ve tek tek incelemenizi sağlar. "Bu siparişe ne oldu?", "Entegrasyon bu isteğe ne yanıt verdi?" gibi soruların cevabı çoğunlukla buradadır. Ekranda birbirinden ayrı iki log kaynağı vardır: Platform logları (uygulama ve entegrasyon istek/yanıt kayıtları) ve Uygulama logları (çalışma alanınızdaki uygulamaların yazdığı işlem kayıtları). İki kaynak aynı veriyi taşımaz; aradığınızı birinde bulamazsanız diğerine bakın. Ekranı çoğunlukla entegrasyon sorunlarını araştıran destek ve operasyon ekipleri kullanır.

Ekrana ulaşma

• Menüden ComHub – Pazaryeri Entegrasyonu › İzleme › Loglar yolunu izleyin. Ekran Platform logları görünümüyle açılır.
• ComHub Genel bakış sayfasındaki İzleme kartında Loglar kutusuna tıklayarak da Platform logları görünümüne gelebilirsiniz.
• OMS Kuyruk ekranında bir kaydın Logları göster bağlantısı, Uygulama logları görünümünü o kaydın anahtarıyla süzülmüş olarak yeni sekmede açar.

Menüde görmüyorsanız hesabınızın bu ekrana yetkisi yoktur.

Ekranın bölümleri

• Başlık: seçili görünüme göre Platform logları ya da Uygulama logları.
• Görünüm sekmeleri: Platform logları ve Uygulama logları.
• Filtre alanı: tarih, saat ve görünüme özgü alanlar; altında Temizle, Detaylı filtrele ve Filtrele düğmeleri.
• Liste: üstünde Her sayfada seçimi, Filtreleme sonucu: [sayı] kayıt metni, yenileme düğmesi ve Sütunlar menüsü.
• Not: listenin altında, varsayılan tarih aralığını ve en geniş aralığı hatırlatan kısa açıklama.

Görünüm değiştirme

Sekmeye tıkladığınızda görünüm hemen değişir. Görünüm değişince tüm filtreler, tarih aralığı ve sayfa sıfırlanır; çünkü iki kaynağın tarih yorumu ve varsayılan aralığı farklıdır. Filtrelerinizi yeni görünümde yeniden girin.

Filtreleme ve arama

Filtreler siz Filtrele düğmesine (ya da bir alanda Enter tuşuna) basana kadar uygulanmaz; uygulanmamış değişiklik varsa Filtrele düğmesi vurgulanır. Filtreleri değiştirmeden Filtrele'ye basmak listeyi güncel veriyle yeniden getirir. Temizle bütün filtreleri sıfırlar ve listeyi hemen yeniden getirir. Detaylı filtrele menüsünden ek filtre alanlarını açıp kapatabilirsiniz; seçiminiz tarayıcınızda hatırlanır. Bir alanı kapattığınızda o alana yazdığınız değer de silinir.

Tarih ve saat (iki görünümde ortak)

Saati 9:5 gibi eksik ya da okunamayan biçimde yazarsanız filtre alanının üstünde Saat okunamadı: "[değer]". SS:dd biçiminde yazın (ör. 09:30). uyarısı çıkar ve liste boş gelir. Saati düzeltip yeniden Filtrele'ye basın.

İpucu: Platform logları'nda gün ve saat, ekranda kullandığınız saat dilimine göre yorumlanır. Uygulama logları'nda ise saatler kaydı yazan sunucunun saatidir ve çevrilmez; aradığınız kaydın saatini bu farkı göz önünde tutarak girin.

Platform logları filtreleri

Uygulama logları filtreleri

Liste

Platform logları kolonları

Uygulama logları kolonları

Her iki görünümde:

• Sayfa boyutu 25, 50 ya da 100 olabilir; varsayılan 25.
• Sütunlar menüsünden kolonları gizleyip gösterebilirsiniz; seçiminiz tarayıcınızda saklanır.
• Kolon başlıklarına tıklayarak sıralama yapılmaz.
• Bir satıra tıklamak ya da satır sonundaki üç nokta menüsünden Detaya git seçmek kaydın detay sayfasını açar.

Log detay sayfası

Detay sayfası kaydın tüm alanlarını ve içeriğini gösterir. Loglara dön düğmesi tarayıcıda bir önceki sayfaya döner; listeden geldiyseniz liste bıraktığınız filtrelerle açılır. Başlıkta kaydın yolu ya da log adı, altında uygulama ve çağıran yazar; sağ üstte kaydın tip rozeti bulunur (platform logunda kayıt hata taşıyorsa kırmızı, değilse gri). Kayıt bir hata taşıyorsa Kayıt sekmesinin en üstünde hata mesajı (ya da Bu kayıt bir hata taşıyor.) uyarı olarak görünür.

Platform logu sekmeleri

• Kayıt: kaydın alanları iki kartta. Birinci kart: Kayıt no, Uç / yol, Çağıran, Uygulama, Tip, Log adı, Sorgu dizesi, Açıklama. İkinci kart: Zaman, İstek zamanı, Yanıt zamanı, Süre, İstek kimliği, Oturum anahtarı, Kullanıcı, IP adresi, Makine, Sunucu, Çalışma alanı. Boş alanlar — olarak görünür. Destek talebinde kaydı tarif etmek için Kayıt no'yu paylaşın.
• İstek: isteğin gövdesi. Sekme her zaman görünür; gövde kaydedilmemişse boş durum metni çıkar.
• Yanıt: yanıtın gövdesi (aynı şekilde).
• Log içeriği: kayıtta istek ve yanıttan ayrı bir içerik varsa görünür.
• Hata: kayıt hata taşıyorsa görünür; Hata mesajı, Hata kaynağı ve varsa hatanın ayrıntılı dökümü.

Uygulama logu sekmeleri

• Kayıt: birinci kartta Kayıt no, Anahtar, Zaman (sunucu saatiyle, çevrilmeden), Uygulama, Çağıran, Log adı; ikinci kartta Tip, Seviye (sayısal değer), Makine, İlişki kimliği, Açıklama.
• Gövde: kaydın içeriği.
• Hata: kayıt hata taşıyorsa görünür; Hata mesajı, Hata kaynağı ve hatanın ayrıntılı dökümü.

Kaydın anahtarı ve tarihi varsa sağ üstte Bu anahtarın o günkü logları düğmesi görünür. Düğme, Uygulama logları listesini aynı anahtar ve aynı gün için süzülmüş olarak açar. Bir siparişin ya da müşterinin o gün içindeki bütün akışını izlemek için kullanın.

Gövde görüntüleme

İstek, Yanıt, Log içeriği ve Gövde sekmeleri aynı görüntüleyiciyi kullanır:

• İçerik JSON biçimindeyse üç görünüm vardır: Ağaç (açılıp kapanabilen yapı; Tümünü aç ve Tümünü kapat düğmeleriyle), Biçimli (girintili metin) ve Ham (kaydedildiği hâliyle). İç içe kaydedilmiş JSON metinleri de çözülerek gösterilir; gerçek metni görmek için Ham'ı seçin.
• İçerik JSON değilse yalnızca ham metin gösterilir. JSON'a benzeyen ama çözülemeyen içerikte İçerik JSON olarak çözülemedi; kaynağında kesilmiş olabilir. uyarısı çıkar.
• Büyüt / Küçült görüntüleme alanının yüksekliğini değiştirir.
• Görüntüleyicinin kendi Kopyala düğmesi o anki görünümdeki metni panoya kopyalar ve kısa süre Kopyalandı yazar. Kartın üstündeki Kopyala düğmesi ise gövdenin tamamını kaydedildiği (ham) hâliyle kopyalar ve Gövde panoya kopyalandı (maskeli hâli). bildirimi çıkarır. Tarayıcı izin vermezse Panoya kopyalanamadı; tarayıcı izin vermedi. bildirimi çıkar.

Güvenlik için gövdedeki hassas alanların (token, şifre, çerez gibi) değerleri gizlenerek gösterilir. Gizlenen alan varsa gövdenin üstünde Gövdede [sayı] alanın değeri gizlendi (token, şifre, çerez gibi). uyarısı çıkar; kopyaladığınız metin de gizlenmiş hâlidir. Gövde çok uzunsa Gövde çok uzun olduğu için kırpıldı; tamamı için log deposuna bakın. uyarısı çıkar. Kayıtta içerik yoksa Bu kayıtta gövde yok yazar; yalnızca istek/yanıt taşıyan log adları gövde kaydeder.

İşlemler

Bir siparişin loglarını bulma

1. Uygulama logları sekmesine geçin.
2. Anahtar alanına sipariş numarasını yazın.
3. Sipariş eskiyse Tarih aralığı'nı genişletin (en fazla 31 gün).
4. Filtrele'ye basın ve listeden kaydı açın.
5. Aynı günün diğer kayıtları için detayda Bu anahtarın o günkü logları düğmesini kullanın.

Belirli bir zaman aralığındaki hataları bulma

1. İlgili sekmede Tarih aralığı'nı seçin, gerekiyorsa Başlangıç saati ve Bitiş saati girin.
2. Uygulama logları'nda Tip alanından Error seçin; Platform logları'nda listede kırmızı Tip rozetlerine bakın.
3. Filtrele'ye basın, kaydı açıp Hata sekmesini inceleyin.

Sık karşılaşılan durumlar

• Liste boş geliyor. Tarih alanları boşken Platform logları yalnızca son 24 saati, Uygulama logları son 10 günü kapsar. Aradığınız kayıt daha eskiyse aralığı genişletin. Diğer sekmedeki kaynakta da arayın; iki kaynak aynı kayıtları taşımaz.
• "Saat okunamadı" uyarısı çıkıyor ve liste boş. Saati SS:dd biçiminde, iki haneli dakikayla yazın (ör. 09:05).
• Sekme değiştirince filtrelerim kayboldu. Bu beklenen davranıştır; görünüm değişince filtreler sıfırlanır.
• Liste "Bir şeyler ters gitti" hatası veriyor. Tarih aralığının 31 günü aşmadığından emin olun. Sorun sürerse Tekrar dene'ye basın; Teknik ayrıntı bölümündeki metni sistem yöneticinize iletin.
• Detayda "Log servisi yapılandırılmadı" ya da "Uygulama logları yapılandırılmadı" yazıyor. Bu bir arıza değil, çalışma alanınız için ilgili log kaynağının kurulumu yapılmamış demektir. Sistem yöneticinize başvurun.
• Gövdede bazı değerler görünmüyor. Hassas alanlar güvenlik için gizlenir; bu değerleri ekrandan görmek mümkün değildir.

İlgili ekranlar

• Log mesajları
• API istek logları (S3)
• Kuyruk
• Control Tower
• Liste ekranlarını kullanma