Retention конфигурация

Тема дорожной карты · Loki

Конфигурация хранения данных в Grafana Loki определяет, как долго лог-данные сохраняются до их удаления Compactor, и задаётся в секции limits_config файла loki-config.yaml с помощью ключа retention_period, принимающего значения длительности, например 744h (31 день) или 30d. Чтобы активировать хранение с ограниченным сроком, необходимо также установить retention_enabled: true в блоке compactor; без этого флага Compactor будет компактировать файлы индекса, но не будет удалять никакие данные, независимо от значения retention_period. Глобальный retention_period в разделе limits_config применяется по умолчанию ко всем тенантам, однако отдельные тенанты могут переопределить его с помощью retention_period в файле per_tenant_override_config, что позволяет гибко управлять жизненным циклом данных в многотенантном развёртывании Grafana Loki. Минимально поддерживаемый период хранения составляет 24 часа, а значение retention_period: 0 полностью отключает удаление данных для данной области. После изменения конфигурации хранения нужно подождать хотя бы один цикл Compactor (по умолчанию 10 минут), прежде чем проверять, удаляются ли старые чанки из объектного хранилища.

Как это работает

Retention конфигурация: retention в Loki enforce-ит compactor — старые chunks удаляются из object storage по global retention period или per-tenant overrides. Compactor также merge-ит + dedupe-ит index файлы. Без него storage растёт вечно. Per-tenant retention (в multi-tenant Loki) даёт каждому tenant разную retention policy — полезно для "free tier: 7 дней, paid tier: 30 дней". Retention на chunk-уровне + может быть гранулярна (per-stream / per-label match).

Когда применять

Retention консервативно с первого дня — легче extend позже, чем nuke месяцы данных. Dedicated compactor instance в prod (не embedded). Мониторьте compactor lag — если отстал, retention не enforce-ится + storage взрывается. Для multi-tenant — план retention pricing в tier-ы.

Типичные ошибки

Ловушки Retention конфигурация: нет compactor (retention не enforce — storage costs взрывают); compactor недопровизион (lag, retention drift); retention короче окна incident-investigation (логи ушли до postmortem); per-tenant retention misconfigured (тихо держит больше задуманного).

Связанные понятия

Полезные ресурсы