From: "Hannes Dürr" <h.duerr@proxmox.com>
To: "Proxmox Backup Server development discussion"
<pbs-devel@lists.proxmox.com>,
"Fabian Grünbichler" <f.gruenbichler@proxmox.com>
Subject: Re: [pbs-devel] [PATCH proxmox-backup v2 3/3] docs: add garbage collection timing example
Date: Mon, 8 Apr 2024 13:11:10 +0200 [thread overview]
Message-ID: <5852b459-85a7-466d-84df-fe98a89f66b7@proxmox.com> (raw)
In-Reply-To: <1712568297.ngmgxkzot1.astroid@yuna.none>
On 4/8/24 11:35, Fabian Grünbichler wrote:
> On April 5, 2024 3:05 pm, Hannes Duerr wrote:
>> To make the garbage collection process easier to understand, we add a
>> timing example with a graphic.
>>
>> Signed-off-by: Hannes Duerr <h.duerr@proxmox.com>
>> ---
>> docs/images/garbage-collection-timing.svg | 2513 +++++++++++++++++++++
>> docs/maintenance.rst | 25 +
>> 2 files changed, 2538 insertions(+)
>> create mode 100644 docs/images/garbage-collection-timing.svg
>>
>> diff --git a/docs/images/garbage-collection-timing.svg b/docs/images/garbage-collection-timing.svg
>> new file mode 100644
>> index 00000000..8108ee23
>> --- /dev/null
>> +++ b/docs/images/garbage-collection-timing.svg
> [snip]
>
>> diff --git a/docs/maintenance.rst b/docs/maintenance.rst
>> index e25c8f19..a23e5c21 100644
>> --- a/docs/maintenance.rst
>> +++ b/docs/maintenance.rst
>> @@ -233,6 +233,31 @@ by the GC as it cannot be certain whether they are still needed.
>> which is 24 hours by default.
>>
>>
>> +Timing Example
>> +^^^^^^^^^^^^^^
>> +
>> +.. figure:: images/garbage-collection-timing.svg
>> + :class: proxmox-svg
>> + :alt: Garbage Collection timing
>> +
>> +t\ :sub:`0`\:
>> +All chunks are part of the backup indices. Some chunks have a newer
>> +``atime`` than the cut-off time, while others have not been accessed
>> +for a while (e.g. because they were only created by a new backup).
>> +
>> +t\ :sub:`1`\:
>> +A backup has been deleted and some chunks are no longer used
>> +
>> +t\ :sub:`2`\:
>> +The first phase of the GC begins and the ``atime`` of the chunks that
>> +are still being used by a backup are updated
>> +
>> +t\ :sub:`3`\:
>> +The second phase of the GC begins. Chunks that have not been used and
>> +whose ``atime`` is older than the cut-off time are deleted. Chunks that
>> +have not been used but whose ``atime`` is newer than the cut-off time
>> +are not yet deleted, but are marked as pending as a precaution.
> I think a visualization might help understand how GC, backup tasks and
> pruning interact. I am not sure this one is "it", though ;)
>
> Maybe changing the time to flow downwards would give more space in the
> horizontal axis to display indices and chunks at a certain point in
> time? At least for me, the arrangement of the chunks between the time
> markers throws me off..
As discussed offlist, a possible compromise would be to split the
graphics into 3 with
descriptive text in between to make it clear that the graphics represent
a moment
during a phase.
>> +
>> Manually Starting GC
>> ^^^^^^^^^^^^^^^^^^^^
>>
>> --
>> 2.39.2
>>
>>
>>
>> _______________________________________________
>> pbs-devel mailing list
>> pbs-devel@lists.proxmox.com
>> https://lists.proxmox.com/cgi-bin/mailman/listinfo/pbs-devel
>>
>>
>>
>
> _______________________________________________
> pbs-devel mailing list
> pbs-devel@lists.proxmox.com
> https://lists.proxmox.com/cgi-bin/mailman/listinfo/pbs-devel
>
>
prev parent reply other threads:[~2024-04-08 11:11 UTC|newest]
Thread overview: 11+ messages / expand[flat|nested] mbox.gz Atom feed top
2024-04-05 13:05 [pbs-devel] [PATCH proxmox-backup v2 0/3] docs: clarify and expand the description of the garbage collection Hannes Duerr
2024-04-05 13:05 ` [pbs-devel] [PATCH proxmox-backup v2 1/3] docs: centralise and update garbage collection description Hannes Duerr
2024-04-08 9:20 ` Fabian Grünbichler
2024-04-10 13:38 ` Hannes Dürr
2024-04-11 7:22 ` Fabian Grünbichler
2024-04-05 13:05 ` [pbs-devel] [PATCH proxmox-backup v2 2/3] docs: add custom class for svgs Hannes Duerr
2024-04-08 9:23 ` Fabian Grünbichler
2024-04-08 10:57 ` Hannes Dürr
2024-04-05 13:05 ` [pbs-devel] [PATCH proxmox-backup v2 3/3] docs: add garbage collection timing example Hannes Duerr
2024-04-08 9:35 ` Fabian Grünbichler
2024-04-08 11:11 ` Hannes Dürr [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=5852b459-85a7-466d-84df-fe98a89f66b7@proxmox.com \
--to=h.duerr@proxmox.com \
--cc=f.gruenbichler@proxmox.com \
--cc=pbs-devel@lists.proxmox.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox