grafana/loki

No documentation on lifecycle policies for retention in object stores

Open

#15.528 geöffnet am 20. Dez. 2024

Auf GitHub ansehen
 (0 Kommentare) (1 Reaktion) (0 zugewiesene Personen)Go (28.187 Stars) (3.997 Forks)batch import
component/storagehelp wantedtype/docs

Beschreibung

The documentation about retention states that logs are only deleted if a lifecycle storage policy on the store deletes it, however, the documentation doesn't specify what that policy should look like.

For instance:

  1. What is the significance of the loki_cluster_seed.json file at the root of the container? (A blanket delete after x days policy would automatically delete this as well)
  2. Are files in /index meant to be deleted, or should it just be limited to /<orgId> or /fake

Contributor Guide

Tech Stack
go
Domain
documentation
Issue Type
documentation
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
2
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
half day
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
fresh
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
clear
Voraussetzungen
Understanding of object storage lifecycle policiesFamiliarity with Grafana Loki storage structure
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
75
Research-Richtung
Examine the current retention documentation at the provided URL to understand what is already stated. Look at the Loki source code to understand the significance of 'loki cluster seed.json' and the index files. Check for any existing issues or discussions about lifecycle policies. Then propose updates to the documentation to clarify the required lifecycle policy, addressing the specific questions about the seed file and index directory.