Prometheus metrics to Honeycomb

Tool to pull prometheus metrics from a url or file, and dump to a honeycomb dataset

Getting started

With docker

Just run the built docker image like so:

docker run --rm hcaptcha/prometheus2honeycomb \
  python3 prometheus2honeycomb.py \
  --url http://my-metrics-server:8000/metrics \
  --ship

Without docker

First you'll need the prom2json go tool installed via the following:

# via GO
go get github.com/prometheus/prom2json/cmd/prom2json

# via HTTP / github releases (only for linux 386 at the moment)
# or install from https://github.com/prometheus/prom2json/releases
./bin/get_prom2json

Then configure the dataset name and honeycomb write key that you want to use to send your data to:

export DATASET_NAME=myDataset
export HONEYCOMB_WRITEKEY=myHoneycombWriteKey

Finally point the tool at a URL and it'll submit all the metrics it finds there. You can also just print the results to screen without the --ship option:

pipenv run python3 prometheus2honeycomb.py --url http://my-metrics-server:8000/metrics --ship

You can also additional fields to the output of each event that gets sent to honeycomb by adding a --extra-args key1=value1 key2=value2

Contributing

Building

Currently this repo is manually built via the following steps:

docker build -t hcaptcha/prometheus2honeycomb:latest .

It gets deployed to dockerhub via the dockerhub cloud build system.

Lint

To run the linter, run ./bin/lint.

If CI is set to true, then it will fail if there are lint issues. Otherwise, if it is not set, you can run this and it will reformat your code to match the standards

Testing

To test the whole workflow, run:

./bin/ci

hCaptcha/prometheus2honeycomb