Prometheus KairosDB Adapter

This is a write adapter that receives samples via Prometheus remote write protocol and stores them in KairosDB. Any labels attached to the metric will be added to the KairosDB metric as a Tag.

As of now this adapter only supports writing to KairosDB.

Building

# Build the binary
make

# Build the docker image with custom docker hub username, image name, and version
# DOCKERHUB_USERNAME defaults to chosenken
# IMAGE_NAME defaults to prometheus-kairosdb-adapter
# VERSION defaults to latest
make DOCKERHUB_USERNAME=<name> IMAGE_NAME=prometheus-kairosdb-adapter VERSION=v1.0 image

# Push the docker image with custom docker hub username, image name, and version
# NOTE:  You can call push without calling image, push will build the image
make DOCKERHUB_USERNAME=<name> IMAGE_NAME=prometheus-kairosdb-adapter VERSION=v1.0 push

Usage

Prometheus write adapter for KairosDB

Usage:
  prometheus-kairosdb-adapter [flags]
  prometheus-kairosdb-adapter [command]

Available Commands:
  echo        Prints out received metrics from prometheus
  help        Help about any command

Flags:
  -d, --debug                 Enable Debug
  -h, --help                  help for prometheus-kairosdb-adapter
      --kairosdb-url string   KairosDB URL
  -p, --listen-port int       Listen Port (default 9201)

Running

./prometheus_kairosdb_adapter --kairosdb-url http://localhost:8080

Running in Docker

# KairosDB is on a different host
docker run --name prometheus-kairosdb-adapter -d -p 9201:9201 chosenken/prometheus-kairosdb-adapter --kairos-url=http://<kairosDB Address>:8080

# KairosDB is on the same host but not in docker
docker run --name prometheus-kairosdb-adapter -d -p 9201:9201 --net="host" chosenken/prometheus-kairosdb-adapter -kairos-url=http://localhost:8080

Configure Prometheus

To configure Prometheus to send samples to the KairosDB adapter, add the following to your prometheus.yaml file:

remote_write:
  - url: "http://localhost:9201/write"

Metrics

Prometheus metrics are exported on the /metrics path. The standard prometheus client library metrics are provided, along with the metric prometheus_kairosdb_ignored_samples_total. The metric is the total number of samples not sent to KairosDB due to unsupported float values (Inf, -Inf, NaN)."