mudhorn/prometheus
1
0
Fork 0
mirror of https://github.com/prometheus/prometheus.git synced 2025-03-05 20:59:13 -08:00
Code Issues Actions 4 Packages Projects Releases Wiki Activity

Reword storage docs on corruption issues

Browse source 
Reword the section on what to do if major corruption happens. Users are
being confused by the existing wording and cherry-picking the meaning
from the single sentance about durability.

Signed-off-by: SuperQ <superq@gmail.com>
This commit is contained in:
SuperQ 2024-08-09 10:48:55 +02:00
parent cf62fb5c44
commit b7dd209663
No known key found for this signature in database
GPG key ID: C646B23C9E3245F1
1 changed files with 6 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

13
docs/storage.md
View file

@ -117,13 +117,12 @@ time series you scrape (fewer targets or fewer series per target), or you
can increase the scrape interval. However, reducing the number of series is can increase the scrape interval. However, reducing the number of series is
likely more effective, due to compression of samples within a series. likely more effective, due to compression of samples within a series.
If your local storage becomes corrupted for whatever reason, the best If your local storage becomes corrupted to the point where Prometheus will not
strategy to address the problem is to shut down Prometheus then remove the start it is recommended to backup the storage directory and restore the
entire storage directory. You can also try removing individual block directories, corrupted block directories from your backups. If you do not have backups the
or the WAL directory to resolve the problem. Note that this means losing last resort is to remove the corrupted files. For example you can try removing
approximately two hours data per block directory. Again, Prometheus's local individual block directories or the write-ahead-log (wal) files. Note that this
storage is not intended to be durable long-term storage; external solutions means losing the data for the time range those blocks or wal covers.
offer extended retention and data durability.
CAUTION: Non-POSIX compliant filesystems are not supported for Prometheus' CAUTION: Non-POSIX compliant filesystems are not supported for Prometheus'
local storage as unrecoverable corruptions may happen. NFS filesystems local storage as unrecoverable corruptions may happen. NFS filesystems