promgrep

Prometheus exporter for metrics that are gotten from stdin and then parsed with regex rules

Usage

Download binary for your platform here

echo "some thing thing thing here " | promgrep --summary "thing@thing"&
curl http://localhost:8880/metrics | grep promgrep

Result:

# HELP promgrep_thing Counters for regex 'thing'
# TYPE promgrep_thing summary
promgrep_thing_sum 0
promgrep_thing_count 3

Arguments

• "--summary [metric_name]@[regex]" defines regex rules for extracting metrics from input stream and expose it as Prometheus Counters. If regex has a group match for a number ([0-9\.]+), the matched number will be used as the counter incrementer. If not defined, an increment of "1" is used. If the regex group is not a number, the matched contents will be used as label contents of the metric. Summary will create two metrics: a _sum with the total counter and a _count with the number of matches found in stream. If no group match for a number is used in regex, sum will be "0" and only _count will increment.

• "--gauge [metric_name]@[regex]" defines regex rules for extracting metrics from input stream and expose it as Prometheus Gauges. The regex must have a group match for a number ([0-9\.]+) as it will be used as the value in metrics. If there is another regex group that does not resolve to a number, the matched contents will be used as "label" value in metric.

• "--output (none|match|all)" determines what will be written to stdout. 'none' for silence, 'match' for lines matches by regex rules or 'all' to input to output passthrough. Defaults to 'match'

Distribution build

Use docker-compose.yml from this repo

Run docker-compose up --build

Get distribution packages at workspace dir /dist

Copy these files to Github under specific "Release" version