VMStorage. Описание опции retentionPeriod

Tags:

1. Использованные материалы

  1. https://docs.victoriametrics.com/victoriametrics/single-server-victoriametrics/#retention

2. Описание

  1. Значение опции retentionPeriod указывается в месяцах, которые здесь равны 31 дню. Например, retentionPeriod 2 соответствует установке retentionPeriod 62d.

  2. Возможные для указания суффиксы: h(ours), d(ays), w(eeks), y(yars).

  3. При retentionPeriod < 31 дня, метрики хранятся партициями по 1 суткам.

  4. При retentionPeriod > 31 дня, метрики хранятся партициями по 1 календарному месяцу.

  5. Нет значения infinite. Для этих целей рекомендуется указывать 100y.

  6. Метрики хранятся в каталогах {storageDataPath}/data/{big,small}. В этих каталогах для каждого календарного месяца существует отдельная директория с именем вида 2024_09, 2024_10, etc.

  7. Вне зависимости от указанного значения в retentionPeriod, удаляться будет целый календарный месяц (кроме случая, когда retentionPeriod < 1 месяца). То есть при retentionPeriod 32d, метрики предыдущего месяца будут храниться ещё один месяц. (переформулировать).

  8. При наступлении retention-события, все календарные каталоги, диапазон содержимого которых вышло за значение RetentionPeriod, будут моментально уничтожены.

  9. Кроме каталога {storageDataPath}/data, где хранятся временные ряды, для хранения "IndexDB" используется каталог {storageDataPath}/indexdb. Индекс не может быть удалён и/или сжат. Кроме того, после первого же retention-события, в каталоге {storageDataPath}/indexdb будут храниться два Индекса. Один из них актуальный и ежедневно пополняющийся, второй статичный прошлый IndexDB.

  10. Оставшееся время до наступления retention-события указывает в секундах в метрике vm_next_retention_seconds.