| name | agentic-cli-logging |
| description | Yapılandırılmış log alanları, stderr vs dosya ve secret redaction kurallarını uygularken kullan. |
Amaç
Log alanları örnekleri: session_id, provider, turn, tool_name, event, duration_ms. Varsayılan stderr; dosyaya yazım opsiyonel. Debug seviyesinde bile API anahtarları, Authorization, kubeconfig içeriği maskelenir (agentic-secrets-handling).
Kapsam
Dahil
- Log seviyesi:
INFO, DEBUG (proje kararı env veya flag).
- Yapılandırılmış JSON log satırı önerisi (observability uyumu).
Hariç
- Merkezi log sunucusu zorunluluğu.
Kurallar
- Kullanıcı mesajı içeriği log’a tam yazılacaksa PII uyarısı ve opt-in (
agentic-trajectory-recording ile hizala).
- Trace id varsa OpenTelemetry ile korelasyon (
agentic-telemetry-optional).
- Hata stack trace yalnız verbose modda.
Kontrol listesi
Hata ve geri dönüş
| Tipik sorun | Kontrol | Sonraki adım |
|---|
| Disk dolu | log path | Rotasyon veya stderr-only |
| Çok gürültülü DEBUG | Filtre | Alan bazlı flag |
İlgili belgeler ve skill'ler
../documantations/ARCHITECTURE_AGENTIC_CLI.md
../agentic-secrets-handling/SKILL.md
../agentic-telemetry-optional/SKILL.md
../agentic-trajectory-recording/SKILL.md