Denetim Logları kullanıcı eylemlerini takip ederken, Sistem Logları arka uç API'si, edge gateway'ler, aktörler ve entegrasyon noktalarından gelen platform olaylarını toplar.
Loglara Erişim
Administration > System Logs (Yönetim > Sistem Logları) menüsüne gidin.
Log Yapısı
Log görüntüleyici, aşağıdaki sütunlara sahip filtrelenebilir bir ızgara sağlar:
- Time (Zaman): Olayın hassas UTC zaman damgası.
- Source (Kaynak): Kaynak alt sistem (örneğin,
Platform,DeviceActor,MQTTBroker). - Level (Seviye): Log girişinin ciddiyeti.
- Message (Mesaj): Hatalar için yığın izlerini içeren detaylı log içeriği.
Log Seviyeleri
Proxus, olayları kategorize etmek için standart loglama seviyeleri kullanır:
| Seviye | Açıklama |
|---|---|
| Critical | Sistemin kapanmasına veya büyük arızaya neden olan ölümcül hatalar. |
| Error | Dikkat gerektiren ancak sistemi durdurmayan çalışma zamanı hataları. |
| Warning | Potansiyel sorunlar veya beklenmedik davranışlar. |
| Information | Normal sistem olayları (başlatma, bağlantı durumu). |
| Debug | Detaylı tanısal bilgiler (konfigürasyon ile etkinleştirilir). |
| Trace | Aşırı detaylı düşük seviye loglar (sadece geliştirme). |
Konfigürasyon
Sistem loglama davranışı merkezi Proxus-config.toml dosyası üzerinden kontrol edilir. Tüm detaylar için Konfigürasyon Dosyası Referansı sayfasına bakın. Docker dağıtımlarında, varsayılan log seviyesi gürültüyü en aza indirmek için Warning (Loglevel=3) olarak ayarlanmıştır.
[Logging]
# 0:Trace, 1:Debug, 2:Information, 3:Warning, 4:Error, 5:Critical
Loglevel = 3
# Logların veritabanında saklanacağı gün sayısı (otomatik temizleme öncesi)
LogRetentionTime = 14
# Logların /config dizinindeki yerel dosyalara yazılmasını etkinleştir
LogToFile = trueGelişmiş İzleme Alanları
Sorun gidermeye yardımcı olmak için Proxus, küresel log seviyesi Warning olarak ayarlanmış olsa bile, belirli kritik alt sistemler için otomatik olarak ayrıntılı tanısal verileri (Debug seviyesi) yakalar:
| Fonksiyonel Alan | Ne Loglanır |
|---|---|
| AI Ajanları (MCP) | Bağlam ve komut yürütme hatalarını ayıklamak için yararlı olan, AI asistanı ve platform arasındaki ayrıntılı etkileşimler. |
| Harici Entegrasyonlar | MQTT brokerlarına, HTTP uç noktalarına ve üçüncü taraf API'lere giden veri akışının kapsamlı takibi. |
| Veri Depolama | Veri bütünlüğünü ve yazma performansını doğrulamak için veritabanı kalıcılık görevlerinin ayrıntılı izlenmesi. |
| Veritabanı Sorguları | Performans analizi için karmaşık sorguların yürütme detayları. |
| Özel Betikleme (SDK) | Geliştiricilerin kodlarını etkili bir şekilde hata ayıklamasını sağlayan, kullanıcı tanımlı betiklerden ve mantıktan gelen tüm hata ayıklama çıktıları. |
Proxus, düşük tahsisli log biçimlendirme için ZLogger kullanır ve log girdilerini kalıcılık ile sonraki işleme için platform mesajlaşma hattı üzerinden yönlendirir.