diff options
| author | Ogulcan Celik <ogulcancelik@gmail.com> | 2026-04-23 00:48:22 +0300 |
|---|---|---|
| committer | Ogulcan Celik <ogulcancelik@gmail.com> | 2026-04-23 00:48:22 +0300 |
| commit | 40750418049c5125724b004c8f55ae66ca77edcf (patch) | |
| tree | d72ecadb0506c3643ffaa5fe7cf40f22c90d967a /CONFIGURATION.md | |
| parent | 3d6f3e78624f1308a360cbf02eeca3fec2434436 (diff) | |
feat(logging): add robust rotating support logs
Diffstat (limited to 'CONFIGURATION.md')
| -rw-r--r-- | CONFIGURATION.md | 19 |
1 files changed, 18 insertions, 1 deletions
diff --git a/CONFIGURATION.md b/CONFIGURATION.md index d57542f7..d943dd6b 100644 --- a/CONFIGURATION.md +++ b/CONFIGURATION.md @@ -283,8 +283,25 @@ notes: |----------|-------------| | `HERDR_LOG` | log level filter (default: `herdr=info`) | -logs are written to: +## logs + +herdr writes local file logs under: + +```text +~/.config/herdr/ +``` + +common files: ```text ~/.config/herdr/herdr.log +~/.config/herdr/herdr-client.log +~/.config/herdr/herdr-server.log ``` + +notes: +- `herdr.log` is used by monolithic `--no-session` mode and some top-level startup paths +- persistent session mode mainly uses `herdr-client.log` and `herdr-server.log` +- logs rotate automatically by size and keep a few older files as `.1`, `.2`, and so on +- default logs are metadata-focused and are intended to be shareable for issue diagnosis +- `HERDR_LOG` can increase verbosity when you need a local repro or deeper debugging |