History

Bryan Boreham 2c1be4df7b tsdb: more efficient sorting of postings read from WAL at startup (#10500 ) * tsdb: avoid slice-to-interface allocation in EnsureOrder This is pulling the `seriesRefSlice` out of the loop, so the compiler doesn't allocate a new one on the heap every time. Signed-off-by: Bryan Boreham <bjboreham@gmail.com> * tsdb: use pointer type in Pool for EnsureOrder As noted by staticcheck, Pool prefers the objects in the pool to have pointer type. This is a little more fiddly to code, but avoids allocation of a wrapper object every time a slice is put into the pool. Removed a comment that said fixing this has a performance penalty: not borne out by benchmarks. Signed-off-by: Bryan Boreham <bjboreham@gmail.com>		3 years ago
..
agent	Enable misspell check in golangci-lint (#10393 )	3 years ago
chunkenc	Add SyncForState Implementation for Ruler HA (#10070 )	3 years ago
chunks	Disable chunk write queue by default, allow user to configure the exact size (#10425 )	3 years ago
docs	Update wal.md (#10442 )	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	tsdb: more efficient sorting of postings read from WAL at startup (#10500 )	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	refactor: use `T.TempDir()` and `B.TempDir` to create temporary directory	3 years ago
tsdbutil	storage: fix bug #10027 in iterators' Seek method	3 years ago
wal	Run gofumpt on all files (#10392 )	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	refactor: use `T.TempDir()` and `B.TempDir` to create temporary directory	3 years ago
blockwriter.go	Move packages out of deprecated pkg directory	3 years ago
blockwriter_test.go	refactor: use `T.TempDir()` and `B.TempDir` to create temporary directory	3 years ago
compact.go	CompactBlockMetas should produce correct mint/maxt for overlapping blocks. (#10108 )	3 years ago
compact_test.go	refactor: use `T.TempDir()` and `B.TempDir` to create temporary directory	3 years ago
db.go	deleting *.tmp WAL files on startup (#10317 )	3 years ago
db_test.go	deleting *.tmp WAL files on startup (#10317 )	3 years ago
example_test.go	Fix Example() function in TSDB (#10153 )	3 years ago
exemplar.go	tsdb: use simpler map key to improve exemplar ingest performance (#10111 )	3 years ago
exemplar_test.go	tsdb: use simpler map key to improve exemplar ingest performance (#10111 )	3 years ago
head.go	Fix panic on query when m-map replay fails with snapshot enabled (#10348 )	3 years ago
head_append.go	clarify Head.appendableMinValidTime (#10303 )	3 years ago
head_bench_test.go	refactor: use `T.TempDir()` and `B.TempDir` to create temporary directory	3 years ago
head_read.go	Label values with matchers by intersecting postings (#9907 )	3 years ago
head_test.go	Enable misspell check in golangci-lint (#10393 )	3 years ago
head_wal.go	Fix queries after a failed snapshot replay (#9980 )	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	Label values with matchers by intersecting postings (#9907 )	3 years ago
querier_bench_test.go	refactor: use `T.TempDir()` and `B.TempDir` to create temporary directory	3 years ago
querier_test.go	refactor: use `T.TempDir()` and `B.TempDir` to create temporary directory	3 years ago
repair.go	Switched to go-kit/log	4 years ago
repair_test.go	refactor: use `T.TempDir()` and `B.TempDir` to create temporary directory	3 years ago
tsdbblockutil.go	TSDB: demistify SeriesRefs and ChunkRefs (#9536 )	3 years ago
wal.go	fix potential goroutine leaks	3 years ago
wal_test.go	refactor: use `T.TempDir()` and `B.TempDir` to create temporary 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: