prometheus / prometheus/docs

Graphite vs. Prometheus storage comparison is confusing

Open
#1,388 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

help-wanted
Dominant language
TypeScript
Stars
717
Forks
1.2k
Avg merge
3d 15h
Merged PRs (30d)
19

Description

In https://prometheus.io/docs/introduction/comparison/ under the Graphite section there is, to me, conflicting and confusing information that I can't make sense out of. I have bold italicized what I think the conflicting information is. Why is Prometheus unsuitable for historical data long term? It says Prometheus data may be kept arbitrarily long.

Storage

Graphite stores time series data on local disk in the Whisper format, an RRD-style database that expects samples to arrive at regular intervals. Every time series is stored in a separate file, and new samples overwrite old ones after a certain amount of time.

Prometheus also creates one local file per time series, but allows storing samples at arbitrary intervals as scrapes or rule evaluations occur. Since new samples are simply appended, old data may be kept arbitrarily long. Prometheus also works well for many short-lived, frequently changing sets of time series.

Summary

Prometheus offers a richer data model and query language, in addition to being easier to run and integrate into your environment. If you want a clustered solution that can hold historical data long term, Graphite may be a better choice.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the Graphite section of the comparison page at https://prometheus.io/docs/introduction/comparison/, especially the Storage and Summary sections quoted in the issue. Determine how arbitrary local retention differs from a clustered solution for long-term historical data, then revise the wording so the distinction is unambiguous; done when the two statements no longer appear contradictory.

Written by the indexing model from the issue text.

Assessment

Tech stack
prometheus
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.