tgres

command module
v0.0.0-...-403286f Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 3, 2016 License: Apache-2.0 Imports: 1 Imported by: 0

README


Getting Started:

$ go get github.com/tgres/tgres

Now you should have a tgres binary in $GOPATH/bin. Look in
$GOPATH/src/github.com/tgres/tgres/etc for a sample config file. The
user of the PostgreSQL database needs CREATE TABLE permissions.

More about Tgres:

Tgres is a "Time Series Database" which uses PostgreSQL for
storage, written in Go.

It is presently work-in-progress, still under development, things in
flux.

As of Jul 2016, Tgres is clustered. I'll be describing it in more
detail in a blog post.

Tgres can receive data using Graphite Text, UDP and Pickle
protocols, as well as Statsd (counters, gauges and timers). It
supports enough of a Graphite HTTP API to be usable with
Grafana. Tgres implements the majority of the Graphite functions.

Tgres places emphasis on accuracy and stores data similarly to
RRDTool, using a weighted average of points that arrive within the
same step rather than discarding them.

Internally a datapoint refers to a time interval rather than a point
in time. This is a more accurate and flexible representation which
should also allow correct updates of past data (NIY).

Tgres stores data in a round-robin database split over a number of
PostgreSQL rows of arrays. This means that a series occupies a
constant number of rows in a database and can be updated in single row
chunks for IO efficiency. The number of datapoints per row is
configurable for each series individually. Tgres provides two
PostgreSQL views to make time series appear as a regular table.

Tgres caches datapoints in memory until a certain number of
datapoints has accumulated or a certain time period has been reached
to reduce IO.

Tgres relies on goroutines heavily and will take advantage of
multiple CPU's on SMP architectures.

One of the main goals of Tgres is to address the data isolation
problem with most of the TS databases out there. Your TS data can reside
in the same PostgreSQL database as other data and can be easily
joined, analyzed, etc.

Other (future) goals/notes:

It has to be simple. There shouldn't be many daemons/components - just
this one process to receive and serve the data and the database server.

Presently Tgres does not store the original datapoints as they
come in, data is always aggregated. This may change.

Graphite API was used only as a starting point, to be able to prove the
concept and test against existing tools (mostly Grafana). Longer term
there may be more interesting methods of exchanging data, e.g. gob or
Redis protocol, etc.

Some terminology:

RRD - Round Robin Database. This is the "technology" that makes it
      possible, it doesn't referer to any specific.

DS -  Data Source. This is your temperature in the room or bytes per
      second passing through, etc. A data source has a name. At a very
      high level it is a "time series" (only calling it that would be
      confusing with respect to RRA's).

RRA - Round Robin Archive. An RRA is an actual series. A DS has at
      least one RRA, usually more than one. For example if we store 60
      points at 1 minute resolution, that's one RRA, and if we store
      12 points at 1 hour resolution, that's another RRA. An RRA is a
      fixed size array of floats.

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
Cluster is a simple clustering package built on top of https://godoc.org/github.com/hashicorp/memberlist.
Cluster is a simple clustering package built on top of https://godoc.org/github.com/hashicorp/memberlist.
cmd
Package rrd does the thing ZZZ.
Package rrd does the thing ZZZ.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL