opentsdb-promql-frontend

command module
Version: v0.0.0-...-41074fd Latest Latest
Warning

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

Go to latest
Published: Apr 7, 2017 License: Apache-2.0 Imports: 20 Imported by: 0

README

A PromQL frontend for OpenTSDB

Currently an early proof-of-concept.

A HTTP proxy that supports a subset of the Prometheus API, accepting PromQL queries and answering them with data pulled from OpenTSDB.

Screenshot

Requirements

  • Go 1.8
  • OpenTSDB 2.3+ (earlier versions could potentially be supported)

How to use

go install github.com/mattbostock/opentsdb-promql-frontend
ADDR=localhost:9080 OPENTSDB_URL=http://localhost:4242 opentsdb-promql-frontend

Next, add a Prometheus datasource to Grafana and use the URL specified by the ADDR environment variable.

You should be able to use PromQL to query your OpenTSDB data.

What should (or might) work

  • You can query your OpenTSDB metrics in Grafana by pointing the Prometheus datasource at this proxy.

  • Aggregations and arithmetric.

Known limitations

  • PromQL has tighter restrictions on how metrics can be named, so if you want to query metrics from OpenTSDB such as foo.bar.baz, you'll need to query it using {__name__="foo.bar.baz"}. This restriction is probably solvable.

  • All queries must include a metric name - queries such as {foo="bar"} are not supported.

  • There are no tests yet.

  • Querying for a list of all metric names is not yet implemented.

  • The Prometheus Remote Read API (unreleased at the time of writing) is not yet supported.

  • It's all very experimental - we're using the Prometheus dev-2.0 branch.

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
api
v1

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
t or T : Toggle theme light dark auto
y or Y : Canonical URL