Günlük
Günlük modülü, Platform OneEntry'de yöneticilerin sistemdeki diğer yöneticilerin eylemlerini ve kamuya açık İçerik API'sinin etkinliğini takip etmelerini sağlar. Modül dört sekmeden oluşmaktadır:
| Sekme | Ne gösterir |
|---|---|
| Yönetici Eylem Günlüğü | Sistem içindeki yöneticilerin tüm eylemleri: varlık oluşturma, değiştirme, silme. |
| Yönetici Trafiği | Yöneticilerin giriş oturumları: ne zaman giriş yaptı, ne zaman çıktı, hangi cihazdan. |
| İçerik API İstatistikleri | Farklı dönemler için sitenin tüm kamuya açık uç noktalarının çağrı sayıları. |
| İçerik API Hataları | Kamuya açık API'den gelen tüm 4xx/5xx yanıtları, istek detayları ve yığın izleri ile birlikte. |
Modül arayüzünde sekmeler şu şekilde adlandırılmıştır: Yönetici Günlüğü, Yönetici Uygulamasına Erişim Günlüğü, İçerik API İstatistikleri, İçerik API Hataları.
İçerik API istatistikleri ve hataları için ayrı izinler gereklidir — bkz. Günlük için İzinler.
Yönetici Eylem Günlüğü
Sistem içindeki tüm yöneticilerin eylemlerini gösteren ana sekme.
Arayüz Öğeleri
Sekme iki bloktan oluşmaktadır:
- Filtreler
- Eylem Listesi
Filtreler
Eylemleri filtrelemek için aşağıdaki alanlar mevcuttur:
- From — Eylemlerin filtrelenmeye başlanacağı tarih için metin giriş alanı.
- To — Eylemlerin filtrelenmeye son verileceği tarih için metin giriş alanı.
Tarihleri, bölgenizin tarih formatında bir dize olarak girebilir veya tarih giriş alanına tıkladığınızda açılan takvimden gerekli tarihi seçebilirsiniz.
- Yönetici ID — Benzersiz yönetici kimliği için sayısal giriş alanı.
- Kullanıcı eylemleri — Kullanıcı eylemleri için açılır liste:
- Oluşturma
- Değiştirme
- Silme
- Durum — Eylem durumları için açılır liste:
- Başarılı
- Hata
- Modül adı — Modül adları için açılır liste:
- Yöneticiler
- Özellik setleri
- Yedekleme
- Blokları yönetme
- Olay yönetimi
- Genel ayarlar
- Dosya yükleme
- Dosya düzenleyici
- Formları yönetme
- Yerelleştirme
- İşaretçiler
- Menü
- Modüller
- İçerik yönetimi
- Ürünler
- Sipariş yönetimi
- Temel ayarlar
- Ödeme yönetimi
- Ürün durumu yönetimi
- KULLANICI
- Kimlik doğrulama sağlayıcıları ve kullanıcıları yönetimi
- Şablon yönetimi
- Önizleme şablonu yönetimi
- Kayıt ID — Benzersiz kayıt kimliği için sayısal giriş alanı.
Filtreler bloğunun altında iki buton bulunmaktadır:
- Verileri Sil — From / To alanları ile belirlenen dönem için yönetici eylem kayıtlar ını siler (bkz. Günlükleri Manuel Olarak Temizleme).
- Sıfırla — Uygulanan filtreleri sıfırlar.
Eylem Listesi
Eylem listesi altı sütundan oluşan bir tablo şeklinde sunulmaktadır:
- Kullanıcı eylemleri
- Durum
- Kullanıcı girişi
- Modül adı
- Kayıt ID
- Tarih ve saat
Her sütun için verileri sütun başlığına tıklayarak sıralama imkanı vardır. İlk tıklama azalan sıralama yapar, ikinci tıklama artan sıralama yapar, üçüncü tıklama sıralamayı sıfırlar.
Blok Görünürlüğü Denetimi
Her blok görünürlüğü geçişi (blok yönetiminde "göster/gizle" anahtarı) otomatik olarak Yönetici Eylem Günlüğü'ne kaydedilir. Hangi yöneticinin ve ne zaman belirli bir bloğun durumunu değiştirdiği görünür.
Eylem listesinde bu kayıt Blokları Yönetme modülüne aittir.
Yönetici Trafiği (Admin Access Log)
Yönetici Trafiği sekmesi, yöneticinin sisteme her giriş ve çıkışını ayrı bir kayıt olarak gösterir. Bu, kimin ve ne zaman yönetici paneline girdiğini görmek için kullanışlıdır — bu, denetim için faydalıdır.
Tablo Alanları
Tablo altı sütundan oluşmaktadır:
| Sütun | Ne anlama geliyor |
|---|---|
| Giriş | Yöneticinin kullanıcı adı |
| IP | Yöneticinin giriş yaptığı IP adresi |
| Giriş Zamanı | Giriş tarihi ve saati |
| Çıkış Zamanı | Çıkış tarihi ve saati (henüz açık oturum için Aktif) |
| Süre | Oturum süresi (aktif için — girişten mevcut zamana kadar) |
| Sebep | Oturum kapatma nedeni: Çıkış (kendi isteğiyle "Çıkış" yaptı) veya Yönetici İptal Edildi (başka bir yönetici oturumu zorla sonlandırdı); açık oturum için — Aktif |
Yönetici Eylem Günlüğü gibi, herhangi bir sütun başlığına tıklayarak sıralama yapılabilir.
Yetki süresinin dolması ve otomatik uzatılması ayrı bir kayıt olarak yazılmaz. Süresi dolmuş bir oturum, kullanılmadığı zaman kapalı olarak işaretlenir.
Filtreler
- From / to — dönem (takvim ile tarih giriş alanları).
- Yönetici ID — belirli bir yönetici için filtreleme için sayısal alan.
- Oturum Durumu — oturum durumu için açılır liste: Tümü / Aktif / Kapalı.
"Verileri Sil" Butonu
From / To alanları ile belirlenen dönem için oturum kayıtlarını siler. Tıklanıldığında bir onay diyalogu açılır:
Eylemi Onayla — Belirtilen dönem için tüm kapalı oturumları silmek istiyor musunuz? Bu işlem geri alınamaz. Aktif oturumlar kalacaktır.
Sadece kapalı oturumlar silinir. Aktif oturumlar (açık yetki ile) silinmez.
İçerik API İstatistikleri
İçerik API İstatistikleri sekmesi, sitenin tüm kamuya açık uç noktalarının çağrı sayıcılarını farklı dönemler için gösterir — 1 saat, 24 saat, 7 gün.
Ne gösterir
- Tüm kamuya açık uç noktaların listesi (
GET /api/content/...) — otomatik olarak oluşturulur, manuel olarak doldurulmasına gerek yoktur. - Her uç noktanın yanındaki sayaç — seçilen dönem içinde kaç kez çağrıldığı.
Arayüz Öğeleri
- Dönem — dönem için açılır liste: Son Saat / Son 24 Saat / Son 7 Gün (varsayılan — Son 24 Saat).
- Yenile — verileri zorla güncelleme butonu.
Veriler dört sütundan oluşan bir tablo ile sunulmaktadır:
| Sütun | Ne anlama geliyor |
|---|---|
| Yol | uç noktanın yolu (/api/content/...) |
| Yöntem | HTTP yöntemi (GET, POST, …) |
| Açıklama | uç noktanın kısa açıklaması |
| İstekler | seçilen dönem için çağrı sayısı |
Sayfanın üst kısmında Otomatik temizleme geçerli değil bilgilendirme banner'ı gösterilir: istatistik gerçek zamanlı olarak okunur ve projede saklanmaz, bu nedenle temizlenmesine gerek yoktur ve admin panelindeki veri saklama süresi ayarlanamaz.
Eğer istatistik verileri geçici olarak kullanılamıyorsa, tablonun üzerinde "Metrik geçici olarak kullanılamıyor. Tüm uç noktalar sıfır sayısı ile gösterilmektedir." uyarısı çıkar. Uyarı metnine rağmen, bu durumda tablo boş olabilir — "Veri mevcut değil" mesajı ile.
İstatistikler sınırlı bir süre saklanır ve admin panelindeki saklama süresi ayarlanamaz. Daha uzun bir dönem için analiz yapmak için verileri kendiniz saklayın. Sayfanın üst kısmındaki bilgilendirme banner'ı bu konuda uyarır.
Neden Gerekli
İstatistikler, hangi İçerik API uç noktalarının kullanıldığını ve hangilerinin çağrılmadığını gösterir. Bir uç noktanın çağrı sayısında ani bir düşüş, genellikle istemci uygulamasında bir sorun olduğunu gösterir.
Veriler, dakikada bir kez güncellenir: 60 saniye içinde Yenile butonuna tekrar basmak aynı değerleri gösterecektir.
İçerik API Hataları
İçerik API Hataları sekmesi, belirli bir dönem içinde kamuya açık API'nin verdiği tüm 4xx/5xx yanıtlarını gösterir. İçerik API'si ile istemci uygulamasını entegre eden geliştiriciler, isteklerindeki hataları doğrudan admin panelinde görebilirler.
Ne gösterir
Her kayıt, ayrı bir HTTP hatasıdır. Tablo beş sütundan oluşmaktadır:
| Sütun | Ne anlama geliyor |
|---|---|
| Zaman | hata zaman damgası |
| Durum | HTTP durumu (4xx / 5xx) |
| Yöntem | istek yöntemi (GET, POST, …) |
| Yol | yol (/api/content/...) |
| Mesaj | hata metni |
Seçilen dönem içinde hata yoksa, tablonun yerine "Seçilen dönem için hata kaydı yok" mesajı gösterilir.
Tablodaki bir satıra tıklamak, hatanın detaylarını gösteren bir pencere açar:
- zaman, HTTP durumu, istek yöntemi ve yolu;
- hata kodu ve metni;
- yığın izleri — genişletilmiş (8 KB'ye kadar);
- isteğin kimliği ve gelen istekle birlikte gelen app-token'ın seri numarası;
- istemcinin IP adresi ve User-Agent'ı;
- Sorgu — istek dizesinin parametreleri;
- isteğin gövdesinin önizlemesi (gizli bilgiler olmadan — şifreler, tokenlar, yetkilendirme başlıkları maskelemektedir).
Filtreler
- From / to — dönem (takvim ile tarih giriş alanları).
- HTTP Durumu — durumlar için açılır liste. Gruplardan seçilebilir (4xx - İstemci tarafı, 5xx - Sunucu tarafı) veya belirli bir kod seçilebilir: 400, 401, 403, 404, 422, 500, 502, 503.
- Yol — yol için filtreleme metni (örneğin,
/api/content/blocks/*).
"Verileri Sil" Butonu
From / To alanları ile belirlenen dönem için hata kayıtlarını siler. Eğer dönem belirtilmemişse — tüm hataları siler.
Güvenlik — Hassas Verilerin Gizlenmesi
Hata kayıtlarındaki hassas veriler otomatik olarak gizlenir. password, token, authorization, api_key, x-app-token, cookie, set-cookie (büyük/küçük harf duyarsız) alanları *** ile değiştirilir. Büyük istek gövdeleri 2 KB'ye kadar kesilir.
Günlükleri Manuel Olarak Temizleme
Günlük kayıtları manuel olarak temizlenir — kayıtları saklayan her sekmede "Verileri Sil" butonu bulunmaktadır:
| Sekme | Ne siler |
|---|---|
| Yönetici Eylem Günlüğü | Seçilen dönem için yönetici eylem kayıtları |
| Yönetici Trafiği | sadece kapalı oturumlar için seçilen dönem |
| İçerik API Hataları | Seçilen dönem için hata kayıtları |
Silme dönemi, sekmenin filtrelerindeki From / To alanları ile belirlenir. Eğer dönem belirtilmemişse — ilgili türdeki tüm kayıtlar silinir. Silme işleminden önce her zaman "Eylemi Onayla" diyalogu gösterilir, işlem geri alınamaz.
"Yönetici Trafiği" sekmesindeki "Verileri Sil" butonu yöneticilerin aktif oturumlarını silmez — mevcut anı kapsayan bir dönem belirleseniz bile, çalışan bir meslektaşın açık oturumu silinmeyecektir. Sadece kapalı oturumlar silinir.
İstatistik verileri gerçek zamanlı olarak okunur ve projede saklanmaz, bu nedenle bu sekmede "Verileri Sil" butonu yoktur — bu, "Otomatik temizleme geçerli değil" banner'ı ile bildirilir.
Günlük için İzinler
İçerik API İstatistikleri ve İçerik API Hataları sekmeleri, izinler ağacında (yeni sekmede açılır) ayrı izinler gerektirir. İzin olmadan sekme gösterilmez.
| Sekme | İzin |
|---|---|
| İçerik API İstatistikleri | journal.viewContentApiStats |
| İçerik API Hataları | journal.viewContentApiErrors |
Yönetici Eylem Günlüğü ve Yönetici Trafiği sekmeleri, günlük modülüne erişimi olan tüm yöneticilere görünür.