# `CMDC.Plugin.Builtin.EventLogger`
[🔗](https://github.com/tupleyun/cmdc/blob/v0.5.3/lib/cmdc/plugin/builtin/event_logger.ex#L1)

P0 事件日志插件 — 将 Agent Pipeline 事件以 JSON Lines 格式追加写入日志文件。

## 日志格式

每条日志是一个 JSON 对象（JSON Lines），包含：

```json
{
  "ts": "2026-03-21T10:00:00.000Z",
  "session": "abc123",
  "event": "before_tool",
  "data": {"tool": "shell", "args": {"command": "mix test"}},
  "level": "info",
  "turn": 1
}
```

## 日志文件路径

默认写入 `{working_dir}/.cmdc/logs/{session_id}.jsonl`。
可通过 `:log_dir` 选项覆盖目录，`:log_file` 直接指定完整路径。

## 配置

    {CMDC.Plugin.Builtin.EventLogger,
      level: :info,       # :debug | :info | :warn
      log_dir: nil,       # 覆盖日志目录
      log_file: nil,      # 直接指定日志文件路径（优先于 log_dir）
      include_args: true  # 是否记录工具调用参数
    }

---

*Consult [api-reference.md](api-reference.md) for complete listing*