Denetim Logları kullanıcı eylemlerini takip ederken, Sistem Logları Proxus platformunun teknik kalp atışını yakalar. Bu akış, arka uç API'sinden, edge gateway'lerden, aktörlerden ve entegrasyon noktalarından gelen logları birleştirir.
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 gerçek zamanlı, 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. Bu, en çok ihtiyaç duyulan yerde derin görünürlüğe sahip olmanızı sağlar:
| 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, sıfır tahsisli (zero-allocation) loglama için NATS JetStream ile ZLogger kullanır. Bu, yüksek hacimli hata ayıklama loglamasının bile platform performansı üzerinde minimum etkiye sahip olmasını sağlar.