Documentation about deleting logs / retention should be reworked

[michaelkebe]

I'm always frustrated when it comes to deleting logs from loki.

1. The documentation is splitted across at least 4 pages.

• https://grafana.com/docs/loki/latest/operations/storage/logs-deletion/
• https://grafana.com/docs/loki/latest/configuration/#compactor
• https://grafana.com/docs/loki/latest/api/#request-log-deletion
• https://grafana.com/docs/loki/latest/operations/storage/retention/

2. After submitting a new delete request, it takes a few minutes a query could not find the logs anymore. The excact timing is not, if not poorly documented.

3. The delete request have a states received and processed, but even if there are received only, it is not possible find them with a query (related to 2.).

4. The deletion of chunks. When does is happen, where does is happen (dependency of the used storage)?

5. How does deleting logs relates to Compactor and Table Manager?

6. How does deleting logs relates to retention?

Describe the solution you'd like A clear and concise description of deleting logs, at best on a single page.

[GrafanaWriter]

@JStickler - can you please review as part of your review of the Loki docs?

[max-wets]

Hi! Any update about this in the current state of Loki documentation?

[JStickler]

@max-wets While we do have a cluster of three issues around the documentation for retention, currently updating the installation and getting started documentation is a higher priority.