2019-03-18 05:44:58 -07:00
|
|
|
# TSDB
|
2017-04-10 04:29:46 -07:00
|
|
|
|
2021-06-17 04:18:51 -07:00
|
|
|
[](https://pkg.go.dev/github.com/prometheus/prometheus/tsdb)
|
2018-05-07 02:10:31 -07:00
|
|
|
|
2020-10-19 04:47:10 -07:00
|
|
|
This directory contains the Prometheus storage layer that is used in its 2.x releases.
|
2017-04-10 04:29:46 -07:00
|
|
|
|
|
|
|
|
A writeup of its design can be found [here](https://fabxc.org/blog/2017-04-10-writing-a-tsdb/).
|
2018-01-09 07:40:05 -08:00
|
|
|
|
2018-10-23 03:43:06 -07:00
|
|
|
Based on the Gorilla TSDB [white papers](http://www.vldb.org/pvldb/vol8/p1816-teller.pdf).
|
|
|
|
|
|
2018-06-04 05:41:43 -07:00
|
|
|
Video: [Storing 16 Bytes at Scale](https://youtu.be/b_pEevMAC3I) from [PromCon 2017](https://promcon.io/2017-munich/).
|
|
|
|
|
|
2021-10-25 06:14:15 -07:00
|
|
|
See also the [format documentation](docs/format/README.md) and [bstream details](docs/bstream.md).
|
2020-10-19 04:47:10 -07:00
|
|
|
|
|
|
|
|
A series of blog posts explaining different components of TSDB:
|
|
|
|
|
* [The Head Block](https://ganeshvernekar.com/blog/prometheus-tsdb-the-head-block/)
|
|
|
|
|
* [WAL and Checkpoint](https://ganeshvernekar.com/blog/prometheus-tsdb-wal-and-checkpoint/)
|
|
|
|
|
* [Memory Mapping of Head Chunks from Disk](https://ganeshvernekar.com/blog/prometheus-tsdb-mmapping-head-chunks-from-disk/)
|
2021-01-21 03:44:40 -08:00
|
|
|
* [Persistent Block and its Index](https://ganeshvernekar.com/blog/prometheus-tsdb-persistent-block-and-its-index/)
|
2021-09-21 09:05:33 -07:00
|
|
|
* [Queries](https://ganeshvernekar.com/blog/prometheus-tsdb-queries/)
|
|
|
|
|
* [Compaction and Retention](https://ganeshvernekar.com/blog/prometheus-tsdb-compaction-and-retention/)
|
|
|
|
|
* [Snapshot on Shutdown](https://ganeshvernekar.com/blog/prometheus-tsdb-snapshot-on-shutdown/)
|
