The quickest way to get started is by using the Helm chart from timescale-observability, which provides a broader framework for installing an end-to-end monitoring stack.
The following command will install Prometheus, TimescaleDB, Timescale-Prometheus Connector, and Grafana into your Kubernetes cluster:
helm repo add timescale https://charts.timescale.com/
helm repo update
helm install <release_name> timescale/timescale-observability
To get a fully-documented configuration file for timescale-observability, please run:
helm show values timescale/timescale-observability > my_values.yml
You can then edit my_values.yml and deploy the release with the following command:
helm upgrade --install <release_name> --values my_values.yml timescale/timescale-observability
By default, the timescale-observability Helm chart sets up a single-instance of TimescaleDB; if you are
interested in a replicated setup for high-availabilty with automated backups, please see
this github repo for additional instructions.
We describe how to use our pre-defined views and functions to work with the prometheus data in the SQL schema doc.
A Helm chart for only the Timescale-Prometheus Connector is available in the helm-chart directory of this repository.
This is used as a dependency from the timescale-observability Helm chart and can be used as a dependency in your own custom Helm chart.
You can download pre-built binaries for the Timescale-Prometheus Connector on our release page.
A docker image for the Timescale-Prometheus Connector is available on Docker Hub at timescale/timescale-prometheus.
You must tell prometheus to use this remote storage connector by adding the
following lines to prometheus.yml:
remote_write:
- url: "http://<connector-address>:9201/write"
remote_read:
- url: "http://<connector-address>:9201/read"
You can limit the metrics being sent to the adapter (and thus being stored in your long-term storage) by
setting up write_relabel_configs in Prometheus, via the prometheus.yml file.
Doing this can reduce the amount of space used by your database and thus increase query performance.
The example below drops all metrics starting with the prefix go_, which matches Golang process information
exposed by exporters like node_exporter:
remote_write:
- url: "http://timescale_prometheus_connector:9201/write"
write_relabel_configs:
- source_labels: [__name__]
regex: 'go_.*'
action: drop
Additional information about setting up relabel configs, the source_labels field, and the possible actions can be found in the Prometheus Docs.
The Timescale-Prometheus Connector Binary is configured either through CLI flags or environment variables.
The list of all available flags is displayed on the help timescale-prometheus -h command. All
environment variables are prefixed with TS_PROM.
Before building, make sure the following prerequisites are installed:
The Timescale-Prometheus Connector is a Go project managed by go modules. You can download it in any directory and on the first build it will download it's required dependencies.
# Fetch the source code of Timescale-Prometheus in any directory
$ git clone git@github.com:timescale/timescale-prometheus.git
$ cd ./timescale-prometheus
# Install the Timescale-Prometheus Connector binary (will automatically detect and download)
# dependencies.
$ cd cmd/timescale-prometheus
$ go install
# Building without installing will also fetch the required dependencies
$ go build ./...You can build the Docker container using the Dockerfile.
We welcome contributions to the Timescale-Prometheus Connector, which is licensed and released under the open-source Apache License, Version 2. The same Contributor's Agreement applies as in TimescaleDB; please sign the Contributor License Agreement (CLA) if you're a new contributor.