# Agentic CLI Logging

> Yapılandırılmış log alanları, stderr vs dosya ve secret redaction kurallarını uygularken kullan.

- Skill: `aibot88/agentic-cli-logging` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add aibot88/agentic-cli-logging`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aibot88/agentic-cli-logging/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: aibot88 (https://skillmd.com/u/aibot88)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/aibot88/agentic-cli-logging

---


## 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

- [ ] Örnek log satırında secret yok mu?
- [ ] Log döndürme / boyut sınırı tanımlı mı?
- [ ] Windows vs Unix path log’da okunaklı mı?

## 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`