Name		Name	Last commit message	Last commit date
parent directory ..
agent		agent
chunkenc		chunkenc
chunks		chunks
docs		docs
encoding		encoding
errors		errors
fileutil		fileutil
goversion		goversion
index		index
record		record
test		test
testdata		testdata
tombstones		tombstones
tsdbutil		tsdbutil
wal		wal
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
README.md		README.md
block.go		block.go
block_test.go		block_test.go
blockwriter.go		blockwriter.go
blockwriter_test.go		blockwriter_test.go
compact.go		compact.go
compact_test.go		compact_test.go
db.go		db.go
db_test.go		db_test.go
example_test.go		example_test.go
exemplar.go		exemplar.go
exemplar_test.go		exemplar_test.go
head.go		head.go
head_append.go		head_append.go
head_bench_test.go		head_bench_test.go
head_read.go		head_read.go
head_test.go		head_test.go
head_wal.go		head_wal.go
isolation.go		isolation.go
isolation_test.go		isolation_test.go
mocks_test.go		mocks_test.go
querier.go		querier.go
querier_bench_test.go		querier_bench_test.go
querier_test.go		querier_test.go
repair.go		repair.go
repair_test.go		repair_test.go
tsdbblockutil.go		tsdbblockutil.go
wal.go		wal.go
wal_test.go		wal_test.go

README.md

TSDB

This directory contains the Prometheus TSDB (Time Series DataBase) library, which handles storage and querying of all Prometheus v2 data.

Due to an issue with versioning, the "latest" docs shown on Godoc are outdated. Instead you may use the docs for v2.31.1

Documentation

External resources

A writeup of the original design can be found here.
Video: Storing 16 Bytes at Scale from PromCon 2017.
Compression is based on the Gorilla TSDB white paper.

A series of blog posts explaining different components of TSDB: