From b4fd31dddceb4ddc9dda6b21f79747e0863f9088 Mon Sep 17 00:00:00 2001 From: disqualifier Date: Fri, 16 Oct 2026 04:40:13 -0400 Subject: [PATCH] docs: one process per live file, a distinct history_name per service Signed-off-by: disqualifier --- README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/README.md b/README.md index ab912bb..986c12f 100644 --- a/README.md +++ b/README.md @@ -85,6 +85,12 @@ setup_logging(name="latest", rotate="daily") - Retention (tier counts / `backup_count`) is unchanged — it's just keyed to the project stem now. +**One process per live file, one `history_name` per service.** Rotation and retention +assume a single writer: two processes writing the same live file both try to roll it, and +two services sharing a `log_dir` with the same history stem prune each other's history +(each counts the other's rolls against its own `backup_count`). Give each process its own +live file, and give services that share a cwd or `log_dir` distinct `history_name`s. + ## Tiered retention (`keep_uncompressed` / `keep_compressed`) The default is a flat `backup_count`: every rolled file is gzipped on roll and the oldest