You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@fluss.apache.org by "wuchong (via GitHub)" <gi...@apache.org> on 2026/08/10 16:22:34 UTC
[I] [docs] Document local log TTL and active segment rolling [fluss]
wuchong opened a new issue, #3938:
URL: https://github.com/apache/fluss/issues/3938
### Motivation
Local log retention behavior is being extended by #3748 and #3830. The user-facing documentation should describe the resulting configuration model and clearly distinguish remote log retention, local log retention, and active-segment rolling.
### Documentation scope
- Document `table.log.local-ttl`:
- it controls retention of local log segments;
- a local segment is eligible for TTL cleanup only after it has been copied to remote storage;
- document its default value and validation constraints, including its relationship with `table.log.ttl`;
- reconcile with the initial documentation changes already included in #3778.
- Document `log.retention.roll-active-segment.enabled`:
- it is a server configuration and is disabled by default;
- when enabled, a non-empty active segment may be rolled after the table log TTL expires and the high watermark reaches the log end offset;
- explain that rolling makes the segment eligible for remote upload and subsequent local cleanup.
- Expand the TTL page to distinguish:
- `table.log.ttl` for table/remote log retention;
- `table.log.local-ttl` for copied local segments;
- active-segment rolling controlled by `log.retention.roll-active-segment.enabled`.
- Update or regenerate the relevant table and server configuration reference pages.
- Update the tiered-storage documentation and add cross-links to the TTL page.
### Related issues and pull requests
- Related to #3748
- Related to #3830
- Related PR: #3778
- Related PR: #3831
### Acceptance criteria
- Both configuration keys are searchable in the published documentation.
- Their defaults, constraints, scope, and interaction are documented.
- The TTL page explains the local-segment lifecycle from active segment, to rolled/uploaded segment, to local cleanup.
- Existing documentation changes in #3778 are retained and reconciled instead of duplicated.
- The TTL, configuration-reference, and tiered-storage pages link to each other where appropriate.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@fluss.apache.org.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [I] [docs] Document local log TTL and active segment rolling [fluss]
Posted by "wuchong (via GitHub)" <gi...@apache.org>.
wuchong closed issue #3938: [docs] Document local log TTL and active segment rolling
URL: https://github.com/apache/fluss/issues/3938
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@fluss.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [I] [docs] Document local log TTL and active segment rolling [fluss]
Posted by "wuchong (via GitHub)" <gi...@apache.org>.
wuchong commented on issue #3938:
URL: https://github.com/apache/fluss/issues/3938#issuecomment-5243075845
cc @gyang94
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@fluss.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org