History

Darshan Chaudhary 9dcf8b2208 Add the ability to disable tsdb isolation (#9270 ) * Disable isolation in isolation struct Signed-off-by: darshanime <deathbullet@gmail.com> * Run tsdb tests with isolation disabled Signed-off-by: darshanime <deathbullet@gmail.com> * Check for isolation disabled in isoState.Close() Signed-off-by: darshanime <deathbullet@gmail.com> * use t.Skip to skip isolation tests when disabled Signed-off-by: darshanime <deathbullet@gmail.com> * address review comments Signed-off-by: darshanime <deathbullet@gmail.com> * fix test for defaultIsolationState Signed-off-by: darshanime <deathbullet@gmail.com> * Change flag name. Set flag in DB. Do not init txRing. Close isoState. Signed-off-by: Ganesh Vernekar <ganeshvern@gmail.com> * Test disabled isolation in CircleCI test_go Signed-off-by: Ganesh Vernekar <ganeshvern@gmail.com> * Skip isolation related tests in db_test.go Signed-off-by: Ganesh Vernekar <ganeshvern@gmail.com> Co-authored-by: Ganesh Vernekar <ganeshvern@gmail.com>		3 years ago
..
agent	Share TSDB locker code with agent (#9623 )	3 years ago
chunkenc	improve bstream comments and doc (#9560 )	3 years ago
chunks	clarify HeadChunkID type and usage (#9726 )	3 years ago
docs	clarify HeadChunkID type and usage (#9726 )	3 years ago
encoding	Format Go source files using 'gofumpt -w -s -extra'	3 years ago
errors	Address golint failures from revive	3 years ago
fileutil	tsdb: Add windows arm64 support.	3 years ago
goversion	Add new Go build tags.	3 years ago
index	Add more size checks when writing individual sections in the index. (#9710 )	3 years ago
record	Add basic initial developer docs for TSDB (#9451 )	3 years ago
test	Move packages out of deprecated pkg directory	3 years ago
testdata	tsdb: Delete blocks atomically; Remove tmp blocks on start; Added test. (#7772 )	4 years ago
tombstones	TSDB: demistify SeriesRefs and ChunkRefs (#9536 )	3 years ago
tsdbutil	Share TSDB locker code with agent (#9623 )	3 years ago
wal	fix: panic when checkpoint directory is empty (#9687 )	3 years ago
.gitignore	Moving tsdb into its own subdirectory	5 years ago
CHANGELOG.md	Rename default branch to main	4 years ago
README.md	Add basic initial developer docs for TSDB (#9451 )	3 years ago
block.go	Move packages out of deprecated pkg directory	3 years ago
block_test.go	Move packages out of deprecated pkg directory	3 years ago
blockwriter.go	Move packages out of deprecated pkg directory	3 years ago
blockwriter_test.go	Move packages out of deprecated pkg directory	3 years ago
compact.go	TSDB: demistify SeriesRefs and ChunkRefs (#9536 )	3 years ago
compact_test.go	Move packages out of deprecated pkg directory	3 years ago
db.go	Add the ability to disable tsdb isolation (#9270 )	3 years ago
db_test.go	Add the ability to disable tsdb isolation (#9270 )	3 years ago
example_test.go	Add basic initial developer docs for TSDB (#9451 )	3 years ago
exemplar.go	Move packages out of deprecated pkg directory	3 years ago
exemplar_test.go	Move packages out of deprecated pkg directory	3 years ago
head.go	Add the ability to disable tsdb isolation (#9270 )	3 years ago
head_append.go	Add the ability to disable tsdb isolation (#9270 )	3 years ago
head_bench_test.go	Move packages out of deprecated pkg directory	3 years ago
head_read.go	Add the ability to disable tsdb isolation (#9270 )	3 years ago
head_test.go	Add the ability to disable tsdb isolation (#9270 )	3 years ago
head_wal.go	Move packages out of deprecated pkg directory	3 years ago
isolation.go	Add the ability to disable tsdb isolation (#9270 )	3 years ago
isolation_test.go	Add the ability to disable tsdb isolation (#9270 )	3 years ago
mocks_test.go	Move packages out of deprecated pkg directory	3 years ago
querier.go	Move packages out of deprecated pkg directory	3 years ago
querier_bench_test.go	Move packages out of deprecated pkg directory	3 years ago
querier_test.go	Move packages out of deprecated pkg directory	3 years ago
repair.go	Switched to go-kit/log	4 years ago
repair_test.go	Move packages out of deprecated pkg directory	3 years ago
tsdbblockutil.go	TSDB: demistify SeriesRefs and ChunkRefs (#9536 )	3 years ago
wal.go	Move packages out of deprecated pkg directory	3 years ago
wal_test.go	Move packages out of deprecated pkg directory	3 years ago

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: