From 99d1243082df2f1c8e1d3268652a14cee4aab462 Mon Sep 17 00:00:00 2001 From: emile Date: Thu, 14 Mar 2019 14:55:27 +0000 Subject: Added a simple description --- README.md | 35 ++++++++++++++++++++++++++++++++++- 1 file changed, 34 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index e5a453b..4685d7e 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,36 @@ # metrics-bundler -The metrics bunder is a service receiving metrics from other services bunding them for further user in prometheus and other time series databases. \ No newline at end of file +The metrics bunder is a service receiving metrics from other services bunding them for further user in prometheus and other time series databases. + +## Functions (read / write metrics) + +First of all, writing metrics works by submitting a POST request to the /metrics endpoint: + +```bash +$ url -X POST --data "key=number&value=800" https://metrics-bundler.nbg1.emile.space/metrics +``` + +After that, a GET request can be submitted to the same endpoint (`/metrics`). It returns all of the +metrics submitted: + +```bash +$ curl -X GET https://metrics-bundler.nbg1.emile.space/metrics +number 800.000000 +``` + +## Prometheus integration + +Prometheus can be instructed to use this by creating a new job in the prometheus configuration file: + +``` +... + + - job_name: 'metrics-bundler' + scrape_interval: 5s + static_configs: + - targets: [':'] + +... +``` + +Using the job a above, prometheus is instructed to scrape the /metrics endpoint of the given host every 5 seconds. \ No newline at end of file -- cgit 1.4.1